Шаг 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.
Когда шаг запущен, могут быть выполнены следующие действия:
- Настроенный опрос можно отправить, просмотреть или отредактировать.
- Шаг можно отменить, щелкнув кнопку Отмена.
- Шаг можно завершить, щелкнув кнопку Продолжить.
Настройка шага
Для настройки шага выполните следующее:
- Создайте или отредактируйте схему рабочего процесса, чтобы получить доступ к панели Библиотека шагов.
- Перетащите Survey123 из панели Библиотека шагов на стрелку соединения шага на холсте рабочего процесса.
Появится панель Подробная информация о шаге.
- Укажите имя шага в текстовом окне Имя шага.
- В разделе 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), последний собранный опрос открыт для просмотра.
- Создать новый - Создайте и соберите опрос.
- Перейдите на вкладку Опции.
- При необходимости настройте Опции шага.
- Вручную - запустить шаг вручную.
- Дополнительно - позволяет завершить шаг без запуска.
- Автоматически - Запускает шаг, как только он становится активным.
Примечание:
Если схема рабочего процесса настроена на автоматический запуск последовательности шагов, включающей шаг Оценка качества данных или Запуск сервиса GP, шаги, которые пытаются запуститься после истечения срока действия токена пользователя, запустившего последовательность шагов, не будут выполняться автоматически. Для выполнения дополнительных автоматизированных шагов без вмешательства вручную требуется лицензия на роль ArcGIS Workflow Manager Server Advanced.
- Запланировать запуск - запустить шаг в соответствии с установленным вами расписанием.
- Вручную - запустить шаг вручную.
- Дополнительно укажите текст справки для шага в текстовом поле Справка по шагу.
Вы также можете использовать следующий пример, чтобы отобразить динамическое значение, используя выражения ArcGIS Arcade:
'For further assistance, please contact ' + jobCreator($job) + '.' - Дополнительно, щелкните вкладку Стиль, чтобы изменить форму и цвет шага.
- Дополнительно, щелкните вкладку Описание и введите описание шага в текстовом поле Описание шага.
Примечание:
Вкладка Описание также содержит идентификатор шага, который можно использовать с динамическими свойствами задания для получения выходных данных шага.
Возвращаемое значение
Когда шаг завершен, его возвращаемое значение сохраняется, чтобы указать результат шага. Возвращаемое значение может быть немедленно оценено с использованием путей для определения следующих шагов рабочего процесса. Вы также можете получить возвращаемое значение для завершенных шагов рабочего процесса с помощью выражений ArcGIS Arcade. В следующей таблице перечислены возвращаемые значения шага:
| Возвращаемые значения | Описание |
|---|---|
| S000001 | Шаг завершен успешно. |
F000001 | Шаг не удалось завершить успешно. |
Выходное значение
Когда шаг завершен, его выходное значение сохраняется и может быть использовано для определения пути, по которому пойдет рабочий процесс, или в качестве входных данных для других шагов рабочего процесса. В следующей таблице показано выходное значение шага:
| Выходные данные | Описание | Синтаксис выражения ArcGIS Arcade |
|---|---|---|
<GlobalID> | Возвращает globalid последний опрос, который был создан, просмотрен или отредактирован. | jobOutputValue($job, '<step_id>') |