Сервис Topographic Production

Лицензия:

Для использования этого ресурса требуется лицензия ArcGIS GIS Server Advanced и расширение сервера ArcGIS Topographic Mapping.

Сервис Topographic Production — это расширение серверного объекта (SOE) для картографичесого сервиса. Это позволяет выполнять возможности по производству топографических продуктов в картографическом сервисе, например, создавать топографические карты на основе отраслевых стандартных спецификаций карт.

Подробнее о Topographic Production Service

Узнайте больше о REST SOE

Подробнее о ArcGIS Server Services Directory

Публикация сервиса

Расширение Topographic Mapping в ArcGIS Pro позволяет публиковать Topographic Production Service.

Конфигурация в ArcGIS Server

Вы можете настроить операции, которые может выполнять сервис, и другие свойства в ArcGIS Server Manager после публикации сервиса. Эти настройки появляются, когда вы ставите отметку Topographic Production или нажимаете Topographic Production, и применяются только если отметка стоит.

Операции

В SOE поддерживаются следующие ресурсы и операции:

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

• calculateExtent — вычисляет пользовательскую область интереса (AOI) для данного продукта и версии.

• delete — удаляет задания, которые были выполнены или отменены, чтобы они больше не появлялись в запросах и не занимали место на сервере.

• generateProduct — автоматизирует процесс создания компоновки или карты на основе существующего определения картографического продукта.

• removeProduct — удаляет картографический продукт из сервиса Topographic Production.

• updateProduct — обновляет свойства существующего картографического продукта.

• products — получает картографические продукты, поддерживаемые сервисом Topographic Production.

  • product — получает единый картографический продукт из продуктов, которые поддерживает сервис Topographic Production.

• jobs — содержит операции, связанные с выполняемыми заданиями.

  • cancel — отменяет задание, отправленное с конечной точки generateProduct.

  • job — отслеживает статус задания, выполняемого конечной точкой generateProduct. Возвращает статус, дату начала, дату последнего изменения и сообщения для задания.

  • query — отслеживает статус заданий, выполняемых конечной точкой generateProduct. Возвращает статус, дату начала, дату последнего изменения и сообщения для набора заданий.

• workflows — содержит ресурсы и операции, связанные с топографическими производственными рабочими процессами, использующими ArcGIS Workflow Manager.

  • taskGroups — содержит операции, связанные с группами задач SOE.

    • addTaskGroup — объединяет определение рабочего процесса с необходимыми для организации конкретики в группу задач SOE, которая может использоваться операцией createTaskGroupJob для создания заданий SOE.

    • createTaskGroupJob — использует группу задач SOE для создания задания группы задач SOE, в результате чего появляется основное задание Workflow Manager и его дочерние задачи.

    • getTaskGroups — возвращает информацию о группе задач SOE.

    • insertTasks — вставляет набор задач в существующее задание производственной группы SOE.

    • removeTaskGroup — убирает группу задач SOE.

    • updateTaskGroup — обновляет группу задач SOE.

  • tasks — содержит операции, связанные с заданием группы задач.

    • updateTask — обновляет значения параметров задачи в задании группы задач.

    • executeTaskJob — выполняет задание группы задач SOE, созданное операцией createTaskGroupJob.

    • getTask — возвращает детали задания задачи SOE

  • projects — содержит операции, обеспечивающие интеграцию между топографическим производственным сервером и сервисными рабочими процессами Workflow Manager.

    • addProject — однопараметрическая операция, принимающая объект JSON, определяющий проект и все его фазы.

    • queryProject — возвращает массив объектов JSON, содержащий проекты.

    • removeProject — удаляет проект.

    • updateProject — обновляет свойства, заданные в JSON проекта.

База данных Topographic Production

База геоданных используется Topographic Production Service для хранения данных. Тип используемой базы геоданных определяется файлом подключения spatial database engine (SDE). В Server Manager путь к SDE-файлу подключения должен быть указан в текстовом поле Topographic Production Database. Учетная запись сервера ArcGIS должна иметь доступ к местоположению файла подключения .sde.

Подсказка:

Путь к этому файлу также можно указать, когда Topographic Production Service публикуется в ArcGIS Pro с помощью текстового поля tmserverDatabase.

Более подробно о публикации Topographic Production Service в ArcGIS Pro

База геоданных топографического сервера содержит несколько таблиц. Таблица TPS_Property содержит свойства, задаваемые при публикации сервиса из ArcGIS Pro и доступные из ArcGIS Server Manager после публикации сервиса. Таблица также хранит свойства каждого сервиса, опубликованного с включённым topographic production SOE. В ArcGIS Enterprise 11.2 таблица содержит следующие свойства: ObjectID, ServiceIdentifier, Name и Value.

Примечание:

Столбец ServiceIdentifier содержит уникальный идентификатор сервиса. Если значение идентификатора равно -1, свойство является глобальным свойством, применимым ко всем сервисам.

Каждая строка в таблице TPS_Property является свойством. Следующая таблица описывает каждое свойство:

Свойство	Описание
AdditionalOutputPaths	Дополнительные пути выходных файлов для операции generateProduct. Пути к файлам должны быть разделены точками с запятой. Внимание: Операция копирования выходных данных в эти места не будет выполнена, если у учетной записи ArcGIS Server нет доступа к чтению и записи указанного файла. Данные и выходные файлы в любом из указанных местоположений удаляются во время очистки, определённой свойством CleanupInterval.
AdminGroupId	Глобальное свойство, позволяющее группе пользователей отменять или удалять задания в веб-приложениях, входящих в расширение сервера ArcGIS Topographic Mapping. Чтобы предоставить группе эти права, обновите свойство AdminGroupId так, чтобы оно соответствовало значению идентификатора группы, соответствующему группе, созданной для веб-приложения. В автономном развертывании ArcGIS Server вы можете назначить эти права группе, указав значение имени роли пользователя с типом роли администратора ArcGIS Server в качестве значения этого свойства. Узнайте больше о ролях в ArcGIS Server Manager
AllowedSDEAuthMode	Режим аутентификации SDE, который разрешен. Поддерживаются следующие: Внимание: Изменение режима путём обновления этого значения представляет угрозу безопасности. Менять эту настройку не рекомендуется. OSA — аутентификация операционной системы, аутентификация, выполняемая операционной системой или сетевым доменом. Используется по умолчанию. СУБД — система управления базами данных управляет именем пользователя и паролем. Базовое — простая аутентификация по имени пользователя и паролю, учетные данные хранятся и управляются конфигурацией сервера ArcGIS или SDE.
AllowedServices	Список сервисов, находящихся вне интегрированной среды и которые организация признала безопасными. Этот список должен содержать только общедоступные сервисы и может выглядеть, как значения, разделённые запятыми. Структура URL сервисов влияет на то, какие сервисы разрешены. Например: https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer/3 — разрешает только сервис слоя для штатов (3 — это штаты). https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer — позволяет использовать сервисы слоев на этом картографическом сервере. https://sampleserver6.arcgisonline.com/arcgis/ — разрешает все сервисы на домене sampleserver6.arcgisonline.com.
AutoUpdateProducts	Определяет, распространяются ли обновления определений продуктов карты, сделанные в файле .json, на определения продуктов карты в базе геоданных топографического сервера при перезагрузке сервера. True — при перезапуске сервиса существующие определения продуктов в базе данных автоматически обновляются с определениями продуктов карты из файла .json, установленного вместе с файлами данных продукта Enterprise. Используется по умолчанию. False — при перезапуске сервиса существующие определения продуктов карты не обновляются автоматически с картами определений продуктов из файла, .json установленного вместе с файлами продукта Enterprise.
CleanupInterval	Количество часов до того, как временные данные использовались для создания картографического продукта и выходных продуктов карты, удаляются с сервера. По умолчанию – 24.
DateTimeFormat	Формат даты и времени, когда токен с датой или временем используется в имени файла выхода задания.
DistributedJobFolders	Это свойство зарезервировано для использования в будущих версиях и в настоящее время не поддерживается.
DistributedProcessing	Это свойство зарезервировано для использования в будущих версиях и в настоящее время не поддерживается.
ExtractionProgress	Указывает, обновляется ли прогресс задания во время извлечения данных для задания. По умолчанию – False. Подсказка: При работе с большими объёмами развертывания значение снижает False трафик базы данных.
extractionTimeout	Сколько времени в секундах может занять извлечение данных до истечения времени.
<file type>	Примечание: Это глобальное свойство, задайте для ServiceIdentifier значение -1. Поддерживаются следующие типы файлов: .aprx .dt2 .gdb .pagx .pdf .tiff .zip Для задания имени выходного файла задания могут использоваться следующие токены: [JobName] — значение параметра outputName для generateProduct операции SOE или имя экспорта в приложении MPS. [JobId] — глобальный уникальный идентификатор (GUID), созданный при экспорте картографического продукта с помощью операции SOE generateProduct или приложения MPS. [JobStartDate] — дата начала для задания в формате локального времени UTC. [Пользователь] — пользователь, который инициировал задание. [ProductName] — указанное название продукта на карте задания. [ProductVersion] — версия заданного продукта карты в задании. [SheetIdentifier] — значение национального эталонного номера (NRN) для выбранного индекса. [MGRS:] — Военная система прямоугольных координат (MGRS), задающая местоположение листа. [MGRS] — 4Q [MGRS:100km] — 4QFJ [MGRS:10km] — 4QFJ16 [MGRS:1km] — 4QFJ1267 [MGRS:100m] — 4QFJ123678 [MGRS:10m] — 4QFJ12346789 [MGRS:1m] — 4QFJ1234567890 [MGRS:ICM] — 1234 [AOI.] — значение таблицы атрибутов индекса AOI. Примечание: Этот токен появляется в имени, если указанное поле содержит значение null. Если в формате отсутствует расширение типа файла, оно автоматически добавляется. Внимание: Добавьте токен [JobId], токен [JobStartDate] или оба, чтобы избежать конфликтов имён файлов.
jobHistory	Количество дней, когда данные, связанные с заданиями по созданию карт, хранятся в базе данных. По умолчанию – 365. Записи в базе данных, связанные с заданием, будут навсегда удалены после установленного количества дней.
LastCleanup	Дата и время, когда временные данные для задания были в последний раз удалены с сервера.
productType	Типы продуктов карт, поддерживаемые сервисом. Несколько значений должны быть разделены запятыми, например: TM, JOG. Определения продуктов карты имеют свойство type, и сервис возвращает продукты со значением, совпадающим с указанным.
resourceCheckInterval	Время между проверками, чтобы проверить, выполнены ли пороговые значения ресурсов, установленные для запуска очистки. Ресурсы включают место на диске. Значение по умолчанию — 300s (300 секунд). Важно: Это считается мягкой очисткой, когда временные файлы заданий в папке TopographicProduction удаляются, записи заданий в таблице TPS_JOB обновляются значением cleaned, а файлы, скопированные в дополнительные каталоги, остаются целыми.
storageHighThreshold	Процент использования диска, который запускает обязательную очистку, начиная с самого старого задания. Значение по умолчанию — %90 (90%). Важно: Это считается мягкой очисткой, когда временные файлы заданий в папке TopographicProduction удаляются, записи заданий в таблице TPS_JOB обновляются значением cleaned, а файлы, скопированные в дополнительные каталоги, остаются целыми.
storageLowThreshold	Процент использования диска, который нужно достичь при обязательной очистке SOE из-за высокого процента использования диска. Значение по умолчанию — %80 (80%). Важно: Это считается мягкой очисткой, когда временные файлы заданий в папке TopographicProduction удаляются, записи заданий в таблице TPS_JOB обновляются значением cleaned, а файлы, скопированные в дополнительные каталоги, остаются целыми.
UseJobIdFolder	Глобальное свойство, указывающее, будет ли выходная папка по умолчанию определяться на основе идентификатора задания. По умолчанию – True. Если задано значение False, выходной URL в ответе jobStatus не будет содержать идентификаторов заданий.
Version	Версия базы геоданных топографического сервера. Примечание: Начиная с ArcGIS Enterprise 12.1, это значение соответствует текущей версии Enterprise.
WorkflowItemIdentifier	Строка ID, связанная с элементом рабочего процесса топографического производства.
WorkflowLocalJobFolder	Путь к местоположению папки, содержащей данные для локальных заданий.