FTP
Статья 03/16/2023
Участники: 7
Обратная связь
В этой статье
Используйте группу действий FTP для отправки и скачивания файлов и управления каталогами на FTP-серверах.
Чтобы установить FTP-соединение, используйте действие Открыть подключение FTP . В следующем примере указаны узел, порт и учетные данные. Кроме того, установленный тайм-аут приводит к сбою действия, если соединение не установлено вовремя.
Загрузите файлы с помощью действия Загрузка файлов с FTP . В следующем примере показана используемая переменная подключения и выбранная папка назначения. Удаленный файл также указан и настроен на перезапись всех существующих файлов в том же месте.
Отправляйте файлы с помощью действия Отправить файлы на FTP , указав файл и удаленное расположение.
Открыть подключение FTP
Это действие устанавливает подключение к удаленному FTP-серверу и сохраняет это подключение в качестве переменной для дальнейшего использования.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
Host
Нет
Текстовое значение Введите адрес FTP-сервера.
Port
Да
Числовое значение 21
Введите порт FTP-сервера.
Active mode
Н/Д
Логическое значение Ложь
Укажите режим подключения
Username
Нет
Текстовое значение Укажите имя пользователя учетной записи FTP
Пароль
Да
Прямой ввод зашифрованного текста или Текстовое значение
Укажите пароль учетной записи FTP
Время ожидания
Да
Числовое значение 10
Задает Время ожидания подключения (в секундах), по истечении которого действие будет признано невыполненным.
Создаваемые переменные
Исключения
Исключение
Описание
Ошибка "Не удалось войти"
Указывает, что не удалось войти в систему.
Ошибка подключения
Указывает, что возникла проблема с подключением
Содержание каталога FTP
Это действие возвращает подкаталоги и файлы, содержащиеся в текущем каталоге FTP-подключения.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
Connection
Нет
Подключение FTP Подключение FTP
Path
Да
Текстовое значение Путь к каталогу для получения содержания.
Создаваемые переменные
Исключения
Исключение
Описание
Ошибка при получении содержимого папки
Указывает, что не удалось получить содержимое папки.
Ошибка "Нет подключения"
Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Каталог не существует"
Указывает, что найти каталог не удалось.
Отрыть защищенное подключение FTP
Устанавливает защищенное подключение к удаленному FTP-серверу и сохраняет это подключение в качестве переменной для дальнейшего использования.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
Host
Нет
Текстовое значение Введите адрес FTP-сервера.
Port
Да
Числовое значение 22
Введите порт FTP-сервера.
Active mode
Н/Д
Логическое значение Истина
Укажите режим подключения
Secure FTP Protocol
Н/Д
SFTP, Явный режим FTPS, Неявный режим FTPS
SFTP
Выберите протокол FTP для шифрования подключения.
Authentication method
Н/Д
Имя пользователя и пароль, Закрытый ключ, Закрытый ключ и парольная фраза
Имя пользователя и пароль
Выберите метод проверки подлинности на FTP-сервере.
User name
Нет
Текстовое значение Укажите имя пользователя учетной записи FTP
Пароль
Да
Прямой ввод зашифрованного текста или Текстовое значение
Укажите пароль учетной записи FTP
Path to private key
Нет
Текстовое значение Введите путь к файлу закрытого ключа, который будет использоваться для проверки подлинности
Парольная фраза закрытого ключа
Да
Прямой ввод зашифрованного текста или Текстовое значение
Введите переменную, содержащую парольную фразу закрытого ключа
Timeout
Да
Числовое значение 10
Задает Время ожидания подключения (в секундах), по истечении которого действие будет признано невыполненным.
Создаваемые переменные
Исключения
Исключение
Описание
Ошибка "Не удалось войти"
Указывает, что не удалось войти в систему.
Ошибка подключения
Указывает, что возникла проблема с подключением
Закрыть подключение
Закрывает открытое FTP-подключение.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
Connection
Нет
Подключение FTP Подключение FTP
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение
Описание:
Ошибка "Нет подключения"
Указывает, что нет открытых подключений к FTP-серверу
Изменить рабочий каталог
Задает текущий рабочий каталог для FTP-подключения.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
Connection
Нет
Подключение FTP Подключение FTP
Set working directory to
Нет
Текстовое значение Установка пути для рабочего каталога
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение
Описание:
Ошибка "Нет подключения"
Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Каталог не существует"
Указывает, что найти каталог не удалось.
Ошибка "Невозможно изменить рабочий каталог"
Указывает, что изменить рабочий каталог невозможно.
Загрузить файлы с FTP-сервера
Загружает один или несколько файлов с FTP-сервера.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
FTP connection
Нет
Подключение FTP Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
Download into folder
Нет
Папка Папка, в которую будут загружены файлы
Файлы для загрузки
Нет
Список файлов FTP Файлы для загрузки
Тип передачи
Неприменимо
Авто, Двоичный, ASCII
Авто
Введите ASCII или "Двоичный", чтобы указать метод загрузки одного файла. Если тип файла неизвестен или загружается несколько файлов, выберите "Авто", чтобы следовать правилам передачи, указанным в параметрах
If file exists
Н/Д
Перезаписать, Не загружать, Загрузить с уникальным именем
Перезаписать
Укажите, что делать, если файл уже существует. "Перезаписать" перезаписывает имеющийся файл (т. е. доступ к нему будет утрачен), а "Загрузить с уникальным именем" добавляет символ подчеркивания и порядковый номер в конце имени
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение
Описание:
Ошибка "Нет подключения"
Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Удаленный файл не существует"
Указывает, что файл отсутствует на FTP-сервере.
Ошибка "Каталог не существует"
Указывает, что найти каталог не удалось.
Ошибка "Подключение FTP прервано"
Указывает, что подключение FTP прервано.
Ошибка "Невозможно загрузить файл"
Указывает, что загрузить файл невозможно.
Загрузить папки с FTP-сервера
Загружает одну или несколько папок с FTP-сервера.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
FTP connection
Нет
Подключение FTP Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
Folder(s) to download
Нет
Список каталогов FTP Имена путей к папкам или FTP-папкам для загрузки
Download into local folder
Нет
Папка Полный путь к месту назначения загружаемых FTP-папок
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение
Описание:
Ошибка "Нет подключения"
Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Удаленный каталог не существует"
Указывает, что каталог отсутствует на FTP-сервере.
Ошибка "Каталог не существует"
Указывает, что найти каталог не удалось.
Ошибка "Подключение FTP прервано"
Указывает, что подключение FTP прервано.
Ошибка "Невозможно загрузить каталог"
Указывает, что загрузить каталог невозможно.
Отправить файлы на FTP
Отправляет один или несколько файлов на FTP-сервер.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
FTP connection
Нет
Подключение FTP Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
File(s) to upload
Нет
Список файлов Файлы для отправки
Remote location
Да
Текстовое значение Расположение, в которое должны быть отправлены файлы
Transfer type
Н/Д
Авто, Двоичный, ASCII
Авто
Введите ASCII или "Двоичный", чтобы указать метод загрузки одного файла. Если тип файла неизвестен или загружается более одного файла, выберите "Авто", чтобы следовать правилам передачи файлов, заданным в параметрах
If file exists
Н/Д
Перезаписать, Не загружать, Загрузить с уникальным именем
Перезаписать
Укажите, что делать, если файл уже существует. "Перезаписать" перезаписывает имеющийся файл (т. е. доступ к нему будет утрачен), а "Загрузить с уникальным именем" добавляет символ подчеркивания и порядковый номер в конце имени
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение
Описание:
Ошибка "Нет подключения"
Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Файл не найден"
Указывает, что файл не найден.
Ошибка "Подключение FTP прервано"
Указывает, что подключение FTP прервано.
Ошибка при отправке файла
Указывает, что отправить файл не удалось.
Отправить папки на FTP
Отправляет одну или несколько папок на FTP-сервер.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
FTP connection
Нет
Подключение FTP Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
Folder(s) to upload
Нет
Список папок Папки для отправки. Отправляемые папки еще не должны уже существовать в активном каталоге на FTP-сервере
Remote location
Нет
Текстовое значение Расположение, в которое должны быть отправлены папки
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение
Описание:
Ошибка "Нет подключения"
Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Удаленный каталог не существует"
Указывает, что каталог отсутствует на FTP-сервере.
Ошибка "Подключение FTP прервано"
Указывает, что подключение FTP прервано.
Ошибка при отправке каталога
Указывает, что отправить каталог не удалось.
Удалить файл FTP
Удаляет один или несколько файлов с FTP-сервера.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
FTP connection
Нет
Подключение FTP Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии «Открыть подключение FTP»
Файлы для удаления
Нет
Список файлов FTP Файлы для удаления
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение
Описание:
Ошибка "Нет подключения"
Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Файл не найден"
Указывает, что файл не найден.
Ошибка "Невозможно удалить файл"
Указывает, что удаление файла невозможно.
Переименовать файл FTP
Переименовывает файл на FTP-сервере.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
FTP connection
Нет
Подключение FTP Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии «Открыть подключение FTP»
Файлы для переименования
Нет
Файл FTP Файл для переименования
Новое имя файла
Нет
Текстовое значение Новое имя файла. Если вы введете имя с путем, файл также будет перемещен в это место. Если расположение не существует, будет выдано исключение
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение
Описание:
Ошибка "Нет подключения"
Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Невозможно переименовать файл"
Указывает, что переименовать файл невозможно.
Ошибка "Файл не найден"
Указывает, что файл не найден.
Создать каталог FTP
Создает каталог на FTP-сервере.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
FTP connection
Нет
Подключение FTP Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
New directory
Нет
Каталог FTP Новый каталог. Если указан путь, будут созданы все новые папки, ведущие к новому каталогу
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение
Description
Ошибка "Доступ запрещен"
Указывает, что у этой учетной записи нет доступа к операции.
Ошибка "Файл не существует"
Указывает, что файл уже существует.
Ошибка при создании каталога
Указывает, что создать каталог невозможно.
Ошибка "Каталог не существует"
Указывает, что найти каталог не удалось.
Ошибка "Нет подключения"
Указывает, что нет открытых подключений к FTP-серверу
Удаляемый каталог FTP
Удаляет каталог с FTP-сервера.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
FTP connection
Нет
Подключение FTP Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
Directory to delete
Нет
Каталог FTP Папка, которую нужно удалить. Все содержимое папки также будет удалено
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение
Description
Ошибка при удалении каталога
Указывает, что удалить каталог невозможно.
Ошибка "Удаленный каталог не существует"
Указывает, что каталог отсутствует на FTP-сервере.
Ошибка изменения рабочего каталога
Указывает, что изменить рабочий каталог не удалось.
Ошибка "Нет подключения"
Указывает, что нет открытых подключений к FTP-серверу
Вызвать команду FTP
Вызывает заданную команду FTP на сервере.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
FTP connection
Нет
Подключение FTP Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии "Открыть подключение FTP"
FTP command
Нет
Текстовое значение Команда для запуска вместе с любыми аргументами. Например, здесь можно запустить FEAT или CHMOD
Valid reply code(s)
Да
Текстовое значение Коды, которые может вернуть команда, разделенные точкой с запятой. Если команда FTP возвращает код, который здесь не был введен, это действие вызовет исключение. Применяется только к простым подключениям FTP или FTPS
Создаваемые переменные
Аргумент
Type
Description
ReplyCode
Текстовое значение Фактический код, который был возвращен. Применяется только к простым подключениям FTP или FTPS
ReplyText
Текстовое значение Текст, возвращенный FTP-сервером
Исключения
Исключение
Описание:
Ошибка вызова команды
Указывает, что при вызове команды FTP произошла ошибка.
Ошибка "Нет подключения"
Указывает, что нет открытых подключений к FTP-серверу
Синхронизировать каталоги
Синхронизирует файлы и подкаталоги в заданной папке с заданным удаленным каталогом FTP.
Аргумент
Необязательно
Принимает
Значение по умолчанию
Description
FTP connection
Нет
Подключение FTP Подключение FTP, с которым требуется работать. Эта переменная должна была быть ранее указана в действии «Открыть подключение FTP»
Synchronization direction
Неприменимо
Удаленное -> локальное (загрузка), Локальное -> удаленное (отправка)
Удаленное -> локальное (загрузка)
Направление метода синхронизации. Вы можете синхронизировать локальный каталог с удаленным каталогом (ЗАГРУЗКА) или удаленный каталог с локальным (ОТПРАВКА)
Files to sync
Н/Д
Все файлы, Только файлы, соответствующие фильтру файлов, Только файлы, не соответствующие фильтру файлов
Все файлы
Выберите, нужно ли синхронизировать все файлы или же вы ограничите их набор с помощью фильтра.
Фильтр файлов
Нет
Текстовое значение *
Шаблон имени файла, который определяет, какие файлы будут включены или исключены. Этот параметр позволяет использовать подстановочные знаки, например ".txt" или "document?.doc". Вы также можете задать несколько фильтров, используя в качестве разделителя запятую: " .txt,*.pdf,document?"
Local folder
Нет
Папка Имя локальной папки для синхронизации
FTP directory
Да
Каталог FTP /
Имя каталога FTP для синхронизации
Delete if source is absent
Н/Д
Логическое значение False
Эта команда удалит файл или папку, которые существуют в целевом каталоге, но не в исходном.
Include subdirectories
Н/Д
Логическое значение Истина
Этот параметр включит в процесс синхронизации подкаталоги.
Time difference in hours
Да
Числовое значение 0
Отличие времени удаленного сервера в часах, если сервер работает в другом часовом поясе.
Time difference in minutes
Да
Числовое значение 0
Отличие времени удаленного сервера в минутах, если сервер работает в другом часовом поясе.
Time difference ahead
Н/Д
Логическое значение Истина
Укажите, опережает ли часовой пояс сервера локальный.
Создаваемые переменные
Аргумент
Type
Description
FtpFilesAdded
Список файлов FTP Список файлов FTP, которые изначально присутствовали в исходной папке и после синхронизации были добавлены в целевой каталог.
FtpFilesModified
Список файлов FTP Список файлов FTP, которые изначально присутствовали как в исходной папке, так и в целевом каталоге, и после синхронизации были добавлены в целевой каталог.
FtpFilesDeleted
Список файлов FTP Список файлов FTP, которые изначально присутствовали в целевом каталоге и после синхронизации были удалены.
FilesAdded
Список файлов Список файлов, которые изначально присутствовали в исходной папке и после синхронизации были добавлены в целевой каталог.
FilesModified
Список файлов Список файлов, которые изначально присутствовали как в исходной папке, так и в целевом каталоге, и после синхронизации были добавлены в целевой каталог.
FilesDeleted
Список файлов Список файлов, которые изначально присутствовали в целевом каталоге и после синхронизации были удалены.
Исключения
Исключение
Описание:
Ошибка при получении содержимого папки
Указывает, что не удалось получить содержимое папки.
Ошибка "Нет подключения"
Указывает, что нет открытых подключений к FTP-серверу
Ошибка "Файл не найден"
Указывает, что файл не найден.
Ошибка "Подключение FTP прервано"
Указывает, что подключение FTP прервано.
Ошибка при отправке файла
Указывает, что отправить файл не удалось.
Ошибка "Удаленный файл не существует"
Указывает, что файл отсутствует на FTP-сервере.
Ошибка "Невозможно загрузить файл"
Указывает, что загрузить файл невозможно.
Ошибка при удалении каталога
Указывает, что удалить каталог невозможно.
Ошибка "Сбой синхронизации"
Указывает, что произошел сбой процесса синхронизации из-за непредвиденной ошибки.
