Administrar teselas de caché de servidor de mapas (Servidor)

Resumen

Crea y actualiza teselas en una caché de capa de teselas web existente (en ArcGIS Enterprise o ArcGIS Online), capas de imágenes de mapa en ArcGIS Enterprise y servicios de imágenes o mapas en caché en un servidor independiente. Esta herramienta se utiliza para crear teselas nuevas, reemplazar teselas faltantes, sobrescribir teselas desactualizadas o eliminar teselas.

Uso

• Esta herramienta puede tardar demasiado en ejecutarse para caché que cubren una extensión geográfica grande o escalas de mapas muy grandes. Si la herramienta se cancela, la creación de teselas se detiene, pero las teselas existentes no se eliminan. Significa que puede cancelar la herramienta si no tiene tiempo suficiente y volver a ejecutarla más tarde en la misma caché estableciendo el parámetro Modo Actualizar en Volver a crear teselas vacías.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Servicio de entrada	La capa de teselas web, la capa de imágenes web o la capa de imágenes de mapa cuyas teselas de caché se actualizarán.	Image Service; Map Server
Escalas	Lista de niveles de escala a los cuales se crearán las teselas. De forma predeterminada, las escalas enumeradas en el cuadro de diálogo de la herramienta se encuentran entre el mínimo y máximo de escalas en caché para el servicio. No puede cambiar el rango de escala de la caché del servicio en ArcGIS Pro.	Double
Modo Actualizar	Especifica el modo que se utilizará para actualizar la caché. Volver a crear teselas vacías—Solo se crearán teselas que estén vacías. Las teselas existentes se dejarán sin cambios. Esta opción no está disponible para capas de teselas web publicadas en ArcGIS Online. Volver a crear todas las teselas—Las teselas existentes se sustituirán y se agregarán teselas nuevas si la extensión ha cambiado. Eliminar teselas—Las teselas se eliminarán de la caché. La estructura de la carpeta de caché no se eliminará.	String
Número de instancias de almacenamiento de servicios en caché (Opcional)	La cantidad total de instancias del servicioSystem/CachingTools que desea dedicar a ejecutar esta herramienta. Si se usa el valor predeterminado de -1, se usarán todas las instancias de la herramienta de almacenamiento en caché de la configuración de ArcGIS Enterprise. Utilice un valor más bajo para utilizar menos instancias de la herramienta de almacenamiento en caché. 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. Cuando se conecta a un servidor independiente, el número predeterminado de instancias es igual al valor de la configuración Número máximo de instancias del servicio de la herramienta de almacenamiento en caché.	Long
Área de interés (Opcional)	Un área de interés que restringirá dónde se van a crear o eliminar las teselas. Este parámetro es útil para administrar teselas para áreas con formas irregulares. También resulta útil cuando se almacenan previamente en caché algunas áreas y se dejan sin almacenar en caché las áreas menos visitadas. Si no proporciona un valor para este parámetro, el valor predeterminado es utilizar la extensión completa del mapa.	Feature Set
Actualizar extensión (Opcional)	Una extensión rectangular usada para crear o eliminar teselas, según el valor del parámetro Modo actualizar. Si se especifican los valores de los parámetros Actualizar extensión y Área de interés, se utilizará el valor Área de interés. 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
Esperar que se complete el trabajo (Opcional)	Especifica si la herramienta continuará ejecutándose mientras se ejecuta el trabajo de caché en ArcGIS Online o Portal for ArcGIS. Activado: la herramienta seguirá ejecutándose mientras el trabajo de la caché se ejecuta en ArcGIS Online o Portal for ArcGIS. Con esta opción, puede solicitar informes de progreso detallados en cualquier momento y ver los mensajes de geoprocesamiento a medida que aparecen. Esta es la opción predeterminada. Desactivado: Se enviará un trabajo al portal, de modo que podrá realizar otras tareas de geoprocesamiento en ArcGIS Pro o cerrarlo. Utilice esta opción cuando esté creando una caché automáticamente en el momento de publicar el servicio. También puede configurar esta opción en cualquier otra caché que cree.	Boolean
URL del portal (Opcional)	La URL del portal.	String

Salida derivada

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

Python

arcpy.server.ManageMapServerCacheTiles(input_service, scales, update_mode, {num_of_caching_service_instances}, {area_of_interest}, {update_extent}, {wait_for_job_completion}, {portal_url})

