Publish the Topographic Production Service

Mit der Production Mapping-Lizenz verfügbar.

The Topographic Production Service is deployed to ArcGIS Server when a map that contains feature data from ArcGIS Enterprise or a file geodatabase is published as a web layer. After the service is deployed, you can configure operations in ArcGIS Pro to run on ArcGIS Server 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.

Hinweis:

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 ArcGIS Server machine in the Enterprise deployment and their version must match the version of the service.
  • The service stores temporary data for each job that is configured to run on ArcGIS Server. The default location for this data is C:\ProgramData\ESRI\TopographicProduction\jobs.
  • The output files created by the generateProduct operation are copied to the output directory of the map service.
    Tipp:

    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 and the output map products themselves are deleted from the server. If you make it available, the default interval is 24 hours.

  • The ArcGIS Server account must have read and write access to the jobs directory location and the location that contains digital elevation models (DEMs) that are used by the map.
  • If your map products use DEMs, copy the DEMs or their mosaic datasets to each ArcGIS Server machine in your Enterprise deployment and use the updateProduct operation's productName and raster parameters to specify the location of the DEMs. Ensure that all ArcGIS Server machines in a multimachine deployment and the ArcGIS Server account have read and write access to the location that contains the DEMs.

Enable capabilities

Ensure that you're signed in to the ArcGIS organization that the service will deploy to with an account that is licensed for ArcGIS Defense Mapping or ArcGIS Production Mapping 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. Provide a name for the web layer in the Name text box.
  4. Füllen Sie optional die Felder Zusammenfassung und Tags aus.

    Für die Freigabe in einem ArcGIS Enterprise-Portal der Version 10.9 oder früher sind eine Zusammenfassung und Tags erforderlich.

    Sie können maximal 128 Tags eingeben.

  5. In the Data and Layer Type section, do one of the following:
    • Choose Map Image to reference datasets in a registered Enterprise database.
      Hinweis:

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

    • Choose Map Image under Copy all data to copy all the layers to the hosting server's managed database.
  6. Wählen Sie unter Speicherort im Menü Ordner im Portal-Inhalt einen Ordner zum Speichern des Web-Layers aus. Sie können auch einen neuen Ordner erstellen.

    Standardmäßig wird der Web-Layer auf der Stammverzeichnisebene im Portal-Inhalt gespeichert.

    Tipp:

    Klicken Sie auf die Schaltfläche Durchsuchen Durchsuchen, um zu einem Ordner im Portal-Inhalt zu navigieren. Sie können auch einen Ordnernamen in das Textfeld eingeben.

  7. Im Dropdown-Menü Server und Ordner können Sie den Verbundserver, auf dem der Service veröffentlicht wird, und den Ordner, in dem er gespeichert wird, angeben. Sie können auch einen neuen Ordner erstellen.

    Standardmäßig wird der Service im Stammverzeichnis des Servers gespeichert.

    Hinweis:

    Die Optionen Server und Ordner werden nur angezeigt, wenn Sie die Freigabe für ArcGIS Enterprise mit der Option Registrierte Daten referenzieren durchführen. In diesem Fall können Sie auch auf die Schaltfläche Data Stores Data Stores klicken, um den Bereich Registrierte Data Stores verwalten zu öffnen. Verwenden Sie diesen Bereich, um Geodatabases und Ordner bei Verbundservern zu registrieren.

  8. Legen Sie unter Freigeben für fest, wie die Freigabe des Web-Layers erfolgen soll:
    • Alle: Geben Sie Ihre Inhalte für die Öffentlichkeit frei. Jeder kann darauf zugreifen.
    • Eigene Organisation: Geben Sie Ihre Inhalte für alle authentifizierten Benutzer in der Organisation frei. Diese Option ist verfügbar, wenn Sie mit einem Organisationskonto angemeldet sind.
    • Gruppen: Geben Sie Ihre Inhalte für Gruppen, denen Sie angehören, und für deren Mitglieder frei.

    Lassen Sie alle Optionen deaktiviert, um die Freigabeebene auf den Besitzer des Elements festzulegen.

  9. Click the Configuration tab.
  10. Ensure that the Configure Layers Layer konfigurieren tab is active.
  11. In the Capabilities section, check the Topographic Production check box to enable the 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.

Configure the service properties

Complete the following steps to configure service operations and other service properties:

  1. In the Capabilities section, for Topographic Production, click Configure Service Properties Service-Eigenschaften konfigurieren.

    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, do one of the following:
      • If ArcGIS Server is deployed as a single-machine site and you only have one map service enabled, do not provide a value for this property. A file-based database is created at the following location after the service is published: C:\ProgramData\ESRI\TopographicProduction.
      • If ArcGIS Server is deployed as a multimachine site or if your single-machine site has multiple map services enabled, you must specify the path to an Enterprise connection file. Your Enterprise organization must have read access to the specified location and the database user specified in the connection file must be able to perform data manipulation language (DML) statements in the database. All machines with multiple map services enabled must use the same Enterprise connection file.

      If the server logs show an error such as -2147220893 Workspace or data source is read only when initializing the Topographic Production Server database, you may need to ensure that you are using an Enterprise connection file.

      Hinweis:

      The provided path updates the location of the jobs directory, which is used to store temporary data for each job.

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

      Map product definitions have a type property. When you specify a value in the productType text box, only the products that match this value are returned by the service. For example, if a single service contains the Multinational Geospatial Co-production Program (MGCP) data to produce MTM products, specify MTM as the product type. You can specify more than one product type by separating product type values with a comma. If you leave this text box blank, no products are returned.

    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.

  4. Optionally, click Configure Parameters Konfigurieren von Parametern to configure more properties.

    Configuration tab in the Share As Web Layer pane

  5. Click Configure Pooling Pooling konfigurieren.
  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.

    Tipp:

    Adjust the range of instances as necessary after monitoring the network 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. Sie können auch auf die Registerkarte Inhalt klicken, um den Ordner, neue Web-Layer und ggf. die Sublayer mit den zugewiesenen IDs anzuzeigen.

    Wenn Sie die Option Zuweisung eindeutiger numerischer IDs für die Freigabe von Web-Layern zulassen im Dialogfeld Karteneigenschaften aktiviert haben, werden die IDs der einzelnen Sublayer angezeigt. Klicken Sie zum Ändern einer ID auf die Zahl neben dem Layer oder der Tabelle. Geben Sie im Dialogfeld Layer-Eigenschaften bzw. Eigenschaften der Standalone-Tabelle auf der Registerkarte Allgemein im Textfeld Layer-ID bzw. Tabellen-ID eine benutzerdefinierte ganzzahlige ID ein. Weitere Informationen finden Sie unter Zuweisen von Layer-IDs.

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, complete the following steps to analyze the configuration and publish it to your active Enterprise portal:

  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 Fehler must be resolved before you can share the web layer. Resolving warnings Warnung 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.

    If you want to save a service definition of the web layer to publish later, click the Publish drop-down arrow and click Save As SD.

  3. When the web layer is finished publishing, click Manage the web layer at the bottom of the Sharing Map As A Web Layer 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 and 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.