Наверх

Добавление и настройка шага Отправить Веб-запрос

В этом разделе

  1. Настройка шага
  2. Сконфигурируйте настройки выхода
  3. Возвращаемое значение
  4. Выходное значение

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

Когда шаг выполняется, веб-запрос отправляется в конечную точку REST, определенную на этом шаге.

Шаг можно завершить, щелкнув кнопку Завершить шаг Complete Step.

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

Для настройки шага выполните следующее:

Внимание:

Чтобы уменьшить уязвимости системы безопасности, настройте шаг Отправить веб-запрос только для доверенных веб-страниц и веб-приложений.

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

    Более подробно о добавлении шагов к схеме рабочего процесса

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

  3. Укажите имя шага в текстовом окне Имя шага.
  4. В разделе Аргументы щелкните Редактировать.
  5. Щелкните стрелку ниспадающего списка URL и выберите тип запроса, который вы хотите отправить.
  6. Введите URL-адрес конечной точки REST в текстовое окно URL.
  7. При желании добавьте переменные пути к URL-адресу, используя следующий синтаксис:
    https://gisserver.domain.com/webadaptorname/apps/workflowmanager/:pathVariable/

    Переменные пути в появятся в разделе Переменные пути.

  8. Если вы добавили переменные пути к URL-адресу, укажите значение для каждой переменной в разделе Переменные пути.
  9. При необходимости добавьте в веб запрос параметры запроса.
    1. Щелкните Добавить ключ и значение в разделе Параметры запроса.
    2. Введите ключ в текстовом окне Ключ.
    3. Введите значение в текстовом окне Значение.
    4. Оставьте текстовое окно Включено отмеченным.
    5. Повторите шаги от a до d, чтобы добавить больше пар ключ-значение.
  10. Щелкните вкладку Авторизация.
  11. Выберите метод аутентификации конечной точки REST и при необходимости предоставьте информацию для аутентификации.
    Внимание:

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

  12. При необходимости щелкните вкладку Заголовки, чтобы добавить в веб запрос пользовательские пары ключ-значение заголовка.
    1. Щелкните Добавить ключ и значение в разделе Пользовательские заголовки.
    2. Введите ключ в текстовом окне Ключ.
    3. Введите значение в текстовом окне Значение.
    4. Оставьте текстовое окно Включено отмеченным.
    5. Повторите шаги от a до d, чтобы добавить больше пар ключ-значение.
  13. При необходимости щелкните вкладку Основа, чтобы добавить данные в веб запрос.

    Основа запроса поддерживает пары ключ-значение данных формы, пары ключ-значение в кодировке URL и необработанные данные в формате JSON или обычного текста.

    Подсказка:

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

  14. При желании, если у вас есть лицензия для ArcGIS Workflow Manager Server Advanced, сконфигурировать настройки выхода шага.
  15. Щелкните Сохранить, чтобы закрыть диалоговое окно Настройка веб-запроса.
  16. Перейдите на вкладку Опции.
  17. При необходимости настройте Опции шага.
    • Вручную - запустить шаг вручную.
      • Дополнительно - позволяет завершить шаг без запуска.
    • Автоматически - Запускает шаг, как только он становится активным.
      Примечание:

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

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

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

  18. Дополнительно укажите текст справки для шага в текстовом поле Справка по шагу.

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

    
'For further assistance, please contact ' + jobCreator($job) + '.'
  19. Дополнительно, щелкните вкладку Стиль, чтобы изменить форму и цвет шага.
  20. Дополнительно, щелкните вкладку Описание и введите описание шага в текстовом поле Описание шага.
    Примечание:

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

Сконфигурируйте настройки выхода

Лицензия:

Для использования этой функциональной возможности требуется лицензия на роль ArcGIS Workflow Manager Server Advanced.

Роль ArcGIS Workflow Manager Server Advanced позволяет сохранить ответ конечной точки REST в виде файла, прикрепить его к заданию и настроить его как пользовательские выходные значения. Выходные значения могут использоваться для определения пути, по которому следует рабочий процесс, или использоваться в качестве входных данных для других шагов на протяжении всего рабочего процесса. Если выходное значение не настроено для шага, код состояния HTTP сохраняется как выходное значение шага. Чтобы сконфигурировать настройки выхода шага, сделайте следующее:

  1. Щелкните вкладку Выход в диалоговом окне Настройка веб-запроса.

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

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

      Имя папки не может содержать специальные символы.

      Примечание:

      Если имя папки не указано, автоматически создается папка с именем Общие.

    2. Выберите одну из следующих опций Имя вложения:
      • Созданный автоматически - вложению автоматически присваивается имя, с помощью следующего синтаксиса: <StepName>_<RunDate>_<RunTime>
      • Пользовательский - позволяет указать пользовательское имя вложения.
  4. При желании выполните следующие действия, чтобы настроить пользовательские выходные значения для ответа конечной точки REST:
    1. Щелкните переключатель Режим тестирования в разделе Выходные значения.
    2. Вставьте пример ответа конечной точки REST в текстовое окно Образец ответа.

      Пример ответа в формате JSON:

      {"access_token": "",
"expires_in":7199,
"spatialReference": {
  "wkid": 4326,
  "latestWkid": 4326
},
"locations": [
  {
    "name": "380 New York Street",
    "extent": {
      "xmin": -117.196701,
      "ymin": 34.055489
    }
  }
]}
    3. Щелкните Добавить выходные данные и путь.
    4. Введите имя для выходного значения в текстовом окне Выходное значение.

      Это имя значения, которое используется для получения пользовательского выходного значения.

    5. Предоставьте выражение JSONPath в точечной записи или в скобках для значения, которое вы хотите сохранить, в текстовом окне Путь извлечения.

      Пример JSONPath в точечной записи:

      $.locations.0.name

      Пример JSONPath в скобках:

      $['locations'][0]['name']

      Значение отображается в столбце Образец результата.

    6. При желании повторите шаги с c по e, чтобы добавить дополнительные пользовательские выходные значения.
  5. Щелкните Сохранить, чтобы закрыть диалоговое окно Настройка веб-запроса.

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

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

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

S000001

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

F000001

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

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

Лицензия:

Для использования этой функциональной возможности требуется лицензия на роль ArcGIS Workflow Manager Server Advanced.

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

Выходные данныеОписаниеСинтаксис выражения ArcGIS Arcade

Состояние

Возвращает код ответа HTTP, если выходное значение не настроено для шага.

jobOutputValue($job, '<step_id>', 'Status')

<CustomOutputValue>

Возвращает пользовательское выходное значение, которое вы настроили для шага.

jobOutputValue($job, '<step_id>', '<custom_output_value_name>')

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

  • Создание и управление схемами рабочих процессов
  • Шаблоны шагов
  • Оценка результатов шагов
  • Настройка путей
  • Динамические свойства заданий
  • Тестирование динамических свойств заданий

Отзыв по этому разделу?

В этом разделе
  1. Настройка шага
  2. Сконфигурируйте настройки выхода
  3. Возвращаемое значение
  4. Выходное значение