Administrar teselas de caché de servidor de globo (Servidor)—ArcMap

Resumen
Uso
Sintaxis
Muestra de código
Entornos
Información de licenciamiento

Resumen

Crea y actualiza las teselas en una caché del servicio de globo existente. Esta herramienta se utiliza para crear teselas nuevas o para reemplazar teselas faltantes, sobrescribir teselas desactualizadas o agregar teselas nuevas. Todas estas acciones se pueden definir por medio de extensiones rectangulares o por medio de una clase de entidad poligonal. Al crear teselas nuevas, puede elegir si crear solo teselas vacías o recrear todas las teselas.

Uso

Esta herramienta se debe utilizar para actualizar una caché para el servidor globe existente. Para actualizar una caché, especifique el ArcGIS Server que aloja el servicio de globo. La herramienta enumerará automáticamente todos los servicios de globo disponibles en ese servidor.
Si ejecuta la actualización sin especificar una extensión se actualiza la extensión completa del servicio.
Al especificar level_from y level_to para las capas de entrada, asegúrese de especificar todos los niveles en los cuales desea que se generen teselas. En level_from se define el nivel de detalle más bajo con el que desea que se inicie la caché de datos. En level_to se define la resolución más alta que desea para el almacenamiento en caché de los datos.

Sintaxis

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

Parámetro	Explicación	Tipo de datos
service	El servicio de globo cuyas teselas de caché desea actualizar. Esta es una cadena de caracteres que contiene la información del servidor y de servicios. Para ver cómo construir esta cadena de caracteres, abra ArcCatalog, seleccione el servicio en el árbol Catálogo y observe el texto en la barra de herramientas Ubicación. Cambie las barras invertidas a barras diagonales, por ejemplo, GIS Servers/arcgis on MYSERVER (admin)/Seattle.GlobeServer.	GlobeServer
in_layers [[layer, level_from, level_to],...]	Las capas que se incluirán en la caché. Para cada capa, es necesario especificar el campo level_from, que comprende el nivel de detalle donde desea que se inicie el almacenamiento en caché de la capa, y level_to, que es el nivel de detalle en el que desea que finalice el almacenamiento en caché de la capa. Si se utilizan los niveles de detalle más pequeños y más grandes para level_from y level_to, respectivamente, se construirá una caché completa para la capa.	Value Table
update_mode	Elija un modo para actualizar la memoria caché. Los dos modos son: RECREATE_EMPTY_TILES —Solo se crearán teselas que estén vacías. Las teselas existentes se dejarán sin cambios. RECREATE_ALL_TILES —Se reemplazarán todas las teselas, incluso las teselas existentes. Adicionalmente, se agregarán teselas nuevas si se cambió la extensión de datos de una capa o se agregaron capas nuevas al servicio de globo y se enumeran en esta herramienta.	String
num_of_caching_service_instances (Opcional)	La cantidad total de instancias del servicio System/CachingTools que desea dedicar a ejecutar esta herramienta. Puede aumentar el ajuste Cantidad máxima de instancias por equipo del servicio System/CachingTools utilizando la ventana Editor del servicio, que está disponible a través de una conexión administrativa a ArcGIS Server. Asegúrese de que los equipos servidores sean compatibles con el número de instancias elegido.	Long
area_of_interest (Opcional)	Define un área de interés para restringir dónde se van a crear o eliminar las teselas. Esta puede ser una clase de entidad o puede ser una entidad que usted defina de forma interactiva en ArcMap. Este parámetro es útil si desea administrar teselas para áreas con formas irregulares. También es útil en situaciones donde desea almacenar en la caché algunas áreas y dejar sin almacenar las áreas menos visitadas.	Feature Set
ignore_status (Opcional)	Este parámetro permite rastrear el estado del almacenamiento en caché si está creando teselas basadas en límites de clase de entidad (consulte el parámetro update_feature_class). TRACK_STATUS —Se lee el campo Almacenado en la caché de la clase de entidad (y se crea si todavía no existe). Las entidades que contienen No o nulo en este campo se almacenan en caché y contendrán Sí si se completó el almacenamiento en caché para la entidad. Las entidades que ya están marcadas con Sí en este campo no se almacenan en la caché. DO_NOT_TRACK_STATUS —Se ignora el campo Almacenado en la caché de la clase de entidad y se crean teselas para todas las entidades en la clase de entidad.	Boolean
update_extent (Opcional)	La extensión rectangular en la cual se deben crear o eliminar las teselas, según el valor del parámetro update_mode. Puede escribir los valores de extensión o elegir una extensión desde una fuente de datos existente.	Extent

Muestra de código

Crea las teselas de la caché para un servicio de globo.

#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"

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

Basic: Requiere 3D Analyst
Standard: Requiere 3D Analyst
Advanced: Requiere 3D Analyst