К статье
Практический материал

Другое · 6 мин

Отправка файла на FTP-сервер из 1С

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

Отправка файла на FTP из 1С используется для выгрузки отчетов, обмена документами с контрагентами, передачи прайсов и резервных копий. В платформе 1С:Предприятие есть встроенные средства для работы с FTP, поэтому в типовых ситуациях внешние программы не требуются.

Главное — правильно задать параметры подключения, выбрать порядок записи файла и проверить, что файл действительно появился на сервере. Ниже приведен порядок действия, условия и способы проверки результата.

Подготовка и параметры подключения

Перед началом работы уточните адрес FTP-сервера, порт, имя пользователя и пароль, а также целевую папку на сервере. Узнайте, требуется ли пассивный режим и какой режим передачи данных подходит: бинарный или текстовый. Неправильный режим может повредить файл или сделать его нечитаемым.

Определите, откуда будет браться файл: из временной папки клиента, сервера приложений или общего сетевого каталога. Путь должен быть доступен тому экземпляру 1С, который выполняет выгрузку, иначе операция завершится ошибкой доступа.

Порядок действий
  1. 1
    Уточните адрес сервера, порт, логин, пароль и целевую папку
  2. 2
    Проверьте доступ к исходному файлу и права на запись в целевую папку
  3. 3
    Создайте FTP-соединение и выполните запись файла
  4. 4
    Проверьте наличие файла на сервере и только потом удалите источник

Создание FTP-соединения в конфигурации

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

После завершения работы соединение необходимо закрыть. Если соединение оставить открытым, могут остаться заблокированные сеансы на сервере и исчерпаться допустимое количество одновременных подключений.

Запись файла на сервер

Для загрузки используется метод записи файла, в котором указываются имя исходного файла и имя, под которым файл должен сохраниться на FTP. Исходный файл должен существовать и не быть заблокированным другим процессом, иначе запись не начнется.

Целевое имя файла лучше задавать явно, включая расширение. Если файл с таким именем уже есть на сервере, уточните поведение при перезаписи: в некоторых конфигурациях старый файл заменяется без предупреждения, что может привести к потере данных.

Отличия по способу работы с клиентом

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

Если выгрузка выполняется по расписанию на сервере 1С, проверьте, под каким пользователем запущен агент, и есть ли у этого пользователя доступ к сетевым ресурсам и папкам обмена.

Проверка результата и обработка ошибок

После записи не считайте операцию успешной только потому, что метод не вернул ошибку. Рекомдуется получить список файлов в целевой папке и сравнить имя, размер или дату изменения с исходными данными.

Контрольные точки

Как проверить результат

Файл присутствует в целевой папке FTP
Норма

Имя, размер и дата совпадают с исходником

Тревожный признак

Файл отсутствует, размер нулевой или дата не обновлена

Соединение закрыто после выгрузки
Норма

Нет висящих сеансов и ошибок в журнале

Тревожный признак

Остаются открытые соединения или повторные ошибки доступа

Исходный файл стоит удалять или перемещать в архив только после подтверждения наличия копии на FTP. Все ошибки подключения, записи и проверки целесообразно записывать в регистр информации или журнал регистрации для дальнейшего анализа.

Ограничения, безопасность и альтернативы

Обычный FTP не шифрует данные, поэтому передача конфиденциальных документов по открытому каналу небезопасна. Если требуется защищенное соединение, уточните, поддерживает ли используемая конфигурация FTPS или SFTP; встроенные возможности 1С могут быть недостаточны.

Пароли и параметры подключения не рекомендуется хранить открытым текстом в коде модулей. Лучше использовать защищенное хранение настроек или отдельные учетные данные с ограниченными правами только на нужную папку.

Если встроенного FTP недостаточно, возможен вызов внешних утилит или использование командной строки, но это требует настройки прав доступа и тщательного тестирования. Альтернативой может быть обмен через промежуточный файловый ресурс или веб-сервис, если контрагент поддерживает такой формат.

Типичные ошибки
01
Файл открыт в другой программе — 1С не может прочитать его для отправки
02
Текстовый режим вместо бинарного для Excel, PDF или архивов — возможна порча файла
03
Удаление исходного файла до проверки наличия копии на FTP — риск потери данных

Типичные ошибки

Одна из частых проблем — попытка записать файл, который в данный момент открыт в другой программе. 1С не сможет прочитать такой файл для отправки, и операция вернет ошибку доступа.

Другая ошибка — использование текстового режима для файлов Excel, PDF или архивов. Это может привести к порче содержимого, поэтому для большинства бизнес-файлов подходит бинарный режим.

Что важно запомнить

Итог

Что важно запомнить

Настройте параметры подключения, проверяйте доступ к файлу, используйте бинарный режим, подтверждайте наличие файла на сервере и закрывайте соединение после завершения.

Часто задаваемые вопросы

Нужен ли отдельный программный модуль для отправки на FTP?

В большинстве конфигураций 1С достаточно встроенных средств для FTP-соединения. Отдельный модуль требуется только при нестандартных требованиях к защите, автоматизации или интеграции с внешними сервисами.

Можно ли отправлять файлы с компьютера пользователя в веб-клиенте?

Прямой доступ к локальному диску пользователя в веб-клиенте ограничен. Файл обычно должен быть загружен на сервер приложений или помещен в доступное сетевое хранилище, из которого 1С сможет прочитать его для выгрузки.

Что делать, если запись на FTP завершается ошибкой?

Проверьте доступность сервера, правильность логина и пароля, права на запись в целевую папку и режим передачи данных. Посмотрите журнал регистрации или регистр информации, где зафиксирована ошибка, и уточните, блокирует ли исходный файл другая программа.

Безопасно ли передавать бухгалтерские документы по FTP?

Обычный FTP не шифрует трафик, поэтому для конфиденциальных документов лучше использовать защищенное соединение, если оно поддерживается, или иной канал обмена. Перед отправкой убедитесь, что это соответствует правилам обработки персональных и бухгалтерских данных.