Publish the Topographic Production Service

Доступно с лицензией Defense Mapping.

The Topographic Production Service is deployed to ArcGIS Server simultaneously with publishing a map as a web layer that contains data from ArcGIS Enterprise or a file geodatabase. After the service is deployed, you can run operations in ArcGIS Server that are configured in ArcGIS Pro as described below. You can also configure the self-serve Map Production System web app using the Enterprise product data files to export map products.

Примечание:

The following items are either required before publishing the service or provide more information about the service:

  • The product data files must be installed on each machine in the ArcGIS Server deployment and their version must match the version of the service.
  • The service stores temporary data for each job on the server. The default location is C:\ProgramData\ESRI\TopographicProduction\jobs.
  • The output files created by the generateProduct operation are copied to the output directory of the map service. The configured map service properties impact these files and how long they are available for download.
  • The ArcGIS Server account must have read and write access to the location of the jobs directory, as well as the location of any digital elevation models (DEMs) that are used.
  • If your products use DEMs, copy them or their mosaic dataset to the server and use the productName and raster parameters from the updateProduct operation to update the path of the new location. Ensure that all the machines in a multimachine deployment and the ArcGIS Server account have read and write access to the new location.

Enable capabilities

Ensure that you're signed in to the ArcGIS organization that the service will deploy to and that the correct account is active before you complete the following steps to enable the Topographic Production Service capability.

  1. In ArcGIS Pro, click the Share tab.
  2. In the Share As group, click the Web Layer drop-down arrow and click Publish Web Layer.

    The Share As Web Layer pane appears.

  3. Type a name for the web layer.
  4. Дополнительно заполните поля Краткая информация и Теги.

    При публикации на ArcGIS Enterprise 10.9 или более ранний портал требуются краткая информации и тэги.

    Вы можете ввести максимум 128 тегов.

  5. Optionally, in the Data and Layer Type section, do any or all of the following:
    • Choose Map Image to reference datasets in a registered Enterprise database.
      Примечание:

      Check the Feature check box to share the web feature layer as a dependent layer to the map image layer.

    • Choose Feature under Copy all data to copy all the layers to the hosting server's managed database.
  6. В разделе Местоположение с помощью меню Папка выберите папку в ресурсах портала, в которой будет храниться веб-слой. Вы можете создать папку.

    По умолчанию, веб-слой хранится на корневом уровне ресурсов портала.

    Подсказка:

    Нажмите кнопку Обзор Обзор, чтобы перейти к папке в ресурсах портала. Вы также можете ввести имя папки в текстовом поле.

  7. Используйте ниспадающее меню Сервер и папка, чтобы указать интегрированный сервер, где будет опубликован сервис, и папку, где он будет храниться. Вы можете создать папку.

    По умолчанию, сервис хранится в корневой папке сервера.

    Примечание:

    Опции Сервер и папка появляются, только если вы публикуете данные на ArcGIS Enterprise, используя опцию Ссылаться на зарегистрированные данные. В этом случае можно также щелкнуть кнопку Хранилища данных Хранилища данных, чтобы открыть панель Управление зарегистрированными хранилищами данных. Используйте эту панель для регистрации баз геоданных и папок на интегрированном сервере.

  8. В разделе Общий доступ укажите, для кого будет доступен веб-слой:
    • Для всех - Поделитесь своими ресурсами с общественностью. Права доступа и просмотра объекта будут у всех.
    • Моя организация - Поделитесь своими ресурсами со всеми аутентифицированными пользователями в организации. Эта опция доступна, если вы произвели вход с использованием учетной записи организации.
    • Группы - Поделитесь своими ресурсами с группами, к которым вы принадлежите, и их участниками.

    Не включайте ни одну из опций, чтобы ограничить доступ только владельцем проекта.

  9. Click the Configuration tab.
  10. Click Configure Layers Конфигурировать слои.
  11. In the Capabilities section, check the Topographic Production check box to enable its service.

    The list of available capabilities depends on the Enterprise version you're using, the types of data included in the map image layer, and whether you are sharing to a server that has server object extensions or server object interceptors.

    After the capability is enabled, you can configure its properties.

Configure the service properties

