Шаг Задать версию задания позволяет задать существующий источник данных сервис-ориентированной версии в качестве текущей версии задания. При выполнении шага версия задания перезаписывается и заменяется указанной. Если указанная версия не существует или пользователь, выполняющий шаг, не имеет доступа к этой версии, шаг завершается сбоем и на листе задания появляется сообщение об ошибке.
Когда вы включаете для шага опцию Управляется Workflow, ArcGIS Workflow Manager управляет сервис-ориентированной версией, а шаги Запросить версию и Очистка можно использовать для изменения или удаления версии.
Настройка шага
Для настройки шага выполните следующее:
- Создайте или отредактируйте схему рабочего процесса, чтобы получить доступ к панели Библиотека шагов.
- Перетащите Задать версию задания из панели Библиотека шагов на стрелку соединения шага в канве рабочего процесса.
Появится панель Подробная информация о шаге.
- Укажите имя шага в текстовом окне Имя шага.
- В разделе Источник данных, выберите опцию:
Выбрать источник — в ниспадающем меню выберите ссылку на данные сервиса объектов, содержащие версию, которую вы хотите установить.
Если у вас нет ссылки на данные сервиса объектов, связанной со схемой рабочего процесса, щелкните Добавить ссылку на данные в ниспадающем меню и добавьте ссылку на данные, выполнив одно из следующих действий:
- Перейти к элементу - найдите и выберите элемент из списка на текущем портале.
Подсказка:
Вы можете уточнить результаты поиска, применив фильтры и теги.
Ввести ID элемента вручную — в текстовых полях ID элемента и Имя ссылки на данные укажите ID элемента и имя ссылки.
Элемент автоматически проверяется Workflow Manager, и тип ссылки на данные задается в поле Тип.
Если ссылка на данные не может быть проверена, необходимо указать ID элемента для действительной ссылки на данные, соответствующей заданному типу ссылки.
- Перейти к элементу - найдите и выберите элемент из списка на текущем портале.
Выражение Arcade — задайте выражение ArcGIS Arcade, которое возвратит идентификатор элемента ссылки на данные, чтобы динамически определить ссылку на данные с той версией, которую вы хотите установить.
Выражение Arcade должно возвращать идентификатор источника данных, а не имя источника данных.
Подсказка:
Нажмите Этот входной параметр поддерживает выражения Arcade
и выберите выражение Arcade, чтобы добавить его в соответствующее текстовое поле.
Примечание:
Для этого шага можно использовать только одну ссылку на данные. Чтобы установить версию задания для нескольких ссылок на данные, настройте дополнительные шаги Задать версию задания на схеме рабочего процесса.
- В разделе Версия, выберите опцию:
- GUID версии - Укажите GUID сервис-ориентированной версии. Этот метод рекомендуется использовать для улучшения производительности.
- Имя версии — Укажите полное имя сервис-ориентированной версии, например, WORKFLOWUSER.JOB_44.
- При необходимости отметьте опцию Управляется Workflow, чтобы включить возможность Workflow Manager управлять сервис-ориентированной версией.
Это включает шаги Запросить версию и Очистка, чтобы вы могли изменить или удалить версию.
- Перейдите на вкладку Опции.
- При необходимости настройте Опции шага.
- Вручную - запустить шаг вручную.
- Дополнительно - позволяет завершить шаг без запуска.
- Автоматически - Запускает шаг, как только он становится активным.
Примечание:
Если для схемы рабочего процесса настроен автоматический запуск последовательности шагов, включая шаги Оценить качество данных и Запустить сервис GP, то после истечения срока действия токена пользователя запускаемые шаги не будут выполняться автоматически. Для выполнения дополнительных автоматизированных шагов без ручного вмешательства требуется роль ArcGIS Workflow Manager Server Advanced.
- Запуск по расписанию - запуск шага по заданному расписанию.
- Вручную - запустить шаг вручную.
- При желании выберите один из следующих вариантов настройки справки на этом шаге:
- Нет - настройте шаг без пошаговой справки.
- Текст - настройте текст справки для шага в текстовом поле Текст.
Вы можете использовать выражения ArcGIS Arcade для предоставления динамического значения справки по шагу. Если справка по шагу содержит обычный текст и выражения Arcade, выполните форматирование текста следующим образом:
'For further assistance, please contact' + JobCreator($Job) + '.' - URL - настройте шаг, указав ссылку на справочный ресурс в текстовом поле URL.
Примечание:
Шаги, выполняемые в веб-приложении, поддерживают только форматы HTTP и HTTPS URL. Шаги, выполняемые в ArcGIS Pro, поддерживают HTTP, HTTPS и форматы файлов.
Вы также можете использовать выражения Arcade для предоставления динамического значения. Если URL-адрес содержит обычный текст и выражения Arcade, выполните форматирование текста следующим образом:
'https://pro.arcgis.com/en/pro-app/latest/tool-reference/' + JobExtendedProperty($Job, 'tools', 'toolbox') + '/' + jobExtendedProperty($job, 'tools', 'alias') + '.htm'Выполните следующие настройки для опции Автоматически кодировать результат Arcade:
- Если выражение Arcade возвращает специальные символы, которых нужно избегать при конвертировании в URL, например, пробел или прямой слэш, убедитесь, что опция Автоматически кодировать результат Arcade включена.
- Если для формирования базового URL-адреса используется выражение Arcade, отключите опцию Автоматически кодировать результат Arcade.
- Дополнительно, щелкните вкладку Стиль, чтобы изменить форму и цвет шага.
- Дополнительно, щелкните вкладку Описание и введите описание шага в текстовом поле Описание шага.
Подсказка:
Вкладка Описание также содержит идентификатор шага, который можно использовать с динамическими свойствами задания для получения выходных данных шага. Щелкните Копировать ID шага
, чтобы скопировать идентификатор шага в буфер обмена.
Возвращаемое значение
Когда шаг завершен, его возвращаемое значение сохраняется, чтобы указать результат шага. Возвращаемое значение может быть немедленно оценено с использованием путей для определения следующих шагов рабочего процесса. Вы также можете получить возвращаемое значение для завершенных шагов рабочего процесса с помощью выражений ArcGIS Arcade. В следующей таблице перечислены возвращаемые значения шага:
| Возвращаемое значение | Описание |
|---|---|
| S000001 | Шаг завершен успешно. |
F000001 | Шаг не удалось завершить успешно. |
Выходное значение
Когда шаг завершен, его выходное значение сохраняется и может использоваться для определения пути, по которому следует рабочий процесс, или может использоваться в качестве входных данных для других шагов рабочего процесса. В следующей таблице перечислены выходные значения шага:
| Выходные данные | Описание |
|---|---|
| версия | Возвращает массив заданной версии. |
dataSource | Возвращает массив URL-адресов ссылок на данные, для которых были успешно заданы версии. |