Gérer des tuiles de cache de serveur de globe (Serveur)—ArcMap

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

Résumé

Crée et actualise des tuiles dans un cache de service de globe existant. Cet outil permet de créer des tuiles ou de remplacer des tuiles manquantes, d'actualiser des tuiles devenues obsolètes ou d'ajouter de nouvelles tuiles. Toutes ces actions peuvent être définies par des étendues rectangulaires ou par une classe d'entités surfaciques. Lorsque vous créez de nouvelles tuiles, vous pouvez choisir de créer uniquement des tuiles vides ou de recréer toutes les tuiles.

Utilisation

Cet outil doit être utilisé pour mettre à jour un cache du serveur de globe existant. Pour mettre un cache à jour, indiquez le nom du serveur ArcGIS hébergeant le service de globe. L'outil répertorie automatiquement tous les services de globe disponibles sur ce serveur.
L'exécution d'une mise à jour sans spécifier d'étendue a pour effet de mettre à jour toute l'étendue du service.
Lorsque vous spécifiez les paramètres level_from et level_to des couches en entrée, veillez à préciser tous les niveaux auxquels vous souhaitez générer des tuiles. Le paramètre level_from définit le niveau de détail le plus faible avec lequel vous souhaitez que votre cache de données commence. Le paramètre level_to définit la résolution la plus élevée que vous souhaitez attribuer à votre mise en cache de données.

Syntaxe

arcpy.server.ManageGlobeServerCacheTiles(service, in_layers, update_mode, {num_of_caching_service_instances}, {area_of_interest}, {ignore_status}, {update_extent})

Paramètre	Explication	Type de données
service	Service de globe dont vous souhaitez mettre à jour les tuiles de cache. Cette chaîne contient les informations relatives au serveur et au service. Pour savoir comment construire cette chaîne, ouvrez ArcCatalog, sélectionnez le 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, comme suit : GIS Servers/arcgis on MYSERVER (admin)/Seattle.GlobeServer.	GlobeServer
in_layers [[layer, level_from, level_to],...]	Couches à inclure dans le cache. Pour chaque couche, vous devez fournir un paramètre level_from, qui correspond au niveau de détail auquel vous souhaitez commencer la mise en cache de la couche, ainsi qu'un paramètre level_to, qui désigne le niveau de détail auquel vous souhaitez terminer la mise en cache de la couche. Si les niveaux de détail minimum et maximum sont utilisés respectivement pour les paramètres level_from et level_to, un cache total est conçu pour la couche.	Value Table
update_mode	Définit le mode de mise à jour du cache. Les deux modes disponibles sont les suivants : RECREATE_EMPTY_TILES —Seules les tuiles vides sont créées. Les tuiles existantes restent en l'état. RECREATE_ALL_TILES —Toutes les tuiles, y compris les tuiles existantes, sont remplacées. Par ailleurs, de nouvelles tuiles sont ajoutées si l'étendue des données d'une couche a changé ou si de nouvelles couches ont été ajoutées au service de globe et répertoriées dans cet outil.	String
num_of_caching_service_instances (Facultatif)	Nombre total d'instances du service System/CachingTools qui seront utilisées pour exécuter cet outil. Vous pouvez augmenter le paramètre Nombre maximum d'instances par machine du service System/CachingTools dans la fenêtre Éditeur de services disponible via une connexion administrateur à ArcGIS Server. Assurez-vous que vos machines serveur peuvent prendre en charge le nombre d'instances sélectionné.	Long
area_of_interest (Facultatif)	Définit une zone d'intérêt pour contraindre l'emplacement où les tuiles seront créées ou supprimées. 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 est utile si vous souhaitez gérer des tuiles pour les zones de forme irrégulière. Il permet également de mettre certaines zones en cache et de conserver telles quelles les zones moins visitées qui n'ont pas été mises en cache.	Feature Set
ignore_status (Facultatif)	Ce paramètre vous permet de suivre l'état de la mise en cache si vous créez des tuiles selon les limites de classe d'entités (voir le paramètre update_feature_class). TRACK_STATUS —Le champ Mis en cache de la classe d'entités est lu (et créé s'il n'existe pas encore). Les entités contenant la valeur Non ou Null dans ce champ sont mises en cache et affichent Oui lorsque la mise en cache de l'entité est terminée. Les entités déjà signalées par un Oui dans ce champ ne sont pas mises en cache. DO_NOT_TRACK_STATUS —Le champ Mis en cache de la classe d'entités est ignoré et des tuiles sont créées pour toutes les entités de la classe d'entités.	Boolean
update_extent (Facultatif)	Etendue rectangulaire dans laquelle les tuiles doivent être créées ou supprimées, selon la valeur du paramètre update_mode. Vous pouvez saisir des valeurs d'étendue ou choisir une étendue à partir d'une source de données existante.	Extent

Exemple de code

Crée des tuiles de cache pour un service de globe.

#ManageGlobeServerCacheTiles For ArcGIS Server 10.1 Beta example (stand-alone script)

# Name: ManageGlobeServerCacheTiles.py
# Description: The following stand-alone script demonstrates how to update the
#               globe map server cache tiles
# Requirements: os, sys, time & traceback modules 
# Author: ESRI

# Any line that begins with a pound sign is a comment and will not be executed
# Empty quotes take the default values
# 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)"
globeServiceName = "tstGlobeService.GlobeService"
globeService = connectionFile + "\\" + server + "\\" + globeServiceName
inputLayers = ""
updateExtents = ""
updateMode = "RECREATE_ALL_TILES"
numOfCachingServiceInstances = "2"
areaOfInterest = ""
ignoreStatus = "DO_NOT_TRACK_STATUS"

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')

try:
    starttime= time.clock()
    result = arcpy.ManageGlobeServerCacheTiles_server (globeService, inputLayers,
                                                       updateMode,
                                                       numOfCachingServiceInstances,
                                                       areaOfInterest,
                                                       ignoreStatus, updateExtents)
    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 "Created the GlobeServer cache successfully for mapservice "
    globeService + "\n 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 1 \n" "Line %i" % tb.tb_lineno)
    report.write(e.message)
report.close()
    
print "Created the globe server cache successfully"

Environnements

Cet outil n'utilise pas d’environnement de géotraitement.

Informations de licence

Basic: Requiert 3D Analyst
Standard: Requiert 3D Analyst
Advanced: Requiert 3D Analyst