Публикация веб-инструмента

Вы можете опубликовать на своем портале ArcGIS Enterpriseпользовательские инструменты геообработки, созданными из моделей ModelBuilder или скриптов Python. В отличие от инструмента, опубликованного с пакетом геообработки, веб-инструмент размещается и запускается на вашем сервере портала или на сервере, интегрированном с вашим порталом. Вы можете получить доступ к веб-инструментам в ArcGIS Pro и Map Viewer, а также как к пользовательским веб-приложениям, например к приложениям, созданным с помощью ArcGIS Web AppBuilder.

В этом руководстве вы опубликуете инструмент модели как веб-инструмент. Инструмент уже создан. Сначала вы запустите инструмент локально в проекте ArcGIS Pro, чтобы убедиться, что он работает успешно. Затем вы поделитесь им как веб-инструментом и запустите его на своем портале на ArcGIS Pro.

Инструмент модели, который вы опубликуете, по сути тот же, что вы создали в кратком руководстве Создание модели геообработки. Выполнение этого руководства не является обязательным условием, но оно будет полезно, если вы не знакомы с моделями геообработки или хотите лучше понять, как работает инструмент.

Обзор

Share a web tool overview video

• Продолжительность видео: 8:49
• Это видео было создано с помощью ArcGIS Pro 2.8.
• Предполагаемое время: 45 минут
• Требования к программному обеспечению:
  • ArcGIS Pro
  • Участие в организации ArcGIS Enterprise с ролью администратора или пользовательской ролью, которая включает право публиковать веб-инструменты.
  • ArcGIS Enterprise 10.6 или более поздней версии

Скачайте данные и откройте проект

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

1. Перейдите на страницу обзора Публикация веб-инструмента в ArcGIS Online.
2. Щелкните Загрузить.
3. В папке Downloads на вашем компьютере дважды щелкните Share_a_web_tool.ppkx, чтобы запустить ArcGIS Pro и открыть проект.

   

   Проект открывается с картой региона Мальборо в Новой Зеландии. Инструмент модели анализирует близость инвазивных трав к местам, где люди могут их встретить и распространить. Слои, представляющие инвазивные травы и места контакта, представлены на панели Содержание.

Запустите модель геообработки как инструмент

Прежде чем опубликовать инструмент в Интернете, вы должны запустить его в проекте ArcGIS Pro. Это гарантирует, что инструмент может получить доступ к своим входным данным и успешно работать. Чтобы понять, что делает этот инструмент, вы посмотрите на него в виде ModelBuilder.

1. Щелкните вкладку просмотра Вычисление ареалов инвазивных видов, чтобы увидеть модель.

   

   В качестве входных данных модель берет такие места, как кемпинги или пешеходные тропы, где люди могут встретить инвазивные травы. Указывается буферное расстояние вокруг места и выбирается инвазивный вид травы. Модель вычисляет количество инвазивной травы в буферной зоне (или зонах, если имеется несколько входных объектов) и создает выходной класс пространственных объектов с результатами.

2. В модели наведите курсор на элемент, представляющий инструмент Буфер, чтобы увидеть его параметры.

   

   Выходные данные инструмента Буфер - это промежуточные данные, используемые только в качестве входных данных для инструмента Суммировать в пределах. По этой причине он записывается не на диск, а в виртуальную рабочую область. Это улучшает производительность инструмента и особенно важно, когда вы создаете веб-инструменты с ModelBuilder.

3. Закройте вид Вычисление ареалов инвазивных видов, щелкнув Закрыть на вкладке.
4. Щелкните вкладку Вид на ленте. В группе Окна нажмите Сбросить панели и нажмите Сбросить панели для геообработки.

   Это гарантирует, что панели Содержание, Каталог и Геообработка открыты, тогда как остальные панели закрыты.

5. Сделайте панель Каталог активной. На панели Проект разверните Наборы инструментов и разверните Share_a_web_tool.tbx.

   Отобразится инструмент модели Вычисление ареалов инвазивных видов.

   Примечание:

   Инструменты могут быть встроенными инструментами , инструментами модели или инструментами-скриптами . Дополнительную информацию см. в словаре геообработки.

