Exporter un cache de serveur de carte (Outils de serveur)

Résumé

Cet outil exporte des tuiles depuis un cache de couche d’images de carte en tant que jeu de données de cache ou paquetage de tuiles vers un dossier du disque. Vous pouvez importer les tuiles dans d’autres caches ou y accéder depuis ArcGIS Desktop ou des appareils mobiles en tant que jeu de données raster, indépendamment de leur service parent.

Utilisation

Avant d'exécuter cet outil, créez le dossier sur le disque qui contiendra les tuiles exportées.
Le compte ArcGIS Server doit disposer d’un accès en écriture au dossier du cache cible. Si le compte ArcGIS Server ne peut pas obtenir l’accès en écriture au dossier du cache cible, mais que le client ArcGIS Pro peut y accéder en écriture, activez le paramètre Copy data from server (Copier les données du serveur).
Le paramètre Overwrite Tiles (Remplacer les tuiles) permet de remplacer l’ensemble des tuiles du cache de destination par les tuiles exportées, plutôt que de fusionner les images. Les tuiles exportées peuvent toujours être contraintes dans une zone d'intérêt.
Lorsque le paramètre Ready To Serve Format (Format prêt à l’emploi) est activé, le contenu du cache est généré conformément à la spécification de paquetage de tuiles ouverte. Le format du cache est Compact V2, mais la structure du cache est stockée au format JSON au lieu de XML. Ce contenu de cache peut être empaqueté dans une archive zip en tant que paquetage de tuiles pour les processus de publication et hors connexion. Ce contenu de cache est prêt à l’emploi avec les processus décrits dans la rubrique Publier une couche de tuiles à partir d’un jeu de données en cache. Ce paramètre est disponible uniquement lorsque le paramètre Export cache type (Exporter le type de cache) a pour valeur Cache dataset (Jeu de données en cache).

