Cache-Status für Kartenserver verwalten (Server Tools)
Zusammenfassung
Verwaltet interne, auf dem Server gespeicherte Daten zu den erstellten Kacheln in einem Karten- oder Image-Service-Cache.
Verwendung
Dieses Werkzeug ist nützlich für das Neuerstellen des Cache-Status, nachdem Sie die Kacheln manuell in das Cache-Verzeichnis kopiert oder Kacheln nach Bedarf erstellt haben.
Dieses Werkzeug ist die einzige Möglichkeit, einen Status für einen Cache zu erstellen, der in einer vorherigen Version von ArcGIS Server oder Portal for ArcGIS erstellt wurde.
Anstatt einen Status für den gesamten Cache zu erstellen, können Sie dieses Werkzeug auch zum Erstellen von Statusberichten für benutzerdefinierte Interessenbereiche oder Maßstabsebenen verwenden. Dazu stellen Sie den Parameter** Modus verwalten** auf Bundle-Status neu erstellen ein. Der Bericht wird in einer neuen File-Geodabase mit dem Namen Status.gdb gespeichert, speziell in einer Feature-Class mit dem Namen TaskStatus.
Beachten Sie, dass das Cache-Verzeichnis auch eine Status.gdb enthält, die sich auf den gesamten Cache bezieht und aktualisiert wird, wenn Sie die anderen Verwaltungsmodusoptionen für dieses Werkzeug verwenden. An diesem Speicherort kann keine benutzerdefinierte Status.gdb ersetzt werden.
Der Kartenbild-Layer, für den der Cache-Status geändert wird. Sie können ihn auswählen, indem Sie in "Portal" zu dem gewünschten Service navigieren. Sie haben auch die Möglichkeit, einen Web-Kachel-Layer per Drag-and-drop aus dem Bereich Katalog der Registerkarte Portal zu verschieben, um diesen Parameter einzugeben.
Image Service; Map Server
Verwaltungsmodus
Gibt die Aktion an, die für die vom Server verwendeten Cache-Status-Informationen ausgeführt werden.
Cache-Status löschen—Löscht die vom Server verwendeten Statusinformationen.
Cache-Status neu erstellen—Löscht die vom Server verwendeten Statusinformationen und erstellt sie anschließend neu.
Bundle-Status neu erstellen—Erstellt Statusinformationen in einer neuen File-Geodatabase mit dem Namen Status.gdb in einem Ordner, den Sie im Parameter Ausgabeordner angegeben haben. Diese Option wird verwendet, wenn Sie einen benutzerdefinierten Statusbericht für einen bestimmten Interessenbereich oder einen Satz von Maßstäben erstellen möchten.
String
Maßstäbe
(Optional)
Die Maßstabsebenen, für die der Status geändert wird. Dieser Parameter kommt nur dann zur Anwendung, wenn mithilfe der Option Bundle-Status neu erstellen ein benutzerdefinierter Status für den Parameter Verwaltungsmodus erstellt wird.
Double
Anzahl der Caching-Service-Instanzen
(Optional)
Definiert die Anzahl der Instanzen, die zum Aktualisieren/Erstellen der Kacheln verwendet werden. Der Wert für diesen Parameter ist auf unbegrenzt (-1) festgelegt und kann nicht geändert werden.
Long
Ausgabeordner
(Optional)
Ausgabeordner für die Status.gdb. Dieser Parameter kommt nur dann zur Anwendung, wenn mithilfe der Option Bundle-Status neu erstellen ein benutzerdefinierter Status erstellt wird.
Folder
Interessenbereich
(Optional)
Ein Interessenbereich (Polygon), der bestimmt, welche Geographie der Statusbericht abdeckt. Dieser Parameter kommt nur dann zur Anwendung, wenn mithilfe der Option Bundle-Status neu erstellen ein benutzerdefinierter Status erstellt wird.
Feature Set
Berichtausdehnung
(Optional)
Eine Rechtecksausdehnung, die den Bereich definiert, für den der Status erstellt wird. Dieser Parameter kommt nur dann zur Anwendung, wenn mithilfe der Option Bundle-Status neu erstellen ein benutzerdefinierter Status erstellt wird.
Beachten Sie, dass der Parameter Interessenbereich die Angabe eines Interessenbereichs ermöglicht, der nicht rechteckig ist.
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.
Der Kartenbild-Layer, für den der Cache-Status geändert wird. Sie können ihn auswählen, indem Sie in "Portal" zu dem gewünschten Service navigieren. Sie haben auch die Möglichkeit, einen Web-Kachel-Layer per Drag-and-drop aus dem Bereich Katalog der Registerkarte Portal zu verschieben, um diesen Parameter einzugeben.
Image Service; Map Server
manage_mode
Gibt die Aktion an, die für die vom Server verwendeten Cache-Status-Informationen ausgeführt werden.
DELETE_CACHE_STATUS—Löscht die vom Server verwendeten Statusinformationen.
REBUILD_CACHE_STATUS—Löscht die vom Server verwendeten Statusinformationen und erstellt sie anschließend neu.
REPORT_BUNDLE_STATUS—Erstellt Statusinformationen in einer neuen File-Geodatabase mit dem Namen Status.gdb in einem Ordner, den Sie im Parameter report_folder angegeben haben. Diese Option wird verwendet, wenn Sie einen benutzerdefinierten Statusbericht für einen bestimmten Interessenbereich oder einen Satz von Maßstäben erstellen möchten.
String
scales[scales,...]
(Optional)
Die Maßstabsebenen, für die der Status geändert wird. Dieser Parameter ist nur anwendbar, wenn ein benutzerdefinierter Status mit der Option REPORT_BUNDLE_STATUS für den Parameter manage_mode erstellt wird.
Double
num_of_caching_service_instances
(Optional)
Definiert die Anzahl der Instanzen, die zum Aktualisieren/Erstellen der Kacheln verwendet werden. Der Wert für diesen Parameter ist auf unbegrenzt (-1) festgelegt und kann nicht geändert werden.
Long
report_folder
(Optional)
Ausgabeordner für die Status.gdb. Dieser Parameter ist nur anwendbar, wenn ein benutzerdefinierter Status mit der Option REPORT_BUNDLE_STATUS erstellt wird.
Folder
area_of_interest
(Optional)
Ein Interessenbereich (Polygon), der bestimmt, welche Geographie der Statusbericht abdeckt. Dieser Parameter ist nur anwendbar, wenn ein benutzerdefinierter Status mit der Option REPORT_BUNDLE_STATUS erstellt wird.
Feature Set
report_extent
(Optional)
Eine Rechtecksausdehnung, die den Bereich definiert, für den der Status erstellt wird. Dieser Parameter ist nur anwendbar, wenn ein benutzerdefinierter Status mit der Option REPORT_BUNDLE_STATUS erstellt wird.
Übrigens können Sie mit dem Parameter area_of_interest einen Interessenbereich angeben, der keine Rechteckform aufweist.
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.
Eine durch Leerzeichen getrennte Zeichenfolge von Koordinaten: Die Ausdehnung der angegebenen Zeichenfolge wird verwendet. Koordinaten werden im Format X-Min, Y-Min, X-Max, Y-Max angegeben.
Extent
Abgeleitete Ausgabe
Name
Erläuterung
Datentyp
output_folder
Die Ausgabeservice-URL.
String
Codebeispiel
ManageMapServerCacheStatus: Beispiel (eigenständiges Skript)
Löscht die Statusinformationen für einen Cache.
# Name: ManageMapServerCacheStatus.py
# Description: The following stand-alone script demonstrates how to delete
# Status of cache using ManageMapServerCachStatus tool
# Any line that begins with a pound sign is a comment and will not be run
# Empty quotes take the default value.
# To accept arguments from the command line replace values of variables to
# "sys.argv[]"
# Import system modules
import arcpy
import sys
import time
import datetime
# Set environment settings
arcpy.env.workspace = "C:/data"
# List of input variables for map service properties
connectionFile = r"C:\Users\<username>\AppData\Roaming\ESRI\Desktop10.1\ArcCatalog"
server = "arcgis on MyServer_6080 (publisher)"
serviceName = "Rainfall.MapService"
inputService = f"{connectionFile}\\{server}\\{serviceName}"
scales = ""
manageMode = "DELETE_CACHE_STATUS"
numOfCachingServiceInstances = "2"
outputFolder = ""
areaOfInterest = ""
reportExtents = ""
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = f'C:/data/report_{arg1}.txt'
# Print results of the script to a report
report = open(file, 'w')
# Use "scales[0]", "scales[-1]", "scales[0:3]"
try:
starttime = time.clock()
result = arcpy.server.ManageMapServerCacheStatus(
inputService,
manageMode,
scales,
numOfCachingServiceInstances,
outputFolder,
areaOfInterest,
reportExtents
)
finishtime = time.clock()
elapsedtime = finishtime - starttime
#print messages to a file
while result.status < 4:
time.sleep(0.2)
resultValue = result.getMessages()
report.write(f"completed {resultValue}")
print(f"Reported the Bundle status for scale = {scales[-1]} of {serviceName} at {outputFolder}")
print(f"using specified feature class {areaOfInterest} in {elapsedtime} sec {arg2}")
except Exception as err:
# If an error occurred, print line number and error message
tb = sys.exc_info()[2]
report.write(f"Failed at step 3 \nLine {tb.tb_lineno}")
report.write(str(err))
report.close()
Umgebungen
Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.
: Die Ausdehnung basiert auf der aktiven Karte oder Szene.
: Die Ausdehnung basiert auf einem Rechteck, das auf der Karte oder Szene aufgezogen wurde.
: 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:
: Die Ausdehnung aller Features.
: Die Ausdehnung der ausgewählten Features.
: Die Ausdehnung sichtbarer Features.
: Die Ausdehnung basiert auf einem Dataset.
: Die Ausdehnung kann in die und aus der Zwischenablage kopiert werden.
: Kopiert die Ausdehnung und das Koordinatensystem in die Zwischenablage.
: Die Ausdehnung wird auf den Standardwert zurückgesetzt.