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

Resumen

Crea y actualiza los mosaicos en una caché existente de capa de teselas web (en ArcGIS Enterprise o ArcGIS Online), las capas de imágenes de mapa en ArcGIS Enterprise y los 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.

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 servicio `System/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. Extensión de dibujo : la extensión se basará en un rectángulo dibujado en el mapa o la escena. Extensión de capa : la extensión se basará en una capa de mapa activa. Elija una capa disponible o utilice la opción Extensión de datos en todas las capas. Cada capa de mapas tiene las opciones siguientes: Todas las entidades : la extensión de todas las entidades. Entidades seleccionadas : utilice la extensión de las entidades seleccionadas. Entidades visibles : la extensión de las entidades visibles. Examinar : la extensión se basará en un dataset. Portapapeles : la extensión puede copiarse en y desde el portapapeles. Copiar extensión : copia las la extensión y el sistema de coordenadas en el portapapeles. Pegar extensión : pega la extensión y el sistema de coordenadas del portapapeles. Si el portapapeles no incluye un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa. Restablecer extensión : la extensión se restablecerá al valor predeterminado. Cuando las coordenadas se proporcionan de forma manual, las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo. El mapa podría utilizar unidades de visualización distintas de las coordenadas proporcionadas. 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. Se recomienda que cree primer utilice esta opción en las secuencias de comandos de Python. Desactivado—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
URL del portal (Opcional)	URL del portal.	String

Salida derivada

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

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 servicio `System/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 usará la extensión de la capa especificada. `Extent` objeto: se usará la extensión del objeto especificado. Cadena de caracteres con las coordenadas delimitadas por espacios: se usará la extensión de la cadena especificada. Las coordenadas se expresan en el orden 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 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. Se recomienda que cree primer utilice esta opción en las secuencias de comandos 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)	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
from arcpy import env
import sys
import time
import datetime

# Set environment settings
env.workspace = "C:/data"

# Sign in to ArcGIS Enterprise
myPortal= "https://MyPortal.domain.com/portalwebadaptor"
arcpy.SignInToPortal(myPortal, "siteadminValue", "siteadminPassword")
myServer="https://Myserver.domain.com/serverwebadaptor"
serviceName= "SampleWorldCities"
serviceType= "MapServer"
myPortalServiceURL = (myServer + "/" + "rest/services" +"/" + serviceName + "/"
                      + serviceType)

### Sign in to ArcGIS Online
##myPortal= "https://www.arcgis.com"
##arcpy.SignInToPortal(myPortal, "MyUserName", "MyPassword")
##serviceRestUrl="https://www.arcgis.com/tiles/orgid"
##serviceName= "MyServiceName"
##serviceType= "MapServer"
##myPortalServiceURL = (serviceRestUrl + "/" + "arcgis/rest/services" +"/" + serviceName + "/"
##                      + serviceType)

# Stand alone ArcGIS Server
##target_server_connection = r"C:\share\python3\arcgis on MyServer.ags"
##serviceName= "MyServiceName"
##serviceType= ".MapServer"
##myPortalServiceURL = (target_server_connection +  "\\" + serviceName + serviceType)

print (myPortalServiceURL)

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

# List of input variables for map or image service
##scales = [591657527.591555,295828763.79577702,147914381.89788899]
scales = [73957190.948944,36978595.474472]
numOfCachingServiceInstances = 8
updateMode = "RECREATE_ALL_TILES"
areaOfInterest = ""
waitForJobCompletion = "WAIT"
updateExtents = ""
portalURL =""

# Print results of the script to a report
report = open(file,'w')

try:
    result = arcpy.server.ManageMapServerCacheTiles(myPortalServiceURL, 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(str(e))
report.close()

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

Entornos

Espacio de trabajo actual

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí

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

Resumen

Uso

Parámetros

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados