История страницы
Upload folder
Action group
Загрузить на сервер
Группа действий: FTPДействие загружает локальную директорию на FTP-сервер
...
The action uploads a local directory to an FTP server
ПараметрыParameters
Входные параметры:
Контекст – контекст подключения к FTP-серверу;
Локальная директория – путь к директории, которую необходимо загрузить на сервер;
Директория на FTP- сервере – Путь к папке на удалённом сервере, куда будет загружена директория;
Перезаписать – логическая переменная, если значение которой «true», то папка с одинаковым наименованием будут перезаписаны в директории;
Только существующие – логическая переменная, если значение которой «true», то скачать только те файлы, которые существуют в локальной директории назначения. В противном случае скачать все файлы. Значение по умолчанию «false». Доступно только с включенным параметром «Перезаписать»;
Только новые - логическая переменная, если значение которой «true», то перезаписать только более новые существующие файлы и все файлы, которых ещё нет в локальной директории. В противном случае скачать все файлы. Если включено «Только существующие», то перезаписать только более новые версии существующих файлов, без добавления тех, которых ещё нет. Доступно только с включенным параметром «Перезаписать»;
Исключить - Наименование файлов, которые будут исключены из скачивания;
Включить поддиректории - логическая переменная, если значение которой «true», то поиск выполняется внутри текущей директории и по всем ее поддиректориям. Если значение равно «false», то поиск выполняется внутри текущей директории. Значение по умолчанию – «false»;
Сохранить структуру директорий - логическая переменная, если значение которой «true», то сохранить структуру директорий одинаково в исходном и целевом местоположении. Если значение равно «false», то структура директорий не сохраняется. Доступно только с включенным параметром „Включить поддиректории“. По умолчанию – «false»;
Глубина - Максимальная глубина просмотра вложенных поддиректорий. Значение по умолчанию равно 5. Используйте -1 для указания безграничной глубины. Доступно только, если значение параметра «Включить поддиректории» равно «true».
Настройки
Input parameters:
Context - the context of connection to the FTP server;
Local directory - the path to the directory to be uploaded to the server;
Remote directory on FTP server - the path to the folder on the remote server where the directory will be uploaded;
Rewrite - a boolean variable, if its value is "true", then the folder with the same name will be overwritten in the directory;
Existing only - a boolean variable, if the value of which is "true", then download only those files that exist in the local destination directory. Otherwise, download all files. The default value is "false". Available only with the "Overwrite" option enabled;
Only new - boolean variable, if its value is "true", then overwrite only newer existing files and all files that are not yet in the local directory. Otherwise, download all files. If "Existing only" is enabled, overwrite only newer versions of existing files, without adding those that don't already exist. Only available with "Overwrite" enabled;
Exclude - name of files that will be excluded from downloading;
Include subdirectories - boolean variable, if its value is "true", the search is performed inside the current directory and through all its subdirectories. If the value is "false", the search is performed within the current directory. The default value is "false";
Keep directories structure - a boolean variable, if the value of which is "true", then save the directory structure equally in the source and target locations. If the value is "false", then the directory structure is not saved. Available only with the "Include subdirectories" option enabled. The default is "false";
Depth - the maximum depth of viewing subdirectories. The default value is 5. Use -1 to specify unlimited depth. Available only if the value of "Include subdirectories" is "true".
Settings
Property | Description | Type | Example of filling in | Obligatory to fill in the field | ||||
Parameters | ||||||||
Context | Unique identifier of the FTP session in the context of which the action will be applied | FTP | FTP context | Yes | ||||
Local directory | Local directory to upload to the FTP server | |||||||
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля | ||||
Параметры | ||||||||
Контекст | Уникальный идентификатор FTP сеанса, в контексте которого будет применено действие | Robin.FTP | Контекст FTP | Да | ||||
Локальная директория | Локальная директория, которую необходимо загрузить на FTP сервер | Robin.FolderPath | C:\doc\img | Да | Директория на FTP- сервере | Целевой каталог, в который будет загружена локальная директория | Robin.String | Да |
Перезаписать | Если значение параметра равно true, то файлы и поддиректории будут перезаписаны. В противном случае перезапись не производится. По умолчанию - false. | Robin.Boolean | true | Нет | ||||
Только существующие | Если значение параметра равно true, то загружать только те файлы, которые существуют в директории назначения. В противном случае загружать все файлы. Значение по умолчанию false. Доступно только с включенным параметром «Перезаписать» | Robin.Boolean | true | Нет | ||||
Только новые | Если значение параметра равно true, то перезаписать только более новые существующие файлы и все файлы, которых ещё нет. В противном случае загрузить все файлы. Если включено «Только существующие», то перезаписать только более новые существующие файлы, без добавления тех, которых ещё нет. Доступно только с включенным параметром «Перезаписать» | Robin.Boolean | true | Нет | Исключить | Файлы, которые необходимо игнорировать во время загрузки. Чтобы указать более одного файла, используйте wild-cards (* или ?) | Robin.String | Нет |
Включить поддиректории | Если значение равно true, то поиск выполняется внутри текущей директории и по всем ее поддиректориям. Если значение равно false, то поиск выполняется только внутри текущей директории. Значение по умолчанию - false | Robin.Boolean | true | Нет | ||||
Сохранить структуру директорий | Если значение равно true, то сохранить структуру директорий одинаково в исходном и целевом местоположении. Если значение равно false, то структура директорий не сохраняется. Доступно только с включенным параметром „Включить поддиректории“. По умолчанию - false | Robin.Boolean | true | Нет | Глубина | Максимальная глубина просмотра вложенных директорий. Используйте -1 для указания глубины без ограничений. Доступно только с включенным параметром „Включить поддиректории“ | Robin.Numeric | Нет |
Особые условия использования
Отсутствуют.
Пример использования
Задача: подключиться к FTP-серверу, загрузить папку на сервер.
Yes | ||||
Remote directory on the FTP server | Target directory to which the local directory will be uploaded | String | Yes | |
Rewrite | If true, files and subdirectories will be overwritten. Otherwise, no overwriting is performed. The default is false. | Boolean | true | No |
Existing only | If true, load only those files that exist in the destination directory. Otherwise, load all files. The default value is false. Available only with the Rewrite parameter enabled | Boolean | true | No |
Only new | If true, overwrite only newer existing files and all files that are still No. Otherwise, load all files. If "Existing only" is enabled, overwrite only newer existing files, without adding those that are still No. Available only with "Rewrite" enabled | Boolean | true | No |
Exclude | Files to ignore during upload. To specify more than one file, use wild-cards (* or ?) | String | No | |
Include subdirectories | If true, the search is performed inside the current directory and all its subdirectories. If false, the search is performed only within the current directory. The default value is false | Boolean | true | No |
Keep directories structure | If true, save the directory structure equally in the source and target locations. If false, the directory structure is not saved. Available only with the "Include subdirectories" option enabled. Default is false | Boolean | true | No |
Depth | Maximum depth for viewing subdirectories. Use -1 to specify the depth with no limit. Available only with the "Include subdirectories" option enabled | Numeric | No |
Special conditions of use
None.
Example of use
Task: connect to FTP server, upload folder to server.
Solution: use the actions "ConnectРешение: воспользоваться действиями "Подключить", "Upload folder", "ОтключитьDisconnect".
Реализация:
Implementation:
- Assemble a robot scheme consisting of the actionsСобрать схему робота, состоящего из действий:
- Настроить параметры для действия "Подключить"Set the parameters for the "Connect" action.
- Настроить параметры для действия Set the parameters for the "Upload folder" action.
Настроить параметры для действия "Отключить" - Set the parameters for the "Disable" action.
- Нажать на кнопку "Старт" в верхней панели.
Результат:
- Click on the "Start" button in the top panel.
Result:
The software robot has completed successfully. The folder is uploaded to the server. Требуется замена скриншотаПрограммный робот отработал успешно. Папка загружена на сервер.