Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Upload folder

Action group

Загрузить на сервер 

Группа действий: FTPДействие загружает локальную директорию на FTP-сервер

...

The action uploads a local directory to an FTP server

ПараметрыParameters

Входные параметры:

  1. Контекст контекст подключения к FTP-серверу;

  2. Локальная директория – путь к директории, которую необходимо загрузить на сервер;

  3. Директория на FTP- сервере – Путь к папке на удалённом сервере, куда будет загружена директория;

  4. Перезаписать – логическая переменная, если значение которой «true», то папка с одинаковым наименованием будут перезаписаны в директории;

  5. Только существующие – логическая переменная, если значение которой «true», то скачать только те файлы, которые существуют в локальной директории назначения. В противном случае скачать все файлы. Значение по умолчанию «false». Доступно только с включенным параметром «Перезаписать»;

  6. Только новые - логическая переменная, если значение которой «true», то перезаписать только более новые существующие файлы и все файлы, которых ещё нет в локальной директории. В противном случае скачать все файлы. Если включено «Только существующие», то перезаписать только более новые версии существующих файлов, без добавления тех, которых ещё нет. Доступно только с включенным параметром «Перезаписать»;

  7. Исключить - Наименование файлов, которые будут исключены из скачивания;

  8. Включить поддиректории - логическая переменная, если значение которой «true», то поиск выполняется внутри текущей директории и по всем ее поддиректориям. Если значение равно «false», то поиск выполняется внутри текущей директории. Значение по умолчанию – «false»;

  9. Сохранить структуру директорий - логическая переменная, если значение которой «true», то сохранить структуру директорий одинаково в исходном и целевом местоположении. Если значение равно «false», то структура директорий не сохраняется. Доступно только с включенным параметром „Включить поддиректории“. По умолчанию – «false»;

  10. Глубина - Максимальная глубина просмотра вложенных поддиректорий. Значение по умолчанию равно 5. Используйте -1 для указания безграничной глубины. Доступно только, если значение параметра «Включить поддиректории» равно «true».

Настройки

Input parameters:

  1. Context - the context of connection to the FTP server;

  2. Local directory - the path to the directory to be uploaded to the server;

  3. Remote directory on FTP server - the path to the folder on the remote server where the directory will be uploaded;

  4. Rewrite - a boolean variable, if its value is "true", then the folder with the same name will be overwritten in the directory;

  5. 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;

  6. 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;

  7. Exclude - name of files that will be excluded from downloading;

  8. 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";

  9. 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";

  10. 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

Свойство

Описание

Тип

Пример заполнения

Обязательность заполнения поля

Параметры

Контекст

Уникальный идентификатор FTP сеанса, в контексте которого будет применено действие

Robin.FTP

Контекст FTP

Да

Локальная директория

Локальная директория, которую необходимо загрузить на FTP сервер

Robin.

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

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:

  1. Assemble a robot scheme consisting of the actionsСобрать схему робота, состоящего из действий:
  2. Настроить параметры для действия "Подключить"Set the parameters for the "Connect" action
    image2024-1-23_16-12-15.png
  3. Настроить параметры для действия Set the parameters for the "Upload folder" action
    Настроить параметры для действия "Отключить"
  4. Set the parameters for the "Disable" action
    image2024-1-23_16-14-30.png
  5. Нажать на кнопку "Старт" в верхней панели. 

Результат: 


  1. Click on the "Start" button in the top panel.  

Result: 

The software robot has completed successfully. The folder is uploaded to the server.  Программный робот отработал успешно. Папка загружена на сервер.