Administrar el estado de la caché del servidor de mapas (Servidor)

Resumen

Administra los datos internos mantenidos por el servidor sobre las teselas construidas en la caché de un servicio de mapas o imágenes.

Uso

• Esta herramienta es útil para volver a crear el estado de la caché después de copiar manualmente las teselas en el directorio de caché o crear teselas según demanda.

• Esta herramienta es la única forma de crear un estado para una caché creada a su vez con una versión anterior de ArcGIS Server o Portal for ArcGIS.

• En lugar de crear un estado para toda la caché, puede usar alternativamente esta herramienta para crear informes de estado para áreas personalizadas de interés y niveles de escala. Esto se consigue estableciendo el parámetro Administrar modo (manage_mode en Python) en REPORT_BUNDLE_STATUS. El informe se almacena en una nueva geodatabase de archivos denominada Status.gdb, concretamente en una clase de entidad denominada TaskStatus.

  Tenga en cuenta que el directorio de la caché también contiene un Status.gdb que pertenece a toda la caché y se actualiza cuando se usan las otras opciones de Administrar modo para esta herramienta. No puede sustituir un Status.gdb personalizado en esta ubicación.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Servicio de entrada	La capa de imágenes de mapa para la que se modificará el estado de caché. Puede elegirla yendo al servicio deseado en Portal o bien puede arrastrar y soltar una capa de teselas web desde el panel Catálogo, pestaña Portal para proporcionar este parámetro.	Image Service; Map Server
Administrar modo	Eliminar estado de caché—Elimina la información de estado utilizada por el servidor. Reconstruir estado de caché—Elimina y, a continuación, vuelve a crear la información de estado utilizada por el servidor. Reconstruir estado del paquete—Crea información de estado en una nueva geodatabase de archivos denominada Status.gdb en la carpeta que especifique en el parámetro Carpeta de salida. Esta opción se usa si desea crear un informe de estado personalizado para un área de interés o un conjunto de escalas en particular.	String
Escalas (Opcional)	Los niveles de escala para los que se modificará el estado. Este parámetro solo es aplicable al crear un estado personalizado mediante la opción Reconstruir estado del paquete del parámetro Administrar modo.	Double
Número de instancias de almacenamiento de servicios en caché (Opcional)	Define la cantidad de instancias que se utilizarán para actualizar/generar las teselas. El valor de este parámetro está establecido en sin límite (-1) y no se puede modificar.	Long
Carpeta de salida (Opcional)	Carpeta de salida para Status.gdb. Este parámetro solo es aplicable al crear un estado personalizado mediante la opción Reconstruir estado del paquete.	Folder
Área de interés (Opcional)	Un área de interés (polígono) que determina la geografía que abarcará el informe de estado. Este parámetro solo es aplicable al crear un estado personalizado mediante la opción Reconstruir estado del paquete.	Feature Set
Reportar extensión (Opcional)	Una extensión rectangular que define el área para la que se creará el estado. Este parámetro solo es aplicable al crear un estado personalizado mediante la opción Reconstruir estado del paquete. Observe que el parámetro Área de interés permite especificar un área de interés no rectangular. Extensión de visualización actual : la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo. Extensión de dibujo : la extensión se basará en un rectángulo dibujado en el mapa o la escena. Esta opción creará una clase de entidad en la geodatabase del proyecto y agregará una capa al mapa. La clase de entidad tendrá el mismo sistema de coordenadas que el mapa. Nota: Esta opción no está disponible en el cuadro de diálogo Entornos. Solo está disponible desde un parámetro de herramienta con un tipo de datos de extensión o desde la pestaña Entornos de un cuadro de diálogo de herramienta. Nota: Cuando la opción de edición Habilitar y deshabilitar edición en la pestaña Editar está activada, es preciso habilitar la edición en la pestaña Editar de la cinta para dibujar la extensión. Extensión de mapa : la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción Extensión de datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas. Cada capa de mapas tiene las opciones siguientes: Todas las entidades : extensión de todas las entidades en una capa. Entidades seleccionadas: extensión de las entidades seleccionadas en la capa. Entidades visibles : extensión de las entidades visibles en la capa. Nota: Las extensiones de las opciones Entidades seleccionadas y Entidades visibles solo están disponibles para capas de entidades. Examinar : la extensión se basará en un dataset existente. Portapapeles : la extensión puede copiarse y pegarse desde el portapapeles. Copiar extensión : copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles. Usar Pegar extensión : pega las coordenadas de la extensión y, si se desea, el sistema de coordenadas desde el portapapeles. Si los valores del portapapeles no incluyen un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa. Nota: Las coordenadas de la extensión se copian del portapapeles y se pegan con el mismo formato y orden que el objeto Extent de ArcPy: x-min, y-min, x-max, y-max y referencia espacial. Restablecer extensión : la extensión se restablecerá al valor predeterminado. Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo. Precaución: El mapa podría utilizar unidades de visualización distintas de las coordenadas introducidas. No se admite el uso de una dirección cardinal (N, S, E, O). Utilice un valor de signo negativo para las coordenadas sur y oeste.	Extent

