Опубликованные из ArcGIS Pro картографические сервисы и сервисы изображений можно расширить с помощью расширений объектов сервера (SOE) и перехватчиков серверных объектов (SOI). SOE позволяют создавать сервисные операции для расширения базовой функциональности сервисов, а SOI - перехватывать запросы и ответы для встроенных операций сервисов.
Для разработки SOE и SOI могут использоваться ArcGIS Enterprise SDK, и оба они содержатся в файлах .soe. Их можно добавить в организацию и управлять из ArcGIS Enterprise Manager. После добавления в организацию SOE и SOI могут использоваться в картографических сервисах и сервисах изображений при публикации из ArcGIS Pro или в слоях изображений карт со страницы сведений об элементе.
Добавление расширения
Чтобы добавить расширение в организацию, нужен файл .soe, который был создан разработчиком данного расширения. Этот файл может содержать одно или несколько расширений.
После получения файла выполните следующие шаги:
-
Войдите в ArcGIS Enterprise Manager как администратор.
Примечание:
Организации могут разрешить издателям устанавливать расширения. См. Изменение прав доступа на публикацию сервисов геообработки и расширений сервисов для дополнительной информации.
- Щелкните кнопку Расширения на боковой панели.
Появится страница расширений.
- Щелкните Добавить расширение.
- Щелкните Выбрать файл и выберите файл .soe для добавления в организацию.
- Щелкните Добавить расширение.
Файл .soe добавлен в организацию.
Теперь, когда вы добавили это расширение в свою организацию, необходимо включить возможность SOE или SOI на нужном картографическом сервисе или сервисе изображений.
Включение SOE
После добавления SOE в вашу организацию, можно включить возможность для картографического сервиса или сервиса изображений. SOE можно включить для слоев изображений карты на странице сведений об элементе.
Чтобы включить SOE со страницы сведений об элементе слоя, выполните следующие действия:
- Выполните вход в организацию как владелец элемента с правами публикации или как администратор.
- Откройте страницу сведений об элементе для слоя изображений карты.
- Щелкните Настройки.
- Прокрутите страницу до раздела Слой изображений карты и раскройте заголовок Расширения.
- Разверните заголовок Расширения серверного объекта (SOE).
Появится список SOE, которые были добавлены в вашу организацию.
- Включите кнопку-переключатель рядом с тем SOE, которое хотите включить для сервиса.
- Раскройте заголовок для SOE, которое вы включили.
Появятся операции и свойства для SOE. Они были созданы по требованию разработчика расширения и обеспечивают более точный контроль над действиями пользователей с SOE.
- Если необходимо, выберите операции, которые вы хотели бы разрешить.
- Если необходимо, измените доступные свойства.
- Нажмите Сохранить, чтобы применить изменения.
Теперь это SOE включено на сервисе. Для отключения используйте переключатель рядом с SOE и нажмите кнопку Сохранить.
Включение SOI
После добавления SOI в вашу организацию, можно включить возможность для картографического сервиса или сервиса изображений. Для слоев изображений карты на странице сведений об элементе можно включить несколько SOI.
Включение нескольких SOI часто называют сцеплением. Создавая такое сцепление (или цепь), необходимо указать порядок, в котором SOI будут выполняться в сервисе.
Чтобы включить одно или несколько SOI со страницы сведений об элементе слоя, выполните следующие действия:
- Выполните вход в организацию как владелец элемента с правами публикации или как администратор.
- Откройте страницу сведений об элементе для слоя изображений карты.
- Щелкните Настройки.
- Прокрутите страницу до раздела Слой изображений карты и раскройте заголовок Расширения.
- Разверните заголовок Перехватчики серверных объектов (SOI).
Появится список SOI, которые были добавлены в вашу организацию.
- Включите кнопку-переключатель рядом с тем SOI, который хотите включить для сервиса.
- Если вы включаете несколько SOI, используйте функцию перетаскивания, чтобы указать порядок, в котором эти SOI будут запускаться в цепи.
SOI, расположенный в верхней части списка, будет запускаться первым.
Подсказка:
Можно в любой момент вернуться к этому диалоговому окну для изменения списка включенных SOI и порядка их выполнения в цепь.
- Разверните заголовок для каждого включенного вами SOI.
Появятся операции и свойства для SOI. Они были созданы по требованию разработчика расширения и обеспечивают более точный контроль над действиями пользователей с SOI.
- Если необходимо, выберите операции, которые вы хотели бы разрешить.
- Если необходимо, измените доступные свойства.
- Нажмите Сохранить, чтобы применить изменения.
Теперь эти SOI включены на сервисе. Для отключения используйте переключатель рядом с SOI и нажмите кнопку Сохранить.
Настройка параметров отладки
Для включения отладки ArcGIS Enterprise Managerпозволяет изменять поведение расширения. Вы можете приостановить запуск сервиса, чтобы прикрепить отладчик к процессу сервиса до того, как будут вызваны методы инициализации расширения. Также можно указать диапазон портов, которые будут использоваться при отладке сервиса.
Для доступа к этим параметрам отладки в Enterprise Manager выполните следующие действия:
- Войдите в ArcGIS Enterprise Manager как администратор.
- Щелкните кнопку Сервисы на боковой панели.
Появится страница сервисов.
- Найдите и щелкните имя сервиса, зарегистрированного на SOE.
- Выберите вкладку Дополнительно и включите режим отладки.
Настройки отладки расширения появляются после включения режима отладки.
- При необходимости включите Приостановить запуск сервиса и введите количество секунд, на которое запуск сервиса должен быть отложен.
- Также можно указать диапазон портов, который будет использоваться при отладке.
- Щелкните Сохранить.
Удаление расширения
При удалении расширения в ArcGIS Enterprise Manager он удаляется из вашей организации. Если расширение зарегистрировано в сервисе, то его удаление также приведет отмене его регистрации в этом сервисе.
Для удаления расширения выполните следующие действия:
- Войдите в ArcGIS Enterprise Manager как администратор.
- Щелкните кнопку Расширения на боковой панели.
Появится страница расширений.
- Щелкните кнопку Дополнительные опции
для расширения, которое вы хотите удалить, и щелкните Удалить. - Щелкните Удалить снова, чтобы подтвердить действие.
Расширение снимается с регистрации в сервисе и удаляется из организации.
Обновление расширения
Вы можете обновить расширение, которое было добавлено в вашу организацию, добавив его обновленный файл .soe.
Для обновления расширения выполните следующие действия:
- Войдите в ArcGIS Enterprise Manager как администратор.
- Щелкните кнопку Расширения на боковой панели.
Появится страница расширений.
- Щелкните кнопку Расширения для расширения, которое вы хотите обновить, и щелкните Обновить.
- Щелкните Выбрать файл и выберите обновленную версию файла .soe.
Имя файла должно совпадать с исходным именем файла .soe.
- Щелкните Обновить расширение.
Расширение обновляется новым файлом .soe.