6. Щелкните правой кнопкой мыши инструмент Вычисление ареалов инвазивных видов и щелкните Открыть.

   Инструмент откроется на панели Геообработка. Вверху панели выбрана вкладка Параметры.

7. Щелкните стрелку ниспадающего списка Местоположения контакта с человеком и выберите Commercial Campgrounds.
8. Для Буферного расстояния введите 1.5. Измените единицы измерения с Неизвестных на Километры.
9. Щелкните стрелку ниспадающего списка Инвазивные виды и щелкните Nassella Tussock Range.
10. Щелкните стрелку ниспадающего списка Единицы измерения площадей и щелкните Гектары.
11. В окне Выходной класс объектов введите Nassella_Tussock_Near_Campgrounds.

    

    Выходной класс пространственных объектов будет создан в базе геоданных проекта по умолчанию.

12. Щелкните Запустить .

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

    Новый слой Nassella_Tussock_Near_Campgrounds обозначен черным контуром и заполнением пустот. В текущем масштабе карты объекты могут быть скрыты символами Коммерческих кемпингов.

13. Увеличьте карту, чтобы увидеть буферные объекты вокруг кемпингов.
14. На панели Содержание щелкните правой кнопкой мыши слой Nassella_Tussock_Near_Campgrounds и щелкните Таблица атрибутов .

    В таблице есть запись для каждого кемпинга.

15. В таблице щелкните правой кнопкой заголовок поля Summarized area in HECTARES и выберите Сортировать по убыванию .

    Четыре кемпинга содержат Nassella Tussock в радиусе 1,5 км.

16. Закройте таблицу.
17. На панели Содержание щелкните правой кнопкой мыши слой Nassella_Tussock_Near_Campgrounds и щелкните Удалить .
18. Сделайте панель Каталог активной. На вкладке Проект разверните Базы данных и разверните model_output.gdb.

    База геоданных содержит класс пространственных объектов с именем Nassella_Tussock_Near_Campgrounds. Это выходные данные, созданные инструментом.

    Примечание:

    У каждого проекта ArcGIS Pro есть база геоданных по умолчанию, отмеченная значком По умолчанию . Это рабочая область, в которую записывается большинство выходных данных геообработки, если не указано иное.

    Когда вы создаете проект, создается база геоданных по умолчанию с тем же именем, что и проект. Однако вы можете изменить базу геоданных по умолчанию. В этом проекте, model_output.gdb - база геоданных по умолчанию.

19. На панели Инструменты быстрого доступа щелкните Сохранить , чтобы сохранить проект.

Настройка веб-инструмента

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

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

1. На ленте щёлкните вкладку Общий доступ. В группе Опубликовать как щелкните стрелку ниспадающенго списка Веб-инструмент и щелкните Опубликовать веб-инструмент .

   Эта команда недоступна, если вы в данный момент не вошли на портал ArcGIS Enterprise. Возможно, вам потребуется управлять подключениями к порталу.

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

   

3. Нажмите OK.

   Откроется панель Опубликовать как Веб-инструмент.

   Подсказка:

   Вы также можете открыть панель, выполнив следующие действия:

   1. Щелкните вкладку Анализ на ленте.
   2. В группе Геообработка щелкните История .
   3. На панели История щелкните правой кнопкой мыши запись Вычисление ареалов инвазивных видов, щелкните Опубликовать как и щелкните Опубликовать веб-инструмент .

   Если в верхней части панели появляется сообщение об ошибке, возможно, у вашей учетной записи нет прав на публикацию веб-инструмента. См. Требования к программному обеспечению для этого руководства.

   На вкладке Общие в разделе Информация об элементе окна Имя, Краткая информация и Теги заполняются метаданными, которые были ранее созданы для инструмента.

4. Рядом с Данными наведите курсор на значок информации и прочтите появившееся сообщение.

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

