Добавление и настройка шага Определить местоположение

Шаг Определить местоположение позволяет определить, где необходимо выполнить задание. Местоположение может быть точкой, линией или полигоном в существующем сервисе объектов, в проекте ArcGIS Pro или на веб-карте в веб-приложении ArcGIS Workflow Manager.

Если шаг выполняется в веб-приложении Workflow Manager и в качестве метода поиска местоположения выбрана Карта, веб-карта, настроенная в этом шаге, отображается на листе задания. Если для шага настроена справка, она отображается в нижней части листа задания. Выбираемые слои отображаются на карте, а все дополнительные слои, кроме слоя Местоположение задания, доступны только для чтения. Используйте виджет Управление слоями , чтобы изменить видимость отдельных слоев, и виджет Нарисовать объект или Выбрать объекты , чтобы определить местоположение для задания.

Примечание:

Если местоположение задания уже определено, его нельзя отредактировать, но можно заменить, нарисовав или выбрав новые объекты.

Если шаг запущен в ArcGIS Pro и в качестве метода выборки выбрана Карта, слой Местоположение задания добавляется к карте, настроенной при запуске шага, и со слоем Местоположение задания появляется панель Создать объекты. Если для шага настроена справка, она отображается в нижней части листа задания. Используйте панель Создать объекты, чтобы определить местоположение для задания.

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

• Только объекты с правильным типом геометрии могут быть сохранены в качестве местоположения задания.
• Если выбрано несколько полигонов или несколько линейных объектов правильного типа геометрии, местоположение сохраняется как составной объект.
• Рисование местоположения в веб-приложении Workflow Manager удаляет все существующие выделения, а выбор объектов удаляет нарисованные местоположения.

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

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

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

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

Для настройки шага выполните следующее:

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

   Более подробно о добавлении шагов к схеме рабочего процесса

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

3. Укажите имя шага в текстовом окне Имя шага.
4. Дополнительно, добавьте сообщение, которое хотите отобразить при выполнении шага, в текстовое окно Подсказка пользователя.

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

   'This job is currently assigned to ' + JobOwner($Job) + '.'

   Подсказка:

   Нажмите Этот входной параметр поддерживает выражения Arcade и выберите выражение Arcade, чтобы добавить его в соответствующее текстовое поле.

5. Щелкните стрелку ниспадающего списка Тип геометрии и выберите тип геометрии выборки для определения местоположения.

   Вы также можете использовать выражения ArcGIS Arcade для предоставления динамического значения.

6. Выберите одну из следующих опций:
   • Карта - позволяет пользователю определять местоположение задания на карте.
   • Геометрия - автоматически определяет местоположения задания с использованием координат в формате Esri JSON.
7. Если вы выбрали Карта, выполните следующие действия:
   1. При необходимости выберите параметры Метода поиска местоположения.
      • Выбрать - позволяет выбрать существующие объекты на карте.
      • Рисование - позволяет создать объекты с помощью инструментов рисования в ArcGIS Pro или виджетов в веб-приложении Workflow Manager.
   2. В разделе Карта в Веб-карта нажмите Добавить, чтобы добавить веб-карту, с которой вы хотите работать в веб-приложении Workflow Manager.

      Появится диалоговое окно Шаг Определить местоположение.

      Примечание:

      Веб-карты нельзя использовать для определения местоположения в ArcGIS Pro. Вы должны указать имя карты, с которой хотите работать в проекте ArcGIS Pro, чтобы определить местоположение.

   3. Выберите один из следующих вариантов, чтобы указать, где находится веб-карта:
      • ArcGIS Online - Добавьте веб-карту, расположенную в ArcGIS Online.
      • Другое - Добавьте общедоступную веб-карту, расположенную на портале ArcGIS Enterprise.
   4. Если вы выбрали Другое, введите URL-адрес портала, который содержит веб-карту, в текстовое окно URL-адрес портала и нажмите Enter.

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

   5. Укажите ID элемента для веб-карты в текстовое поле ID элемента.
   6. Введите имя веб-карты в текстовом окне Имя привязки.
   7. Нажмите OK.

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

      Примечание:

      Веб-карту можно отредактировать, щелкнув Редактировать, или удалить, нажав Удалить.

   8. Введите имя карты, с которой вы хотите работать в своем проекте ArcGIS Pro, в текстовом поле ArcGIS Pro.
   9. При желании, если для веб-карты настроен параметр Включить поиск, введите определяющий запрос, текст для поиска или выражение Arcade в окне Поиск текста, чтобы увеличить масштаб до исходного экстента карты при выполнении шага в веб-приложении Workflow Manager.
8. Если вы выбрали Геометрию, используйте следующие примеры, чтобы определить местоположение задания с использованием координат в формате Esri JSON.

   Вы можете использовать строку, выражение Arcade или их комбинацию для определения местоположения.

   Определите местоположение точки с помощью строки JSON.

   {"x" : -118.15, "y" : 33.80, "spatialReference" : {"wkid" : 4326}}

   Задайте местоположение точки с помощью выражения Arcade.

   '{"x":' + JobOutputValue($Job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'testx') + ', "y":' + JobOutputValue($Job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'testy') + ', "spatialReference" : {"wkid" : ' + JobOutputValue($Job, '6d3a2e62-41f3-0ca5-d14a-bf87b8e4e4ec', 'wkid') + "}}"

   Задайте местоположение точки с помощью выражения Arcade, которое преобразует координаты в формате GeoJSON в формат Esri JSON.

   {GeoJsonToEsriJson(JobExtendedProperty($Job, 'assets', 'geojson'), 'Point'), "spatialReference" : {"wkid" : 4326}}

   Задайте местоположение с помощью поля shape.

   JobExtendedProperty($Job, '<table_name>','shape')

   Примечание:

   Поле shape - это имя поля, используемое для получения геометрии из расширенной таблицы свойств.

   Пространственная привязка по умолчанию - Web Mercator Auxiliary Sphere (wkid 3857). Если у геометрии, возвращаемой выражением Arcade, другая пространственная привязка, местоположение определяется, и пространственная привязка преобразуется в wkid 3857.

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

      Примечание:

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

    • Запуск по расписанию - запуск шага по заданному расписанию.

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

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

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

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

    • 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.

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

    Подсказка:

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

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

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

Возвращаемое значение	Описание
S000001	Шаг завершен успешно.
F000001	Шаг не удалось завершить успешно.

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

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

Выходные данные	Описание
<Location>	Возвращает определенное местоположение.