Gérer l’état d’un cache de serveur de carte (Outils de serveur)
Résumé
Gère des données internes conservées par le serveur qui concernent les tuiles générées dans un cache de service de carte ou d'imagerie.
Utilisation
Cet outil permet de recréer l'état du cache une fois que vous avez copié manuellement les tuiles dans le répertoire de cache ou créé des tuiles à la demande.
C’est le seul outil qui permette de créer l’état d’un cache conçu avec une version antérieure d’ArcGIS Server ou de Portal for ArcGIS.
Vous pouvez utiliser cet outil afin de créer des rapports d'état pour des zones d'intérêt personnalisées et des niveaux d'échelle, plutôt que de créer l'état de l'ensemble du cache. Pour cela, définissez le paramètre Manage Mode (Mode de gestion) sur Rebuild bundle status (Recréer l’état du cache). Le rapport est stocké dans une nouvelle géodatabase fichier intitulée Status.gdb, plus particulièrement dans une classe d’entités nommée TaskStatus.
Notez que votre répertoire de cache contient également une géodatabase Status.gdb appartenant à l’ensemble du cache et mise à jour lorsque vous utilisez les autres options Manage Mode (Mode de gestion) de cet outil. Vous ne pouvez pas remplacer une géodatabase Status.gdb par une autre à cet emplacement.
Couche d’images de carte dont l’état du cache est modifié. Vous pouvez la choisir en accédant au service souhaité dans le Portail ou faire glisser et déposer une couche de tuiles Web depuis l’onglet Portail de la fenêtre Catalog (Catalogue) pour spécifier ce paramètre.
Image Service; Map Server
Mode de gestion
Indique l’action à effectuer sur les informations d’état du cache utilisées par le serveur.
Supprimer l'état du cache—Supprime les informations d'état utilisées par le serveur.
Recréer l'état du cache—Supprime puis recrée les informations d'état utilisées par le serveur.
Recréer l'état du groupe—Crée des informations d’état dans une nouvelle géodatabase fichier intitulée Status.gdb dans un dossier que vous spécifiez dans le paramètre Output Folder (Dossier en sortie). Utilisez cette option si vous souhaitez créer un rapport d'état personnalisé pour une zone d'intérêt ou un jeu d'échelles spécifique.
String
Échelles
(Facultatif)
Niveaux d'échelle pour lesquels l'état sera modifié. Ce paramètre s’applique uniquement lors de la création d’un état personnalisé à l’aide de l’option Rebuild bundle status (Recréer l’état du groupe) du paramètre Manage Mode (Mode de gestion).
Double
Nombre d’instances de service de mise en cache
(Facultatif)
Définit le nombre d'instances qui seront utilisées pour mettre à jour/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
Dossier en sortie
(Facultatif)
Dossier en sortie pour Status.gdb. Ce paramètre s’applique uniquement lors de la création d’un état personnalisé à l’aide de l’option Rebuild bundle status (Recréer l’état du groupe).
Folder
Zone d’intérêt
(Facultatif)
Zone d'intérêt (polygone) qui détermine la géographie couverte par le rapport d'état. Ce paramètre s’applique uniquement lors de la création d’un état personnalisé à l’aide de l’option Rebuild bundle status (Recréer l’état du groupe).
Feature Set
Etendue du rapport
(Facultatif)
Etendue rectangulaire définissant la zone dont l'état sera créé. Ce paramètre s’applique uniquement lors de la création d’un état personnalisé à l’aide de l’option Rebuild bundle status (Recréer l’état du groupe).
Notez que le paramètre Area Of Interest (Zone d’intérêt) vous permet de spécifier une zone d’intérêt non rectangulaire.
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.
Couche d’images de carte dont l’état du cache est modifié. Vous pouvez la choisir en accédant au service souhaité dans le Portail ou faire glisser et déposer une couche de tuiles Web depuis l’onglet Portail de la fenêtre Catalog (Catalogue) pour spécifier ce paramètre.
Image Service; Map Server
manage_mode
Indique l’action à effectuer sur les informations d’état du cache utilisées par le serveur.
DELETE_CACHE_STATUS—Supprime les informations d'état utilisées par le serveur.
REBUILD_CACHE_STATUS—Supprime puis recrée les informations d'état utilisées par le serveur.
REPORT_BUNDLE_STATUS—Crée des informations d’état dans une nouvelle géodatabase fichier intitulée Status.gdb dans un dossier que vous spécifiez dans le paramètre report_folder. Utilisez cette option si vous souhaitez créer un rapport d'état personnalisé pour une zone d'intérêt ou un jeu d'échelles spécifique.
String
scales[scales,...]
(Facultatif)
Niveaux d'échelle pour lesquels l'état sera modifié. Ce paramètre s’applique uniquement lors de la création d’un état personnalisé à l’aide de l’option REPORT_BUNDLE_STATUS du paramètre manage_mode.
Double
num_of_caching_service_instances
(Facultatif)
Définit le nombre d'instances qui seront utilisées pour mettre à jour/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
report_folder
(Facultatif)
Dossier en sortie pour Status.gdb. Ce paramètre s’applique uniquement lors de la création d’un état personnalisé à l’aide de l’option REPORT_BUNDLE_STATUS.
Folder
area_of_interest
(Facultatif)
Zone d'intérêt (polygone) qui détermine la géographie couverte par le rapport d'état. Ce paramètre s’applique uniquement lors de la création d’un état personnalisé à l’aide de l’option REPORT_BUNDLE_STATUS.
Feature Set
report_extent
(Facultatif)
Etendue rectangulaire définissant la zone dont l'état sera créé. Ce paramètre s’applique uniquement lors de la création d’un état personnalisé à l’aide de l’option REPORT_BUNDLE_STATUS.
Notez que le paramètre area_of_interest vous permet de spécifier une zone d’intérêt non rectangulaire.
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
Sortie dérivée
Nom
Explication
Type de données
output_folder
URL de service en sortie.
String
Exemple de code
Exemple d’utilisation de l’outil ManageMapServerCacheStatus (script autonome)
Supprime les informations d'état d'un cache.
# Name: ManageMapServerCacheStatus.py
# Description: The following stand-alone script demonstrates how to delete
# Status of cache using ManageMapServerCachStatus tool
# Any line that begins with a pound sign is a comment and will not be run
# 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
import sys
import time
import datetime
# Set environment settings
arcpy.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.MapService"
inputService = f"{connectionFile}\\{server}\\{serviceName}"
scales = ""
manageMode = "DELETE_CACHE_STATUS"
numOfCachingServiceInstances = "2"
outputFolder = ""
areaOfInterest = ""
reportExtents = ""
currentTime = datetime.datetime.now()
arg1 = currentTime.strftime("%H-%M")
arg2 = currentTime.strftime("%Y-%m-%d %H:%M")
file = f'C:/data/report_{arg1}.txt'
# Print results of the script to a report
report = open(file, 'w')
# Use "scales[0]", "scales[-1]", "scales[0:3]"
try:
starttime = time.clock()
result = arcpy.server.ManageMapServerCacheStatus(
inputService,
manageMode,
scales,
numOfCachingServiceInstances,
outputFolder,
areaOfInterest,
reportExtents
)
finishtime = time.clock()
elapsedtime = finishtime - starttime
#print messages to a file
while result.status < 4:
time.sleep(0.2)
resultValue = result.getMessages()
report.write(f"completed {resultValue}")
print(f"Reported the Bundle status for scale = {scales[-1]} of {serviceName} at {outputFolder}")
print(f"using specified feature class {areaOfInterest} in {elapsedtime} sec {arg2}")
except Exception as err:
# If an error occurred, print line number and error message
tb = sys.exc_info()[2]
report.write(f"Failed at step 3 \nLine {tb.tb_lineno}")
report.write(str(err))
report.close()
Environnements
Cet outil n’utilise pas d’environnement de géotraitement.
: l’étendue repose sur la carte ou scène active.
: l’étendue est basée sur un rectangle dessiné sur la carte ou dans la scène.
: 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 :
: étendue de toutes les entités.
: étendue des entités sélectionnées.
: étendue des entités visibles.
: l’étendue repose sur un jeu de données existant.
: l’étendue peut être copiée depuis et vers le Presse-papiers.
: copie l’étendue et le système de coordonnées dans le Presse-papiers.
: la valeur par défaut de l’étendue est rétablie.