FTP

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

Внешняя система реализует функциональность FTP-клиента.

Внимание

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

../../_images/ftp1.png

Основные настройки

FTP (connectorType) настраивается по пути: Интеграция → Внешние системы → выбор системы двойным щелчком → вкладка Коннектор → тип FTP.

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

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

  • Сервер (serverAddress) - указывается сервер

  • Порт (port) - указание порта, если не указано, по умолчанию 21.

Параметры авторизации

  • Вход по имени пользователя и паролю (useUsernameAndPassword) - указание принципа входа, если флаг установлен, то вход осуществляется по Имени пользователя (userName) и Паролю (passwordNew) (прописывается автоматически системой), по умолчанию флаг не установлен.

  • Получать пароль из модуля Credential (управление пользователями) (useCredential) - при установке флага Пароль скрывается, для просмотра доступно поле Имя пользователя (именно по нему будет применён пароль из Credential).

Загружать с FTP в Platform (toPlatform)

  • Каталог на FTP для получения сообщения в Platform (inputDirectory) - указывается путь к каталогу относительно корня в FTP директории. Настройка активна, если установлен флаг Загружать с FTP в Platform. Если каталог не указан, используется корень.

  • Удалять файлы после загрузки (isDeleteFiles) - если флаг установлен, файлы будут удалены из каталога после загрузки. Настройка активна, если установлен флаг Загружать с FTP в Platform.

Сохранять на FTP из Platform (fromPlatform)

  • Каталог для получения сообщений из Platform (outputDirectory) - указывается путь каталога, именно сюда будут загружены данные. Настройка активна, если установлен флаг Сохранять на FTP из Platform. Если каталог не указан, используется корень.

  • Шаблон для формирования имени файла (fileNamePattern) - задаётся шаблон по форме {/Message/Id}.json. Настройка активна, если установлен флаг Сохранять на FTP из Platform.

Примечание

Для корректной работы системы должен быть установлен один из флагов Загружать с FTP в Platform или Сохранять на FTP из Platform, при этом заполнять данные внутри настроки флага не обязательно (тогда используется корень). Если установлено оба флага Загружать с FTP в Platform и Сохранять на FTP из Platform, то настройка внутри флагов необходима.

../../_images/ftp2.png

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

Дополнительные настройки

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

Внимание

Перед переходом в режим редактора конфигурации сохраните внесенные данные!

Откроется окно редактора конфигурации, содержащее конфигурацию:

{
        "$type": "DT.ClusterConfiguration.DtSystem, DT_Core",
        "config": {
                "$type": "DT.ConfigurationRepository.Configuration.Adapter.FtpSystemConfig, DT_ConfigurationRepository",
                "useUsernameAndPassword": true,
                "account": {
                        "$type": "DT.ClusterConfiguration.Account, DT_Core",
                        "userName": "Админ",
                        "useCredential": false
                },
                "serverAddress": "Сер",
                "port": 21,
                "allowIfServerCertificateValidationFailed": false,
                "isUnsafePlainFtpWithoutTls": false,
                "toPlatform": true,
                "fromPlatform": true,
                "connectorType": "Ftp",
                "readInterval": 1000,
                "inputDirectory": "загружать",
                "isDeleteFiles": false,
                "outputDirectory": "каталог",
                "fileNamePattern": "шаблон",
                "checkLastWriteTime": false,
                "handlersList": [
                        {
                                "handlerId": "9d3d39f5-85f6-4f13-be6a-6c75e7dc68c8",
                                "isStarted": true
                        },
                        {
                                "handlerId": "a3fc2e56-113f-470d-b046-f36798869a10",
                                "isStarted": true
                        }
                ],
                "sendingStrategy": ""
        }
}

Параметры конфигурации:

  • allowIfServerCertificateValidationFailed (boolean): значение по умолчанию false, принимает любой SSL сертификат.

  • isUnsafePlainFtpWithoutTls (boolean): настройка использования небезопасного FTP-соединения без TLS. Значение по умолчанию false - используется защищённое соединение (FTPS), при true платформа подключается к серверу по открытым каналам (plain FTP).

  • readInterval (integer) - интервал считывания (опроса) сервера, используется для определения частоты проверки входящего каталога на наличие новых файлов. По умолчанию установлено 1000 миллисекунды (мс).

  • checkLastWriteTime (boolean): чтение и отправка файлов после их изменения в каталоге. Значение по умолчанию false.