To configure service operations and other service properties, complete the following steps:

  1. In the Capabilities section, for Topographic Production, click Configure Service Properties Настроить свойства сервиса.

    The TopographicProductionServer Properties pane appears.

  2. Optionally, check any of the check boxes in the Operations section to enable or disable the service operations.

    Topographic Production Service operations are enabled by default. The following operations are supported:

    products

    Retrieves the products that the Topographic Production Service supports

    jobs

    Contains more operations

    addProduct

    Adds a map product definition to the service that can be used to generate a map

    removeProduct

    Removes a product from the Topographic Production Service

    updateProduct

    Updates an existing product's properties

    generateProduct

    Automates the process of producing a layout or map based on a map product

  3. In the Properties section, specify the following properties:
    1. For tmserverDatabase, specify the database for the Topographic Production Server. This can be left blank on single-machine ArcGIS Server deployments. A geodatabase is created in the default server location of C:\ProgramData\ESRI\TopographicProduction after the deployment.

      If a multimachine deployment is used, do not leave this property blank. Specify the path to an Enterprise connection file. Your Enterprise organization must have read access to the specified location. When publishing multiple map services in a multimachine deployment, all of them must use the same Enterprise connection file.

      Примечание:

      The provided path updates the location of the jobs directory, which is used to store temporary data for each job. If an Enterprise connection file is used, the database user specified in the connection must be able to perform data manipulation language (DML) statements in the database.

    2. For productType, specify the type of map products this service will support, such as MTM, TDS, and CTM.

      Each map product definition has a type property. When you specify a value for productType, only products that match this value are returned by the service. If you leave it blank, all products are returned. For example, if a single service contains the data to produce MTM products, specify MTM as the product type.

    3. For extractionTimeout, specify how long in seconds the data extraction can run before timing out.

      The default is 900 seconds. If a data extraction time out error occurs when running the generateProduct operation, try increasing this value before running the operation again.

    4. For autoUpdateProducts, specify whether the service automatically updates existing map product definitions with the ArcGIS Pro product data files installed by the ArcGIS Production Mapping product files installer.

      The default is True.

    Примечание:

    You can make the Cleanup Interval property available through the Enterprise Manager site; it is infrequently used and unavailable by default. This property specifies the number of hours before temporary data used to produce a map product is deleted from the server. If you make it available, the default is 24 hours.

  4. Optionally, click Configure Parameters Настроить параметры to configure more properties.

    Configuration tab in the Share As Web Layer pane

  5. Click Configure Pooling Настроить Слияние сервисов.
  6. Ensure that the Dedicated instance option is chosen in the Instance Type group.
  7. Optionally, specify the range for the number of instances per machine in the Number of instances per machine section.

    This is the minimum and maximum number of dedicated instances that can run for the service at any given time, including when the service is not in use. These are the instances that handle calls to the map service, as well as REST operations that don't consume many resources and are handled quickly.

    Подсказка:

    Adjust the range of instances as necessary after monitoring the traffic to these endpoints. The generateProduct operation uses the TopographicProductionSystemTools geoprocessing service to perform the work. Adjusting the range of instances of this service impacts the throughput of generating map products.

  8. При необходимости щелкните вкладку Ресурсы, чтобы просмотреть папку, новые веб-слои и подслои с назначенными идентификаторами, если они доступны.

    Если вы включили опцию Разрешить назначение уникальных числовых ID для опубликованных веб слоев в диалоговом окне Свойства карты, назначенные идентификаторы появляются для каждого подслоя. Чтобы изменить ID, щелкните по номеру рядом со слоем или таблицей. В диалоговом окне Свойства слоя или Свойства автономной таблицы, на вкладке Общие, введите пользовательский целочисленный ID в окне ID слоя или ID таблицы. Более подробно см. в Назначение ID слою.

You're ready to analyze and publish the map as a service web layer.

Publish the service

Once you have configured all of the settings for the service, you can analyze the configuration and publish it to your active Enterprise portal by completing the following steps:

  1. Click Analyze to check for problems.

    Errors and warnings are listed on the Messages tab. Right-click a message to open its help topic or take corrective action in the software. Errors Ошибка must be resolved before you can share the web layer. Resolving warnings Предупреждение is recommended but not required.

    Learn more about analyzing GIS resources

  2. After you have resolved errors, and optionally, resolved warnings, click Publish to share the web layer.

    To save a service definition for the web layer instead, click the Publish drop-down arrow and click Save As SD.

  3. When the web layer is published, click the Manage the web layer link at the bottom of the pane.

    A browser page appears. If necessary, sign in to your portal to open the web layer's item page.

Once published, the service's operations are available in ArcGIS GIS Server from the ArcGIS REST API, as well as in a configured, self-serve Map Production System (MPS) web app on the Enterprise portal with the ArcGIS Defense Mapping or ArcGIS Production Mapping server extension.