Действия пакета интеграции FTPFTP Integration Pack Activities

Важно!

Эта версия Orchestrator достигла конца поддержки, мы рекомендуем выполнить обновление до Orchestrator 2019.This version of Orchestrator has reached the end of support, we recommend you to upgrade to Orchestrator 2019.

Следующие инструкции по настройке применяются ко всем действиям в этом пакете интеграции.The following configuration instructions apply to all activities in this integration pack. Ссылки на этот раздел включены в инструкции по настройке для каждого действия.Links to this section are included in the configuration instructions for each activity.

Процедуры, описанные в этом разделе, выполняются с действием, которое было помещено в окно Runbook Runbook Designer Orchestrator.The procedures in this topic are performed on an activity that has been placed in the runbook window of the Orchestrator Runbook Designer.

Свойства действияActivity Properties

Каждое действие имеет набор обязательных или необязательных свойств, определяющих конфигурацию этого действия.Each activity has a set of required or optional properties that define the configuration of that activity. Это включает в себя способ подключения к другим действиям или действия, выполняемые действием.This includes how it connects to other activities or how the activity performs its actions. Вы можете просматривать или изменять свойства действий, когда действие помещается в окно Runbook.You can view or modify activity properties when the activity is placed in the runbook window.

Просмотр и Настройка свойств действияTo view and configure the properties for an activity

  1. Дважды щелкните действие.Double-click the activity. Кроме того, можно щелкнуть действие правой кнопкой мыши и выбрать пункт Свойства.Alternatively, you can right-click the activity, and then click Properties.
  2. Чтобы сохранить записи конфигурации, нажмите кнопку Готово.To save your configuration entries, click Finish.

В диалоговом окне Свойства действия несколько вкладок в левой части предоставляют доступ к общим и конкретным параметрам действия.In the activity properties dialog box, several tabs along the left side provide access to general and specific settings for the activity. Количество доступных вкладок для свойств объекта различается в разных действиях.The number of available tabs for object properties differs between different activities.

Вкладка «Общие»General Tab

На этой вкладке содержатся свойства имя и Описание для действия.This tab contains the Name and Description properties for the activity. По умолчанию имя действия совпадает с типом действия, а Описание — пустым.By default, the Name of the activity is the same as its activity type, and the Description is blank. Эти свойства можно изменить, чтобы создать более описательные имена или указать подробные описания действий действия.You can modify these properties to create more descriptive names or provide detailed descriptions of the actions of the activity.

Вкладка «Свойства»Properties Tab

Эта вкладка содержит свойства, относящиеся к конкретному действию.This tab contains properties that are specific to the activity. Все действия в этом пакете интеграции имеют свойство имя конфигурации в верхней части вкладки свойства или фильтры . Это свойство используется для указания соединения с FTP-сервером.All activities in this integration pack have the Configuration Name property at the top of the Properties or Filters tab. This property is used to specify the connection to the FTP server.

Настройка свойства "имя конфигурации"To configure the Configuration Name property

  1. Нажмите кнопку с многоточием (...) рядом с полем имя .Click the ellipsis (...) button next to the Name field.
  2. Выберите подходящее имя подключения.Select the applicable connection name.

Поведение фильтраFilter Behavior

Действия переводят список папок и файлов и синхронизируют фильтры использования папок и файлов для определения элементов, которые будут перечислены или синхронизированы.The activities List Folders/Files and Synchronize Folder/File use filters to determine the items that will be listed or synchronized. Значения свойств потенциальных кандидатов сравниваются со значениями фильтров, чтобы определить, соответствуют ли они критериям.Property values of potential candidates are compared to the values of the filters to determine if they meet the criteria. При совпадении с значениями можно выбрать один из доступных методов сравнения.When matching against values, you can select one of the available methods of comparison. Параметр предоставляется либо для сопоставления, либо для несоответствия фильтру с помощью каждого метода.An option is provided to either match or not match the filter using each method. Например, версия метода "не соответствует" находит элементы, которые не соответствуют фильтру, чтобы начать действие.For example, the "Does not" version of a method finds items that do not match the filter to start the activity. Все текстовые фильтры чувствительны к регистру.All text filters are case sensitive.

  • Equals: свойство сообщения совпадает с текстом или числом, указанным в фильтре.Equals: the property of the message matches the text or number specified in the filter.
  • Не равно: свойство сообщения не соответствует тексту или числу, указанному в фильтре.Does not equal: the property of the message does not match the text or number specified in the filter.

Вкладка «поведение при запуске»Run Behavior Tab

На этой вкладке содержатся свойства, определяющие, как действие обрабатывает публикуемые данные с несколькими значениями, и какие уведомления будут отправляться в случае сбоя или запуска действия в течение некоторого времени.This tab contains the properties that determine how the activity handles multi-value published data and what notifications will be sent if the activity fails or runs for an excessive period of time.

Поведение опубликованных данных с несколькими значениямиMulti-Value Published Data Behavior

Действия Get получают сведения из другого действия или за пределами источника и могут возвращать одно или несколько значений в опубликованных данных.The Get activities retrieve information from another activity or outside source, and can return one or more values in the published data. Например, при использовании действия "перечислить папки/файлы" выходные данные этого действия могут быть списком компьютеров, принадлежащих к указанной коллекции.For example, when you use the List Folders/Files activity, the data output from that activity could be a list of computers that belong to the specified collection.

