Skip To Content

Публикация веб-инструмента сервиса печати с пользовательскими компоновками из ArcGIS Pro

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

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

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

Этот раздел сходен с разделом Публикация дополнительных сервисов для печати в ArcMap. Однако данный раздел использует ArcMap для публикации сервиса геообработки на вашем сервере; данный раздел использует ArcGIS Pro для публикации веб-инструмента на вашем портале.

Создание пользовательской компоновки

Если вы хотите создать шаблон пользовательской компоновки, это можно сделать в ArcGIS Pro. См. раздел Компоновки в ArcGIS Pro для получения подробной информации. Сохранение новой компоновки в папке: На вкладке Общий доступ в группе Сохранить как щелкните Файл компоновки. Или, щелкните компоновку правой кнопкой мыши на панели Каталог и выберите Сохранить как файл компоновки.

Важные моменты при подготовке ваших компоновок

Есть несколько рекомендаций для создания компоновок в ArcGIS Pro, которые будут использованы в портале ArcGIS Enterprise:

  • Если у вас имеется более одного фрейма карты в компоновке, выберите фрейм карты, который вы хотите использовать в веб-инструменте, и назовите его WEBMAP_MAP_FRAME (имя чувствительно к регистру). Сервис, используемый инструментом, будет использовать фрейм карты, имеющий это имя.
  • Вставьте динамический текст, такой как заголовок, имя автора, и т.д. Более подробно о динамическом тексте см. Что такое динамический текст? в документации ArcGIS Pro. Для этого следует выполнить следующие действия.
    1. На вкладке Вставка на ленте, выберите команду Текст в группе Текст.
    2. Щелкните местоположение в компоновке, чтобы разместить новый текстовый элемент.
    3. Откройте страницу Свойство для текстового элемента.
    4. Добавьте один из следующих тегов в свойство Текст выбранного элемента:

      titleText

      <dyn type="layout" property="metadata" attribute="title" emptyStr=""/>

      authorText

      <dyn type="layout" property="metadata" attribute="contactname" emptyStr=""/>

      copyrightText

      <dyn type="layout" property="metadata" attribute="credits" emptyStr=""/>
  • Вы также можете добавить элемент динамического текста Текущее время из категории Система в ниспадающем списке Динамический текст. Он также расположен в группе Текст на ленте Вставка.
  • Если вы хотите вставить пользовательский текстовый элемент, добавьте текстовый элемент и окружите имя элемента открывающимися и закрывающимися фигурными скобками, такими как {parcel-id}.
Внимание:

Не вставляйте динамический текст Имя пользователя в компоновку. Этот динамический текст будет заполнен информацией о сервисе печати.

Регистрация папки шаблонов компоновок в ArcGIS Server

Чтобы создать и опубликовать веб-инструмент в ArcGIS Enterprise, папка, содержащая ваши шаблоны компоновок, должна быть доступна для ArcGIS Server. Если папка доступна для сервера, вы можете зарегистрировать её на сервере; в противном случае, скопируйте содержимое папки на сервер из ArcGIS Pro при публикации веб-инструмента.