5. В разделе Местоположение оставьте настройки по умолчанию.

   Веб-инструмент будет доступен на корневом уровне ресурсов вашего портала и на хост-сервере вашего портала ArcGIS Enterprise.

6. В окне Опубликовать для установите отметку рядом с названием вашей организации ArcGIS Enterprise.

   Все участники организации, которые могут создавать контент, смогут запускать веб-инструмент. Более подробно об общих настройках веб-инструментов.

7. В верхней части панели щёлкните вкладку Настройка.

   В этом руководстве вы будете использовать настройки по умолчанию. Более подробно о настройках конфигурации веб-инструмента.

8. Щелкните закладку Ресурсы.

   

9. Рядом с инструментом Вычисление ареалов инвазивных видов щелкните Настроить свойства инструмента .
10. В окне Описание введите (или скопируйте и вставьте) следующий текст: Находит и обобщает инвазивные виды в буферной зоне указанных мест.
11. В разделе Параметры разверните Местоположения контактов с человеком.

    Описание параметра берется из метаданных инструмента геообработки.

12. Щелкните стрелку ниспадающего списка Режим ввода и выберите Определяемое пользователем значение.

    В настройках режима ввода тип геометрии по умолчанию - точечный. Когда вы запускали инструмент в предыдущем разделе, вы использовали точечный слой (Commercial Campgrounds) для местоположений контактов. Это означает, что инструмент был проверен только для точечных данных в этом параметре. Для обеспечения успеха веб-инструмент не принимает другие типы геометрии.

    Под типом геометрии находится схема таблицы, которая будет использоваться для интерактивно создаваемых входных слоев. (Это схема таблицы слоя Commercial Campgrounds.)

13. Разверните параметр Буферное расстояние.

    По умолчанию режим ввода для этого параметра установлен на Определяемое пользователем значение. Значение по умолчанию - 1,5 километра, потому что это параметр, который вы использовали при запуске инструмента. Пользователь инструмента может изменить это значение.

14. Разверните параметр Инвазивные виды.

    По умолчанию режим ввода - Список выбора. Пользователь инструмента должен иметь возможность выбрать инвазивный вид травы для анализа, но никакие другие слои не должны быть доступны для выбора. Данные для слоев, выбранных в списке выбора, будут скопированы на сервер.

15. В списке слоев отметьте четыре вида инвазивной травы, перечисленные ниже. Снимите все остальные отметки.

    • White Edged Nightshade Range
    • Kangaroo Grass Range
    • Chilean Needlegrass Range
    • Nassella Tussock Range (нельзя снять отметку)

    

16. Разверните параметр Единицы измерения площадей.

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

17. Щелкните стрелку ниспадающего списка Режим ввода и щелкните Постоянное значение.

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

18. Разверните параметр Выходной класс объектов.

    В окне Имя замените имя по умолчанию на Invasive Grass Summary.

    Этот параметр не будет отображаться в веб-инструменте. Пользователь инструмента не может изменить имя или местоположение выходного класса пространственных объектов. Выходной класс пространственных объектов создается на сервере и возвращается клиенту, запускающему веб-инструмент. В нем показана схема таблицы (схема выходного класса пространственных объектов при запуске инструмента).

    Последний параметр, Выходной сервис объектов, отмечен по умолчанию. Если отметка установлена, этот параметр отображается в веб-инструменте. Это дает пользователю инструмента возможность записать результаты анализа в сервис объектов на портале, а также в локальную файловую базу геоданных. Если отметки нет, параметр не отображается в веб-инструменте. Более подробно об использовании веб-инструментов с выходным сервисом объектов.

    Примечание:

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

Публикация веб-инструмента

Вы проанализируете инструмент на предмет предупреждений или ошибок и опубликуете его на своем портале.

1. В верхней части панели Опубликовать как веб-инструмент щелкните Назад .
2. В нижней части панели, под пунктом Закончить публикацию, щелкните Анализ.

   На вкладке Сообщения в верхней части панели отображаются предупреждения и ошибки. Есть четыре сгруппированных предупреждения.

