Добавление и настройка шага Survey123

Шаг Survey123 позволяет собирать, просматривать и редактировать опросы ArcGIS Survey123 в ArcGIS Workflow Manager.

На шаге Survey123 необходимо создать расширенную таблицу свойств из формы опроса, чтобы связать данные опроса с заданиями. При отправке опроса соответствующая таблица расширенных свойств заполняется данными, собранными в ходе опроса. Если расширенная таблица свойств не создана из формы опроса, опросы могут быть собраны, но собранные данные недоступны для задания.

Подсказка:

Чтобы отобразить или отредактировать данные из опросов, собранных за пределами вашего рабочего процесса, создайте расширенную таблицу свойств из формы опроса. Добавьте шаг Обновить свойства задания перед шагом Survey123 в схеме рабочего процесса и обновите ID ссылки в таблице расширенных свойств с помощью существующего опроса globalid.

Когда шаг выполняется в веб-приложении Workflow Manager, опрос, настроенный на этом шаге, отображается на листе задания. При запуске шага в ArcGIS Pro на листе задания появляется кнопка Открыть в веб, которая открывает опрос, настроенный на шаге в веб-приложении Workflow Manager. Если для шага настроен текст справки, он отображается в нижней части листа задания.

Примечание:

Пользователь, выполняющий действие, должен иметь достаточные права в Survey123 для просмотра, редактирования или отправки формы опроса, настроенной на шаге.

Более подробно о публикации опросов в Survey123

Внимание:

Если опрос, настроенный на этом шаге, не размещен на том же портале ArcGIS Enterprise, что и ArcGIS Workflow Manager Server, рекомендуется войти в веб-приложение Workflow Manager и Survey123 с помощью разных веб-браузеров. Если во время выполнения шага вы вошли на несколько порталов в одном и том же веб-браузере, ваши учетные данные Survey123 используются для доступа к опросу вместо ваших учетных данных Workflow Manager.

Когда шаг запущен, могут быть выполнены следующие действия:

  • Настроенный опрос можно отправить, просмотреть или отредактировать.
  • Шаг можно отменить, щелкнув кнопку Отмена.
  • Шаг можно завершить, щелкнув кнопку Продолжить.

Настройка шага

Выполните следующие действия, чтобы настроить этот шаг:

  1. Создайте или отредактируйте схему рабочего процесса, чтобы получить доступ к панели Библиотека шагов.
  2. Перетащите Survey123 из панели Библиотека шагов на стрелку соединения шага на холсте рабочего процесса.

    Появится панель Подробная информация о шаге.

  3. Укажите имя шага в текстовом окне Имя шага.
  4. В разделе Survey123 Form щелкните Добавить форму Survey123.

    Появится диалоговое окно Add Survey123 Form.

  5. Выберите одну из следующих опций, чтобы указать, где находится ваша форма Survey123:
    • Эта организация Enterprise - Добавьте опрос, который доступен на том же портале, что и Workflow Manager.
    • ArcGIS Online - Добавьте общедоступный опрос, расположенный в ArcGIS Online.
    • Другое - Добавьте общедоступный опрос, расположенный на другом портале.
  6. Если вы выбрали Другое, введите URL-адрес портала, который содержит ваш опрос, в текстовое поел URL-адрес портала и нажмите Enter.

    Для ArcGIS Enterprise используйте формат https://webadaptorhost.domain.com/webadaptorname.

  7. Введите ID формы для опроса в текстовое поле ID формы.
  8. Введите имя опроса в текстовом окне Имя привязки.
  9. Нажмите OK.

    Опрос появится на панели Подробная информация о шаге.

    Примечание:

    Опрос можно удалить, щелкнув кнопку Удалить опрос Delete Survey.

  10. Щелкните кнопку-переключатель Отношения, чтобы переключиться между отношениями опроса один-к-одному (1-1) или один-ко-многим (1-M) с заданиями Workflow Manager.
    • 1-1 - Устанавливает отношение один-к-одному, чтобы разрешить привязку только одного опроса к заданию.
    • 1-M - Устанавливает отношение один-ко-многим, чтобы можно было связать несколько опросов с заданием.
  11. Выберите одну из следующих опций как настройку Режима:
    • Создать новый - Создайте и соберите опрос.
      Примечание:

      Этот опция доступна только для опросов с отношением один-ко-многим (1-M).

    • Редактировать - отредактируйте опрос.
      Примечание:

      Если для задания не существует опроса, создается и собирается опрос. Если опрос настроен с отношением один-ко-многим (1-M), последний собранный опрос редактируется.

    • Просмотр - просмотр опроса.
      Примечание:

      Если опрос настроен с отношением один-ко-многим (1-M), последний собранный опрос открыт для просмотра.

  12. Перейдите на вкладку Опции.
  13. При необходимости настройте Опции шага.
    • Вручную - запустить шаг вручную.
      • Дополнительно - позволяет завершить шаг без запуска.
    • Автоматически - Запускает шаг, как только он становится активным.
      Примечание:

      Если схема рабочего процесса настроена на автоматический запуск последовательности шагов, включающей шаг Оценка качества данных или Запуск сервиса GP, шаги, которые пытаются запуститься после истечения срока действия токена пользователя, запустившего последовательность шагов, не будут выполняться автоматически. У вас должна быть лицензия для роли ArcGIS Workflow Manager Server Advanced, чтобы продолжать выполнять больше автоматизированных шагов без ручного вмешательства.

    • Запланировать запуск - запустить шаг в соответствии с установленным вами расписанием.

      Более подробно об опциях расписания

  14. При желании выберите один из следующих вариантов настройки справки на этом шаге:
    • Нет - настройте шаг без пошаговой справки.
    • Текст - настройте текст справки для шага в текстовом поле Текст.

      Вы можете использовать выражения ArcGIS Arcade для предоставления динамического значения справки по шагу. Если справка по шагу содержит обычный текст и выражения Arcade, отформатируйте текст следующим образом:

      
      'For further assistance, please contact' + JobCreator($Job) + '.'

      Подсказка:

      Нажмите Этот входной параметр поддерживает выражения Arcade This input supports Arcade expressions и выберите выражение ArcGIS 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.

  15. Дополнительно, щелкните вкладку Стиль, чтобы изменить форму и цвет шага.
  16. Дополнительно, щелкните вкладку Описание и введите описание шага в текстовом поле Описание шага.
    Подсказка:

    Вкладка Описание также содержит идентификатор шага, который можно использовать с динамическими свойствами задания для получения выходных данных шага. Щелкните Копировать ID шага Copy Step ID, чтобы скопировать идентификатор шага в буфер обмена.

Возвращаемое значение

Когда шаг завершен, его возвращаемое значение сохраняется, чтобы указать результат шага. Возвращаемое значение может быть немедленно оценено с использованием путей для определения следующих шагов рабочего процесса. Вы также можете получить возвращаемое значение для завершенных шагов рабочего процесса с помощью выражений ArcGIS Arcade. В следующей таблице перечислены возвращаемые значения шага:

Возвращаемое значениеОписание

S000001

Шаг завершен успешно.

F000001

Шаг не удалось завершить успешно.

Выходное значение

Когда шаг завершен, его выходное значение сохраняется и может использоваться для определения пути, по которому следует рабочий процесс, или может использоваться в качестве входных данных для других шагов рабочего процесса. В следующей таблице перечислено выходное значение шага:

Выходные данныеОписание

<GlobalID>

Возвращает globalid последнего опроса, который был создан, просмотрен или отредактирован.

Связанные разделы