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

Если вам необходимы возможности печати в 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. Для вставки динамического текста выполните следующие действия:
  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}.
• Если вы вставляете масштабную линейку, рекомендуется выбрать опцию Вычислить в центре, которая вычисляет масштаб карты, используя центр фрейма вместо местоположения вдоль экватора. Эта опия не рекомендуется для текста масштаба (например, 1:3000).
• В версии 11.2 появилась возможность добавлять в компоновку атрибуты и статистику в виде элементов динамического текста.

Внимание:

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

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

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

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

Подготовка пользовательских инструментов

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

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

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

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

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

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

   Подсказка:

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

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

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

7. Нажмите Запустить для запуска инструмента.
8. Перейдите в Наборы инструментов > Инструменты сервера > Печать и дважды щелкните инструмент-скрипт Get Layout Templates Info, чтобы открыть его.

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

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

9. Выберите ту же папку для Папки шаблонов компоновки, которую вы указывали при запуске инструмента Экспорт веб-карты на шаге 5. Щёлкните Запустить для запуска скрипта.

Теперь необходимо запустить два инструмента геообработки с пользовательскими компоновками, результаты можно опубликовать на ArcGIS Enterprise. Следующий рабочий процесс зависит от того, работаете ли вы на портале ArcGIS Enterprise (с одним или несколькими интегрированными сайтами сервера) или с отдельным сайтом сервера.

Использование пользовательских шаблонов печати на портале ArcGIS Enterprise

Шаблоны компоновок (.pagx) и шаблоны отчетов (.rptt) можно загружать в качестве элементов портала, которые в дальнейшем можно отправлять на отдельные сервисы печати. Для загрузки пользовательского шаблона печати выполните следующие действия:

1. Создайте шаблон компоновки или отчета в ArcGIS Pro.
2. Сохраните шаблон в файле .pagx или .rptt.
3. Войдите на ваш портал.
4. Щелкните Ресурсы.
5. Щелкните Новый элемент.
6. Либо перетащите файл шаблона, либо щелкните Ваше устройство и выберите нужный файл.

Теперь шаблон можно отправить сервисам печати через параметры Layout_Item_ID и Report_Item_ID.

Дополнительную информацию см. в разделах Создание пользовательского шаблона отчета и Файлы компоновок.

Ограничения

При использовании пользовательских шаблонов печати существуют следующие ограничения:

• Элементы должны находиться на том же портале, где находится сервер сервисов печати. Например, сервис печати, работающий на портале A, не может получить доступ к элементу с портала B.
• Используемые по умолчанию сервисы печати готового сервиса печати и ArcGIS GIS Server не поддерживают эту возможность.
• Веб-клиенты в настоящее время не поддерживают эту возможность. Вместо этого необходимо написать собственный Javascript API.

Публикация сервисов печати на портале ArcGIS Enterprise для создания отчетов

В версии 11.2 появилась возможность публиковать сервисы печати из ArcGIS Pro 3.2 и выше, чтобы обеспечить печать отчетов, на основе шаблонов компоновок (.pagx), шаблонов отчетов (.rptx) или и тех, и других.

Типы отчетов

Существует три типа отчетов, которые можно сформировать с помощью сервиса печати:

• Компоновки с элементами динамического текста - одностраничный формат вывода, включающий карту и атрибуты и статистику, которые отображаются с помощью элементов динамического текста.
• Отчеты без карт - многостраничный формат вывода, который может содержать атрибуты, статистику, диаграммы и вложения. Поддерживается только формат PDF.
• Компоновки с элементами динамического текста или без них и отчет - многостраничный вариант вывода, содержащий как компоновку, так и отчет. Поддерживается только формат PDF.

Публикация отчета

Для публикации отчета выполните следующие действия:

1. Создайте Компоновку с элементами динамического текста или шаблон Отчета в ArcGIS Pro.
2. Сохраните шаблон в виде шаблона Компоновки (.pagx) или Отчета (.rptx) в папке с файлами шаблонов.
3. В ArcGIS Pro откройте инструмент Экспорт веб-карты.
4. Установите параметр Layout Templates Folder в папку с файлами шаблонов, в которую вы сохранили свой шаблон.
5. Запустите инструмент Экспорт веб-карты.
6. Перейдите к Наборы инструментов > Инструменты сервера > Печать и дважды щелкните инструмент-скрипт Get Layout Templates Info или Get Report Templates Info, в зависимости от того, какой тип отчета вы публикуете - Компоновки, Отчеты или и те, и другие.
7. Опубликуйте свои шаблоны как сервис Печати.

Ограничения

При использовании отчетов существуют следующие ограничения:

• Используемые по умолчанию сервисы печати готового сервиса печати и ArcGIS GIS Server не поддерживают эту возможность.
• Map Viewer и ArcGIS Experience Builder не поддерживают эту возможность.
• Веб-клиенты в настоящее время не поддерживают эту возможность. Вместо этого необходимо использовать Javascript API для создания пользовательского приложения или виджета.

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

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

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

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

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

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

6. Щелкните Опубликовать для публикации веб-инструмента.
7. Проверьте, что ваш веб-инструмент опубликован правильно.

   Веб-инструмент доступен на вашем портале 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 на сервере с помощью следующих шагов.

1. Добавьте административное подключение к сайту ArcGIS Server.

   Для публикации сервисов геообработки на автономном сервере подключение должно быть административным.

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

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

7. Щелкните Опубликовать, чтобы начать публикацию сервиса печати.
8. Проверьте, что сервис опубликован правильно.

   Он будет доступен в ArcGIS Server Manager.

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

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

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

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

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

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

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