Etiqueter	Explication	Type de données
Service en entrée	Couche d’images de carte dont les tuiles de cache doivent être exportées. Vous pouvez la sélectionner en accédant au service sur un portail, ou vous pouvez faire glisser une couche de tuiles Web depuis l’onglet Portal (Portail) de la fenêtre Project (Projet) pour fournir cette valeur de paramètre.	Image Service; Map Server
Chemin de mise en cache cible	Dossier dans lequel le cache sera exporté. Ce dossier n’a pas besoin d’être un répertoire de cache du serveur enregistré. Le compte ArcGIS Server doit disposer d’un accès en écriture au dossier du cache cible. Si le compte de serveur ne peut pas obtenir l’accès en écriture au dossier du cache cible, mais que le client ArcGIS Desktop ou ArcGIS Pro peut y accéder en écriture, activez le paramètre Copy data from server (Copier les données du serveur).	Folder
Exporter le type de cache	Spécifie le type de cache à exporter. Les paquetages de tuiles peuvent être utilisés avec ArcGIS Maps SDKs for Native Apps. Jeu de données en cache—Le cache du service de carte ou d’imagerie généré à l’aide d’ArcGIS Server est exporté. Il peut être utilisé dans ArcGIS Desktop et par les services de carte ou d’imagerie ArcGIS Server. Cette option permet de générer le contenu dans un format prêt à l’emploi. Il s’agit de l’option par défaut. Paquetage de tuiles—Un fichier compressé unique dans lequel le jeu de données de cache est ajouté en tant que couche et consolidé afin de pouvoir être partagé est exporté. Il peut être utilisé dans ArcGIS Pro et avec ArcGIS Maps SDKs for Native Apps.	String
Copier les données du serveur	Spécifie la façon dont les tuiles sont transférées dans le dossier cible. Activez ce paramètre si le compte ArcGIS Server ne peut pas obtenir l’accès en écriture au dossier cible et que le client ArcGIS Desktop ou ArcGIS Pro peut y accéder en écriture. Le logiciel exporte les tuiles dans le répertoire en sortie du serveur avant de les placer dans le dossier cible. Activé—Les tuiles sont d’abord placées dans le répertoire en sortie du serveur, puis transférées dans le dossier cible. Le client ArcGIS Desktop ou ArcGIS Pro doit disposer d’un accès en écriture au dossier cible. Décoché—Les tuiles sont exportées directement dans le dossier cible. Le compte ArcGIS Server doit disposer d’un accès en écriture au dossier cible. Il s’agit de l’option par défaut.	Boolean
Type de format de stockage	Spécifie le format de stockage du cache utilisé pour le cache exporté. Compact—Les tuiles sont regroupées dans des paquets ou des fichiers de paquets afin d’économiser de l’espace sur le disque et d’accélérer la copie des caches. Si le paramètre Export cache type (Exporter le type de cache) est défini sur Tile package (Paquetage de tuiles), il s’agit de l’option par défaut. Compact V2—Les tuiles sont regroupées dans des fichiers de paquets uniquement. Ce format offre de meilleures performances sur les partages réseau et les répertoires de stockage cloud. Si le paramètre Export cache type (Exporter le type de cache) est défini sur Tile package (Paquetage de tuiles), l’extension du paquetage de tuiles est `.tpkx`. Celle-ci est prise en charge par les versions récentes des produits ArcGIS, comme ArcGIS Online, ArcGIS Enterprise 12.0, ArcGIS Maps SDKs for Native Apps 200.0 ou version ultérieure et ArcGIS Runtime versions 100.5 à 100.15. Éclaté—Chaque tuile sera stockée en tant que fichier individuel.	String
Échelles	Liste des niveaux d'échelle auxquels les tuiles sont exportées.	Double
Nombre d’instances de service de mise en cache (Facultatif)	Nombre d’instances utilisées pour mettre à jour ou générer les tuiles. La valeur de ce paramètre est définie sur illimitée (-1) et ne peut pas être modifiée.	Long
Zone d’intérêt (Facultatif)	Zone d’intérêt qui contraint spatialement la zone où les tuiles sont exportées du cache. Ce paramètre est utile lors de l’exportation de zones de forme irrégulière, car l’outil découpe le jeu de données du cache à une résolution de pixel. Si vous n’indiquez pas de zone d’intérêt, l’étendue globale de la carte est exportée.	Feature Set
Étendue d’exportation (Facultatif)	Étendue rectangulaire définissant les tuiles à exporter. Par défaut, l’étendue est définie sur l’étendue complète du service de carte dans lequel vous effectuez l’importation. Le paramètre facultatif Area Of Interest (Zone d’intérêt) vous permet également de procéder à l’importation à l’aide d’un polygone. Nous vous conseillons de ne pas définir ces deux paramètres. Si vous entrez des valeurs pour les deux paramètres, le paramètre Area Of Interest (Zone d’intérêt) est prioritaire sur celui-ci. Current Display Extent (Étendue actuellement affichée) : l’étendue repose sur la carte ou scène active. Draw Extent (Dessiner l’étendue) : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Extent of a Layer (Étendue d’une couche) : l’étendue repose sur une couche de carte active. Choisissez une couche disponible ou utilisez l’option Étendue des données dans toutes les couches. Chaque couche de carte comporte les options suivantes : All Features (Toutes les entités) : étendue de toutes les entités. Selected Features (Entités sélectionnées) : étendue des entités sélectionnées. Visible Features (Entités visibles) : étendue des entités visibles. Browse (Parcourir) : l’étendue repose sur un jeu de données existant. Clipboard (Presse-papiers) : l’étendue peut être copiée depuis et vers le Presse-papiers. Copy Extent (Copier l’étendue) : copie l’étendue et le système de coordonnées dans le Presse-papiers. Paste Extent (Coller l’étendue) : colle l’étendue et les coordonnées depuis le Presse-papiers. Si le Presse-papiers n’inclut pas de système de coordonnées, l’étendue utilise celui de la carte. Reset Extent (Réinitialiser l’étendue) : la valeur par défaut de l’étendue est rétablie. Lorsque les coordonnées sont saisies manuellement, elles doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active. La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. Utilisez le signe moins pour les coordonnées sud et ouest.	Extent
Remplacer les tuiles (Facultatif)	Indique si les images du cache de destination sont fusionnées avec les tuiles du cache d’origine ou remplacées par ces dernières. Activé—Tous les pixels de la zone d’intérêt sont exportés, en remplaçant les tuiles du cache de destination par les tuiles du cache d’origine. Décoché—Lorsque les tuiles sont exportées, les pixels transparents du cache d’origine sont ignorés. L'image est ainsi fusionnée dans le cache de destination. Il s’agit de l’option par défaut.	Boolean
Format prêt à l’emploi (Facultatif)	Indique si le contenu du cache est généré conformément à la spécification de paquetage de tuiles ouverte et spécifie le format de fichier de la structure de cache. Ce paramètre est disponible uniquement lorsque le paramètre Export cache type (Exporter le type de cache) a pour valeur Cache dataset (Jeu de données en cache). Activé—Le contenu du cache est généré conformément à la spécification de paquetage de tuiles ouverte (`https://github.com/Esri/tile-package-spec`). Un paquetage de tuiles peut être empaqueté dans une archive zip en tant que paquetage de tuiles pour les processus hors ligne. Le format du cache est Compact V2 et la structure du cache est stockée au format JSON. Décoché—Le contenu en cache est généré à l’aide d’une structure stockée au format XML. Utilisez cette option pour copier le cache dans des versions précédentes d’ArcGIS Enterprise. Il s’agit de l’option par défaut.	Boolean

