Руководство пользователя: Публикация дополнительных сервисов для печати
В этом разделе
- Регистрация папки шаблонов компоновок в
ArcGIS for Server - Подготовка и публикация сервиса
- Обновление шаблонов компоновки
В некоторых случаях, помимо сервиса PrintingTools, включенного в ArcGIS for Server, вам может понадобиться опубликовать дополнительные сервисы веб-печати. Например, можно создать новый сервис и настроить его для ссылки на собственную папку компоновок карты. Можно также опубликовать один бесплатный сервис, а другой, расширенный сервис, за плату.
Чтобы создать собственный сервис для печати, необходимо опубликовать сервис геообработки с помощью инструмента Экспорт веб-карты (Export Web Map). В данном руководстве пошагово описывается этот процесс.
Регистрация папки шаблонов компоновок в ArcGIS for Server
При работе с этим руководством вы будет использовать папку документов ArcMap (MXD), в которой подготовлены различные компоновки для печати веб-карт. Это папка шаблонов компоновок.
Если папка шаблонов компоновок в данный момент находится на сервере или доступна серверу, зарегистрируйте ее в ArcGIS for Server. Чтобы узнать, как зарегистрировать папку на сервере, ознакомьтесь с разделом Регистрация данных в ArcGIS for Server с помощью ArcGIS for Desktop.
Если невозможно поместить папку шаблонов компоновок на сервер или в местоположение, доступное серверу, никаких дополнительных действий предпринимать не требуется. Папка шаблонов компоновок будет скопирована на сервер при публикации сервиса, что обеспечит доступность серверу этой папки. Несмотря на то, что этот вариант более прост в настройке, для последующего обновления шаблонов компоновок придется предпринимать дополнительные действия.
Подготовка и публикация сервиса
Первым действием для публикации является запуск инструмента Экспорт веб-карты со значениями по умолчанию, которые следует использовать для сервиса. Затем можно опубликовать результат инструмента в качестве сервиса геообработки.
- В ArcCatalog или окне Каталог в приложении ArcMap перейдите по следующему пути: Наборы инструментов (Toolboxes) > Системные наборы инструментов (System Toolboxes) > Инструменты сервера (Server Tools) > Печать (Printing).
- Двойным щелчком откройте инструмент Экспорт веб-карты (Export Web Map).
- Оставьте параметр Веб-карта как JSON (Web Map as JSON) пустым.
Чтобы напечатать изображения, пользователи этого сервиса будут предоставлять в качестве значения этого параметра свои веб-карты JSON. Виджеты печати в веб-интерфейсах ArcGIS API, Portal for ArcGIS шаблоны веб-приложений и Web AppBuilder for ArcGIS создают этот JSON в фоновом режиме.
- Оставьте заданное по умолчанию значение для параметра Выходной файл (Output File). После публикации этого инструмента на сервере выходные данные будут помещены в каталог заданий сервера.
- Предоставьте параметр Папка шаблонов компоновки, нажав кнопку обзора и перейдя в папку, где расположены компоновки.
Подсказка:
Если необходимо предоставить ссылку на базовые компоновки, установленные вместе с ArcGIS for Server, оставьте данный параметр пустым.
- Дополнительно следует задать значение для параметра Шаблон компоновки (Layout Template), выбрав одну из компоновок в раскрывающемся списке. При использовании вашего сервиса это будет компоновка по умолчанию.
- Щелкните OK, чтобы запустить инструмент.
- Щелкните Геообработка (Geoprocessing) > Результаты для отображения окна Результаты.
- Разверните пункт Текущий сеанс (Current Session), щелкните правой кнопкой мыши только что полученный результат ExportWebMap и выберите Общий доступ как (Share As) > Сервис геообработки (Geoprocessing Service).
- Выберите Опубликовать сервис и нажмите Далее.
- Выберите подключение к ArcGIS for Server (или нажмите кнопку для добавления нового подключения) и присвойте сервису имя. Затем щелкните кнопку Далее.
- Выберите папку, в которой будет размещен этот сервис. Невозможно опубликовать сервис в существующие папки System или Utilities. Необходимо использовать свою папку или корневую папку.
Завершив выбор папки, щелкните кнопку Продолжить (Continue).
Открывается Редактор сервисов (Service Editor), в котором можно выполнить подготовительные работы, прежде чем опубликовать сервис, например, настроить доступные варианты значений параметров для использования в сервисе.
- Щелкните пункт Параметры (Parameters) и убедитесь, что Режим выполнения (Execution Mode) сервиса задан как Синхронный (Synchronous). Можно выбрать значение Асинхронный (Asynchronous), если запросы будут выполняться дольше нескольких секунд. Сервисы печати для Portal for ArcGIS должны быть Синхронными.
- В редакторе сервисов (Service Editor) найдите левую панель, на которой указан каждый параметр инструмента (Веб-карта как JSON (Web Map as JSON), Выходной файл (Output File), Формат (Format), Папка шаблонов компоновок (Layout Templates Folder) и Шаблон компоновки (Layout Template)). Щелкните каждый из этих параметров и изучите заданные по умолчанию значения. Если необходимо изменить значения по умолчанию, следует вернуться к диалоговому окну инструмента Экспорт веб-папок и задать значения там, как это делалось на предыдущих этапах настоящего руководства. Можно полностью скрыть параметр от пользователей и вынудить их использовать параметр по умолчанию путем определения для параметра Режим ввода (Input mode) значения Постоянное значение (Constant value).
Внимание:
Вследствие известных ограничений инструмента Экспорт веб-карты (Export Web Map), доступные конечным пользователям значения параметров отфильтровать нельзя.
- Воспользуйтесь Редактором сервисов для определения других свойств, которые следует задать для сервиса, например минимальным и максимальным количеством экземпляров, которые могут работать на одном компьютере.
- Щелкните Опубликовать, чтобы опубликовать сервис.
Если получить предупреждение о копировании данных на сервер, щелкните кнопку ОК. Это приводит к копированию выходного изображения по умолчанию, что не является значительным объемом данных.
- Убедитесь, что сервис опубликован правильно, перейдя к нему в диспетчере или в каталоге сервисов.
Теперь на новый сервис можно ссылаться в виджетах печати, которые предоставляются веб-API ArcGIS. URL для сервиса печати можно найти в папке ArcGIS Services.
Чтобы применить пользовательский сервис печати в Portal for ArcGIS, скопируйте этот URL, включая задачу Экспорта веб-карты и вставьте в диалоговое окно Служебные сервисы в разделе Печать. Обратите внимание, что для сервиса печати портал воспринимает только URL-адреса, которые используют протокол HTTPS.
Обновление шаблонов компоновки
Если необходимо обновить компоновки в папке шаблонов компоновки, соответствующий рабочий процесс определяется в зависимости от того, зарегистрирована ли папка шаблонов компоновки на сервере до публикации (см. предыдущий раздел "Регистрация шаблонов компоновки в ArcGIS for Server").
Обновление папки шаблонов компоновки при регистрации ее в ArcGIS for Server
Если зарегистрировать папку шаблонов компоновки на сервере, это будет означать доступность компоновок для сервера. Если вы вносите обновления в файлы MXD в папке, то ваши изменённые компоновки тут же станут доступными. Если вы добавляете новую компоновку в папку шаблонов, то вам необходимо перезапустить сервис печати прежде, чем вы сможете получить доступ и использовать компоновку.
Обновление папки шаблонов компоновки без регистрации ее в ArcGIS for Server
Если папка шаблонов компоновки не была зарегистрирована на сервере, компоновки копируются на сервер в момент публикации. Необходимо перезаписать сервис для обновления шаблонов на сервере. Выполните следующие действия для выполнения перезаписи.
- В ArcMap откройте инструмент Экспорт веб-карты (Export Web Map) и выполните его с помощью необходимых значений по умолчанию, как описано в предыдущем разделе.
- Щелкните правой кнопкой мыши результаты геообработки и выберите Общий доступ как > Сервис геообработки.
- Выберите опцию Перезаписать существующий сервис и щелкните Далее.
- Щелкните имя сервиса, который необходимо перезаписать, затем нажмите Продолжить.
- В редакторе сервисов убедитесь, что все свойства сервиса заданы в соответствии с вашими предпочтениями (значения свойств по умолчанию – это значения, заданные при исходной публикации сервиса). Затем щелкните кнопку Опубликовать.
Все опции, заданные во время первой публикации, будут перезаписаны новыми. Папка шаблонов компоновки (включая обновления) копируется на сервер и заменяет папку шаблонов компоновки, которая была помещена там при первой публикации сервиса.