Шаг Survey123 позволяет собирать, просматривать и редактировать опросы ArcGIS Survey123 в ArcGIS Workflow Manager.
На шаге Survey123 необходимо создать расширенную таблицу свойств из формы опроса, чтобы связать данные опроса с заданиями. При отправке опроса соответствующая таблица расширенных свойств заполняется данными, собранными в ходе опроса. Если расширенная таблица свойств не создана из формы опроса, опросы могут быть собраны, но собранные данные недоступны для задания.
Подсказка:
Чтобы просматривать или редактировать данные из опросов, которые собираются вне рабочего процесса, создайте расширенную таблицу свойств из формы опроса. Добавьте шаг Обновить свойства задания перед шагом Survey123 в схеме рабочего процесса и обновите ID ссылки в таблице расширенных свойств с помощью существующего опроса globalid.
Когда шаг выполняется в веб-приложении Workflow Manager, опрос, настроенный на этом шаге, отображается на листе задания. При запуске шага в ArcGIS Pro на листе задания появляется кнопка Открыть в веб-сети, которая открывает опрос, настроенный на шаге в веб-приложении Workflow Manager. Если для шага настроен текст справки, он отображается в нижней части листа задания.
Примечание:
Пользователь, выполняющий шаг, должен иметь достаточные права в Survey123 для просмотра, редактирования или отправки формы опроса, настроенной на шаге.
Внимание:
Если опрос, настроенный на этом шаге, не размещен на том же портале ArcGIS Enterprise, что и ArcGIS Workflow Manager Server, рекомендуется войти в веб-приложение Workflow Manager и Survey123 с помощью разных веб-браузеров. Если во время выполнения шага вы вошли на несколько порталов в одном и том же веб-браузере, ваши учетные данные Survey123 используются для доступа к опросу вместо ваших учетных данных Workflow Manager.
When the step is run, the following actions can be performed:
- Настроенный опрос можно отправить, просмотреть или отредактировать.
- The step can be cancelled by clicking Cancel.
- The step can be finished by clicking Proceed.
Настройка шага
To configure the step, do the following:
- Create or edit a workflow diagram to access the Step Library panel.
- Перетащите Survey123 из панели Библиотека шагов на стрелку соединения шага на холсте рабочего процесса.
The Step Details panel appears.
- Provide a name for the step in the Step Name text box.
- В разделе Survey123 Form щелкните Добавить форму Survey123.
Появится диалоговое окно Add Survey123 Form.
- Выберите одну из следующих опций, чтобы указать, где находится ваша форма Survey123:
- Эта организация Enterprise - Добавьте опрос, который доступен на том же портале, что и Workflow Manager.
- ArcGIS Online - Добавьте общедоступный опрос, расположенный в ArcGIS Online.
- Другое - Добавьте общедоступный опрос, расположенный на другом портале.
- Если вы выбрали Другое, введите URL-адрес портала, который содержит ваш опрос, в текстовое окно URL-адрес портала и нажмите Enter.
Например, формат может быть https://webadaptorhost.domain.com/webadaptorname.
- Введите ID формы для опроса в текстовое окно ID формы.
- Введите имя опроса в текстовом окне Имя привязки.
- Нажмите OK.
Опрос появится на панели Подробная информация о шаге.
Примечание:
Опрос можно удалить, щелкнув кнопку Удалить опрос
. - Щелкните кнопку-переключатель Отношения, чтобы переключиться между отношениями опроса один-к-одному (1-1) или один-ко-многим (1-M) с заданиями Workflow Manager.
- 1-1 - Устанавливает отношение один-к-одному, чтобы разрешить привязку только одного опроса к заданию.
- 1-M - Устанавливает отношение один-ко-многим, чтобы можно было связать несколько опросов с заданием.
- Выберите одну из следующих опций как настройку Режима:
- Создать новый - Создайте и соберите опрос.
Примечание:
Этот опция доступна только для опросов с отношением один-ко-многим (1-M).
- Редактировать - Отредактируйте опрос.
Примечание:
Если для задания не существует опроса, создается и собирается опрос. Если опрос настроен с отношением один-ко-многим (1-M), последний собранный опрос редактируется.
- Просмотр - просмотр опроса.
Примечание:
Если опрос настроен с отношением один-ко-многим (1-M), последний собранный опрос открыт для просмотра.
- Создать новый - Создайте и соберите опрос.
- 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.
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. |
Выходное значение
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 |
|---|---|---|
<GlobalID> | Возвращает globalid последний опрос, который был создан, просмотрен или отредактирован. | jobOutputValue($job, '<step_id>') |