Salida derivada

Etiqueta	Explicación	Tipo de datos
Dirección URL del servicio de mapas de salida	La URL de servicio de salida.	String

Python

arcpy.server.ManageMapServerCacheStatus(input_service, manage_mode, {scales}, {num_of_caching_service_instances}, {report_folder}, {area_of_interest}, {report_extent})

Nombre	Explicación	Tipo de datos
input_service	La capa de imágenes de mapa para la que se modificará el estado de caché. Puede elegirla yendo al servicio deseado en Portal o bien puede arrastrar y soltar una capa de teselas web desde el panel Catálogo, pestaña Portal para proporcionar este parámetro.	Image Service; Map Server
manage_mode	DELETE_CACHE_STATUS—Elimina la información de estado utilizada por el servidor. REBUILD_CACHE_STATUS—Elimina y, a continuación, vuelve a crear la información de estado utilizada por el servidor. REPORT_BUNDLE_STATUS—Crea información de estado en una nueva geodatabase de archivos denominada Status.gdb en la carpeta que especifique en el parámetro Carpeta de salida. Esta opción se usa si desea crear un informe de estado personalizado para un área de interés o un conjunto de escalas en particular.	String
scales [scales,...] (Opcional)	Los niveles de escala para los que se modificará el estado. Este parámetro solo es aplicable cuando se crea un estado personalizado mediante la opción REPORT_BUNDLE_STATUS para el parámetro manage_mode.	Double
num_of_caching_service_instances (Opcional)	Define la cantidad de instancias que se utilizarán para actualizar/generar las teselas. El valor de este parámetro está establecido en sin límite (-1) y no se puede modificar.	Long
report_folder (Opcional)	Carpeta de salida para Status.gdb. Este parámetro solo es aplicable al crear un estado personalizado mediante la opción REPORT_BUNDLE_STATUS.	Folder
area_of_interest (Opcional)	Un área de interés (polígono) que determina la geografía que abarcará el informe de estado. Este parámetro solo es aplicable al crear un estado personalizado mediante la opción REPORT_BUNDLE_STATUS.	Feature Set
report_extent (Opcional)	Una extensión rectangular que define el área para la que se creará el estado. Este parámetro solo es aplicable al crear un estado personalizado mediante la opción REPORT_BUNDLE_STATUS. Observe que el parámetro area_of_interest permite especificar un área de interés no rectangular. MAXOF: se usará la extensión máxima de todas las entradas. MINOF: se usará el área mínima común a todas las entradas. DISPLAY: la extensión es igual a la visualización visible. Nombre de capa: se utilizará la extensión de la capa especificada. Objeto de Extent: se utilizará la extensión del objeto especificado. Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.	Extent

Salida derivada

Nombre	Explicación	Tipo de datos
output_folder	La URL de servicio de salida.	String

Muestra de código

Ejemplo de ManageMapServerCacheStatus (script independiente)

Elimine la información de estado de una caché.

# 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.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 ("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 as 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(str(e))

report.close()

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: Sí
• Standard: Sí
• Advanced: Sí