Administrar teselas de memoria caché de servidor de globo (Servidor)

Resumen

Crea y actualiza las teselas en una memoria 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 sólo teselas vacías o recrear todas las teselas.

Uso

Sintaxis

ManageGlobeServerCacheTiles_Server (server_name, object_name, {update_extent}, in_layers, {thread_count}, update_mode, {update_feature_class}, {ignore_status})
ParámetroExplicaciónTipo de datos
server_name

El equipo de ArcGIS Server que aloja el servicio de globo cuyas teselas está administrando.

String
object_name

El servicio de globo cuyas teselas se modificarán.

String
update_extent
(Opcional)

La extensión rectangular en la cual se deben crear o eliminar las teselas, según el Modo actualizar. Puede escribir los valores de extensión o elegir una extensión desde una fuente de datos existente.

Extent
in_layers
[in_layers,...]

Seleccione las capas que se incluirán en la memoria caché.

Para cada capa, es necesario especificar el campo level_from, que comprende el nivel de detalle en 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 memoria caché completa para la capa.

Value Table
thread_count
(Opcional)

Cantidad de instancias de servicio de globo para utilizar mientras ejecute esta herramienta. Por defecto, se utilizará la cantidad máxima de instancias permitidas (el valor predeterminado para un servicio de ArcGIS Server es 2). Si tiene más potencia en el servidor, puede aumentar la cantidad máxima de instancias permitidas en las Propiedades del servicio y después puede aumentar este parámetro cuando ejecuta la herramienta.

Long
update_mode

Elija un modo para actualizar la memoria caché. Los dos modos son:

  • Volver a crear teselas vacíasSólo se crearán teselas que estén vacías. Las teselas existentes se dejarán sin cambios.
  • Volver a crear todas las teselasSe 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
update_feature_class
(Opcional)

Puede utilizar una clase de entidad poligonal para administrar teselas (crear/actualizar) basadas en las extensiones de entidades de una clase de entidad. Por ejemplo, si pone en caché un país, puede suministrar una clase de entidad de áreas urbanas principales. Al hacerlo, solicita que el servidor sólo cree previamente teselas que cubran aquellas áreas urbanas. El resto de las áreas se pueden almacenar en memoria caché según demanda, cuando lo soliciten los clientes. Esto permite ahorrar el tiempo y espacio en disco que se consumiría al crear teselas innecesarias en áreas rurales.

Feature Class
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).

  • IGNORE_COMPLETION_STATUS_FIELDSe ignora el campo Completado de la clase de entidad y se crean teselas para todas las entidades en la clase de entidad. Ésta es la opción predeterminada.
  • TRACK_COMPLETION_STATUSSe lee el campo Completado de la clase de entidad (y se crea si todavía no existe). Las entidades marcadas con No o nulas en este campo se almacenan en caché y se marcan con si se completó el almacenamiento en caché para la entidad. Las entidades que ya están marcadas con en este campo no se almacenan en memoria caché.
Boolean

Ejemplo de código

Este ejemplo crea una memoria caché completa para un servicio de globo.

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

# 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
server = "MyServer"
globeServerObject = "tstGlobeService"
inputLayers = ""
extents = ""
cacheDir = "C:\\arcgisserver\\arcgiscache\\GlobeCache"
threadCount = "2"
updateMode = "Recreate All Tiles"
pathToFeatureClass = ""
ignoreStatus = "IGNORE_COMPLETION_STATUS_FIELD"

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 (server, globeServerObject, 
                                              extents, updateMode,
                                              inputLayers, threadCount,
                                              pathToFeatureClass,
                                              ignoreStatus)
    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 "
    + globeServerObject + "\n   at " + cacheDir + globeServerObject
    + " 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

Temas relacionados

Información de licencia

ArcView: Requiere 3D Analyst
ArcEditor: Requiere 3D Analyst
ArcInfo: Requiere 3D Analyst

7/11/2012