Шаг Отправить веб-запрос позволяет отправлять запросы конечным точкам REST для получения данных или публикации обновлений. Если у вас есть Workflow Manager с лицензий на роль ArcGIS Workflow Manager Server Advanced, вы можете настроить ответ конечной точки REST как пользовательские выходные значения, сохранить его как файл и прикрепить к заданию. Пользовательские выходные значения могут использоваться для извлечения токенов для последующих вызовов REST, определения пути, по которому следует рабочий процесс, или использоваться в качестве входных данных для других шагов на протяжении всего рабочего процесса.
Когда шаг выполняется, веб-запрос отправляется в конечную точку REST, определенную на этом шаге.
Шаг можно завершить, щелкнув кнопку Завершить шаг .
Настройка шага
To configure the step, do the following:
Внимание:
Чтобы уменьшить уязвимости системы безопасности, настройте шаг Отправить веб-запрос только для доверенных веб-страниц и веб-приложений.
- Create or edit a workflow diagram to access the Step Library panel.
- Перетащите Отправить веб-запрос из панели Библиотека шагов на стрелку соединения шага на холсте рабочего процесса.
The Step Details panel appears.
- Provide a name for the step in the Step Name text box.
- В разделе Аргументы щелкните Редактировать.
- Щелкните стрелку ниспадающего списка URL и выберите тип запроса, который вы хотите отправить.
- Введите URL-адрес конечной точки REST в текстовое окно URL.
- При желании добавьте переменные пути к URL-адресу, используя следующий синтаксис:
https://gisserver.domain.com/webadaptorname/apps/workflowmanager/:pathVariable/
Переменные пути в появятся в разделе Переменные пути.
- Если вы добавили переменные пути к URL-адресу, укажите значение для каждой переменной в разделе Переменные пути.
- При необходимости добавьте в веб запрос параметры запроса.
- Щелкните Добавить ключ и значение в разделе Параметры запроса.
- Введите ключ в текстовом окне Ключ.
- Введите значение в текстовом окне Значение.
- Оставьте текстовое окно Включено отмеченным.
- Повторите шаги от a до d, чтобы добавить больше пар ключ-значение.
- Щелкните вкладку Авторизация.
- Выберите метод аутентификации конечной точки REST и при необходимости предоставьте информацию для аутентификации.
Внимание:
Информация для аутентификации, которую вы предоставляете на шаге, не зашифрована. Чтобы защитить информацию, добавьте зашифрованные пользовательские настройки для хранения информации и ссылки на нее на шаге с использованием динамических свойств задания.
- При необходимости щелкните вкладку Заголовки, чтобы добавить в веб запрос пользовательские пары ключ-значение заголовка.
- Щелкните Добавить ключ и значение в разделе Пользовательские заголовки.
- Введите ключ в текстовом окне Ключ.
- Введите значение в текстовом окне Значение.
- Оставьте текстовое окно Включено отмеченным.
- Повторите шаги от a до d, чтобы добавить больше пар ключ-значение.
- При необходимости щелкните вкладку Основа, чтобы добавить данные в веб запрос.
Основа запроса поддерживает пары ключ-значение данных формы, пары ключ-значение в кодировке URL и необработанные данные в формате JSON или обычного текста.
Подсказка:
Вы также можете использовать выражение Arcade для получения пользовательских настроек или предоставления динамических значений в основном тексте.
- При желании, если у вас есть лицензия для ArcGIS Workflow Manager Server Advanced, сконфигурировать настройки выхода шага.
- Щелкните Сохранить, чтобы закрыть диалоговое окно Настройка веб-запроса.
- Click the Options tab.
- Configure Step Options as necessary.
- Manual—Run the step manually.
- Optional—Allow the step to be finished without being run.
- Automatic—Run the step as soon as it becomes active.
Примечание:
If your workflow diagram is configured to automatically run a sequence of steps that includes the Evaluate Data Quality or the Run GP Service step, steps that attempt to run after the user token that started the sequence of steps expires will not run automatically. You must have a license for the ArcGIS Workflow Manager Server Advanced role to continue running the additional automated steps without manual intervention.
- Run on a Schedule—Run the step according to a schedule you set.
- Manual—Run the step manually.
- Optionally, provide help text for the step in the Step Help text box.
You can also use the following example to display a dynamic value using ArcGIS Arcade expressions:
'For further assistance, please contact ' + jobCreator($job) + '.'
- Optionally, click the Style tab to change the shape and color of the step.
- Optionally, click the About tab and provide a description for the step in the Step Description text box.
Примечание:
The About tab also contains the step's ID that can be used with dynamic job properties to obtain a step's output.
Сконфигурируйте настройки выхода
Лицензия:
This functionality requires a license for the ArcGIS Workflow Manager Server Advanced role.
Роль ArcGIS Workflow Manager Server Advanced позволяет сохранить ответ конечной точки REST в виде файла, прикрепить его к заданию и настроить его как пользовательские выходные значения. Выходные значения могут использоваться для определения пути, по которому следует рабочий процесс, или использоваться в качестве входных данных для других шагов на протяжении всего рабочего процесса. Если выходное значение не настроено для шага, код состояния HTTP сохраняется как выходное значение шага. Чтобы сконфигурировать настройки выхода шага, сделайте следующее:
- Щелкните вкладку Выход в диалоговом окне Настройка веб-запроса.
Если диалоговое окно Настройка веб-запроса недоступно, щелкните шаг Отправить веб-запрос на холсте рабочего процесса и щелкните Редактировать в разделе Аргументы на панели Подробная информация о шаге.
- При желании щелкните переключатель Включено в разделе Вложить ответ, чтобы сохранить ответ конечной точки REST в виде файла и прикрепить его к заданию.
- При желании выполните следующие действия, чтобы настроить имя вложения и папку, в которой оно будет храниться:
- Введите имя папки, в которой будет храниться вложение, в текстовом окне Имя папки.
Имя папки не может содержать специальные символы.
Примечание:
Если имя папки не указано, автоматически создается папка с именем Общие.
- Выберите одну из следующих опций Имя вложения:
- Созданный автоматически - вложению автоматически присваивается имя, с помощью следующего синтаксиса: <StepName>_<RunDate>_<RunTime>
- Пользовательский - позволяет указать пользовательское имя вложения.
- Введите имя папки, в которой будет храниться вложение, в текстовом окне Имя папки.
- При желании выполните следующие действия, чтобы настроить пользовательские выходные значения для ответа конечной точки REST:
- Щелкните переключатель Режим тестирования в разделе Выходные значения.
- Вставьте пример ответа конечной точки 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 } } ]}
- Щелкните Добавить выходные данные и путь.
- Введите имя для выходного значения в текстовом окне Выходное значение.
Это имя значения, которое используется для получения пользовательского выходного значения.
- Предоставьте выражение JSONPath в точечной записи или в скобках для значения, которое вы хотите сохранить, в текстовом окне Путь извлечения.
Пример JSONPath в точечной записи:
$.locations.0.name
Пример JSONPath в скобках:
$['locations'][0]['name']
Значение отображается в столбце Образец результата.
- При желании повторите шаги с c по e, чтобы добавить дополнительные пользовательские выходные значения.
- Щелкните Сохранить, чтобы закрыть диалоговое окно Настройка веб-запроса.
Return value
When the step is completed, its return value is stored to indicate the result of the step. The return value can be immediately evaluated using paths to determine the next steps in the workflow. You can also retrieve the return value for completed steps throughout the workflow using ArcGIS Arcade expressions. The following table lists the step's return values:
Return values | Description |
---|---|
S000001 | The step completed successfully. |
F000001 | The step failed to complete successfully. |
Выходное значение
Лицензия:
This functionality requires a license for the ArcGIS Workflow Manager Server Advanced role.
When the step is completed, its output value is stored and can be used to determine the path the workflow follows or be used as inputs for other steps throughout the workflow. The following table shows the step's output value:
Выходные данные | Описание | Синтаксис выражения ArcGIS Arcade |
---|---|---|
Состояние | Возвращает код ответа HTTP, если выходное значение не настроено для шага. | jobOutputValue($job, '<step_id>', 'Status') |
<CustomOutputValue> | Возвращает пользовательское выходное значение, которое вы настроили для шага. | jobOutputValue($job, '<step_id>', '<custom_output_value_name>') |