FTP
Стаття 11/08/2023
Співавторів: 7
Зворотний зв’язок
Зміст статті
Використовуйте групу дій FTP, щоб завантажувати та завантажувати файли, а також керувати каталогами на FTP-серверах.
Щоб встановити FTP-з’єднання, скористайтеся дією Відкрити з’єднання FTP. У наведеному нижче прикладі вказано хост, порт і облікові дані. Крім того, встановлений тайм-аут робить дію невдалою, якщо з’єднання не встановлено вчасно.
Завантажте файли за допомогою дії Завантажити файли з FTP . У наведеному нижче прикладі показано змінну підключення, яка використовується, і вибрану папку призначення. Також було вказано віддалений файл, який було налаштовано на перезапис наявних файлів у тому самому місці.
Завантажте файли, скориставшись дією Вивантажити файли на FTP і вказавши файл і віддалене розташування.
Відкрити FTP-підключення
Ця дія встановлює підключення до віддаленого FTP-сервера та зберігає це підключення як змінну для подальшого використання.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
Хост
No
Текстове значення
Введіть адресу FTP-сервера.
Порт
Так
Числове значення
21
Введіть порт FTP-сервера.
Активний режим
Немає
Логічне значення
Ні
Укажіть режим підключення
Ім'я користувача
No
Текстове значення
Укажіть ім’я користувача облікового запису FTP
Пароль
Так
Пряме зашифроване введення або текстове значення
Укажіть пароль облікового запису FTP.
Час очікування
Так
Числове значення
10
Укажіть час очікування підключення (у секундах), після завершення якого дію буде визнано невдалою
Змінні, які створюються
Винятки
Виняток
Опис
Помилка входу
Указує, що не вдалося ввійти
Помилка підключення
Вказує на проблему зі з’єднанням
Отримати вміст каталогу на FTP-сервері
Ця дія повертає підкаталоги та файли, що містяться в поточному каталозі FTP-підключення.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
Connection
No
FTP-з’єднання
FTP-підключення
Шлях
Так
Текстове значення
Шлях до каталогу, вміст якого потрібно отримати.
Змінні, які створюються
Винятки
Виняток
Опис
Помилка отримання вмісту папки
Указує, що не вдалось отримати вміст папки
Не підключено
Вказує на відсутність відкритого з’єднання з FTP-сервером
Помилка "Каталог не існує"
Указує, що каталог не знайдено
Відкрити захищене FTP-підключення
Ця дія встановлює захищене підключення до віддаленого FTP-сервера та зберігає це підключення як змінну для подальшого використання.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
Хост
No
Текстове значення
Введіть адресу FTP-сервера.
Порт
Так
Числове значення
22
Введіть порт FTP-сервера.
Активний режим
Немає
Логічне значення
Так
Укажіть режим підключення
Захищений протокол FTP
Немає
SFTP, FTPS явний, FTPS неявний
SFTP
Виберіть протокол FTP для шифрування підключення
Спосіб автентифікації
Немає
Ім’я користувача та пароль, приватний ключ, приватний ключ і парольна фраза
Ім’я користувача та пароль
Виберіть спосіб автентифікації на FTP-сервері
Ім’я користувача
No
Текстове значення
Укажіть ім’я користувача облікового запису FTP
Пароль
Так
Пряме зашифроване введення або текстове значення
Укажіть пароль облікового запису FTP
Шлях до закритого ключа
No
Текстове значення
Введіть шлях до файлу закритого ключа, який використовуватиметься для автентифікації
Парольна фраза закритого ключа
Так
Пряме зашифроване введення або текстове значення
Введіть змінну, що містить парольну фразу закритого ключа
Час очікування
Так
Числове значення
10
Укажіть час очікування підключення (у секундах), після завершення якого дію буде визнано невдалою
Змінні, які створюються
Аргумент
Ввести
Опис
SftpConnection
FTP-з’єднання
SFTP-підключення
Винятки
Виняток
Опис
Помилка входу
Указує, що не вдалося ввійти
Помилка підключення
Вказує на проблему зі з’єднанням
Закрити підключення
Ця дія закриває відкрите FTP-підключення.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
Connection
No
FTP-з’єднання
FTP-підключення
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
Виняток
Опис
Не підключено
Вказує на відсутність відкритого з’єднання з FTP-сервером
Змінити робочий каталог
Ця дія встановлює поточний робочий каталог для FTP-підключення.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
Connection
No
FTP-з’єднання
FTP-підключення
Установити робочий каталог
No
Текстове значення
Установіть шлях до каталогу, який використовуватиметься як робочий
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
Виняток
Опис
Не підключено
Вказує на відсутність відкритого з’єднання з FTP-сервером
Помилка "Каталог не існує"
Указує, що каталог не знайдено
Не вдалося змінити робочий каталог
Указує на проблему під час змінення робочого каталогу
Завантажити файли з FTP-сервера
Завантажує один або кілька файлів з FTP-сервера.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
FTP-підключення
No
FTP-з’єднання
FTP-з’єднання для роботи. Ця змінна повинна бути попередньо вказана в дії Відкрити з’єднання FTP
Завантажити в папку
No
Папку
Папка призначення для файлів, які буде завантажено
Файли, які потрібно завантажити
No
Список FTP-файлів
Файли, які потрібно завантажити
Тип передавання
Немає
Авто, Двійковий, ASCII
Авто
Введіть ASCII або binary, щоб вказати спосіб завантаження окремого файлу. Якщо тип файлу невизначений або завантажено кілька файлів, виберіть «Автоматично», щоб дотримуватися правил передавання, указаних у параметрах
Якщо файл існує
Немає
Перезаписати, Не завантажувати, Завантажити з унікальною назвою
Перезаписати
Вкажіть, що робити, якщо файл вже існує. Перезапис поверх оригінального файлу призводить до того, що ви більше не можете отримати до нього доступ, а завантаження з унікальною назвою додає символ підкреслення та порядковий номер у кінці
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
Виняток
Опис
Не підключено
Вказує на відсутність відкритого з’єднання з FTP-сервером
Віддалений файл не існує
Указує, що файл не існує на FTP-сервері
Помилка "Каталог не існує"
Указує, що каталог не знайдено
FTP-підключення перервано
Указує, що FTP-підключення перервано
Не вдалося завантажити файл
Указує на проблему під час завантаження файлу
Завантажити папки з FTP-сервера
Завантажує одну або кілька папок з FTP-сервера.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
FTP-підключення
No
FTP-з’єднання
FTP-з’єднання для роботи. Ця змінна повинна бути попередньо вказана в дії Відкрити з’єднання FTP
Папки, які потрібно завантажити
No
Список каталогів FTP
Шляхи до папок на FTP-сервері, які потрібно завантажити, або їх імена
Завантажити в локальну папку
No
Папку
Повний шлях до призначення папок FTP, які ви завантажуєте повторно
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
Виняток
Опис
Не підключено
Вказує на відсутність відкритого з’єднання з FTP-сервером
Помилка "Віддалений каталог не існує"
Указує, що каталог не існує на FTP-сервері
Помилка "Каталог не існує"
Указує, що каталог не знайдено
FTP-підключення перервано
Указує, що FTP-підключення перервано
Не вдалося завантажити каталог
Указує на проблему під час завантаження каталогу
Передати файли на FTP-сервер
Передає один або кілька файлів на FTP-сервер.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
FTP-підключення
No
FTP-з’єднання
FTP-з’єднання для роботи. Ця змінна повинна бути попередньо вказана в дії Відкрити з’єднання FTP
Файли, які потрібно передати
No
Список файлів
Файли, які потрібно передати
Віддалене розташування
Так
Текстове значення
Розташування, у яке потрібно передати файли
Тип передавання
Немає
Авто, Двійковий, ASCII
Авто
Введіть ASCII або binary, щоб вказати спосіб завантаження окремого файлу. Якщо ви не впевнені, якого типу буде файл, або якщо ви завантажуєте кілька файлів повторно, виберіть «Автоматично», щоб дотримуватися правил передавання, указаних у параметрах
Якщо файл існує
Немає
Перезаписати, Не завантажувати, Завантажити з унікальною назвою
Перезаписати
Вкажіть, що робити, якщо файл вже існує. Функція «Перезаписати» записує поверх оригінального файлу, щоб ви більше не мали до нього доступу, а команда «Завантажити з унікальним ім’ям» додає символ підкреслення та порядковий номер у кінці
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
Виняток
Опис
Не підключено
Вказує на відсутність відкритого з’єднання з FTP-сервером
Помилка "Файл не знайдено"
Указує, що файл не знайдено
FTP-підключення перервано
Указує, що FTP-підключення перервано
Помилка передавання файлу
Указує, що файл не вдалося передати
Передати папки на FTP-сервер
Передає одну або кілька папок на FTP-сервер.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
FTP-підключення
No
FTP-з’єднання
FTP-з’єднання для роботи. Ця змінна повинна бути попередньо вказана в дії Відкрити з’єднання FTP
Папки, які потрібно передати
No
Список папок
Папки для завантаження. Папки, що завантажуються, не повинні існувати в активному каталозі FTP-сервера
Віддалене розташування
No
Текстове значення
Розташування, у яке потрібно передати папки
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
Виняток
Опис
Не підключено
Вказує на відсутність відкритого з’єднання з FTP-сервером
Помилка "Віддалений каталог не існує"
Указує, що каталог не існує на FTP-сервері
FTP-підключення перервано
Указує, що FTP-підключення перервано
Помилка передавання каталогу
Указує, що каталог не вдалося передати
Видалити файл з FTP-сервера
Видаляє один або кілька файлів з FTP-сервера.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
FTP-підключення
No
FTP-з’єднання
FTP-з’єднання для роботи. Ця змінна повинна бути попередньо вказана в дії Відкрити з’єднання FTP
Файли, які потрібно видалити
No
Список FTP-файлів
Файли, які потрібно видалити
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
Виняток
Опис
Не підключено
Вказує на відсутність відкритого з’єднання з FTP-сервером
Помилка "Файл не знайдено"
Указує, що файл не знайдено
Не вдалося видалити файл
Указує, що видалити файл неможливо
Перейменувати файл на FTP-сервері
Перейменовує файл, розміщений на FTP-сервері.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
FTP-підключення
No
FTP-з’єднання
FTP-з’єднання для роботи. Ця змінна повинна бути попередньо вказана в дії Відкрити з’єднання FTP
Файл, який потрібно перейменувати
No
FTP-файл
Файл, який потрібно перейменувати
Нове ім’я файлу
No
Текстове значення
Нове ім’я файлу. Якщо ви введете ім’я зі шляхом, файл також буде переміщено до цього місця. Якщо розташування не існує, він викличе виняток
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
Виняток
Опис
Не підключено
Вказує на відсутність відкритого з’єднання з FTP-сервером
Не вдалося перейменувати файл
Указує на проблему під час перейменування файлу
Помилка "Файл не знайдено"
Указує, що файл не знайдено
Створити каталог на FTP-сервері
Створює каталог на FTP-сервері.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
FTP-підключення
No
FTP-з’єднання
FTP-з’єднання для роботи. Ця змінна повинна бути попередньо вказана в дії Відкрити з’єднання FTP
Новий каталог
No
Каталог FTP
Новий каталог. Якщо вказано шлях, буде створено всі нові папки, що ведуть до нового каталогу
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
Виняток
Опис
Немає доступу
Указує, що в цього облікового запису немає доступу до операції
Файл існує
Указує, що файл уже існує
Помилка створення каталогу
Указує на проблему під час створення каталогу
Помилка "Каталог не існує"
Указує, що каталог не знайдено
Не підключено
Вказує на відсутність відкритого з’єднання з FTP-сервером
Видалити каталог на FTP-сервері
Видаляє каталог з FTP-сервера.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
FTP-підключення
No
FTP-з’єднання
FTP-з’єднання для роботи. Ця змінна повинна бути попередньо вказана в дії Відкрити з’єднання FTP
Каталог, який потрібно видалити
No
Каталог FTP
Папка, яку потрібно видалити. Все, що є в папці, також буде видалено
Змінні, які створюються
Ця дія не створює жодних змінних.
Винятки
Виняток
Опис
Помилка видалення каталогу
Указує на проблему під час видалення каталогу
Помилка "Віддалений каталог не існує"
Указує, що каталог не існує на FTP-сервері
Помилка змінення робочого каталогу
Указує, що робочий каталог не вдалося змінити
Не підключено
Вказує на відсутність відкритого з’єднання з FTP-сервером
Викликати команду FTP
Викликає вказану команду FTP на сервері.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
FTP-підключення
No
FTP-з’єднання
FTP-з’єднання для роботи. Ця змінна повинна бути попередньо вказана в дії відкритого FTP-з’єднання
Команда FTP
No
Текстове значення
Команда, яку потрібно запускати разом із будь-якими аргументами. Наприклад, тут можна запустити FEAT, або CHMOD
Припустимі коди відповідей
Так
Текстове значення
Коди, які може бути повернуто командою, відокремлені крапкою з комою. Якщо команда FTP повертає код, який тут не був введений, ця дія викличе виняток. Застосовується лише до простих з’єднань FTP або FTPS
Змінні, які створюються
Аргумент
Ввести
Опис
ReplyCode
Текстове значення
Фактичний код, який було повернуто. Застосовується лише до простих з’єднань FTP або FTPS
Текст відповіді
Текстове значення
Текст, який повернув FTP-сервер
Винятки
Виняток
Опис
Помилка виклику команди
Указує, що під час виклику команди FTP сталася помилка
Не підключено
Вказує на відсутність відкритого з’єднання з FTP-сервером
Синхронізувати каталоги
Синхронізує файли та підкаталоги певної папки з указаним віддаленим каталогом на FTP-сервері.
Аргумент
Необов'язково
Приймає
Значення за замовчуванням
Опис
FTP-підключення
No
FTP-з’єднання
FTP-з’єднання для роботи. Ця змінна повинна бути попередньо вказана в дії Відкрити з’єднання FTP
Напрямок синхронізації
Немає
Віддалений -локальний (Завантажити), Локальний ->> віддалений (Вивантажити)
Віддалений -> локальний (Завантажити)
Спрямованість методу синхронізації. Чи буде локальна тека синхронізована з віддаленим каталогом (DOWNLOAD), чи віддалений каталог буде синхронізовано з локальною текою (UPLOAD)
Файли, які потрібно синхронізувати
Немає
Усі файли, Лише файли, що відповідають фільтру файлів, Лише файли, які не відповідають фільтру файлів
Усі файли
Виберіть, які файли потрібно синхронізувати: усі чи лише певний їх набір, визначений за допомогою фільтра
Фільтр файлів
No
Текстове значення
*
Шаблон назви файлу, який визначає, які файли буде включено або виключено. За допомогою цього параметра можна використовувати символи-замінники, зокрема «.txt», «документ?». док». Цей параметр також дозволяє використовувати декілька фільтрів, використовуючи кому як роздільник, « .txt,*.pdf,документ?»
Локальна папка
No
Папку
Ім’я локальної папки, яку потрібно синхронізувати
Каталог на FTP-сервері
Так
Каталог FTP
/
Ім’я каталогу на FTP-сервері, який потрібно синхронізувати
Видалити, якщо немає у вихідному каталозі
Немає
Логічне значення
Ні
Цей параметр вилучить файл або папку, які існують у цільовому каталозі, а не у джерелі.
Включити підкаталоги
Немає
Логічне значення
Так
Цей параметр дає змогу включити підкаталоги в процес синхронізації.
Різниця в часі в годинах
Так
Числове значення
0
Відмінність часу віддаленого сервера в годинах, якщо він працює в іншому часовому поясі.
Різниця в часі у хвилинах
Так
Числове значення
0
Різниця в часі в хвилинах віддаленого сервера, якщо він працює в іншому часовому поясі.
Різниця в часі
Немає
Логічне значення
Так
Укажіть, чи випереджає часовий пояс сервера локальний.
Змінні, які створюються
Аргумент
Ввести
Опис
Додано FtpFilesДодано
Список FTP-файлів
Список файлів на FTP-сервері, які від початку містилися у вихідному каталозі та після синхронізації з’явилися в цільовому.
FtpFilesModified
Список FTP-файлів
Список файлів на FTP-сервері, які від початку містилися у вихідному й цільовому каталогах і після синхронізації присутні в цільовому каталозі.
FtpFilesDeleted
Список FTP-файлів
Список файлів на FTP-сервері, які від початку містилися в цільовому каталозі, але зникли з нього після синхронізації.
ФайлиДодано
Список файлів
Список файлів, які від початку містилися у вихідному каталозі та після синхронізації з’явилися в цільовому.
ФайлиМодифіковані
Список файлів
Список файлів, які від початку містилися у вихідному й цільовому каталогах і після синхронізації присутні в цільовому каталозі.
ФайлиВидалені
Список файлів
Список файлів, які від початку містилися в цільовому каталозі, але зникли з нього після синхронізації.
Винятки
Виняток
Опис
Помилка отримання вмісту папки
Указує, що не вдалось отримати вміст папки
Не підключено
Вказує на відсутність відкритого з’єднання з FTP-сервером
Помилка "Файл не знайдено"
Указує, що файл не знайдено
FTP-підключення перервано
Указує, що FTP-підключення перервано
Помилка передавання файлу
Указує, що файл не вдалося передати
Віддалений файл не існує
Указує, що файл не існує на FTP-сервері
Не вдалося завантажити файл
Указує на проблему під час завантаження файлу
Помилка видалення каталогу
Указує на проблему під час видалення каталогу
Помилка синхронізації
Указує, що синхронізацію не виконано через неочікувану помилку.