По умолчанию данные из действия "список папок/файлов" будут передаваться в виде нескольких отдельных выходов.By default, the data from the List Folders/Files activity will be passed on as multiple individual outputs. Это вызывает следующее действие столько раз, сколько имеется элементов в выходных данных.This invokes the next activity as many times as there are items in the output. Кроме того, можно предоставить один выход для действия, включив параметр сведение .Alternatively, you can provide a single output for the activity by enabling the Flatten option. При включении этого параметра необходимо выбрать параметр форматирования:When you enable this option, you must choose a formatting option:

  • Разделяйте разрывами строк.Separate with line breaks. Каждый элемент находится на новой строке.Each item is on a new line. Этот формат полезен для создания текстовых файлов, пригодных для восприятия, для вывода.This format is useful for creating human-readable text files for the output.
  • Разделите с.Separate with. Каждый элемент отделяется одним или несколькими выбранными символами.Each item is separated by one or more characters of your choice.
  • Используйте формат CSV.Use CSV format. Все элементы находятся в формате CSV (значение с разделителями-запятыми).All items are in CSV (comma-separated value) format. Этот формат удобен для импорта данных в электронные таблицы или другие приложения.This format is useful for importing data into spreadsheets or other applications.

Действие будет создавать новый набор данных при каждом запуске.The activity will produce a new set of data every time it runs. Функция « сведение » не выполняет сведение данных между несколькими экземплярами одного действия.The Flatten feature does not flatten data across multiple instances of the same activity.

Уведомления о событияхEvent Notifications

Выполнение некоторых действий должно занять ограниченное время.Some activities are expected to take a limited amount of time to complete. Если они не завершаются в течение этого времени, они могут быть остановлены, или может возникнуть другая неполадка, препятствующая их завершению.If they do not complete within that time they may be stalled or there may be another issue preventing them from completing. Можно определить количество секунд ожидания завершения действия.You can define the number of seconds to wait for completion of the action. По истечении этого периода будет отправлено событие платформы, и будет выведено сообщение о выпуске.After this period a platform event will be sent and the issue will be reported. Кроме того, можно также указать, генерировать ли событие платформы, если действие возвращает отказ.You can also choose whether to generate a platform event if the activity returns a failure.

Получение уведомления о том, что действие занимает больше времени, чем заданное время, или не может быть запущеноTo be notified when the activity takes longer than a specified time to run or fails to run

  1. В поле уведомления о событии введите количество секунд времени выполнения до создания уведомления.In the Event Notifications box, enter the number of seconds of run time before a notification is generated.
  2. Выберите отчет, если не удается запустить действие для создания уведомлений об ошибках запуска.Select Report if activity fails to run to generate run failure notifications.

Опубликованные данныеPublished Data

Опубликованные данные являются основой рабочего модуля Runbook.Published data is the foundation of a working runbook. Это данные, создаваемые в результате действий действия.It is the data produced as a result of the actions of an activity. Эти данные публикуются во внутренней шине данных, которая уникальна для каждого модуля Runbook.This data is published to an internal data bus that is unique for each runbook. Последующие действия в модуле Runbook могут подписываться на эти данные и использовать их в своей конфигурации.Subsequent activities in the runbook can subscribe to this data and use it in their configuration. Условия связи также используют эти сведения для добавления возможностей принятия решений в модули Runbook.Link conditions also use this information to add decision-making capabilities to runbooks.

Действие может подписываться только на данные из действий, которые связаны перед ним в модуле Runbook.An activity can subscribe only to data from the activities that are linked before it in the runbook. Опубликованные данные можно использовать для автоматического заполнения значений свойств, необходимых действиям.You can use published data to automatically populate the property values needed by activities.

Использование опубликованных данныхTo use published data

  1. Щелкните правой кнопкой мыши поле значение свойства, выберите подпишите, а затем — опубликованные данные.Right-click the property value box, click Subscribe, and then click Published Data.
  2. Щелкните раскрывающийся список действие и выберите действие, из которого требуется получить данные.Click the Activity drop-down box and select the activity from which you want to obtain the data. Чтобы просмотреть дополнительные элементы данных, общие для всех модулей Runbook, выберите Показать общие опубликованные данные.To view additional data elements common to all runbooks, select Show Common Published Data.
  3. Выберите элемент опубликованные данные, который требуется использовать, и нажмите кнопку ОК.Click the published data element that you want to use, and then click OK.

Список элементов данных, опубликованных каждым действием, см. в таблице опубликованные данные в разделе действие.For a list of the data elements published by each activity, see the Published Data table in the activity topic. Сведения об общих элементах опубликованных данных см. в разделе Общие опубликованные данные.For information about the common published data items, see Common Published Data.

ДействияActivities

Этот пакет интеграции добавляет категорию FTP в область действий в Runbook Designer.This integration pack adds the FTP category to the Activity pane in the Runbook Designer. Эта категория содержит следующие действия.This category contains the following activities:

Создать папкуCreate Folder
Удалить файлDelete File
Удаление папкиDelete Folder
Скачать файлDownload File
Вывод списка папок и файловList Folders/Files
Переименовать файл или папкуRename File/Folder
Возобновление загрузки файловResume File Download
Синхронизировать папку или файлSynchronize Folder/File
Отправить файлUpload File