3. Разверните группу и наведите курсор на одно из предупреждений.

   Предупреждение информирует вас о том, что источник данных не зарегистрирован и будет скопирован на сервер. (Одно и то же предупреждение появляется для каждого инвазивного типа травы.) Для больших наборов данных копирование данных на сервер может замедлить процесс публикации. В этом случае наборы данных небольшие, и вы можете спокойно игнорировать предупреждения.

   Подсказка:

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

4. В нижней части панели щелкните Опубликовать.

   Когда инструмент будет успешно опубликован на вашем портале, внизу панели появится сообщение.

   Примечание:

   Если веб-инструмент с таким именем уже существует на вашем портале, вы получите сообщение об ошибке публикации. Нажмите OK на сообщении об ошибке. На панели Опубликовать как веб-инструмент щелкните вкладку Общие. В окне Имя отредактируйте имя инструмента (без пробелов). В нижней части панели щелкните Опубликовать снова.

5. Получив сообщение об успешной публикации, щелкните Управление веб-инструментом, чтобы открыть веб-браузер вашей организации ArcGIS Enterprise. Войдите в систему, если будет предложено.

   Откроется страница элемента веб-инструмента. Вы можете вернуться позже, чтобы добавить дополнительные метаданные и образец изображения на страницу элемента.

6. В верхней части страницы элемента щелкните Ресурсы.

   

   Веб-инструмент появится в вашем списке элементов ресурсов.

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

Использование веб-инструмента

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

1. В ArcGIS Pro, сделайте панель Каталог активной. Щелкните вкладку Портал в верхней части панели.

   

   Элемент веб-инструмента SummarizeInvasiveSpecies появится на вкладке Мои ресурсы.

   Примечание:

   Для других участников вашей организации инструмент отображается на вкладке Моя организация . Его также можно найти на вкладке ArcGIS Enterprise с помощью поиска.

2. Дважды щелкните веб-инструмент SummarizeInvasiveSpecies и дважды щелкните веб-инструмент Вычисление ареалов инвазивных видов.

   

   Инструмент откроется на панели Геообработка. Параметры Буферное расстояние и Инвазивные виды установлены по умолчанию. Настройки можно изменить, но пока вы их принимаете. Обратите внимание, что инструмент не отображает параметры для единиц измерения или выходного класса пространственных объектов. У вас есть возможность создать выходной сервис объектов - если у вас есть роль publisher, - но вы не сделаете этого в этом руководстве.

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

3. Рядом с параметром Местоположения контакта с человеком щелкните Создать точки .

   В базе геоданных по умолчанию создается новый класс точечных объектов, а на панель Содержание добавляется редактируемый слой. Панель инструментов построения появится на карте. Прежде чем добавить местоположение для анализа, вы переименуете слой и выберете другой символ.

4. На панели Содержание щелкните один раз слой Summarize_Invasive_Species_Human_Contact_Locations_Points, чтобы сделать его имя редактируемым. Введите Citizen Request и нажмите Enter.
5. Под новым именем слоя щелкните его символ по умолчанию.

   Появится панель Символы, на которой представлены опции форматирования точечных символов.

6. Вверху панели убедитесь, что выбрана вкладка Галерея. В окне поиска введите Esri Pin и нажмите Enter.
7. В списке результатов щелкните символ Esri Pin 1 среднего размера.

   

   Символ слоя обновляется на панели Содержание.

   Предположим, с вами связался владелец виноградника, который считает, что видел Nassella Tussock недалеко от своей собственности.

8. На ленте щёлкните вкладку Карта. В группе Запрос щелкните Найти местоположение .

   Появится панель Найти местоположение. На панели выбрана вкладка Найти местоположение.

9. На панели Найти местоположение щелкните Опции и убедитесь, что ArcGIS World Geocoding Service или иной поставщик услуг поиска доступен и включен.

   Если единственным поставщиком является поставщик XY, на следующем шаге используйте пространственные координаты вместо адреса.