Nombre	Explicación	Tipo de datos
input_service	La capa de teselas web, la capa de imágenes web o la capa de imágenes de mapa cuyas teselas de caché se actualizarán.	Image Service; Map Server
scales [scales,...]	Lista de niveles de escala a los cuales se crearán las teselas.	Double
update_mode	Especifica el modo que se utilizará para actualizar la caché. RECREATE_EMPTY_TILES—Solo se crearán teselas que estén vacías. Las teselas existentes se dejarán sin cambios. Esta opción no está disponible para capas de teselas web publicadas en ArcGIS Online. RECREATE_ALL_TILES—Las teselas existentes se sustituirán y se agregarán teselas nuevas si la extensión ha cambiado. DELETE_TILES—Las teselas se eliminarán de la caché. La estructura de la carpeta de caché no se eliminará.	String
num_of_caching_service_instances (Opcional)	La cantidad total de instancias del servicioSystem/CachingTools que desea dedicar a ejecutar esta herramienta. Si se usa el valor predeterminado de -1, se usarán todas las instancias de la herramienta de almacenamiento en caché de la configuración de ArcGIS Enterprise. Utilice un valor más bajo para utilizar menos instancias de la herramienta de almacenamiento en caché. 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. Cuando se conecta a un servidor independiente, el número predeterminado de instancias es igual al valor de la configuración Número máximo de instancias del servicio de la herramienta de almacenamiento en caché.	Long
area_of_interest (Opcional)	Un área de interés que restringirá dónde se van a crear o eliminar las teselas. Este parámetro es útil para administrar teselas para áreas con formas irregulares. También resulta útil cuando se almacenan previamente en caché algunas áreas y se dejan sin almacenar en caché las áreas menos visitadas. Si no proporciona un valor para este parámetro, el valor predeterminado es utilizar la extensión completa del mapa.	Feature Set
update_extent (Opcional)	Una extensión rectangular usada para crear o eliminar teselas, según el valor del parámetro update_mode. Si se especifican los valores de los parámetros update_extent y area_of_interest, se utilizará el valor area_of_interest. 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
wait_for_job_completion (Opcional)	Especifica si la herramienta continuará ejecutándose mientras se ejecuta el trabajo de caché en ArcGIS Online o Portal for ArcGIS. WAIT—La herramienta seguirá ejecutándose mientras el trabajo de la caché se ejecute en ArcGIS Online o Portal for ArcGIS. Con esta opción, puede solicitar informes de progreso detallados en cualquier momento y ver los mensajes de geoprocesamiento a medida que aparecen. Esta es la opción predeterminada. Se recomienda que utilice esta opción en los scripts de Python. DO_NOT_WAIT—Se enviará un trabajo al servidor, de modo que podrá realizar otras tareas de geoprocesamiento. Utilice esta opción cuando esté creando una caché automáticamente en el momento de publicar el servicio. También puede configurar esta opción en cualquier otra caché que cree.	Boolean
portal_url (Opcional)	La URL del portal.	String

Salida derivada

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

Muestra de código

Ejemplo de ManageMapServerCacheTiles (script independiente)

A continuación, se muestra cómo volver a crear todas las teselas de caché para un mapa o servicio de imágenes utilizando un área de interés.

# Name: ManageMapServerCacheTiles.py
# Description: The following stand-alone script demonstrates how to Recreate all 
#               cache tiles for for a map or image service using an area of interest.
#               This tool works for weblayers published to ArcGIS Enterprise and ArcGIS Online.
#               and for map and image services on a stand alone ArcGIS Server

# Example: This sample script updates map cache tiles.

import arcpy
import os

# Sign in to portal
myPortal= "https://www.myArcGISEnterprise.com/webadaptor"
arcpy.SignInToPortal(myPortal, "MyUserName", "MyPassword")
serviceName= "MyCounty"
serviceType= "MapServer"
myPortalServiceURL = (myPortal + "/" + "rest/services" +"/" + serviceName + "/" + serviceType)


# Stand alone ArcGIS Server
target_server_connection = r"C:\Project\gisserver.ags.esri.com (publisher).ags"
serviceName= "MyCounty"
serviceType= "MapServer"
myServerServiceURL= target_server_connection + "/" + serviceName + "." + serviceType


#variables for reporting
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = 'C:/data/report_%s.txt' % arg1


# List of input variables for map or image service 
scales = [500000,250000]
numOfCachingServiceInstances = 8
updateMode = "RECREATE_ALL_TILES"
areaOfInterest = "C:/data/shp/CaTxFlMaMin.shp"
waitForJobCompletion = "WAIT"
updateExtents = ""
portalURL =""

# Variables for reporting
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:
    result = arcpy.server.ManageMapServerCacheTiles(mytest, scales, updateMode,
                                                    numOfCachingServiceInstances, areaOfInterest,
                                                    updateExtents, waitForJobCompletion,
                                                    portalURL)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print ("Created cache tiles for given schema successfully for " + serviceName )
    
except Exception as e:
    # If an error occurred, print line number and error message
    import traceback, sys
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(e.message)
report.close()

print ("Completed update of cache tiles for " + serviceName)

Entornos

Espacio de trabajo actual

Información de licenciamiento

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