Der Service "Topografische Erstellung"

Lizenz:

Um diese Ressource zu nutzen, sind eine ArcGIS GIS Server Advanced-Lizenz und eine Lizenz für die Server-Erweiterung "ArcGIS Topographic Mapping" erforderlich.

Der Service "Topografische Erstellung" ist eine Serverobjekterweiterung (SOE) für einen Kartenservice. Er ermöglicht die Verwendung topografischer Erstellungsfunktionen im Kartenservice, z. B. das Erstellen topografischer Karten auf Basis von standardisierten Kartenproduktspezifikationen.

Weitere Informationen zum Service "Topografische Erstellung"

Weitere Informationen zu REST-SOEs

Weitere Informationen zum ArcGIS Server-Services-Verzeichnis

Veröffentlichen des Service

Die Erweiterung "Topographic Mapping" in ArcGIS Pro ermöglicht es Ihnen, den Service "Topografische Erstellung" zu veröffentlichen.

Konfiguration in ArcGIS Server

Sie können die Vorgänge, die der Service ausführen kann, und weitere Eigenschaften in ArcGIS Server Manager nach der Veröffentlichung des Services konfigurieren. Diese Einstellungen werden angezeigt, wenn Sie das Kontrollkästchen Topografische Erstellung aktivieren oder auf Topografische Erstellung klicken, und werden nur angewendet, wenn das Kontrollkästchen aktiviert ist.

Operationen

In der SOE werden die folgenden Ressourcen und Vorgänge unterstützt:

• addProduct: Fügt dem Service eine Definition eines Kartenprodukts hinzu, die zum Generieren einer Karte verwendet werden kann.

• calculateExtent: Berechnet einen benutzerdefinierten Interessenbereich (AOI) für ein bestimmtes Produkt und eine bestimmte Version.

• delete: Löscht Aufträge, die ausgeführt oder abgebrochen wurden, sodass sie nicht mehr in Abfragen erscheinen oder Serverplatz belegen.

• generateProduct: Automatisiert das Erzeugen eines Layouts oder einer Karte auf Grundlage einer vorhanden Kartenproduktdefinition.

• removeProduct: Entfernt ein Kartenprodukt aus dem Service "Topografische Erstellung".

• updateProduct: Aktualisiert die Eigenschaften eines vorhandenen Kartenprodukts.

• products: Ruft die vom Service "Topografische Erstellung" unterstützten Kartenprodukte ab.

  • product: Ruft ein einzelnes Kartenprodukt aus den vom Service "Topografische Erstellung" unterstützten Produkten ab.

• jobs: Enthält die Vorgänge mit Aufträgen, die ausgeführt werden.

  • cancel: Bricht einen über den Endpunkt generateProduct gesendeten Auftrag ab.

  • job: Verfolgt den Status eines vom Endpunkt generateProduct ausgeführten Auftrags. Gibt den Status, das Startdatum, das Datum der letzten Änderungen und die Nachrichten für den Auftrag zurück.

  • query: Verfolgt den Status vom Endpunkt generateProduct ausgeführter Aufträge. Gibt den Status, das Startdatum, das Datum der letzten Änderungen und die Nachrichten für einen Satz von Aufträgen zurück.

• workflows: Enthält die Ressourcen und Vorgänge mit Workflows der topografischen Erstellung, die ArcGIS Workflow Manager verwenden.

  • taskGroups: Enthält die Vorgänge mit SOE-Task-Gruppen.

    • addTaskGroup: Kombiniert eine Workflow-Definition mit den von einer Organisation erforderlichen Details zu einer SOE-Task-Gruppe, die vom Vorgang "createTaskGroupJob" verwendet werden kann, um SOE-Aufträge zu erstellen.

    • createTaskGroupJob: Verwendet eine SOE-Task-Gruppe, um einen SOE-Task-Gruppen-Auftrag zu erstellen, der zu einem übergeordneten Workflow Manager-Auftrag und dessen untergeordneten Aufträgen führt.

    • getTaskGroups: Gibt Informationen über eine SOE-Task-Gruppe zurück.

    • insertTasks: Fügt einen Satz von Tasks in einen vorhandenen SOE-Task-Gruppen-Erstellungsauftrag ein.

    • removeTaskGroup: Entfernt eine SOE-Task-Gruppe.

    • updateTaskGroup: Aktualisiert eine SOE-Task-Gruppe.

  • tasks: Enthält die Vorgänge mit Task-Gruppen-Aufträgen.

    • updateTask: Aktualisiert die Parameterwerte eines Tasks in einem Task-Gruppen-Auftrag.

    • executeTaskJob: Führt den vom VorgangcreateTaskGroupJob erstellten SOE-Task-Gruppen-Auftrag aus.

    • getTask: Gibt die Informationen über eine SOE-Task-Gruppe zurück.

  • projects: Enthält die Vorgänge, die die Integration zwischen dem Server für die topografische Erstellung und den servicebasierten Workflow Manager-Workflows ermöglichen.

    • addProject: Ein Einzelparameter-Vorgang, der das JSON-Objekt akzeptiert, das das Projekt und alle seine Phasen definiert.

    • queryProject: Gibt ein JSON-Objekt-Array zurück, das Projekte darstellt.

    • removeProject: Entfernt ein Projekt.

    • updateProject: Aktualisiert die in der JSON eines Projekts definierten Eigenschaften.