Sortie dérivée

Etiqueter	Explication	Type de données
Chemin d'accès au cache en sortie	Le dossier dans lequel le cache a été exporté.	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})

Nom	Explication	Type de données
input_service	Couche d’images de carte dont les tuiles de cache doivent être exportées.	Image Service; Map Server
target_cache_path	Dossier dans lequel le cache sera exporté. Ce dossier n’a pas besoin d’être un répertoire de cache du serveur enregistré. Le compte ArcGIS Server doit disposer d’un accès en écriture au dossier du cache cible. Si le compte de serveur ne peut pas obtenir l’accès en écriture au dossier du cache cible, mais que le client ArcGIS Desktop ou ArcGIS Pro peut y accéder en écriture, activez le paramètre Copy data from server (Copier les données du serveur).	Folder
export_cache_type	Spécifie le type de cache à exporter. Les paquetages de tuiles peuvent être utilisés avec ArcGIS Maps SDKs for Native Apps. `CACHE_DATASET`—Le cache du service de carte ou d’imagerie généré à l’aide d’ArcGIS Server est exporté. Il peut être utilisé dans ArcGIS Desktop et par les services de carte ou d’imagerie ArcGIS Server. Cette option permet de générer le contenu dans un format prêt à l’emploi. Il s’agit de l’option par défaut. `TILE_PACKAGE`—Un fichier compressé unique dans lequel le jeu de données de cache est ajouté en tant que couche et consolidé afin de pouvoir être partagé est exporté. Il peut être utilisé dans ArcGIS Pro et avec ArcGIS Maps SDKs for Native Apps.	String
copy_data_from_server	Spécifie la façon dont les tuiles sont transférées dans le dossier cible. Définissez ce paramètre sur `COPY_DATA` si le compte ArcGIS Server ne peut pas obtenir l’accès en écriture au dossier cible et que le client ArcGIS Desktop ou ArcGIS Pro peut y accéder en écriture. Le logiciel exporte les tuiles dans le répertoire en sortie du serveur avant de les placer dans le dossier cible. `COPY_DATA`—Les tuiles sont d’abord placées dans le répertoire en sortie du serveur, puis transférées dans le dossier cible. Le client ArcGIS Desktop ou ArcGIS Pro doit disposer d’un accès en écriture au dossier cible. `DO_NOT_COPY`—Les tuiles sont exportées directement dans le dossier cible. Le compte ArcGIS Server doit disposer d’un accès en écriture au dossier cible. Il s’agit de l’option par défaut.	Boolean
storage_format_type	Spécifie le format de stockage du cache utilisé pour le cache exporté. `COMPACT`—Les tuiles sont regroupées dans des paquets ou des fichiers de paquets afin d’économiser de l’espace sur le disque et d’accélérer la copie des caches. Si le `export_cache_type` paramètre est défini sur `TILE_PACKAGE`, il s’agit de l’option par défaut. `COMPACT_V2`—Les tuiles sont regroupées dans des fichiers de paquets uniquement. Ce format offre de meilleures performances sur les partages réseau et les répertoires de stockage cloud. Si le paramètre `export_cache_type` est défini sur `TILE_PACKAGE`, l’extension du paquetage de tuiles est `.tpkx`. Celle-ci est prise en charge par les versions récentes des produits ArcGIS, comme ArcGIS Online, ArcGIS Enterprise 12.0, ArcGIS Maps SDKs for Native Apps 200.0 ou version ultérieure et ArcGIS Runtime versions 100.5 à 100.15. `EXPLODED`—Chaque tuile sera stockée en tant que fichier individuel.	String
scales [scales,...]	Liste des niveaux d'échelle auxquels les tuiles sont exportées.	Double
num_of_caching_service_instances (Facultatif)	Nombre d’instances utilisées pour mettre à jour ou générer les tuiles. La valeur de ce paramètre est définie sur illimitée (-1) et ne peut pas être modifiée.	Long
area_of_interest (Facultatif)	Zone d’intérêt qui contraint spatialement la zone où les tuiles sont exportées du cache. Ce paramètre est utile lors de l’exportation de zones de forme irrégulière, car l’outil découpe le jeu de données du cache à une résolution de pixel. Si vous n’indiquez pas de zone d’intérêt, l’étendue globale de la carte est exportée.	Feature Set
export_extent (Facultatif)	Étendue rectangulaire définissant les tuiles à exporter. Par défaut, l’étendue est définie sur l’étendue complète du service de carte dans lequel vous effectuez l’importation. Le paramètre facultatif Area Of Interest (Zone d’intérêt) vous permet également de procéder à l’importation à l’aide d’un polygone. Nous vous conseillons de ne pas définir ces deux paramètres. Si vous entrez des valeurs pour les deux paramètres, le paramètre Area Of Interest (Zone d’intérêt) est prioritaire sur celui-ci. `MAXOF` : l’étendue maximale de toutes les entrées est utilisée. `MINOF` : l’étendue minimale commune à toutes les entrées est utilisée. `DISPLAY` : l’étendue est égale à l’affichage visible. Nom de la couche : l’étendue de la couche spécifiée est utilisée. `Extent` object : l’étendue de l’objet spécifié est utilisée. Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.	Extent
overwrite (Facultatif)	Indique si les images du cache de destination sont fusionnées avec les tuiles du cache d’origine ou remplacées par ces dernières. `OVERWRITE`—Tous les pixels de la zone d’intérêt sont exportés, en remplaçant les tuiles du cache de destination par les tuiles du cache d’origine. `MERGE`—Lorsque les tuiles sont exportées, les pixels transparents du cache d’origine sont ignorés. L'image est ainsi fusionnée dans le cache de destination. Il s’agit de l’option par défaut.	Boolean
ready_to_serve_format (Facultatif)	Indique si le contenu du cache est généré conformément à la spécification de paquetage de tuiles ouverte et spécifie le format de fichier de la structure de cache. Ce paramètre peut être utilisé uniquement lorsque le paramètre `export_cache_type` a pour valeur `CACHE_DATASET`. `READY_TO_SERVE_FORMAT`—Le contenu du cache est généré conformément à la spécification de paquetage de tuiles ouverte (`https://github.com/Esri/tile-package-spec`). Un paquetage de tuiles peut être empaqueté dans une archive zip en tant que paquetage de tuiles pour les processus hors ligne. Le format du cache est Compact V2 et la structure du cache est stockée au format JSON. `NON_READY_TO_SERVE_FORMAT`—Le contenu en cache est généré à l’aide d’une structure stockée au format XML. Utilisez cette option pour copier le cache dans des versions précédentes d’ArcGIS Enterprise. Il s’agit de l’option par défaut.	Boolean

Sortie dérivée

Nom	Explication	Type de données
output_cache_path	Le dossier dans lequel le cache a été exporté.	String

Exemple de code

Exemple 1 d’utilisation de la fonction ExportMapServerCache (script autonome)

Exportez des tuiles de cache pour une classe d’entités tout en remplaçant le format de stockage EXPLODED par 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()

Exemple 2 d’utilisation de la fonction ExportMapServerCache (script autonome)

Exportez un cache avec TILE_PACKAGE lorsque les instances ArcGIS Server ne peuvent pas accéder au dossier de destination.

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

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

Basic: Oui
Standard: Oui
Advanced: Oui

Exporter un cache de serveur de carte (Outils de serveur)

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes