Добавление и настройка шага Создать версию

Лицензия:

Участникам организации должна быть назначена лицензия для расширения типа пользователя ArcGIS Advanced Editing для использование этого шага.

Управление версиями позволяет нескольким пользователям завершить работу со своей собственной версией пространственных данных, чтобы они могли согласовать и опубликовать свои изменения в сервис-ориентированной версии по умолчанию. Это гарантирует, что пользователи получают доступ к нужным данным в нужное время, и помогает избежать конфликтов редактирования.

При запуске шага он проверяет каждый из источников данных сервиса объектов, определенных в рабочем процессе, на наличие существующей версии данных для конкретного задания. Если источник данных не содержит версию для конкретного задания, шаг Создать версию автоматически создает ее и связывает ее с заданием. Шаг Создать версию поддерживает создание только одной версии задания для каждого сервиса объектов для источников данных, определенных в схеме рабочего процесса задания.

Когда завершается выполнение шага, на листе задания появляется сообщение с результатом шага.

Если источник данных не был определен для шага, или если на шаге не удалось создать версии, появится сообщение CreateVersionFailed, и задание не перейдет к следующему шагу. Наведите курсор на сообщение об ошибке, чтобы отобразить дополнительную информацию об ошибке.

Если шаг завершается ошибкой и коды возврата не соответствуют ни одному из настроенных путей, а шаг не является дополнительным, он остается в состоянии сбоя и не может быть пропущен.

Настройка шага

Выполните следующие действия, чтобы настроить этот шаг:

  1. Создайте или отредактируйте схему рабочего процесса, чтобы получить доступ к панели Библиотека шагов.
  2. Перетащите Создать версию из панели Библиотека шагов на стрелку соединения шага на канве рабочего процесса.

    Появится панель Подробная информация о шаге.

  3. Укажите имя шага в текстовом окне Имя шага.
  4. При необходимости укажите имя версии в текстовом поле Имя версии.
    Подсказка:

    Чтобы добавить уникальный идентификатор к имени версии, введите [index] там, где в имени версии должен отображаться уникальный идентификатор.

  5. При необходимости настройте уровни разрешений для версий в разделе Права доступа.
    Примечание:

    Параметр права доступа позволяет ограничить просмотр и редактирование версий другими пользователями, кроме владельца версии. По умолчанию Частный.

  6. В разделе Источники данных вы можете выбрать одну из следующих опций:
    • Все - выберите эту опцию, чтобы создать версию для всех источников данных, настроенных в схеме рабочего процесса.
    • Выбрать источники - выберите эту опцию и нажмите Добавить источник, чтобы выбрать источники данных, для которых вы хотите создать версии.
      Подсказка:

      Чтобы удалить источник данных, щелкните Удалить Delete.

    • Выражение Arcade — выберите эту опцию и укажите выражение ArcGIS Arcade для динамической ссылки на источник данных, для которого будут создаваться версии при выполнении шага.

      Выражение Arcade должно возвращать идентификатор источника пространственных данных, а не имя источника пространственных данных. Если вам необходимо выбрать более одного источника данных, отформатируйте выражение следующим образом:

      '["' + JobExtendedProperty($Job, 'versions', 'datasource1') + '"' + ',' + '"' + JobExtendedProperty($Job, 'versions', 'datasource2') + '"]'
      Подсказка:

      Нажмите Этот входной параметр поддерживает выражения Arcade This input supports Arcade expressions и выберите выражение ArcGIS Arcade, чтобы добавить его в соответствующее текстовое поле.

  7. Перейдите на вкладку Опции.
  8. При необходимости настройте Опции шага.
    • Вручную - запустить шаг вручную.
      • Дополнительно - позволяет завершить шаг без запуска.
    • Автоматически - Запускает шаг, как только он становится активным.
      Примечание:

      Если схема рабочего процесса настроена на автоматический запуск последовательности шагов, включающей шаг Оценка качества данных или Запуск сервиса GP, шаги, которые пытаются запуститься после истечения срока действия токена пользователя, запустившего последовательность шагов, не будут выполняться автоматически. У вас должна быть лицензия для роли ArcGIS Workflow Manager Server Advanced, чтобы продолжать выполнять больше автоматизированных шагов без ручного вмешательства.

    • Запланировать запуск - запустить шаг в соответствии с установленным вами расписанием.

      Более подробно об опциях расписания

  9. При желании выберите один из следующих вариантов настройки справки на этом шаге:
    • Нет - настройте шаг без пошаговой справки.
    • Текст - настройте текст справки для шага в текстовом поле Текст.

      Вы можете использовать выражения 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.

  10. Дополнительно, щелкните вкладку Стиль, чтобы изменить форму и цвет шага.
  11. Дополнительно, щелкните вкладку Описание и введите описание шага в текстовом поле Описание шага.
    Подсказка:

    Вкладка Описание также содержит идентификатор шага, который можно использовать с динамическими свойствами задания для получения выходных данных шага. Щелкните Копировать ID шага Copy Step ID, чтобы скопировать идентификатор шага в буфер обмена.

Возвращаемое значение

Когда шаг завершен, его возвращаемое значение сохраняется, чтобы указать результат шага. Возвращаемое значение может быть немедленно оценено с использованием путей для определения следующих шагов рабочего процесса. Вы также можете получить возвращаемое значение для завершенных шагов рабочего процесса с помощью выражений ArcGIS Arcade. В следующей таблице перечислены возвращаемые значения шага:

Возвращаемое значениеОписание

S000001

Шаг завершен успешно.

F000001

Шаг не удалось завершить успешно.

Выходное значение

Когда шаг завершен, его выходное значение сохраняется и может использоваться для определения пути, по которому следует рабочий процесс, или может использоваться в качестве входных данных для других шагов рабочего процесса. В следующей таблице перечислены выходные значения шага:

Выходные данныеОписание

версии

Возвращает массив всех созданных версий.

dataSources

Возвращает массив URL-адресов всех источников данных, для которых были успешно созданы версии.

dataSourceNames

Возвращает массив всех имен источников данных для каждой созданной версии.

Связанные разделы