10. Щелкните в окне поиска. Введите (или скопируйте и вставьте) New Zealand State Highway 6 and Rapaura Road, Renwick, 7273 и нажмите Enter. Или введите эти координаты в окне поиска: 173.8170288°E 41.4865202°S.

    Карта приблизится к местоположению, и на перекрестке улиц появится временный маркер.

11. Наведите курсор на это место и щелкните, чтобы создать точечный объект на слое Citizen Inquiry.

    Ваш интерактивный ввод объекта сохраняется автоматически.

12. На ленте на вкладке Карта в группе Навигация щелкните инструмент Исследовать .

    Это останавливает процесс интерактивного ввода объектов.

13. На панели Найти местоположение в окне поиска очистите результат, чтобы удалить временный маркер.
14. В нижней части вида карты нажмите ниспадающую стрелку масштаба и щелкните 1:10000.

    Если этот масштаб не отображается в вашем списке предопределенных масштабов, вы можете ввести его прямо в поле масштабирования.

15. На панели Содержание включите слой World Imagery (Clarity).

    

    Поблизости есть здания (в том числе винодельни и рестораны). Регион Мальборо славится своим вином. Тамне очень много Nassella Tussock, но вы можете увидеть пару участков на карте.

    Примечание:

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

16. Станет активной панель Геообработка.

    

    Параметр Местоположения контактов с человеком установлен на слой, который вы только что создали в интерактивном режиме.
17. Щелкните Запустить .

    Когда операция завершится, в нижней части панели Геообработки появится сообщение. На панели Содержание к карте добавляется слой с названием Invasive Grass Summary.

18. На панели Содержание щелкните правой кнопкой мыши слой Invasive Grass Summary и выберите Приблизить к слою .

    Карта приближается к экстенту 1,5-километрового буфера.

    

19. На панели Содержание щелкните правой кнопкой мыши слой Invasive Grass Summary и щелкните Таблица атрибутов .

    В таблице поле Summarized area in HECTARES показывает, что около 20 гектаров Nassella Tussock находятся в буферной зоне.

20. Закройте таблицу атрибутов.

    Примечание:

    Перед запуском веб-инструмента вы можете в интерактивном режиме создать несколько входных объектов. Каждый объект будет помещен в буфер и суммирован. Вы также можете запустить инструмент несколько раз, продолжая добавлять объекты в интерактивном режиме. Каждый раз при запуске инструмента создается новый выходной класс пространственных объектов.

    После остановки интерактивного создания вы можете перезапустить его, щелкнув Создать точки в параметре входных данных веб-инструмента. Однако это перезаписывает существующий слой (Citizen Request) и его исходный набор данных. Чтобы возобновить редактирование без перезаписи слоя, вы можете создавать объекты на панели Создать объекты.

Просмотр выходных данных и истории геообработки

Исходные наборы данных для слоев Citizen Request и Invasive Grass Summary находятся в базе геоданных по умолчанию. Результаты анализа сохраняются в истории геообработки проекта.

1. Сделайте панель Каталог активной. В верхней части панели щелкните вкладку Проект.
2. При необходимости разверните Базы данных и разверните базу геоданных model_output.

   База геоданных содержит класс объектов с именем feature_set<number>. Это источник данных слоя Invasive Grass Summary. Она также содержит класс объектов с именем Summarize_Invasive_Species_Human_Contact_Locations_Points. Это источник данных слоя Citizen Request.

3. Щелкните вкладку Анализ на ленте. В группе Геообработка щелкните История .

   

   Откроется панель История. Она содержит записи для двух успешных операций геообработки: веб-инструмента и настольного инструмента . Наведите курсор на записи, чтобы просмотреть подробную информацию о каждой операции.

4. На Панели инструментов быстрого доступа нажмите Сохранить , чтобы сохранить проект.

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

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

ArcGIS Pro это не единственное клиентское приложение, которое может запускать веб-инструменты; Map Viewer, ArcGIS Web AppBuilder и пользовательские веб-приложения также могут запускать веб-инструменты. Еще одно введение в публикацию веб-инструментов см. в разделе Как опубликовать веб-инструмент из ArcGIS Pro.