Exportar caché del servidor de mapas (Herramientas del Servidor)

Resumen

Exporta teselas de la caché de una capa de imágenes de mapa como un dataset de la caché o un paquete de teselas a una carpeta en el disco. Las teselas pueden importarse a otras cachés o bien puede accederse a ellas desde ArcGIS Desktop o dispositivos móviles como un dataset ráster, independientemente de su servicio principal.

Uso

Antes de ejecutar esta herramienta, cree la carpeta en el disco que mantendrá las teselas exportadas.
La cuenta de ArcGIS Server debe tener acceso de escritura a la carpeta de caché de destino. Si a la cuenta de ArcGIS Server no se le puede conceder acceso de escritura a la carpeta de la caché de destino, pero el cliente de ArcGIS Pro tiene acceso de escritura a ella, compruebe el parámetro Copiar datos desde el servidor.
El parámetro Sobrescribir teselas permite que las teselas exportadas sobrescriban por completo las teselas en la caché de destino, en lugar de mezclar las imágenes. Las teselas exportadas todavía se pueden restringir a un área de interés.
Si el parámetro Formato listo para servir está seleccionado, el contenido de la caché se genera utilizando la [especificación de paquetes de teselas] abierta (https://github.com/Esri/tile-package-spec). El formato de la caché es Compact V2, pero el esquema de la caché se almacena en JSON en lugar de XML. El contenido de esta caché se puede empaquetar en un archivo zip como paquete de teselas para la publicación y los flujos de trabajo sin conexión. El contenido de esta caché está listo para servir mediante los flujos de trabajo descritos describen en el tema Publicar una capa de teselas desde un dataset de caché (https://enterprise.arcgis.com/en/portal/12.0/use/publish-tile-layer-ref-cache.htm). Este parámetro está disponible solamente cuando el valor del parámetro Exportar tipo de caché es Dataset de caché.

Etiqueta	Explicación	Tipo de datos
Servicio de entrada	La capa de imágenes de mapa con teselas de caché que se va a exportar. Puede seleccionarla accediendo al servicio de un portal o arrastrar una capa de teselas web desde la pestaña Portal del panel Proyecto para suministrar el valor de este parámetro.	Image Service; Map Server
Ruta de la caché de destino	La carpeta a la cual se exportará la memoria caché. Esta carpeta no tiene que ser un directorio de caché de un servidor registrado. La cuenta de ArcGIS Server debe tener acceso de escritura a la carpeta de caché de destino. Si a la cuenta del servidor no se le puede conceder acceso de escritura a la carpeta de la caché de destino, pero el cliente de ArcGIS Desktop o ArcGIS Pro tiene acceso de escritura a ella, compruebe el parámetro Copiar datos desde el servidor.	Folder
Exportar tipo de caché	Especifica el tipo de caché que se exportará. Los paquetes de teselas son adecuados para su uso con ArcGIS Maps SDKs for Native Apps. Dataset de caché—Se exportará una caché de servicio de mapas o imágenes que se genera con ArcGIS Server. Se puede utilizar en ArcGIS Desktop y mediante los servicios de mapas o imágenes de ArcGIS Server. Esta opción permite generar el contenido en un formato listo para servir. Esta es la opción predeterminada. Paquete de teselas—Se exportará un único archivo comprimido en el que el dataset de la caché se agrega como una capa y está consolidado para que se pueda compartir. Se puede utilizar en ArcGIS Pro y con ArcGIS Maps SDKs for Native Apps.	String
Copiar datos del servidor	Especifica cómo se moverán las teselas a la carpeta de destino. Active este parámetro si a la cuenta de ArcGIS Server no se le puede conceder acceso de escritura a la carpeta de destino y el cliente de ArcGIS Desktop o ArcGIS Pro tiene acceso de escritura a ella. El software exporta las teselas al directorio de salida del servidor antes de pasarlas a la carpeta de destino. Activado—Las teselas se ubicarán primero en el directorio de salidas del servidor y, a continuación, se moverán a la carpeta de destino. El cliente de ArcGIS Desktop o ArcGIS Pro debe disponer de acceso de escritura a la carpeta de destino. Desactivado—Las teselas se exportarán directamente a la carpeta de destino. La cuenta de ArcGIS Server debe tener acceso de escritura a la carpeta de destino. Esta es la opción predeterminada.	Boolean
Tipo de formato de almacenamiento	Especifica el formato de almacenamiento que se utilizará para la caché exportada. Compacta—Las teselas se agruparán en archivos de paquete y bundlex para ahorrar espacio en el disco y permitir una copia más rápida de las cachés. Si el parámetro Exportar tipo de caché está configurado como Paquete de teselas, este es el valor predeterminado. Compact V2—Las teselas se agruparán solo en archivos de paquete. Este formato proporciona un mejor rendimiento en las redes compartidas y en los directorios de cloudstore. Si el parámetro Exportar tipo de caché está configurado en Paquete de teselas, la extensión del paquete de teselas será `.tpkx`, que es compatible con versiones recientes de productos ArcGIS como ArcGIS Online, ArcGIS Enterprise 12.0, ArcGIS Maps SDKs for Native Apps 200.0 o posterior, y ArcGIS Runtime 100.5-100.15. Expandido—Cada tesela se almacenará como un archivo individual.	String
Escalas	Lista de niveles de escala a los cuales se exportarán las teselas.	Double
Número de instancias de almacenamiento de servicios en caché (Opcional)	Cantidad de instancias que se utilizarán para actualizar o generar las teselas. El valor de este parámetro está establecido en sin límite (-1) y no se puede modificar.	Long
Área de interés (Opcional)	Un área de interés que restringe espacialmente dónde se exportarán las teselas desde la caché. Este parámetro es útil cuando exporta áreas con formas irregulares, puesto que la herramienta recorta el dataset de la caché en la resolución de píxeles. Si no especifica un área de interés, se exportará la extensión completa del mapa.	Feature Set
Exportar extensión (Opcional)	Extensión rectangular que define las teselas que se exportarán. De forma predeterminada, la extensión se encuentra configurada como la extensión completa del servicio de mapas en el que realiza la importación. El parámetro Área de interés opcional permite importar mediante un polígono de forma alternativa. Se recomienda no proporcionar valores para ambos parámetros. Si los valores se proporcionan para los dos parámetros, el parámetro Área de interés prevalece sobre este. 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
Sobrescribir teselas (Opcional)	Especifica si las imágenes en la caché de recepción se fusionarán con las teselas de la caché de origen o bien se sobrescribirán. Activado—Todos los píxeles del área de interés se reemplazarán, sobrescribiendo con efectividad las teselas en la caché de destino con las de la caché de origen. Desactivado—Cuando las teselas se exportan, los píxeles transparentes en la caché de origen se ignoran. Como consecuencia de ello, se obtiene una imagen fusionada o mezclada en la caché de destino. Esta es la opción predeterminada.	Boolean
Formato listo para servir (Opcional)	Especifica si el contenido de la caché se generará utilizando la especificación de paquete de teselas abierta, y especifica el formato de archivo del esquema de la caché. Este parámetro solo puede usarse cuando el valor del parámetro Exportar tipo de caché es Dataset de caché. Activado—El contenido de la caché se generará utilizando la especificación del paquete de teselas abierta (`https://github.com/Esri/tile-package-spec`). Un paquete de teselas se puede empaquetar en un archivo zip como paquete de teselas para flujos de trabajo sin conexión. El formato de la caché será Compact V2, y el esquema de la caché se almacenará en formato JSON. Desactivado—El contenido de la caché se generará utilizando un esquema almacenado en formato XML. Utilice esta opción para copiar la caché en versiones anteriores de ArcGIS Enterprise. Esta es la opción predeterminada.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Ruta de caché de salida	La carpeta a la que se ha exportado la memoria caché.	String

arcpy.server.ExportMapServerCache(input_service, target_cache_path, export_cache_type, copy_data_from_server, storage_format_type, scales, {num_of_caching_service_instances}, {area_of_interest}, {export_extent}, {overwrite}, {ready_to_serve_format})

Nombre	Explicación	Tipo de datos
input_service	La capa de imágenes de mapa con teselas de caché que se va a exportar.	Image Service; Map Server
target_cache_path	La carpeta a la cual se exportará la memoria caché. Esta carpeta no tiene que ser un directorio de caché de un servidor registrado. La cuenta de ArcGIS Server debe tener acceso de escritura a la carpeta de caché de destino. Si a la cuenta del servidor no se le puede conceder acceso de escritura a la carpeta de la caché de destino, pero el cliente de ArcGIS Desktop o ArcGIS Pro tiene acceso de escritura a ella, compruebe el parámetro Copiar datos desde el servidor.	Folder
export_cache_type	Especifica el tipo de caché que se exportará. Los paquetes de teselas son adecuados para su uso con ArcGIS Maps SDKs for Native Apps. `CACHE_DATASET`—Se exportará una caché de servicio de mapas o imágenes que se genera con ArcGIS Server. Se puede utilizar en ArcGIS Desktop y mediante los servicios de mapas o imágenes de ArcGIS Server. Esta opción permite generar el contenido en un formato listo para servir. Esta es la opción predeterminada. `TILE_PACKAGE`—Se exportará un único archivo comprimido en el que el dataset de la caché se agrega como una capa y está consolidado para que se pueda compartir. Se puede utilizar en ArcGIS Pro y con ArcGIS Maps SDKs for Native Apps.	String
copy_data_from_server	Especifica cómo se moverán las teselas a la carpeta de destino. Defina este parámetro a `COPY_DATA` si a la cuenta de ArcGIS Server no se le puede conceder acceso de escritura a la carpeta de destino y el cliente de ArcGIS Desktop o ArcGIS Pro tiene acceso de escritura a ella. El software exporta las teselas al directorio de salida del servidor antes de pasarlas a la carpeta de destino. `COPY_DATA`—Las teselas se ubicarán primero en el directorio de salidas del servidor y, a continuación, se moverán a la carpeta de destino. El cliente de ArcGIS Desktop o ArcGIS Pro debe disponer de acceso de escritura a la carpeta de destino. `DO_NOT_COPY`—Las teselas se exportarán directamente a la carpeta de destino. La cuenta de ArcGIS Server debe tener acceso de escritura a la carpeta de destino. Esta es la opción predeterminada.	Boolean
storage_format_type	Especifica el formato de almacenamiento que se utilizará para la caché exportada. `COMPACT`—Las teselas se agruparán en archivos de paquete y bundlex para ahorrar espacio en el disco y permitir una copia más rápida de las cachés. Si el parámetro `export_cache_type` está definido en `TILE_PACKAGE`, este es el valor predeterminado. `COMPACT_V2`—Las teselas se agruparán solo en archivos de paquete. Este formato proporciona un mejor rendimiento en las redes compartidas y en los directorios de cloudstore. Si el parámetro `export_cache_type` está configurado en `TILE_PACKAGE`, la extensión del paquete de teselas será `.tpkx`, que es compatible con versiones recientes de productos ArcGIS como ArcGIS Online, ArcGIS Enterprise 12.0, ArcGIS Maps SDKs for Native Apps 200.0 o posterior, y ArcGIS Runtime 100.5-100.15. `EXPLODED`—Cada tesela se almacenará como un archivo individual.	String
scales [scales,...]	Lista de niveles de escala a los cuales se exportarán las teselas.	Double
num_of_caching_service_instances (Opcional)	Cantidad de instancias que se utilizarán para actualizar o generar las teselas. El valor de este parámetro está establecido en sin límite (-1) y no se puede modificar.	Long
area_of_interest (Opcional)	Un área de interés que restringe espacialmente dónde se exportarán las teselas desde la caché. Este parámetro es útil cuando exporta áreas con formas irregulares, puesto que la herramienta recorta el dataset de la caché en la resolución de píxeles. Si no especifica un área de interés, se exportará la extensión completa del mapa.	Feature Set
export_extent (Opcional)	Extensión rectangular que define las teselas que se exportarán. De forma predeterminada, la extensión se encuentra configurada como la extensión completa del servicio de mapas en el que realiza la importación. El parámetro Área de interés opcional permite importar mediante un polígono de forma alternativa. Se recomienda no proporcionar valores para ambos parámetros. Si los valores se proporcionan para los dos parámetros, el parámetro Área de interés prevalece sobre este. `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
overwrite (Opcional)	Especifica si las imágenes en la caché de recepción se fusionarán con las teselas de la caché de origen o bien se sobrescribirán. `OVERWRITE`—Todos los píxeles del área de interés se reemplazarán, sobrescribiendo con efectividad las teselas en la caché de destino con las de la caché de origen. `MERGE`—Cuando las teselas se exportan, los píxeles transparentes en la caché de origen se ignoran. Como consecuencia de ello, se obtiene una imagen fusionada o mezclada en la caché de destino. Esta es la opción predeterminada.	Boolean
ready_to_serve_format (Opcional)	Especifica si el contenido de la caché se generará utilizando la especificación de paquete de teselas abierta, y especifica el formato de archivo del esquema de la caché. Este parámetro solo puede utilizarse cuando el valor del parámetro `export_cache_type` es `CACHE_DATASET`. `READY_TO_SERVE_FORMAT`—El contenido de la caché se generará utilizando la especificación del paquete de teselas abierta (`https://github.com/Esri/tile-package-spec`). Un paquete de teselas se puede empaquetar en un archivo zip como paquete de teselas para flujos de trabajo sin conexión. El formato de la caché será Compact V2, y el esquema de la caché se almacenará en formato JSON. `NON_READY_TO_SERVE_FORMAT`—El contenido de la caché se generará utilizando un esquema almacenado en formato XML. Utilice esta opción para copiar la caché en versiones anteriores de ArcGIS Enterprise. Esta es la opción predeterminada.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
output_cache_path	La carpeta a la que se ha exportado la memoria caché.	String

Muestra de código

Ejemplo 1 de ExportMapServerCache (secuencia de comandos independiente)

Exportar teselas de caché para una clase de entidad al mismo tiempo que se cambia el formato de almacenamiento de EXPLODED a COMPACT.

# Name: ExportMapServerCacheTiles.py
# Description: The following stand-alone script demonstrates how to export
#              cache from a map layer in ArcGIS Enterprise portal,
#              as CACHE_DATASET in COMPACT_V2 storage format and MERGE tiles
#              using an AREA_OF_INTEREST to TARGET_CACHE_PATH
#              which is accessible to server instances

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

# 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
targetCachePath     = "C:/data/temp"
exportCacheType     = "CACHE_DATASET"
copyDataFromServer     = "DO_NOT_COPY"
storageFormat         = "COMPACT_V2"
scales             = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
areaOfInterest         = "C:/data/101/Portland/Metro.shp"
exportExtents         = ""
overwriteTiles         = "MERGE"
ready_to_serve_format   = "NON_READY_TO_SERVE_FORMAT"

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

try:
    result = arcpy.server.ExportMapServerCache(myPortalServiceURL, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest, exportExtents,
                                               overwriteTiles,
                                               ready_to_serve_format)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print ("Exported cache 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()

Ejemplo 2 de ExportMapServerCache (script independiente)

Exporte la caché usando TILE_PACKAGE cuando la carpeta de destino sea inaccesible para las instancias de ArcGIS Server.

# Name: ExportMapServerCacheTiles2.py
# Description: The following stand-alone script demonstrates how to export cache
#               on a map service on standalone server as TILE_PACKAGE for default number of scales of a service, to a
#               TARGET_CACHE_PATH which is inaccessible to server instances using
#               COPY_DATA_FROM_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)

# 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
targetCachePath = "C:/temp/usa"
exportCacheType = "TILE_PACKAGE"
copyDataFromServer = "COPY_DATA"
storageFormat = "COMPACT_V2"
scaleValues = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
exportExtents = ""
areaOfInterest = ""
overwriteTiles = "MERGE"
ready_to_serve_format = "NON_READY_TO_SERVE_FORMAT"

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

try:
    result = arcpy.server.ExportMapServerCache(inputService, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest,
                                               exportExtents, overwriteTiles,
                                               ready_to_serve_format)
    while result.status < 4:
        time.sleep(0.2)
    resultValue = result.getMessages()
    report.write ("completed " + str(resultValue))

    print ("Exported cache 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()

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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

Exportar caché del servidor de mapas (Herramientas del Servidor)

Resumen

Uso

Parámetros

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados