Gérer l'état d’un cache de serveur de carte—Aide

Résumé
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

Résumé

Gère des données internes conservées par le serveur qui concernent les tuiles générées dans un cache de service de carte ou d'imagerie.

Utilisation

Cet outil peut supprimer ou recréer les informations sur l'état d'avancement du cache signalées dans ArcMap ou le gestionnaire ArcGIS Server.
Cet outil permet de recréer l'état du cache une fois que vous avez copié manuellement les tuiles dans le répertoire de cache ou créé des tuiles à la demande.
C'est le seul outil qui permette de créer l'état d'un cache conçu avec une version antérieure d'ArcGIS Server.
Vous pouvez utiliser cet outil afin de créer des rapports d'état pour des zones d'intérêt personnalisées et des niveaux d'échelle, plutôt que de créer l'état de l'ensemble du cache. Pour ce faire, définissez le paramètre Mode de gestion (manage_mode dans Python) sur REPORT_BUNDLE_STATUS. Le rapport est stocké dans une nouvelle géodatabase fichier intitulée Status.gdb, plus particulièrement dans une classe d'entités nommée TaskStatus que vous pouvez afficher dans ArcMap.
Notez que votre répertoire de cache contient également une géodatabase Status.gdb appartenant à l'ensemble du cache et mise à jour lorsque vous utilisez les autres options Mode de gestion de cet outil. Vous ne pouvez pas remplacer une géodatabase Status.gdb par une autre à cet emplacement.

Syntaxe

ManageMapServerCacheStatus_server (input_service, {scales}, manage_mode, {num_of_caching_service_instances}, {report_folder}, {report_extent}, {area_of_interest})

Paramètre	Explication	Type de données
input_service	Nom du service de carte ou d'imagerie dont l'état sera modifié. Cette chaîne contient les informations relatives au serveur et au service. Pour savoir comment construire cette chaîne, ouvrez ArcCatalog, sélectionnez votre service dans l'arborescence du catalogue et notez le texte dans la barre d'outils Emplacement. Remplacez les barres obliques inverses par des barres obliques, par exemple, GIS Servers/arcgis on MYSERVER (admin)/USA.MapServer.	String
scales (Facultatif)	Niveaux d'échelle dont l'état sera modifié. Ce paramètre s'applique uniquement lors de la création d'un état personnalisé à l'aide de l'option REPORT_BUNDLE_STATUS pour le paramètre manage_mode.	Double
manage_mode	DELETE_CACHE_STATUS —Supprime les informations d'état utilisées par le serveur. REBUILD_CACHE_STATUS —Supprime puis recrée les informations d'état utilisées par le serveur. REPORT_BUNDLE_STATUS —Crée des informations d'état dans une nouvelle géodatabase fichier intitulée Status.gdb dans un dossier que vous spécifiez dans le paramètre Dossier en sortie. Utilisez cette option si vous souhaitez créer un rapport d'état personnalisé pour une zone d'intérêt ou un jeu d'échelles spécifiques.	String
num_of_caching_service_instances (Facultatif)	Nombre total d'instances du service des outils de mise en cache du dossier système que vous souhaitez utiliser pour exécuter cet outil. Vous pouvez augmenter le nombre maximum d'instances par machine du service des outils de mise en cache du dossier système en ouvrant la fenêtre Editeur de services via une connexion administrateur à ArcGIS Server. Assurez-vous que vos machines serveur peuvent prendre en charge le nombre d'instances sélectionné. Cet outil utilise trois instances par défaut, si elles sont disponibles. L'opération risque d'être ralentie si vous utilisez cet outil avec davantage d'instances.	Long
report_folder (Facultatif)	Dossier en sortie pour Status.gdb. Ce paramètre s'applique uniquement lors de la création d'un état personnalisé à l'aide de l'option REPORT_BUNDLE_STATUS. Le compte exécutant ArcGIS for Desktop doit posséder des droits d'accès en écriture sur ce dossier. Ce dossier ne doit pas déjà contenir une géodatabase Status.gdb.	Folder
report_extent (Facultatif)	Etendue rectangulaire définissant la zone dont l'état sera créé. Ce paramètre s'applique uniquement lors de la création d'un état personnalisé à l'aide de l'option REPORT_BUNDLE_STATUS. Notez la présence du paramètre Zone d'intérêt qui permet de spécifier une zone d'intérêt non rectangulaire.	Extent
area_of_interest (Facultatif)	Zone d'intérêt (polygone) qui détermine la géographie couverte par le rapport d'état. Il peut s'agir d'une classe d'entités ou d'une entité que vous définissez de manière interactive dans ArcMap. Ce paramètre s'applique uniquement lors de la création d'un état personnalisé à l'aide de l'option REPORT_BUNDLE_STATUS.	Feature Set

Exemple de code

Exemple ManageMapServerCacheStatusSupprime les informations d'état d'un cache.

# Name: ManageMapServerCacheStatus.py
# Description: The following stand-alone script demonstrates how to delete 
# status of cache using ManageMapServerCachStatus tool  

# Requirements: os, sys, time and traceback modules
# Any line that begins with a pound sign is a comment and will not be executed
# 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
from arcpy import env
import os, sys, time, datetime, traceback, string

# Set environment settings
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 = 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 = "C:/data/report_%s.txt" % arg1

# 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.ManageMapServerCacheStatus_server(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 ("completed " + str(resultValue))
    
    print "Reported the Bundle status for scale =" + str(scales[-1]) + "of " +\
    serviceName + "at " + outputFolder + "\n using specified feature class " +\
    areaOfInterest + " in " + str(elapsedtime) + " sec \n on " + arg2

except Exception, e:
    # If an error occurred, print line number and error message
    tb = sys.exc_info()[2]
    report.write("Failed at step 3 \n" "Line %i" % tb.tb_lineno)
    report.write(e.message)

report.close()

Environnements

Cet outil n'utilise aucun environnement de géotraitement

Informations de licence

ArcGIS Desktop Basic: Oui
ArcGIS Desktop Standard: Oui
ArcGIS Desktop Advanced: Oui