Exporter un cache de serveur de carte (Serveur)

Synthèse

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 posséder des droits d’accès en écriture sur le dossier du cache cible. Si le compte ArcGIS Server ne peut pas obtenir de droits d’accès en écriture sur le dossier du cache cible, mais que le client ArcGIS Pro peut y accéder en écriture, choisissez le paramètre Copier les données à partir du serveur (copy_data_from_server).

• Le paramètre Remplacer les tuiles permet aux tuiles exportées de remplacer entièrement les tuiles du cache de destination, au lieu de fusionner les images. Les tuiles exportées peuvent toujours être contraintes dans une zone d'intérêt.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Service d'entrée	Couche d’images de carte dont les tuiles de cache doivent être exportées. Vous pouvez la choisir en accédant au service souhaité dans un portail ou faire glisser et déposer une couche de tuiles web depuis l’onglet Portal (Portail) de la fenêtre Project (Projet) pour indiquer ce 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 posséder des droits d’accès en écriture sur le dossier du cache cible. Si le compte de serveur ne peut pas obtenir de droits d’accès en écriture sur le dossier de destination, mais que le client ArcGIS Desktop ou ArcGIS Pro peut y accéder en écriture, choisissez le paramètre Copier les données à partir du serveur.	Folder
Exporter le type de cache	Cet outil exporte le cache comme jeu de données de cache ou paquetage de tuiles. Les paquetages de tuiles sont adaptés aux déploiements ArcGIS Runtime et ArcGIS Mobile. Jeu de données du cache—Cache du service de carte ou d’imagerie généré avec ArcGIS Server. Il peut être utilisé dans ArcGIS Desktop et par les services de carte ou d’imagerie ArcGIS Server. Il s’agit de l’option par défaut. Paquetage de tuiles—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é. Il peut être utilisé dans ArcGIS Desktop, ArcGIS Runtime et les applications mobiles.	String
Copier les données du serveur	Activez ce paramètre uniquement si le compte ArcGIS Server ne peut pas obtenir de droits d’accès en écriture sur le 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 placées dans le répertoire en sortie du serveur, puis transférées dans le dossier cible. Le client ArcGIS Desktop doit posséder des droits d’accès en écriture sur le dossier cible. Désactivé - Les tuiles sont exportées directement dans le dossier cible. Le compte ArcGIS Server doit posséder des droits d’accès en écriture sur le dossier cible.	Boolean
Type de format de stockage	Format de stockage du cache exporté. Compacter—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éférentiels sur le Cloud. Si le paramètre Exporter le type de cache est défini sur Paquetage de tuiles, l’extension du paquetage de tuiles est (.tpkx). Celle-ci est prise en charge par les dernières versions de la plateforme ArcGIS telles que ArcGIS Online, ArcGIS Enterprise 11.3 et ArcGIS Runtime 100.5. Eclaté—Chaque tuile est stockée en tant que fichier individuel (de la façon dont les caches étaient toujours stockés avant ArcGIS Server).	String
Échelles	Liste des niveaux d'échelle auxquels les tuiles sont exportées.	Double
Nombre d’instances de service de mise en cache (Facultatif)	Indique le nombre d’instances qui seront 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 si vous voulez exporter des 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. Notez que le paramètre facultatif Area Of Interest (Zone d’intérêt) de cet outil vous permet également de procéder à l’importation à l’aide d’un polygone. Nous vous déconseillons de ne pas définir ces deux paramètres dans le cadre d’une tâche. Si vous entrez des valeurs pour les deux paramètres, le paramètre Area Of Interest (Zone d’intérêt) est prioritaire sur le paramètre Import Extent (Emprise d’importation). Current Display Extent (Étendue actuellement affichée)  : l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active. Dessiner l’étendue  : l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène. Cette option crée une classe d’entités dans la géodatabase du projet et ajoute une couche à la carte. La classe d’entités possède le même système de coordonnées que la carte. Remarque : Cette option n’est pas disponible dans la boîte de dialogue Environnements. Elle est disponible uniquement dans un paramètre de l’outil correspondant à un type de données d’étendue ou dans l’onglet Environnements de la boîte de dialogue de l’outil. Remarque : Lorsque l’option de mise à jour Activer et désactiver la mise à jour de l’onglet Mettre à jour est activée, vous devez activer la mise à jour dans l’onglet du ruban Mettre à jour pour dessiner l’étendue. Extent of a Layer (Étendue d’une couche)  : l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option Extent of data in all layers (Étendue des données dans toutes les couches) pour obtenir l’étendue combinée de toutes les couches de carte actives, y compris le fond de carte. Cette option est uniquement disponible lorsqu’une carte avec des couches est active. Chaque couche de carte comporte les options suivantes : Toutes les entités  : étendue de toutes les entités dans la couche. Entités sélectionnées : étendue de toutes les entités sélectionnées dans la couche. Entités visibles  : étendue des entités visibles dans la couche. Remarque : Les étendues des options Entités sélectionnées  et Entités visibles  sont disponibles uniquement pour les couches d’entités. Browse (Parcourir)  : l’étendue repose sur un jeu de données existant. Presse-papiers  : l’étendue peut être copiée vers et collée depuis le Presse-papiers. Copier l’étendue  : copie les coordonnées et le système de coordonnées de l’étendue dans le Presse-papiers. Coller l’étendue  : colle les coordonnées et, éventuellement, le système de coordonnées de l’étendue depuis le Presse-papiers. Si les valeurs du Presse-papiers n’incluent pas de système de coordonnées, l’étendue utilise celui de la carte. Remarque : Les coordonnées de l’étendue sont copiées vers et collées depuis le Presse-Papiers avec la même mise en forme et le même ordre que ceux de l’objet ArcPy Extent : X min, Y min, X max, Y max et la référence spatiale. Reset Extent (Réinitialiser l’étendue)  : la valeur par défaut de l’étendue est rétablie. Manually entered coordinates (Coordonnées saisies manuellement) : les coordonnées doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active. Attention : La carte peut utiliser des unités d’affichage différentes de celles des coordonnées saisies. L’utilisation d’une direction cardinale (N, S, E, O) n’est pas prise en charge. 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é : l'exportation remplace tous les pixels de la zone d'intérêt, en remplaçant les tuiles du cache de destination par les tuiles du cache d'origine. Désactivé : lorsque les tuiles sont exportées, les pixels transparents du cache d'origine sont ignorés par défaut. L'image est ainsi fusionnée dans le cache de destination. Il s’agit de l’option par défaut.	Boolean

