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 puede quitar o regenerar la información de estado de finalización de caché proporcionada en ArcMap o ArcGIS Server Manager.
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.
Sintaxis
ManageMapServerCacheStatus_server (input_service, manage_mode, {scales}, {num_of_caching_service_instances}, {report_folder}, {area_of_interest}, {report_extent})| Parámetro | Explicación | Tipo de datos |
input_service | El mapa o servicio de imágenes en el que se modificará el estado. 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 su servicio en el árbol Catálogo y observe el texto en la barra de herramientas Ubicación. Cambie las barras diagonales inversas a barras diagonales, por ejemplo, GIS Servers/arcgis on MYSERVER (admin)/USA.MapServer. | Image Service; MapServer |
manage_mode |
| 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) | La cantidad total de instancias del servicio System/CachingTools que desea dedicar a ejecutar esta herramienta. Puede aumentar la 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 de servidor son compatibles con el número de instancias elegidos. Esta herramienta usa tres instancias de forma predeterminada si hay muchas disponibles. El uso de un gran número de instancias con esta herramienta puede ralentizar la operación. | Long |
report_folder (Opcional) | Carpeta de salida para el 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 cuando se crea 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. | Extent |
Muestra de código
Ejemplo de ManageMapServerCacheStatus (secuencia de comandos 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.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()
Entornos
Esta herramienta no utiliza ningún entorno de geoprocesamiento.
Información sobre licencias
- ArcGIS Desktop Basic: Sí
- ArcGIS Desktop Standard: Sí
- ArcGIS Desktop Advanced: Sí