Если вам необходимы возможности печати в ArcGIS Enterprise, находящиеся вне пределов возможностей сервиса PrintingTools по умолчанию, вы можете создать собственные компоновки в ArcGIS Pro. Вы можете либо опубликовать эти компоновки на портале как веб-инструмент или опубликовать их на сайте автономного ArcGIS Server как сервис геообработки. Такие сервисы геообработки называются сервисами печати.
Не следует обновлять компоновки, поставляемые с сервисом PrintingTools по умолчанию, а также добавлять новые компоновки и повторно публиковать этот сервис. Вместо этого запустите инструмент-скрипт Экспорт веб-карты в ArcGIS Pro и опубликуйте результат, который будет использоваться, как дополнительный ресурс при печати веб-карты.
Если вы публикуете веб-инструмент на портале, результат данного упражнения будет публиковаться на том портале ArcGIS Enterprise, на который вы выполнили вход, и сервис печати, лежащий в основе веб-инструмента, будет сохранен на выбранном интегрированном ArcGIS Server .
Если вы работаете с сайтом отдельного сервера, результатом данного упражнения будет сервис печати, основанный на инструментах Экспорт веб-карты и Получить информацию о шаблонах компоновки, запускаемых в ArcGIS Pro.
Создание пользовательской компоновки
Если вы хотите создать шаблон пользовательской компоновки, это можно сделать в ArcGIS Pro. См. раздел Компоновки в ArcGIS Pro для получения подробной информации. Сохранение компоновки в папке: На вкладке Общий доступ в группе Сохранить как щелкните Файл компоновки. Или, щелкните компоновку правой кнопкой мыши на панели Каталог и выберите Сохранить как файл компоновки.
Примечание:
Для поддержки пользовательских компоновок, созданных в ArcGIS Pro 3.0 и более поздних версий, в вашей организации должен использоваться ArcGIS Server версии не ранее 11.0.
Подготовка компоновок
Есть несколько рекомендаций для создания компоновок в ArcGIS Pro, которые будут использованы в портале ArcGIS Enterprise:
- Если у вас имеется более одного фрейма карты в компоновке, выберите фрейм карты, который вы хотите использовать в веб-инструменте, и назовите его WEBMAP_MAP_FRAME (имя чувствительно к регистру). Сервис печати будет использовать фрейм карты, имеющий это имя.
- Вставьте динамический текст, такой как заголовок, имя автора, и т.д. Более подробно о динамическом тексте см. Что такое динамический текст? в документации ArcGIS Pro. Для вставки динамического текста выполните следующие действия:
- На вкладке Вставка на ленте, выберите команду Текст в группе Текст.
- Щелкните местоположение в компоновке, чтобы разместить новый текстовый элемент.
- Откройте страницу Свойство для текстового элемента.
- Добавьте один из следующих тегов в свойство Текст выбранного элемента:
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}.
- Если вы вставляете масштабную линейку, рекомендуется выбрать опцию Вычислить в центре, которая вычисляет масштаб карты, используя центр фрейма вместо местоположения вдоль экватора. Эта опия не рекомендуется для текста масштаба (например, 1:3000).
- В версии 11.2 появилась возможность добавлять в компоновку атрибуты и статистику в виде элементов динамического текста.
Внимание:
Не вставляйте динамический текст Имя пользователя в компоновку. Этот динамический текст будет заполнен информацией о сервисе печати.
Регистрация папки шаблонов компоновки в ArcGIS Server
Папка, содержащая шаблоны компоновок должны быть доступна для ArcGIS Server (интегрированного с порталом или автономного). Если папка доступна для сервера, вы можете зарегистрировать её на сервере; в противном случае, скопируйте содержимое папки на сервер из ArcGIS Pro при публикации веб-инструмента или сервиса печати.
Подробные инструкции см. в разделе Управление зарегистрированными хранилищами данных в справке ArcGIS Pro.
Подготовка пользовательских инструментов
Когда все подготовлено, запустите инструмент-скрипт Экспорт веб-карты, используя папку, содержащую ваши шаблоны пользовательских компоновок. Далее, запустите инструмент-скрипт Получить информацию шаблонов компоновки, ссылаясь на ту же папку.
- На панели Геообработка перейдите в Наборы инструментов > Серверные инструменты > Печать.
- Двойным щелчком откройте инструмент Экспорт веб-карты.
- Оставьте параметр Веб-карта как JSON равным значению #.
Чтобы напечатать изображения, пользователи этого сервиса будут предоставлять в качестве значения этого параметра свои веб-карты JSON. Виджеты печати в веб-интерфейсах ArcGIS API, шаблонах приложений ArcGIS Enterprise и ArcGIS Web AppBuilder создают этот JSON.
- Оставьте параметр Выходной файл без изменений.
После публикации этого инструмента на сервере выходные данные будут помещены в каталог заданий сервера.
- Задайте параметр Папка шаблонов компоновки, нажав кнопку обзора и перейдя в папку, где расположены компоновки.
Подсказка:
Если необходимо только предоставить ссылку на базовые компоновки, установленные вместе с ArcGIS Enterprise, оставьте данный параметр пустым.
- Дополнительно выберите компоновку из ниспадающего списка Шаблон компоновки.
При использовании вашего сервиса это будет компоновка по умолчанию.
- Нажмите Запустить для запуска инструмента.
- Перейдите в Наборы инструментов > Инструменты сервера > Печать и дважды щелкните инструмент-скрипт Get Layout Templates Info, чтобы открыть его.
- Легенда
- Текст заголовка
- Информация об авторских правах
- Информация об авторе
- Пользовательские текстовые элементы
- Выберите ту же папку для Папки шаблонов компоновки, которую вы указывали при запуске инструмента Экспорт веб-карты на шаге 5. Щёлкните Запустить для запуска скрипта.
Инструмент-скрипт Получить информацию шаблонов компоновки позволяет добавить в сервисы печати задачу Получить информацию шаблонов компоновки. В этой задаче предусмотрены размер страницы компоновки и размер фрейма карты. Она также показывает, доступны ли следующие элементы компоновки:
Теперь необходимо запустить два инструмента геообработки с пользовательскими компоновками, результаты можно опубликовать на ArcGIS Enterprise. Следующий рабочий процесс зависит от того, работаете ли вы на портале ArcGIS Enterprise (с одним или несколькими интегрированными сайтами сервера) или с отдельным сайтом сервера.
Использование пользовательских шаблонов печати на портале ArcGIS Enterprise
Шаблоны компоновок (.pagx) и шаблоны отчетов (.rptt) можно загружать в качестве элементов портала, которые в дальнейшем можно отправлять на отдельные сервисы печати. Для загрузки пользовательского шаблона печати выполните следующие действия:
- Создайте шаблон компоновки или отчета в ArcGIS Pro.
- Сохраните шаблон в файле .pagx, или .rptt.
- Войдите на ваш портал.
- Щелкните Ресурсы.
- Щелкните Новый элемент.
- Либо перетащите файл шаблона , либо щелкните Ваше устройство и выберите нужный файл.
Дополнительную информацию см. в разделах Создание пользовательского шаблона отчета и Файлы компоновок.
Если в вашей организации настроена пользовательская группа шаблонов компоновки, вы можете поделиться шаблонами с группой, чтобы сделать их доступными для печати в Map Viewer.
Ограничения
При использовании пользовательских шаблонов печати существуют следующие ограничения:
- Элементы должны находиться на том же портале, где находится сервер сервисов печати. Например, сервис печати, работающий на портале A, не может получить доступ к элементу с портала B.
- Используемые по умолчанию сервисы печати готового сервиса печати и ArcGIS GIS Server не поддерживают эту возможность.
- Веб-клиенты в настоящее время не поддерживают эту возможность. Вместо этого необходимо написать собственный JavaScript Maps SDK.
Публикация сервисов печати на портале ArcGIS Enterprise для создания отчетов
В версии 11.2 появилась возможность публиковать сервисы печати из ArcGIS Pro 3.2 и выше, чтобы обеспечить печать отчетов, на основе шаблонов компоновок (.pagx), шаблонов отчетов (.rptx) или и тех, и других.
Типы отчетов
Существует три типа отчетов, которые можно сформировать с помощью сервиса печати:
- Компоновки с элементами динамического текста - одностраничный формат вывода, включающий карту и атрибуты и статистику, которые отображаются с помощью элементов динамического текста.
- Отчеты без карт - многостраничный формат вывода, который может содержать атрибуты, статистику, диаграммы и вложения. Поддерживается только формат PDF.
- Компоновки с элементами динамического текста или без них и отчет - многостраничный формат вывода, содержащий как компоновку, так и отчет. Поддерживается только формат PDF.
Публикация отчета
Для публикации отчета выполните следующие действия:
- Создайте шаблон Компоновки с элементами динамического текста или шаблон Отчета в ArcGIS Pro.
- Сохраните шаблон в виде шаблона Компоновки (.pagx) или Отчета (.rptx) в своей папке с файлами шаблонов.
- В ArcGIS Pro откройте инструмент Экспорт веб-карты.
- Установите параметр Layout Templates Folder в папку с файлами шаблонов, в которую вы сохранили свой шаблон.
- Запустите инструмент Экспорт веб-карты.
- Перейдите к Наборы инструментов > Инструменты сервера > Печать и дважды щелкните инструменты-скрипты Get Layout Templates Info или Get Report Templates Info, в зависимости от того, какой тип отчета вы публикуете: компоновки, отчеты или и те, и другие.
- Опубликуйте свои шаблоны как сервис печати.
Ограничения
При использовании отчетов существуют следующие ограничения:
- Используемые по умолчанию сервисы печати готового сервиса печати и ArcGIS GIS Server не поддерживают эту возможность.
- Map Viewer и ArcGIS Experience Builder не поддерживают эту возможность.
- Веб-клиенты в настоящее время не поддерживают эту возможность. Вместо этого необходимо использовать JavaScript Maps SDK для создания пользовательского приложения или виджета.
Публикация веб-инструмента печати на портале ArcGIS Enterprise
Если вы работаете с порталом ArcGIS Enterprise, выполните следующие шаги, чтобы опубликовать результаты работы инструмента геообработки на портале в виде веб-инструмента:
- На вкладке Анализ на ленте, щелкните История, или щелкните вкладку История на панели Каталог. Щелкните правой кнопкой мыши результат инструмента Экспорт веб-карты и выберите Опубликовать как > Веб-инструмент.
Откроется диалоговое окно Опубликовать как веб-инструмент.
- Используйте опцию Анализировать для определения любых возможных проблем.
- На вкладке Общие в диалоговом окне замените значения по умолчанию в Информации об элементе (имя, краткую информацию и теги) должным образом. Если вы зарегистрировали папку шаблонов компоновки на сервере, как описано выше, выберите опцию Ссылаться на зарегистрированные данные; в противном случае выберите Копировать все данные. Выберите папку портала, в которую вы хотите сохранить веб-инструмент, а также интегрированный сайт ArcGIS Server и папку сервера, в которую вы хотите сохранить используемый инструментом сервис геообработки. Затем задайте опции публикации для этого веб-инструмента.
- Перейдите на вкладку Настройка. Укажите Режим выполнения для инструмента в разделе Параметры. В большинстве случаев вам подойдет Синхронный. Выберите Асинхронный режим, если вы ожидаете, что запросы к инструменту будут занимать более нескольких секунд (например, печать большой детализированной карты). Затем задайте Уровень сообщений для записей в журнале для данного инструмента.
- Перейдите на вкладку Содержание. Нажмите Добавить инструмент и добавьте результат Получить информацию шаблонов компоновки.
Оба инструмента, которые вы запускали, теперь встроены в этот веб-инструмент.
- Щелкните Опубликовать для публикации веб-инструмента.
- Проверьте, что ваш веб-инструмент опубликован правильно.
Веб-инструмент доступен на вашем портале ArcGIS Enterprise и используемый им сервис геообработки доступен в ArcGIS Server Manager.
Теперь на новый веб-инструмент можно ссылаться в виджетах печати, которые предоставляются веб-интерфейсами ArcGIS API, а также во Вьюере карт портала. Адрес URL для веб-инструмента доступен на странице его элемента на портале ArcGIS Enterprise.
Веб-инструмент поддерживается пользовательским сервисом на интегрированном сайте ArcGIS Server. Вы можете настроить этот сервис в качестве сервиса печати вашего портала ArcGIS Enterprise. Откройте ArcGIS Server Manager и найдите сервис, затем скопируйте этот URL, включая задачу Экспорта веб-карты и вставьте URL в диалоговое окно Служебные сервисы в разделе Печать.
Публикация сервиса печати на автономном сервере
Если вы работаете с отдельным сайтом ArcGIS Server версии 10.6 или более новой, можно опубликовать сервис печати из ArcGIS Pro на сервере с помощью следующих шагов.
- Добавьте административное подключение к сайту ArcGIS Server.
Для публикации сервисов геообработки на автономном сервере подключение должно быть административным.
- На панели Каталог щелкните подключение к серверу правой кнопкой и выберите Опубликовать. Используйте опцию Сервис геообработки для запуска окна Выбрать элементы истории. Выберите элемент Экспорт веб-карты из списка, чтобы открыть окно Опубликовать сервис геообработки.
- Используйте опцию Анализировать для определения любых возможных проблем.
- На вкладке Общие в диалоговом окне замените значения по умолчанию в Информации об элементе (имя, краткую информацию и теги) должным образом. Если вы зарегистрировали папку шаблонов компоновки на сервере, как описано выше, выберите опцию Ссылаться на зарегистрированные данные; в противном случае выберите Копировать все данные. Выберите папку сервера, в которой будет сохранен базовый сервис геообработки. Затем задайте опции публикации для этого веб-инструмента.
- Перейдите на вкладку Настройка. Укажите Режим выполнения для инструмента в разделе Параметры. В большинстве случаев вам подойдет Синхронный. Выберите Асинхронный режим, если вы ожидаете, что запросы к сервису печати будут занимать более нескольких секунд (например, печать большой детализированной карты). Затем задайте Уровень сообщений для записей в журнале для данного инструмента.
- Перейдите на вкладку Содержание. Нажмите Добавить инструмент и добавьте результат Получить информацию шаблонов компоновки.
Оба инструмента, которые вы запускали, теперь встроены в этот сервис печати.
- Щелкните Опубликовать, чтобы начать публикацию сервиса печати.
- Проверьте, что сервис опубликован правильно.
Доступно в ArcGIS Server Manager.
Теперь на новый сервис можно ссылаться в виджетах печати, которые предоставляются веб-интерфейсами ArcGIS API. URL для сервиса печати можно найти в папке ArcGIS Services.
Чтобы зарегистрировать пользовательский сервис печати на портале ArcGIS Enterprise, скопируйте этот URL, включая задачу Экспорта веб-карты, и вставьте в диалоговое окно Служебные сервисы в разделе Печать. Обратите внимание, что для сервиса печати портал воспринимает только URL-адреса, которые используют протокол HTTPS.
Обновление шаблонов компоновки
Если необходимо обновить компоновки в папке шаблонов компоновки, соответствующий рабочий процесс определяется в зависимости от того, зарегистрирована ли папка шаблонов компоновки на сервере до публикации (см. раздел Регистрация шаблонов компоновки в ArcGIS Server выше). Также имеет значение, хотите ли вы добавить компоновку в папку или обновить существующую компоновку. Это важно, поскольку задача геообработки, которую вы создали, сохраняет список компоновок, которые содержались в папке шаблонов компоновок на момент выполнения.
Если зарегистрировать папку шаблонов компоновки на сервере перед публикацией, это будет означать доступность компоновок для сервера. Если вы вносите обновления в существующие файлы компоновки (.pagx) в папке, то ваши изменённые компоновки тут же станут доступными. Однако сервер не увидит новые компоновки, которые вы добавили после публикации.
Соответственно, если верно что-либо из следующего, необходимо снова выполнить рабочий процесс и опубликовать новый веб-инструмент или сервис печати, чтобы изменения стали доступными для пользователей ArcGIS Server:
- Вы не зарегистрировали папку шаблонов компоновки на сервере перед публикацией веб-инструмента или сервиса печати, что означает, что компоновки были скопированы на сервер в момент публикации.
- После публикации веб-инструмента или сервиса печати, можно добавить новый шаблон компоновки в папку и сделать его доступным для пользователей.