Подробные инструкции см. в разделе Управление зарегистрированными хранилищами данных в справке ArcGIS Pro.

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

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

  1. На панели Геообработка перейдите в Наборы инструментов > Серверные инструменты > Печать.
  2. Двойным щелчком откройте инструмент Экспорт веб-карты.
  3. Оставьте параметр Веб-карта как JSON равным значению #.

    Чтобы напечатать изображения, пользователи этого сервиса будут предоставлять в качестве значения этого параметра свои веб-карты JSON. Виджеты печати в веб-интерфейсах ArcGIS API, шаблонах приложений ArcGIS Enterprise и в Web AppBuilder for ArcGIS создают этот JSON.

  4. Оставьте параметр Выходной файл без изменений.

    После публикации этого инструмента на сервере выходные данные будут помещены в каталог заданий сервера.

  5. Задайте параметр Папка шаблонов компоновки, нажав кнопку обзора и перейдя в папку, где расположены компоновки.
    Подсказка:

    Если необходимо только предоставить ссылку на базовые компоновки, установленные вместе с ArcGIS Enterprise, оставьте данный параметр пустым.

  6. Дополнительно выберите компоновку из ниспадающего списка Шаблон компоновки.

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

  7. Нажмите Запустить для запуска инструмента.
  8. Перейдите в Наборы инструментов > Инструменты сервера > Печать и дважды щелкните инструмент-скрипт Получить информацию шаблонов компоновки, чтобы открыть его.
  9. Инструмент-скрипт Получить информацию шаблонов компоновки позволяет добавить в сервисы печати задачу Получить информацию шаблонов компоновки. В этой задаче предусмотрены размер страницы компоновки и размер фрейма карты. Она также показывает, доступны ли следующие элементы компоновки:

    • Легенда
    • Текст названия
    • Информация об авторских правах
    • Информация об авторе
    • Пользовательские текстовые элементы

  10. Выберите ту же Папку шаблонов компоновки, которую вы указывали при запуске инструмента Экспорт веб-карты в шаге 5. Щёлкните Запустить для запуска скрипта.
  11. На вкладке Анализ на ленте, щелкните История, или щелкните вкладку История на панели Каталог. Щелкните правой кнопкой мыши результат инструмента Экспорт веб-карты и выберите Опубликовать как > Веб-инструмент.

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

  12. Используйте опцию Анализировать для определения любых возможных проблем.
  13. На вкладке Общие в диалоговом окне замените значения по умолчанию в Информации об элементе (имя, краткую информацию и теги) должным образом. Если вы зарегистрировали папку шаблонов компоновки на сервере, как описано выше, выберите опцию Ссылаться на зарегистрированные данные; в противном случае выберите Копировать все данные. Выберите папку портала, в которую вы хотите сохранить веб-инструмент, а также интегрированный сайт ArcGIS Server и папку сервера, в которую вы хотите сохранить используемый инструментом сервис геообработки. Затем задайте опции публикации для этого веб-инструмента.
  14. Перейдите на вкладку Настройка. Укажите Режим выполнения для инструмента в разделе Параметры. В большинстве случаев вам подойдет Синхронный. Выберите Асинхронный режим, если вы ожидаете, что запросы к инструменту будут занимать более нескольких секунд (например, печать большой детализированной карты). Затем задайте Уровень сообщений для записей в журнале для данного инструмента.
  15. Перейдите на вкладку Содержание. Нажмите Добавить инструмент и добавьте результат Получить информацию шаблонов компоновки.

    Оба инструмента, которые вы запускали, теперь встроены в этот веб-инструмент.

  16. Щелкните Опубликовать для публикации веб-инструмента.
  17. Убедитесь, что веб-инструмент опубликован корректно; он должен быть доступен на вашем портале ArcGIS Enterprise и используемый им сервис геообработки должен быть доступен в ArcGIS Server Manager.

Теперь на новый веб-инструмент можно ссылаться в виджетах печати, которые предоставляются веб-интерфейсами ArcGIS API, а также во Вьюере карт портала. Адрес URL для веб-инструмента доступен на странице его элемента на портале ArcGIS Enterprise.

Веб-инструмент поддерживается пользовательским сервисом на интегрированном сайте ArcGIS Server. Вы можете настроить этот сервис в качестве сервиса печати вашего портала ArcGIS Enterprise. Откройте ArcGIS Server Manager, найдите этот сервис, затем скопируйте этот URL, включая задачу Экспорта веб-карты и вставьте URL в диалоговое окно Служебные сервисы в разделе Печать.

Обновление шаблонов компоновки

Если необходимо обновить компоновки в папке шаблонов компоновки, соответствующий рабочий процесс определяется в зависимости от того, зарегистрирована ли папка шаблонов компоновки на сервере до публикации (см. раздел «Регистрация шаблонов компоновки в ArcGIS Server" выше). Также имеет значение, хотите ли вы добавить новую компоновку в папку, или просто обновить существующую компоновку. Это важно, поскольку задача геообработки, которую вы создали, сохраняет список компоновок, которые содержались в папке шаблонов компоновок на момент выполнения.

Если зарегистрировать папку шаблонов компоновки на сервере перед публикацией, это будет означать доступность компоновок для сервера. Если вы вносите обновления в существующие файлы компоновки (.pagx) в папке, то ваши изменённые компоновки тут же станут доступными. Однако сервер не увидит новые компоновки, которые вы добавили после публикации веб-инструмента.

Соответственно, если любое из следующего верно, вам необходимо заново выполнить рабочий процесс выше и опубликовать новый веб-инструмент для того, чтобы изменения были доступны для пользователей вашего ArcGIS Server:

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