Публикация пользовательских компоновок для печати из 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 создают этот JSON.

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

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

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

   Подсказка:

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

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

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

7. Нажмите Запустить для запуска инструмента.

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

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

   • Легенда

   • Текст заголовка

   • Информация об авторских правах

   • Информация об авторе

   • Пользовательские текстовые элементы

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

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

Используйте пользовательские шаблоны печати в ArcGIS Enterprise

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

1. Создайте шаблон компоновки или отчета в ArcGIS Pro.

2. Сохраните шаблон в файле .pagx или .rptt.

3. Войдите в вашу организацию.

4. Щелкните Ресурсы.

5. Щелкните Новый элемент.

6. Либо перетащите файл шаблона, либо щелкните Ваше устройство и выберите нужный файл.

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

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

Ограничения

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

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

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

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

Типы отчетов

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

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

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

  Примечание:

  Чтобы сгенерировать отчет без карты, необходимо задать Шаблон отчета и задать параметру Шаблон компоновки значение MAP_ONLY.

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

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

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

1. Создайте шаблон Компоновки с элементами динамического текста или шаблон Отчета в ArcGIS Pro.

2. Сохраните шаблон в виде шаблона Компоновки (.pagx) или Отчета (.rptx) в своей папке с файлами шаблонов.

3. В ArcGIS Pro откройте инструмент Экспорт веб-карт.

4. Установите параметр Layout Templates Folder в папку с файлами шаблонов, в которую вы сохранили свой шаблон.

5. Запустите инструмент Экспорт веб-карты.

6. Зайдите в Наборы инструментов > Инструменты сервера > Печать и дважды щелкните инструмент-скрипт Получить информацию шаблонов компоновки или Получить информацию шаблонов отчетов, в зависимости от того, публикуете ли вы компоновки, отчёты или и то, и другое.

7. Опубликуйте свои шаблоны как сервис печати.

Ограничения

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

• Используемые по умолчанию сервисы печати готового сервиса печати и ГИС-сервер ArcGIS не поддерживают эту возможность.

• 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 web API, а также в Map Viewer. Адрес URL для веб-инструмента доступен на странице его элемента в организации.

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

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

Если вы работаете с автономным сайтом ArcGIS Server, вы можете опубликовать сервис печати из 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:

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

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