Topographic-Production-Datenbank

Eine Geodatabase wird vom Service "Topografische Erstellung" zur Datenspeicherung verwendet. Der Typ der Geodatabase wird durch eine SDE-Verbindungsdatei (Spatial Database Engine) bestimmt. In Server Manager muss der Pfad zu einer SDE-Verbindungsdatei im Textfeld Topographic-Production-Datenbank angegeben werden. Das ArcGIS Server-Konto muss Lesezugriff auf den Speicherort der .sde-Verbindungsdatei haben.

Tipp:

Der Pfad zu dieser Datei kann auch angegeben werden, wenn der Service "Topografische Erstellung" in ArcGIS Pro über das Textfeld tmserverDatabase veröffentlicht wird.

Weitere Informationen über das Veröffentlichen des Service "Topografische Erstellung" in ArcGIS Pro

Die Geodatabase des Servers für die topografische Erstellung enthält mehrere Tabellen. Die Tabelle "TPS_Property" enthält die Eigenschaften, die bei der Veröffentlichung des Service über ArcGIS Pro definiert werden und nach der Veröffentlichung des Service über ArcGIS Server Manager zugänglich sind. In der Tabelle werden außerdem Eigenschaften für jeden Service gespeichert, der mit aktivierter SOE für die topografische Erstellung veröffentlicht wird. In ArcGIS Enterprise 11.2 enthält die Tabelle folgende Eigenschaften: ObjectID, ServiceIdentifier, Name und Value.

Hinweis:

Die Spalte "ServiceIdentifier" enthält die eindeutige ID des Service. Wenn der Wert der ID -1 lautet, ist die Eigenschaft eine globale Eigenschaft, die für alle Services gilt.

Jede Zeile in der Tabelle "TPS_Property" ist eine Eigenschaft. In der folgenden Tabelle werden die einzelnen Eigenschaften beschrieben:

