Skip To Content

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

Уровень сложности: СреднийТребования к данным: Используйте собственные данные

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

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

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

Вы будете использовать подготовленную папку документов ArcMap (.mxd), в которой содержатся различные компоновки для печати веб-карт. Это папка шаблонов компоновок.

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

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

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

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

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

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

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

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

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

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

  10. Выберите ту же Папку шаблонов компоновки, которую вы указывали при запуске инструмента Экспорт веб-карты в шаге 5, и нажмите OK для запуска скрипта.
  11. Щелкните Геообработка > Результаты для отображения окна Результаты.
  12. Разверните пункт Текущий сеанс, щелкните правой кнопкой мыши результат Экспорт веб-карты и выберите Опубликовать как > Сервис геообработки.
  13. Выберите Опубликовать сервис и нажмите Далее.
  14. Выберите подключение к ArcGIS Server (или нажмите кнопку для добавления нового подключения), присвойте сервису имя и щелкните Далее.
  15. Выберите папку, в которой будет размещен этот сервис. Невозможно опубликовать сервис в существующие папки System или Utilities. Необходимо использовать свою папку или корневую папку. Нажмите Продолжить. Откроется Редактор сервисов, в котором можно выполнить подготовительные работы перед публикацией, например, задать доступные варианты параметров для использования в сервисе.
  16. Щелкните пункт Параметры и убедитесь, что Режим выполнения сервиса задан как Синхронный. Можно выбрать значение Асинхронный, если запросы будут выполняться дольше нескольких секунд. Сервисы печати, используемые в портале ArcGIS Enterprise должны быть Синхронными.
  17. Щелкните каждый параметр и изучите заданные по умолчанию значения. Если необходимо изменить значения по умолчанию, следует вернуться к диалоговому окну инструмента Экспорт веб-папок и задать значения там, как это делалось на предыдущих этапах настоящего руководства. Можно полностью скрыть параметр от пользователей и вынудить их использовать параметр по умолчанию путем определения для параметра Режим ввода значения Постоянное значение.
    Внимание:

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

  18. Нажмите Добавить инструмент и добавьте результат Получить информацию шаблонов компоновки из работающего инструмента-скрипта.
  19. Щелкните Опубликовать, чтобы опубликовать сервис.

    Если получить предупреждение о копировании данных на сервер, щелкните кнопку ОК. Это приводит к копированию выходного изображения по умолчанию, что не является значительным объемом данных.

  20. Убедитесь, что сервис опубликован правильно, перейдя к нему в диспетчере или в каталоге сервисов.

Теперь на новый сервис можно ссылаться в виджетах печати, которые предоставляются веб-интерфейсами ArcGIS API. URL для сервиса печати можно найти в папке ArcGIS Services.

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

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

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

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

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

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

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

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

  1. В ArcMap откройте инструмент Экспорт веб-карты и запустите его с помощью необходимых значений по умолчанию, как описано в предыдущем разделе.
  2. Щелкните правой кнопкой мыши результаты геообработки и выберите Опубликовать как > Сервис геообработки.
  3. Выберите опцию Перезаписать существующий сервис и щелкните Далее.
  4. Щелкните имя сервиса, который необходимо перезаписать, затем нажмите Продолжить.
    Примечание:

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

  5. В Редакторе сервисов убедитесь, что все свойства сервиса заданы в соответствии с вашими предпочтениями (значения свойств по умолчанию – это значения, заданные при исходной публикации сервиса), и щелкните Опубликовать.

Все опции, заданные во время первой публикации, будут перезаписаны новыми. Папка шаблонов компоновки (включая обновления) копируется на сервер и заменяет папку шаблонов компоновки, которая была помещена там при первой публикации сервиса.

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

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

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

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

Более подробно о создании эффективных компоновок см. в разделе Краткий обзор компоновок страниц.