Kartenserver-Cache exportieren (Server)

Zusammenfassung

Exportiert Kacheln eines Kartenbild-Layer-Cache als Cache-Dataset oder Kachelpaket in einen Festplattenordner. Die Kacheln können in andere Caches exportiert werden. Außerdem ist der Zugriff darauf von ArcGIS Desktop, ArcGIS Pro oder mobilen Geräten als Raster-Dataset unabhängig vom übergeordneten Service möglich.

Verwendung

• Erstellen Sie vor dem Ausführen dieses Werkzeugs auf dem Datenträger den Ordner, der die exportierten Kacheln enthalten soll.

• Das ArcGIS Server-Konto muss Schreibzugriff auf den Ziel-Cache-Ordner haben. Wenn dem ArcGIS Server-Konto kein Schreibzugriff auf den Ziel-Cache-Ordner gewährt werden kann, der ArcGIS AllSource-Client jedoch über den entsprechenden Schreibzugriff verfügt, aktivieren Sie den Parameter Daten vom Server kopieren.

• Mit dem Parameter Kacheln überschreiben können die Kacheln im Ziel-Cache vollständig von den exportierten Kacheln überschrieben werden, statt die Bilder zu überblenden. Exportierte Kacheln können auf einen Interessenbereich beschränkt werden.

• Wenn der Parameter Sofort einsatzfähiges Format aktiviert ist, wird der Cache-Inhalt mithilfe der offenen Kachelpaketspezifikation generiert. Das Cache-Format ist Comact V2, das Cache-Schema wird jedoch im JSON- und nicht im XML-Format gespeichert. Dieser Cache-Inhalt kann zur Veröffentlichung und für Offline-Workflows als Kachelpaket in ein ZIP-Archiv komprimiert werden. Der Cache-Inhalt ist bei Verwendung der Workflows, die im Thema Veröffentlichen eines Kachel-Layers aus einem Cache-Dataset beschrieben werden, sofort einsatzfähig. Dieser Parameter ist nur verfügbar, wenn der Wert für den Parameter Cache-Exporttyp Cache-Dataset lautet.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabeservice	Der Kartenbild-Layer mit den zu exportierenden Cache-Kacheln. Sie können ihn auswählen, indem Sie im Portal zu dem Service navigieren. Sie haben auch die Möglichkeit, einen Web-Kachel-Layer aus dem Bereich Projekt der Registerkarte Portal auf diesen Parameter zu ziehen, um den Wert bereitzustellen.	Image Service; Map Server
Ziel-Cache-Pfad	Der Ordner, in den der Cache exportiert wird. Dieser Ordner muss kein registriertes Server-Cache-Verzeichnis sein. Das ArcGIS Server-Konto muss Schreibzugriff auf den Ziel-Cache-Ordner haben. Wenn dem Serverkonto kein Schreibzugriff auf den Ziel-Cache-Ordner gewährt werden kann, der ArcGIS Desktop- oder ArcGIS AllSource-Client jedoch über den entsprechenden Schreibzugriff verfügt, aktivieren Sie den Parameter Daten vom Server kopieren.	Folder
Cache-Exporttyp	Gibt den Typ des zu exportierenden Cache an. Kachelpakete sind für die Verwendung mit ArcGIS Maps SDKs for Native Apps geeignet. Cache-Dataset—Exportiert wird ein Karten- oder Image-Service-Cache, der mithilfe von ArcGIS Server generiert wird. Er kann in ArcGIS Desktop und durch ArcGIS Server-Karten- oder -Image-Services verwendet werden. Mit dieser Option können Sie den Inhalt in einem sofort einsatzfähigen Format generieren. Dies ist die Standardeinstellung. Kachelpaket—Exportiert wird eine einzelne komprimierte Datei, worin das Cache-Dataset als Layer hinzugefügt und konsolidiert wird, sodass es freigegeben werden kann. Kann in ArcGIS AllSource und mit ArcGIS Maps SDKs for Native Apps verwendet werden.	String
Daten von Server kopieren	Gibt an, wie Kacheln in den Zielordner verschoben werden. Aktivieren Sie diesen Parameter nur, wenn dem ArcGIS Server-Konto kein Schreibzugriff auf den Zielordner gewährt werden kann und der ArcGIS Desktop- oder ArcGIS AllSource-Client über den entsprechenden Schreibzugriff verfügt. Die Software exportiert die Kacheln im Server-Ausgabeverzeichnis, bevor sie in den Zielordner verschoben werden. Aktiviert: Kacheln werden zuerst im Server-Ausgabeverzeichnis platziert und dann in den Zielordner verschoben. Der ArcGIS Desktop-Client muss Schreibzugriff auf den Zielordner haben. Deaktiviert: Kacheln werden direkt in den Zielordner exportiert. Das ArcGIS Server-Konto muss Schreibzugriff auf den Zielordner haben. Dies ist die Standardeinstellung.	Boolean
Speicherformattyp	Gibt das Speicherformat für den exportierten Cache an. Reorganisieren—Kacheln werden in Bundle- und Bundlex-Dateien gruppiert, um Platz auf dem Datenträger zu sparen und das schnellere Kopieren von Caches zu ermöglichen. Wenn für den Parameter Cache-Exporttyp auf Kachelpaket festgelegt ist, ist dies die Standardeinstellung. Compact V2—Kacheln werden nur in Bundle-Dateien gruppiert. Dieses Format bietet eine bessere Performance bei Netzwerkfreigaben und Cloud-Speicher-Verzeichnissen. Wenn der Parameter Cache-Exporttyp auf Kachelpaket festgelegt ist, lautet die Erweiterung des Kachelpakets .tpkx. Diese wird von neueren Versionen der ArcGIS-Produkte wie ArcGIS Online, ArcGIS Enterprise 11.5, ArcGIS Maps SDKs for Native Apps 200.0 und höher sowie ArcGIS Runtime 100.5 bis 100.15 unterstützt. Exploded—Jede Kachel wird als einzelne Datei gespeichert.	String
Maßstäbe	Eine Liste von Maßstabsebenen, aus denen Kacheln exportiert werden.	Double
Anzahl der Caching-Service-Instanzen (optional)	Die Anzahl der Instanzen, die zum Aktualisieren oder Erstellen der Kacheln verwendet werden. Der Wert für diesen Parameter ist auf unbegrenzt (-1) festgelegt und kann nicht geändert werden.	Long
Interessenbereich (optional)	Ein Interessenbereich, der den Kachelexport aus dem Cache räumlich beschränkt. Dieser Parameter ist hilfreich, wenn Sie unregelmäßig geformte Bereiche exportieren, da das Werkzeug das Cache-Dataset mit Pixelauflösung ausschneidet. Wenn Sie keinen Interessenbereich angeben, wird die volle Ausdehnung der Karte exportiert.	Feature Set
Exportausdehnung (optional)	Eine rechteckige Ausdehnung, die die zu exportierenden Kacheln definiert. Standardmäßig ist die Ausdehnung auf die volle Ausdehnung des Kartenservice festgelegt, in den Sie importieren. Alternativ können Sie mit dem optionalen Parameter Interessenbereich den Vorgang auf Basis eines Polygons durchführen. Es wird empfohlen, nicht für beide Parameter Werte anzugeben. Wenn Werte für beide Parameter angegeben werden, hat der Parameter Interessenbereich Vorrang vor diesem Parameter. Aktuelle Anzeigeausdehnung : Die Ausdehnung basiert auf der aktiven Karte oder Szene. Ausdehnung darstellen : Die Ausdehnung basiert auf einem Rechteck, das auf der Karte oder Szene aufgezogen wurde. Ausdehnung eines Layers: Die Ausdehnung basiert auf einem aktiven Karten-Layer. Wählen Sie einen verfügbaren Layer aus, oder verwenden Sie die Option Ausdehnung von Daten in allen Layern. Jeder Karten-Layer bietet die folgenden Optionen: Alle Features : Die Ausdehnung aller Features. Ausgewählte Features : Die Ausdehnung der ausgewählten Features. Sichtbare Features : Die Ausdehnung sichtbarer Features. Durchsuchen : Die Ausdehnung basiert auf einem Dataset. Zwischenablage : Die Ausdehnung kann in die und aus der Zwischenablage kopiert werden. Ausdehnung kopieren : Kopiert die Ausdehnung und das Koordinatensystem in die Zwischenablage. Ausdehnung einfügen : Fügt die Ausdehnung und das Koordinatensystem aus der Zwischenablage ein. Wenn die Zwischenablage kein Koordinatensystem enthält, wird für die Ausdehnung das Koordinatensystem der Karte verwendet. Ausdehnung zurücksetzen: Die Ausdehnung wird auf den Standardwert zurückgesetzt. Wenn die Koordinaten manuell eingegeben wurden, dann müssen die Koordinaten numerische Werte sein und im Koordinatensystem der aktiven Karte liegen. Die Karte kann statt der angegebenen Koordinaten auch andere Anzeigeeinheiten verwenden. Verwenden Sie für die Koordinaten in Richtung Süden und Westen Werte mit negativem Vorzeichen.	Extent
Kacheln überschreiben (optional)	Legt fest, ob die Bilder im empfangenden Cache mit den Kacheln aus dem ursprünglichen Cache zusammengeführt oder von diesen überschrieben werden. Aktiviert: Alle Pixel im Interessenbereich werden ersetzt, sodass die Kacheln im Ziel-Cache mit den Kacheln aus dem ursprünglichen Cache überschrieben werden. Deaktiviert: Beim Exportieren der Kacheln werden die transparenten Pixel im ursprünglichen Cache ignoriert. Das Ergebnis ist ein zusammengeführtes oder überblendetes Bild im Ziel-Cache. Dies ist die Standardeinstellung.	Boolean
Sofort einsatzfähiges Format (optional)	Gibt an, ob der Cache-Inhalt mithilfe der offenen Kachelpaketspezifikation generiert wird, und bestimmt das Dateiformat des Cache-Schemas. Dieser Parameter ist nur verfügbar, wenn der Wert für den Parameter Cache-Exporttyp Cache-Dataset lautet. Aktiviert: Der Cache-Inhalt wird mithilfe der offenen Kachelpaketspezifikation generiert. Ein Kachelpaket kann für Offline-Workflows in ein ZIP-Archiv gepackt werden. Das Cache-Format lautet dann Comact V2 und das Cache-Schema wird im JSON-Format gespeichert. Deaktiviert: Der Cache-Inhalt wird mit einem im XML-Format gespeicherten Schema generiert. Verwenden Sie diese Option, um den Cache in vorherige Versionen von ArcGIS Enterprise zu kopieren. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe-Cache-Pfad	Der Ordner, in den der Cache exportiert wurde.	String

Python

arcpy.management.ExportMapServerCache(input_service, target_cache_path, export_cache_type, copy_data_from_server, storage_format_type, scales, {num_of_caching_service_instances}, {area_of_interest}, {export_extent}, {overwrite}, {ready_to_serve_format})

Name	Erläuterung	Datentyp
input_service	Der Kartenbild-Layer mit den zu exportierenden Cache-Kacheln.	Image Service; Map Server
target_cache_path	Der Ordner, in den der Cache exportiert wird. Dieser Ordner muss kein registriertes Server-Cache-Verzeichnis sein. Das ArcGIS Server-Konto muss Schreibzugriff auf den Ziel-Cache-Ordner haben. Wenn dem Serverkonto kein Schreibzugriff auf den Ziel-Cache-Ordner gewährt werden kann, der ArcGIS Desktop- oder ArcGIS AllSource-Client jedoch über den entsprechenden Schreibzugriff verfügt, aktivieren Sie den Parameter Daten vom Server kopieren.	Folder
export_cache_type	Gibt den Typ des zu exportierenden Cache an. Kachelpakete sind für die Verwendung mit ArcGIS Maps SDKs for Native Apps geeignet. CACHE_DATASET—Exportiert wird ein Karten- oder Image-Service-Cache, der mithilfe von ArcGIS Server generiert wird. Er kann in ArcGIS Desktop und durch ArcGIS Server-Karten- oder -Image-Services verwendet werden. Mit dieser Option können Sie den Inhalt in einem sofort einsatzfähigen Format generieren. Dies ist die Standardeinstellung. TILE_PACKAGE—Exportiert wird eine einzelne komprimierte Datei, worin das Cache-Dataset als Layer hinzugefügt und konsolidiert wird, sodass es freigegeben werden kann. Kann in ArcGIS AllSource und mit ArcGIS Maps SDKs for Native Apps verwendet werden.	String
copy_data_from_server	Gibt an, wie Kacheln in den Zielordner verschoben werden. Stellen Sie für diesen Parameter COPY_DATA ein, wenn dem ArcGIS Server-Konto kein Schreibzugriff auf den Zielordner gewährt werden kann und der ArcGIS Desktop- oder ArcGIS AllSource-Client über den entsprechenden Schreibzugriff verfügt. Die Software exportiert die Kacheln im Server-Ausgabeverzeichnis, bevor sie in den Zielordner verschoben werden. COPY_DATA—Kacheln werden zuerst im Server-Ausgabeverzeichnis platziert und dann in den Zielordner verschoben. Der ArcGIS Desktop- oder ArcGIS AllSource-Client muss über Schreibzugriff auf den Zielordner verfügen. DO_NOT_COPY—Kacheln werden direkt in den Zielordner exportiert. Das ArcGIS Server-Konto muss Schreibzugriff auf den Zielordner haben. Dies ist die Standardeinstellung.	Boolean
storage_format_type	Gibt das Speicherformat für den exportierten Cache an. COMPACT—Kacheln werden in Bundle- und Bundlex-Dateien gruppiert, um Platz auf dem Datenträger zu sparen und das schnellere Kopieren von Caches zu ermöglichen. Wenn der Parameter export_cache_type auf TILE_PACKAGE festgelegt ist, ist dies die Standardeinstellung. COMPACT_V2—Kacheln werden nur in Bundle-Dateien gruppiert. Dieses Format bietet eine bessere Performance bei Netzwerkfreigaben und Cloud-Speicher-Verzeichnissen. Wenn der Parameter export_cache_type auf TILE_PACKAGE festgelegt ist, lautet die Erweiterung des Kachelpakets .tpkx. Diese wird von neueren Versionen der ArcGIS-Produkte wie ArcGIS Online, ArcGIS Enterprise 11.5, ArcGIS Maps SDKs for Native Apps 200.0 und höher sowie ArcGIS Runtime 100.5 bis 100.15 unterstützt. EXPLODED—Jede Kachel wird als einzelne Datei gespeichert.	String
scales [scales,...]	Eine Liste von Maßstabsebenen, aus denen Kacheln exportiert werden.	Double
num_of_caching_service_instances (optional)	Die Anzahl der Instanzen, die zum Aktualisieren oder Erstellen der Kacheln verwendet werden. Der Wert für diesen Parameter ist auf unbegrenzt (-1) festgelegt und kann nicht geändert werden.	Long
area_of_interest (optional)	Ein Interessenbereich, der den Kachelexport aus dem Cache räumlich beschränkt. Dieser Parameter ist hilfreich, wenn Sie unregelmäßig geformte Bereiche exportieren, da das Werkzeug das Cache-Dataset mit Pixelauflösung ausschneidet. Wenn Sie keinen Interessenbereich angeben, wird die volle Ausdehnung der Karte exportiert.	Feature Set
export_extent (optional)	Eine rechteckige Ausdehnung, die die zu exportierenden Kacheln definiert. Standardmäßig ist die Ausdehnung auf die volle Ausdehnung des Kartenservice festgelegt, in den Sie importieren. Alternativ können Sie mit dem optionalen Parameter Interessenbereich den Vorgang auf Basis eines Polygons durchführen. Es wird empfohlen, nicht für beide Parameter Werte anzugeben. Wenn Werte für beide Parameter angegeben werden, hat der Parameter Interessenbereich Vorrang vor diesem Parameter. MAXOF: Die maximale Ausdehnung aller Eingaben wird verwendet. MINOF: Die minimale gemeinsame Fläche aller Eingaben wird verwendet. DISPLAY: Die Ausdehnung entspricht der sichtbaren Anzeige. Layer-Name: Die Ausdehnung des angegebenen Layers wird verwendet. Extent-Objekt: Die Ausdehnung des angegebenen Objekts wird verwendet. Durch Leerzeichen getrennte Koordinatenzeichenfolge: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Die Koordinaten werden in der Reihenfolge X-Min, Y-Min, X-Max, Y-Max ausgedrückt.	Extent
overwrite (optional)	Legt fest, ob die Bilder im empfangenden Cache mit den Kacheln aus dem ursprünglichen Cache zusammengeführt oder von diesen überschrieben werden. OVERWRITE—Alle Pixel im Interessenbereich werden ersetzt, sodass die Kacheln im Ziel-Cache mit den Kacheln aus dem ursprünglichen Cache überschrieben werden. MERGE—Beim Exportieren der Kacheln werden die transparenten Pixel im ursprünglichen Cache ignoriert. Das Ergebnis ist ein zusammengeführtes oder überblendetes Bild im Ziel-Cache. Dies ist die Standardeinstellung.	Boolean
ready_to_serve_format (optional)	Gibt an, ob der Cache-Inhalt mithilfe der offenen Kachelpaketspezifikation generiert wird, und bestimmt das Dateiformat des Cache-Schemas. Dieser Parameter kann nur verwendet werden, wenn der Wert für den Parameter export_cache_type CACHE_DATASET lautet. READY_TO_SERVE_FORMAT—Der Cache-Inhalt wird mithilfe der offenen Kachelpaketspezifikation generiert (https://github.com/Esri/tile-package-spec). Ein Kachelpaket kann für Offline-Workflows in ein ZIP-Archiv gepackt werden. Das Cache-Format lautet dann Comact V2 und das Cache-Schema wird im JSON-Format gespeichert. NON_READY_TO_SERVE_FORMAT—Der Cache-Inhalt wird mit einem im XML-Format gespeicherten Schema generiert. Verwenden Sie diese Option, um den Cache in vorherige Versionen von ArcGIS Enterprise zu kopieren. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
output_cache_path	Der Ordner, in den der Cache exportiert wurde.	String

Codebeispiel

ExportMapServerCache: Beispiel 1 (eigenständiges Skript)

Exportieren von Cache-Kacheln für eine Feature-Class, während das Speicherformat von EXPLODED in COMPACT geändert wird.

# Name: ExportMapServerCacheTiles.py
# Description: The following stand-alone script demonstrates how to export
# 		cache from a map layer in ArcGIS Enterprise portal,
# 		as CACHE_DATASET in COMPACT_V2 storage format and MERGE tiles
#               using an AREA_OF_INTEREST to TARGET_CACHE_PATH
#		which is accessible to server instances

# Example: This sample script updates map cache tiles.

import arcpy
from arcpy import env
import os, sys, time, datetime, traceback, string
import traceback, sys

# Set environment settings
env.workspace = "C:/data"

# Sign in to ArcGIS Enterprise
myPortal= "https://MyPortal.domain.com/portalwebadaptor"
arcpy.SignInToPortal(myPortal, "siteadminValue", "siteadminPassword")
myServer="https://Myserver.domain.com/serverwebadaptor"
serviceName= "SampleWorldCities"
serviceType= "MapServer"
myPortalServiceURL = (myServer + "/" + "rest/services" +"/" + serviceName + "/"
                      + serviceType)



# Stand alone ArcGIS Server
##target_server_connection = r"C:\share\python3\arcgis on MyServer.ags"
##serviceName= "MyServiceName"
##serviceType= ".MapServer"
##myPortalServiceURL = (target_server_connection +  "\\" + serviceName + serviceType)

print (myPortalServiceURL)

#variables for reporting
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = r'C:\test\report_%s.txt'% arg1


# List of input variables for map or image service 
targetCachePath 	= "C:/data/temp"
exportCacheType 	= "CACHE_DATASET"
copyDataFromServer 	= "DO_NOT_COPY"
storageFormat 		= "COMPACT_V2"
scales 			= [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
areaOfInterest 		= "C:/data/101/Portland/Metro.shp"
exportExtents 		= ""
overwriteTiles 		= "MERGE"
ready_to_serve_format   = "NON_READY_TO_SERVE_FORMAT"


# Print results of the script to a report
report = open(file,'w')

try:
    result = arcpy.server.ExportMapServerCache(myPortalServiceURL, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest, exportExtents,
					       overwriteTiles,
                                               ready_to_serve_format)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print ("Exported cache successfully for " + serviceName )
    
except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(str(e))
report.close()

ExportMapServerCache: Beispiel 2 (eigenständiges Skript)

Exportieren des Cache mit TILE_PACKAGE, wenn die ArcGIS Server-Instanzen nicht auf den Zielordner zugreifen können.

# Name: ExportMapServerCacheTiles2.py
# Description: The following stand-alone script demonstrates how to export cache
#               on a map service on standalone server as TILE_PACKAGE for default number of scales of a service, to a
#               TARGET_CACHE_PATH which is inaccessible to server instances using
#               COPY_DATA_FROM_SERVER 

# Example: This sample script updates map cache tiles.

import arcpy
from arcpy import env
import os, sys, time, datetime, traceback, string
import traceback, sys

# Set environment settings
env.workspace = "C:/data"

# Sign in to ArcGIS Enterprise
##myPortal= "https://MyPortal.domain.com/portalwebadaptor"
##arcpy.SignInToPortal(myPortal, "siteadminValue", "siteadminPassword")
##myServer="https://Myserver.domain.com/serverwebadaptor"
##serviceName= "SampleWorldCities"
##serviceType= "MapServer"
##myPortalServiceURL = (myServer + "/" + "rest/services" +"/" + serviceName + "/"
##                      + serviceType)
##

# Stand alone ArcGIS Server
target_server_connection = r"C:\share\python3\arcgis on MyServer.ags"
serviceName= "MyServiceName"
serviceType= ".MapServer"
myPortalServiceURL = (target_server_connection +  "\\" + serviceName + serviceType)

print (myPortalServiceURL)

#variables for reporting
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = r'C:\test\report_%s.txt'% arg1


# List of input variables for map or image service 
targetCachePath = "C:/temp/usa"
exportCacheType = "TILE_PACKAGE"
copyDataFromServer = "COPY_DATA"
storageFormat = "COMPACT_V2"
scaleValues = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
exportExtents = ""
areaOfInterest = ""
overwriteTiles = "MERGE"
ready_to_serve_format = "NON_READY_TO_SERVE_FORMAT"

# Print results of the script to a report
report = open(file,'w')

try:
    result = arcpy.server.ExportMapServerCache(inputService, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest,
                                               exportExtents, overwriteTiles,
                                               ready_to_serve_format)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print ("Exported cache successfully for " + serviceName )
    
except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(str(e))
report.close()

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.