Sortie obtenue

Étiquette	Explication	Type de données
Chemin d'accès au cache en sortie	Le dossier dans lequel le cache a été exporté.	String

Python

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

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 posséder des droits d’accès en écriture sur le dossier du cache cible. Si le compte de serveur ne peut pas obtenir de droits d’accès en écriture sur le dossier de destination, mais que le client ArcGIS Desktop ou ArcGIS Pro peut y accéder en écriture, choisissez le paramètre Copier les données à partir du serveur.	Folder
export_cache_type	Cet outil exporte le cache comme jeu de données de cache ou paquetage de tuiles. Les paquetages de tuiles sont adaptés aux déploiements ArcGIS Runtime et ArcGIS Mobile. CACHE_DATASET—Cache du service de carte ou d’imagerie généré avec ArcGIS Server. Il peut être utilisé dans ArcGIS Desktop et par les services de carte ou d’imagerie ArcGIS Server. Il s’agit de l’option par défaut. TILE_PACKAGE—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é. Il peut être utilisé dans ArcGIS Desktop, ArcGIS Runtime et les applications mobiles.	String
copy_data_from_server	Définissez ce paramètre sur COPY_DATA si le compte ArcGIS Server ne peut pas obtenir de droits d’accès en écriture sur le 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 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 posséder des droits d’accès en écriture sur le dossier cible. DO_NOT_COPY—Les tuiles sont exportées directement dans le dossier cible. Le compte ArcGIS Server doit posséder des droits d’accès en écriture sur le dossier cible. Il s’agit de l’option par défaut.	Boolean
storage_format_type	Format de stockage du 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 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éférentiels sur le 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 dernières versions de la plateforme ArcGIS telles que ArcGIS Online, ArcGIS Enterprise 11.3 et ArcGIS Runtime 100.5. EXPLODED—Chaque tuile est stockée en tant que fichier individuel (de la façon dont les caches étaient toujours stockés avant ArcGIS Server).	String
scales [scales,...]	Liste des niveaux d'échelle auxquels les tuiles sont exportées.	Double
num_of_caching_service_instances (Facultatif)	Indique le nombre d’instances qui seront 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 si vous voulez exporter des 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. Notez que le paramètre facultatif Area Of Interest (Zone d’intérêt) de cet outil vous permet également de procéder à l’importation à l’aide d’un polygone. Nous vous déconseillons de ne pas définir ces deux paramètres dans le cadre d’une tâche. Si vous entrez des valeurs pour les deux paramètres, le paramètre Area Of Interest (Zone d’intérêt) est prioritaire sur le paramètre Import Extent (Emprise d’importation). 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. Objet Extent : 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—L'exportation remplace tous les pixels de la zone d'intérêt, en remplaçant les tuiles du cache de destination par les tuiles du cache d'origine. MERGE—Lorsque les tuiles sont importées, les pixels transparents du cache d'origine sont ignorés par défaut. L'image est ainsi fusionnée dans le cache de destination. Il s’agit de l’option par défaut.	Boolean