Eigenschaft	Beschreibung
AdditionalOutputPaths	Zusätzliche Ausgabedateipfade für den Vorgang generateProduct. Dateipfade müssen durch ein Semikolon getrennt werden. Achtung: Das Kopieren von Ausgaben an diese Speicherorte schlägt fehl, wenn das ArcGIS Server-Konto keinen Lese- und Schreibzugriff auf die angegebene Datei hat. Daten und Ausgabedateien an den angegebenen Speicherorten werden während der von der Eigenschaft CleanupInterval definierten Bereinigungen gelöscht.
AdminGroupId	Eine globale Eigenschaft, die es einer Gruppe von Benutzern ermöglicht, Aufträge in den Web-Apps der Server-Erweiterung ArcGIS Topographic Mapping abzubrechen oder zu löschen. Um einer Gruppe diese Berechtigungen zu erteilen, aktualisieren Sie die Eigenschaft AdminGroupId, damit sie mit dem Wert einer Gruppen-ID übereinstimmt, die einer Gruppe entspricht, die Sie für eine Web-App erstellen. In einer eigenständigen ArcGIS Server-Bereitstellung können Sie diese Berechtigungen einer Gruppe zuweisen, indem Sie den Wert des Rollennamens eines Benutzers mit dem Rollentyp "ArcGIS Server Administrator" als Wert für diese Eigenschaft angeben. Weitere Informationen zu Rollen in ArcGIS Server Manager
AllowedSDEAuthMode	Der zulässige SDE-Authentifizierungsmodus. Folgendes wird unterstützt: Achtung: Das Ändern des Modus durch Aktualisierung dieses Wertes birgt ein Sicherheitsrisiko. Das Ändern dieser Einstellung wird nicht empfohlen. OSA: Betriebssystem-Authentifizierung; Authentifizierung durch das Betriebssystem oder die Netzwerkdomäne. Dies ist die Standardeinstellung. DBMS: Das Datenbankmanagementsystem verwaltet Benutzernamen und Kennwort. Standard: Einfache Authentifizierung mit Benutzernamen und Kennwort; die Anmeldeinformationen werden von ArcGIS Server oder der SDE-Konfiguration gespeichert und verwaltet.
AllowedServices	Eine Liste von Services, die sich außerhalb der Verbundumgebung befinden, die eine Organisation als sicher eingestuft hat. Diese Liste sollte nur öffentliche Services enthalten, und die Werte können durch Komma getrennt werden. Die Struktur der Service-URL beeinflusst, welche Services zulässig sind. Beispiel: https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer/3: Lässt nur den Layer-Service für Bundesstaaten/Bundesländer/Kantone zu (3 steht für Bundesstaaten/Bundesländer/Kantone). https://sampleserver6.arcgisonline.com/arcgis/rest/services/Census/MapServer: Lässt die Layer-Services auf diesem Kartenserver zu. https://sampleserver6.arcgisonline.com/arcgis/: Lässt alle Services in der Domäne sampleserver6.arcgisonline.com zu.
AutoUpdateProducts	Legt fest, ob Aktualisierungen der Kartenproduktdefinitionen – die in der .json-Datei vorgenommen wurden – auf die Kartenproduktdefinitionen in der Geodatabase des Servers für die topografische Erstellung übertragen werden, wenn der Server neu gestartet wird. True: Wenn der Service neu gestartet wird, werden die bestehenden Kartenproduktdefinitionen in der Datenbank automatisch mit den Kartenproduktdefinitionen aus der mit den Enterprise-Produktdaten installierten .json-Datei aktualisiert. Dies ist die Standardeinstellung. False: Wenn der Service neu gestartet wird, werden die bestehenden Kartenproduktdefinitionen nicht automatisch mit den Kartenproduktdefinitionen aus der mit den Enterprise-Produktdaten installierten .json-Datei aktualisiert.
CleanupInterval	Die Anzahl der Stunden, bevor temporäre Daten, die zur Erstellung eines Kartenprodukts verwendet werden, und die ausgegebenen Kartenprodukte vom Server gelöscht werden. Die Standardeinstellung ist 24.
DateTimeFormat	Das Datums- und Uhrzeitformat, wenn ein Token mit Datum oder Uhrzeit in einem Auftrags-Ausgabedateinamen verwendet wird.
DistributedJobFolders	Diese Eigenschaft ist für eine zukünftige Version reserviert und wird derzeit nicht unterstützt.
DistributedProcessing	Diese Eigenschaft ist für eine zukünftige Version reserviert und wird derzeit nicht unterstützt.
ExtractionProgress	Gibt an, ob der Fortschritt eines Auftrags aktualisiert wird, während Daten für den Auftrag extrahiert werden. Die Standardeinstellung ist False. Tipp: Bei der Arbeit mit umfangreichen Bereitstellungen reduziert der Wert False den Datenbankverkehr.
extractionTimeout	Die Zeitspanne in Sekunden, in der die Datenextraktion ausgeführt werden kann, bevor ein Timeout erfolgt.
<file type>	Hinweis: Dies ist eine globale Eigenschaft. Legen Sie den Wert ServiceIdentifier auf -1 fest. Die folgenden Dateitypen werden unterstützt: .aprx .dt2 .gdb .pagx .pdf .tiff .zip Die folgenden Token können verwendet werden, um den Namen einer Auftragsausgabedatei zu definieren: [JobName]: Der outputName-Parameterwert für den SOE-Vorgang generateProduct oder der Name des Exports in der MPS-App. [JobId]: Die GUID (Globally Unique Identifier), die beim Export eines Kartenprodukts mit dem SOE-Vorgang generateProduct oder der MPS-App erstellt wird. [JobStartDate]: Das Startdatum des Auftrags im lokalen UTC-Zeitformat. [User]: Der Benutzer, der den Auftrag initiiert hat. [ProductName]: Der für den Auftrag angegebene Kartenproduktname. [ProductVersion]: Die für den Auftrag angegebene Kartenproduktversion. [SheetIdentifier]: Der NRN-Wert (National Reference Number) für den ausgewählten Index. [MGRS:]: Das MGWS (Military Grid Reference System), das die Position auf dem Blatt angibt. [MGRS]: 4Q [MGRS:100km]: 4QFJ [MGRS:10km]: 4QFJ16 [MGRS:1 km]: 4QFJ1267 [MGRS:100m]: 4QFJ123678 [MGRS:10m]: 4QFJ12346789 [MGRS:1m]: 4QFJ1234567890 [MGRS:ICM]: 1234 [AOI.]: Ein Wert der AOI-Indexattributtabelle. Hinweis: Dieses Token ist Teil des Namens, wenn das angegebene Feld einen NULL-Wert enthält. Wenn das Format keine Dateierweiterung aufweist, wird sie automatisch angehängt. Achtung: Fügen Sie das [JobId]-Token, das [JobStartDate]-Token oder beide hinzu, um Dateinamenskonflikte zu vermeiden.
jobHistory	Die Anzahl der Tage, während derer Daten im Zusammenhang mit Kartenerstellungsaufträgen in der Datenbank gespeichert sind. Die Standardeinstellung ist 365. Auftragsbezogene Datensätze in der Datenbank werden nach der festgelegten Anzahl von Tagen endgültig gelöscht.
LastCleanup	Das Datum und die Uhrzeit, an dem bzw. der die temporären Daten für einen Auftrag zuletzt vom Server gelöscht wurden.
productType	Die vom Service unterstützten Kartenprodukttypen. Mehrere Werte müssen durch ein Komma getrennt werden. Beispiel: TM, JOG. Kartenproduktdefinitionen weisen die type-Eigenschaft auf, und der Service gibt die Kartenprodukte mit einem Wert zurück, der dem angegebenen Wert entspricht.
resourceCheckInterval	Die Zeitspanne zwischen den Überprüfungen, um festzustellen, ob die für das Auslösen von Bereinigungen festgelegten Ressourcenschwellenwerte erreicht wurden. Ressourcen beinhalten Festplattenspeicher. Der Standardwert ist 300s (300 Sekunden). Wichtig Dies gilt als sanfte Bereinigung. Das heißt, die temporären Auftragsdateien im Ordner "TopographicProduction" werden gelöscht, Auftragsdatensätze in der Tabelle "TPS_JOB" mit dem Wert cleaned werden aktualisiert, und Dateien, die in zusätzliche Verzeichnisse kopiert wurden, bleiben intakt.
storageHighThreshold	Der Prozentsatz der Festplattennutzung, der eine obligatorische Bereinigung auslöst, beginnend mit dem ältesten Auftrag. Der Standardwert ist %90 (90 %). Wichtig Dies gilt als sanfte Bereinigung. Das heißt, die temporären Auftragsdateien im Ordner "TopographicProduction" werden gelöscht, Auftragsdatensätze in der Tabelle "TPS_JOB" mit dem Wert cleaned werden aktualisiert, und Dateien, die in zusätzliche Verzeichnisse kopiert wurden, bleiben intakt.
storageLowThreshold	Der Prozentsatz der Festplattennutzung, der erreicht werden muss, wenn eine obligatorische SOE-Bereinigung aufgrund eines hohen Prozentsatzes der Festplattennutzung ausgelöst wird. Der Standardwert ist %80 (80 %). Wichtig Dies gilt als sanfte Bereinigung. Das heißt, die temporären Auftragsdateien im Ordner "TopographicProduction" werden gelöscht, Auftragsdatensätze in der Tabelle "TPS_JOB" mit dem Wert cleaned werden aktualisiert, und Dateien, die in zusätzliche Verzeichnisse kopiert wurden, bleiben intakt.
UseJobIdFolder	Eine globale Eigenschaft, die angibt, ob der Standard-Ausgabeordner eines Auftrags basierend auf der Auftrags-ID benannt wird. Die Standardeinstellung ist True. Wenn der Wert auf False gesetzt ist, enthält die Ausgabe-URL in der Antwort jobStatus keine Auftrags-IDs.
Version	Die Version der Geodatabase des Servers für die topografische Erstellung. Hinweis: Ab ArcGIS Enterprise 12.1 entspricht dieser Wert der aktuellen Version von Enterprise.
WorkflowItemIdentifier	Die ID-Zeichenfolge, die mit einem Worklflow-Element der topografischen Erstellung verknüpft ist.
WorkflowLocalJobFolder	Der Pfad zum Speicherort eines Ordners, der die Daten für lokale Aufträge enthält.