FTP-клиент 1С продвинутый (сервер, пароли, регламентные задания)

В задании указывается, что передать, откуда, куда и когда. Направлений два: скачать файлы с FTP на сервер 1С или выложить с сервера 1С на FTP. Заданий может быть сколько угодно, у каждого своё расписание, свой FTP и свои настройки уведомлений. Нужна БСП в конфигурации.

Как это работает

Кнопка «Выполнить сейчас» в списке делает то же самое сразу, не дожидаясь расписания, и показывает результат, так удобно проверять новое задание.

Список заданий: направление, FTP, файлы, расписание, последний запуск и его результат.

Вверху карточки обычными словами написано, что задание будет делать, так что перед сохранением можно себя проверить.

Карточка задания. Подписи «Откуда / Куда» меняются вместе с направлением.

Что можно настроить

• один файл, файлы по маске или все файлы каталога;
• удалять ли файл-источник после передачи;
• что делать, если файлов нет: ничего или считать ошибкой (второе нужно, когда файл обязан быть, например ежедневный прайс);
• сколько раз повторять при обрыве связи;
• письмо при ошибке и (или) при успехе, через учётную запись почты БСП. В теме можно использовать [Задание] и [Результат], в письме будет список файлов и текст ошибок.

Журнал регистрации и письма

Каждый запуск пишется в журнал регистрации, события FTP-клиент.Задания по расписанию: по расписанию он был или вручную, какие файлы переданы, какие были ошибки. Письма пишутся отдельным событием вместе с полным текстом и адресатами: отправленные с уровнем «Информация», неотправленные с уровнем «Ошибка». Так что если что-то не пришло, разобраться можно без отладчика.

Что ещё надо знать

• задания выполняются на сервере 1С, поэтому и каталоги указываются на сервере или сетевые (\\сервер\папка), права на них нужны учётной записи, под которой работает служба 1С;
• для скачивания каталог на сервере создаётся сам, для выгрузки на FTP он должен существовать;
• настраивать задания может только пользователь с правом «Администрирование»;
• пароли заданий хранятся в безопасном хранилище БСП и обратно в форму не возвращаются;
• если закрыть карточку с несохранёнными изменениями, обработка спросит, сохранить ли их.

В оригинале FTP работал только с компьютера пользователя. Я добавил второй режим, через сервер 1С, и теперь в окне подключения можно выбрать, откуда подключаться:

• Клиент: соединение идёт с компьютера, где сидит пользователь. Подходит, если FTP в локальной сети офиса или доступ к нему открыт только с рабочих мест.
• Сервер 1С: соединение идёт с сервера. Это выручает, когда поставщик пускает на FTP только с IP сервера, когда пользователь работает удалённо или через браузер. Самому пользователю доступ к FTP при этом не нужен, ставить ему FileZilla тоже не надо.

Там же галка «Защищенное соединение», если сервер поддерживает FTPS.

Браузер FTP не умеет, поэтому в веб-клиенте обработка всегда работает через сервер 1С. Файлы с компьютера и на компьютер передаются через браузер. Расширение для работы с файлами обработка предложит поставить один раз, без него файлы скачиваются средствами браузера.

Загрузка, скачивание и удаление файла в веб-клиенте.

Слева дерево каталогов, справа файлы текущей папки. Файлы и папки можно загружать и скачивать целиком, вместе с вложенными, создавать, переименовывать, удалять, искать по маске. Двойной щелчок по папке открывает её. Файлы .epf и .erf открываются сразу как обработка или отчёт, а .mxl как табличный документ.

В меню «Инструменты» (кроме веб-клиента): открыть конфигуратор, сохранить конфигурацию в .cf, выгрузить файловую базу в .dt, в том числе сразу в текущий каталог на FTP. Загрузить .cf с FTP можно только с правом «Администрирование», и перед этим обработка предупредит, что конфигурация будет заменена полностью.

FTP показывает размер файлов, но не папок. Когда на сервере кончается место, приходится открывать папки по одной и прикидывать. Кнопка «Посчитать размер папок» обходит все папки текущего каталога вместе с вложенными и заполняет колонки «Размер» и «Файлов». Если папок много и считается долго, можно прервать по Ctrl+Break, уже посчитанное останется.

При запуске открывается окно подключения. Слева сохранённые профили (последние сверху), справа параметры. Двойной щелчок по профилю подключает к серверу, а кнопка «Изменить» только заполняет поля, чтобы что-то поправить.

• Импорт из FileZilla (sitemanager.xml): переносятся FTP и FTPS-сайты вместе с папками, пассивным режимом и начальным каталогом. SFTP-сайты и пароли под мастер-паролем FileZilla пропускаются.
• Профили можно выгрузить в JSON и загрузить в другой базе (Профили - Ещё). Пароли попадают в файл, только если сами это выберете.
• Строку подключения вида ftp://пользователь:пароль@сервер:порт можно скопировать в буфер и вставить из буфера. Спецсимволы в логине и пароле обрабатываются правильно. Включать ли пароль в строку, обработка спросит.
• Оттуда же можно скопировать готовый код подключения к FTP на встроенном языке.
• Если соединение отвалилось после простоя, обработка переподключится сама.

Как хранятся пароли

DPAPI защищает от администратора 1С и других пользователей базы, от кражи базы или её копии и от других пользователей Windows на этом компьютере. От вируса, запущенного под вашей учёткой, или от администратора домена не защитит. И помните, что обычный FTP без TLS передаёт пароль по сети открытым текстом, так что если сервер умеет FTPS, лучше его включить.

Администрирование - Печатные формы, отчеты и обработки - Дополнительные отчеты и обработки. Дальше «Добавить из файла...» (или «Обновить из файла...», если обработка уже есть), выбрать FTPКлиентПродвинутый.epf и подтвердить предупреждение безопасности.

В карточке три команды:

• FTP-клиент Продвинутый открывает проводник;
• Задания FTP по расписанию открывает список заданий;
• Выполнить задания FTP и есть тот самый будильник, ему нужно включить расписание, например раз в 5 минут.

Без БСП обработку можно открыть через «Файл - Открыть», работать будет всё, кроме заданий по расписанию.

За основу взята «FTP-Клиент на 1С» v1.1. Автор называл её велосипедом с удобными педалями, я к этому велосипеду приделал багажник и фары:

• список профилей, импорт из FileZilla, выгрузка и загрузка в JSON;
• пароли шифруются через DPAPI, а не хранятся в Base64, появилась галка «Запомнить пароль», при копировании строки подключения спрашивается, включать ли пароль;
• подключение через сервер 1С (переключатель «Клиент / Сервер 1С»), в этом режиме дерево каталогов строится за один серверный вызов; переподключение после простоя;
• веб-клиент и асинхронная работа с файлами;
• подсчёт размера папок;
• регистрация в БСП и задания по расписанию с письмами и журналом регистрации;
• исправлены ошибки: строка подключения с @ : / в пароле и с %XX, кавычки в генерируемом коде, разделитель каталогов на Linux, одноимённые временные файлы, сохранение настроек без права «Сохранение данных пользователя», пакетный запуск конфигуратора без /DisableStartupDialogs.