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