Sortie obtenue

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 l’outil 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: ExportMapServerCache.py for ArcGIS Server
# Description: The following stand-alone script demonstrates how to export
# 		cache as CACHE_DATASET in COMPACT storage format and MERGE tiles
#               using an AREA_OF_INTEREST to TARGET_CACHE_PATH
#		which is accessible to server instances
# 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.MapServer"
inputService 		= connectionFile + "\\" + server + "\\" + serviceName
targetCachePath 	= "C:/data/temp"
exportCacheType 	= "CACHE_DATASET"
copyDataFromServer 	= "DO_NOT_COPY"
storageFormat 		= "COMPACT"
scales 			= [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
areaOfInterest 		= "C:/data/101/Portland/Metro.shp"
exportExtents 		= ""
overwriteTiles 		= "MERGE"

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 "scaleValues[0]","scaleValues[-1]","scaleValues[0:3]"

# Enter rectangular custom extent values for the "exportExtents" variable to
# constrain the exporting cache along the rectangular extents

try:
    starttime = time.clock()
    result = arcpy.server.ExportMapServerCache(inputService, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest, exportExtents,
					       overwriteTiles)
    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("Exported cache successfully for mapservice " + serviceName + \
        " to " + targetCachePath + "\n using " + areaOfInterest + "\n in " + \
        str(elapsedtime) + " sec \n on " + arg2)

except Exception as e:
    # If an error occurred, print line number and error message
    tb = sys.exc_info()[2]
    report.write("Failed at \n" "Line %i" % tb.tb_lineno)
    report.write(str(e))

print("Exported Map server Cache  using area of Interest")

report.close()

Exemple 2 d'utilisation de l'outil ExportMapServerCache (script autonome)

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

# Name: ExportMapServerCache.py
# Description: The following stand-alone script demonstrates how to export cache
#               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
# 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.MapServer"
inputService = connectionFile + "\\" + server + "\\" + serviceName
targetCachePath = "C:/temp/usa"
exportCacheType = "TILE_PACKAGE"
copyDataFromServer = "COPY_DATA"
storageFormat = "COMPACT"
scaleValues = [500000,250000,125000,64000]
numOfCachingServiceInstances = "2"
exportExtents = ""
areaOfInterest = ""
overwriteTiles = "MERGE"

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 "scaleValues[0]","scaleValues[-1]","scaleValues[0:3]"

try:
    starttime = time.clock()
    result = arcpy.server.ExportMapServerCache(inputService, targetCachePath,
                                               exportCacheType,
                                               copyDataFromServer,
                                               storageFormat, scales,
                                               numOfCachingServiceInstances,
                                               areaOfInterest,
                                               exportExtents, overwriteTiles)
    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("Exported cache successfully for mapservice " + serviceName + " to " + \
        targetCachePath + " in " + str(elapsedtime) + " sec \n on" + arg2)

except Exception as e:
    # If an error occurred, print line number and error message
    tb = sys.exc_info()[2]
    report.write("Failed at step 1 \n" "Line %i" % tb.tb_lineno)
    report.write(str(e))

print("Exported Map server Cache ")

report.close()

Environnements

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

Informations de licence

• Basic: Oui
• Standard: Oui
• Advanced: Oui