Шаг Survey123 позволяет собирать, просматривать и редактировать опросы ArcGIS Survey123 в ArcGIS Workflow Manager.
На шаге Survey123 необходимо создать расширенную таблицу свойств из формы опроса, чтобы связать данные опроса с заданиями. При отправке опроса соответствующая таблица расширенных свойств заполняется данными, собранными в ходе опроса. Если расширенная таблица свойств не создана из формы опроса, опросы могут быть собраны, но собранные данные недоступны для задания.
Подсказка:
Чтобы отобразить или отредактировать данные из опросов, собранных за пределами вашего рабочего процесса, создайте расширенную таблицу свойств из формы опроса. Добавьте шаг Обновить свойства задания перед шагом Survey123 в схеме рабочего процесса и обновите ID ссылки в таблице расширенных свойств с помощью существующего опроса globalid.
Когда шаг выполняется в веб-приложении Workflow Manager, опрос, настроенный на этом шаге, отображается на листе задания. При запуске шага в ArcGIS Pro на листе задания появляется кнопка Открыть в веб, которая открывает опрос, настроенный на шаге в веб-приложении Workflow Manager. Если для шага настроен текст справки, он отображается в нижней части листа задания.
Примечание:
Пользователь, выполняющий действие, должен иметь достаточные права в Survey123 для просмотра, редактирования или отправки формы опроса, настроенной на шаге.
Когда шаг запущен, могут быть выполнены следующие действия:
- Настроенный опрос можно отправить, просмотреть или отредактировать.
- Шаг можно отменить, щелкнув кнопку Отмена.
- Шаг можно завершить, щелкнув кнопку Продолжить.
Настройка шага
Выполните следующие действия, чтобы настроить этот шаг:
- Создайте или отредактируйте схему рабочего процесса, чтобы получить доступ к панели Библиотека шагов.
- Перетащите Survey123 из панели Библиотека шагов на стрелку соединения шага на холсте рабочего процесса.
Появится панель Подробная информация о шаге.
- Укажите имя шага в текстовом окне Имя шага.
- В разделе Survey123 Form щелкните Добавить форму Survey123.
Появится диалоговое окно Add Survey123 Form.
- Выберите одну из следующих опций, чтобы указать, где находится ваша форма Survey123:
- ArcGIS Online - Добавьте опрос, расположенный в ArcGIS Online.
- Другое - Добавьте общедоступный опрос, расположенный на портале ArcGIS Enterprise.
- Если вы выбрали Другое, введите URL-адрес портала, который содержит ваш опрос, в текстовое поел URL-адрес портала и нажмите Enter.
Для ArcGIS Enterprise используйте формат https://webadaptorhost.domain.com/webadaptorname.
- Введите ID формы для опроса в текстовое поле ID формы.
- Введите имя опроса в текстовом окне Имя привязки.
- Нажмите OK.
Опрос появится на панели Подробная информация о шаге.
Примечание:
Опрос можно удалить, щелкнув кнопку Удалить опрос
. - Щелкните кнопку-переключатель Отношения, чтобы переключиться между отношениями опроса один-к-одному (1-1) или один-ко-многим (1-M) с заданиями Workflow Manager.
- 1-1 - Устанавливает отношение один-к-одному, чтобы разрешить привязку только одного опроса к заданию.
- 1-M - Устанавливает отношение один-ко-многим, чтобы можно было связать несколько опросов с заданием.
- Выберите одну из следующих опций как настройку Режима:
- Создать новый - Создайте и соберите опрос.
Примечание:
Этот опция доступна только для опросов с отношением один-ко-многим (1-M).
- Редактировать - отредактируйте опрос.
Примечание:
Если для задания не существует опроса, создается и собирается опрос. Если опрос настроен с отношением один-ко-многим (1-M), последний собранный опрос редактируется.
- Просмотр - просмотр опроса.
Примечание:
Если опрос настроен с отношением один-ко-многим (1-M), последний собранный опрос открыт для просмотра.
- Создать новый - Создайте и соберите опрос.
- Перейдите на вкладку Опции.
- При необходимости настройте Опции шага.
- Вручную - запустить шаг вручную.
- Дополнительно - позволяет завершить шаг без запуска.
- Автоматически - Запускает шаг, как только он становится активным.
- Запланировать запуск - запустить шаг в соответствии с установленным вами расписанием.
- Вручную - запустить шаг вручную.
- При желании выберите один из следующих вариантов настройки справки на этом шаге:
- Нет - настройте шаг без пошаговой справки.
- Текст - настройте текст справки для шага в текстовом поле Текст.
Вы можете использовать выражения ArcGIS Arcade для предоставления динамического значения справки по шагу. Если справка по шагу содержит обычный текст и выражения Arcade, отформатируйте текст следующим образом:
'For further assistance, please contact' + JobCreator($Job) + '.'Подсказка:
Нажмите Этот входной параметр поддерживает выражения Arcade
и выберите выражение ArcGIS Arcade, чтобы добавить его в соответствующее текстовое поле. - URL - настройте шаг, указав ссылку на справочный ресурс в текстовом поле URL.
Примечание:
Поддерживаются только форматы URL-адресов 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.
- Дополнительно, щелкните вкладку Стиль, чтобы изменить форму и цвет шага.
- Дополнительно, щелкните вкладку Описание и введите описание шага в текстовом поле Описание шага.
Подсказка:
Вкладка Описание также содержит идентификатор шага, который можно использовать с динамическими свойствами задания для получения выходных данных шага. Щелкните Копировать ID шага
, чтобы скопировать идентификатор шага в буфер обмена.
Возвращаемое значение
Когда шаг завершен, его возвращаемое значение сохраняется, чтобы указать результат шага. Возвращаемое значение может быть немедленно оценено с использованием путей для определения следующих шагов рабочего процесса. Вы также можете получить возвращаемое значение для завершенных шагов рабочего процесса с помощью выражений ArcGIS Arcade. В следующей таблице перечислены возвращаемые значения шага:
| Возвращаемое значение | Описание |
|---|---|
| S000001 | Шаг завершен успешно. |
F000001 | Шаг не удалось завершить успешно. |
Выходное значение
Когда шаг завершен, его выходное значение сохраняется и может использоваться для определения пути, по которому следует рабочий процесс, или может использоваться в качестве входных данных для других шагов рабочего процесса. В следующей таблице перечислено выходное значение шага:
| Выходные данные | Описание |
|---|---|
<GlobalID> | Возвращает globalid последнего опроса, который был создан, просмотрен или отредактирован. |