Empaqueter des résultats

Résumé

Permet d'empaqueter un ou plusieurs résultats de géotraitement, y compris tous les outils et jeux de données en entrée et en sortie, dans un fichier (.gpk) compressé.

Utilisation

• Lorsqu'un outil est exécuté, les informations concernant l'exécution sont écrites sous la forme d'un résultat dans la fenêtre Résultats. Les résultats peuvent être ajoutés en entrée directement à partir de la fenêtre Résultats à l'aide de la fonction glisser-déplacer, ou vous pouvez également les enregistrer dans un fichier de résultats (.rlt) en entrée.

  Pour en savoir plus sur l'utilisation des résultats

• Lorsque l'option Prise en charge d'ArcGIS Runtime est activée (arcgisruntime = "RUNTIME" dans Python), le paquetage de géotraitement créé peut être utilisé dans l'environnement ArcGIS Runtime. Pour prendre en charge l'environnement d'exécution :

  • Toutes les sources de données non associées à une géodatabase sont converties en une géodatabase fichier.
  • Une fichier de définition du service de carte (.msd) est créé et ajouté au package.
  • Une copie de l'outil empaqueté est créée dans une nouvelles boîte à outils configurée à des fins de publication.

• Lorsque la case Convertir les données en géodatabase fichier est cochée (convert_data = 'CONVERT' dans Python)

  • Chaque source de données unique correspond a une géodatabase fichier créée dans le dossier ou paquetage consolidé.
  • Les formats raster et vectoriel compressés sont convertis en une géodatabase fichier et la compression est perdue.
  • Les données des géodatabases d'entreprise ne sont pas consolidées. Pour convertir les données de géodatabases d'entreprise en une géodatabase fichier, activez le paramètre Inclure les données de géodatabase d'entreprise plutôt que de référencer les données.

• Lorsque la case Convertir les données en géodatabase fichier est décochée (convert_data = 'PRESERVE' dans Python)

  • Le format source des données des couches en entrée est préservé. Cela ne s'applique pas aux formats des données de géodatabases personnelles (.mdb), de données VPF et de tables basées sur des feuilles de calcul Excel ou des connexions OLEDB. Ces formats ne sont pas pris en charge dans les environnements 64x et sont donc pas convertis en géodatabase fichier.
  • Les formats raster ADRG, CADRG/ECRG, CIB et RPF sont toujours convertis en rasters de géodatabase fichier. ArcGIS ne peut pas écrire ces formats de manière native. Ils sont toujours convertis en rasters de géodatabase fichier pour des raisons d'efficacité.
  • Dans la structure de dossier en sortie, les géodatabases fichier sont consolidées en un dossier propre à chaque version, et tous les autres formats sont consolidés dans le dossier commonData.
  • Les formats vectoriels et raster compressés ne sont pas découpés, même si une étendue est spécifiée dans le paramètre Etendue.

• Pour les couches qui contiennent une jointure ou qui font partie d'une classe de relations, toutes les sources de données jointes ou associées seront consolidées dans le dossier en sortie.

• Pour les couches d'entités, le paramètre Etendue permet de sélectionner les entités qui sont consolidées. Pour les couches raster, le paramètre Etendue permet de découper les jeux de données raster.

• Certains jeux de données font référence à d'autres jeux de données. Par exemple, vous pouvez avoir un jeu de données de topologie qui référence quatre classes d'entités. Les réseaux géométriques, les réseaux et les localisateurs sont d'autres exemples de jeux de données faisant référence à d'autres jeux de données. Lorsque vous consolidez ou empaquetez une couche en fonction de ces types de jeux de données, les jeux de données participants sont consolidés ou empaquetés.

• S'il est activé, le paramètre Structure uniquement permet uniquement de consolider ou d'empaqueter la structure des sources de données en entrée et en sortie. Une structure correspond à la structure ou à la conception d'une classe d'entités ou d'une table qui consiste en des définitions de champ et de table, des propriétés de système de coordonnées, une symbologie, des ensembles de définition, etc. Les données ou enregistrements ne sont ni consolidés, ni empaquetés.

• Les sources de données qui ne prennent pas en charge la structure seule ne seront ni consolidées, ni empaquetées. Si le paramètre Structure uniquement est activé et que l'outil détecte une couche qui n'est pas prise en charge pour la structure uniquement, un message d'avertissement apparaît et cette couche est ignorée. Si la structure seule n'est pas prise en charge pour l'unique couche spécifiée, l'outil échouera.

• Vous ne pouvez pas créer de paquetage à partir d'un résultat qui a échoué. Toutefois, vous pouvez utiliser l'outil Consolider le résultat pour créer un dossier contenant tous les outils et données utilisés par le résultat qui a échoué.

• Pour décompresser un paquetage de géotraitement, faites glisser le fichier .gpk dans ArcMap ou cliquez avec le bouton droit sur le fichier .gpk et cliquez sur Décompresser. Vous pouvez également utiliser l'outil Extraire le paquetage et spécifier un dossier en sortie.

  Par défaut, les paquetages sont extraits dans votre profil d'utilisateur.

  Pour modifier l'emplacement cible par défaut des paquetages décompressés, ouvrez Options ArcMap dans le menu Personnaliser. Dans l'onglet Partage, repérez la section Empaquetage et activez l'option Emplacement spécifié par l'utilisateur, puis accédez à l'emplacement du nouveau dossier.

Syntaxe

PackageResult_management (in_result, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {arcgisruntime}, {additional_files}, {summary}, {tags}, {version})

Paramètre	Explication	Type de données
in_result	Résultat empaqueté. L'entrée peut être un résultat ajouté via l'opération glisser-déposer directement à partir de la fenêtre Résultats ou en accédant à un fichier de résultats (.rlt).	File; String
output_file	Nom et emplacement du fichier de paquetage en sortie (.gpk).	File
convert_data (Facultatif)	Spécifie si les couches en entrée sont converties en une géodatabase fichier ou si leur format original est conservé. CONVERT — Les données sont converties en une géodatabase fichier. Remarque : Ce paramètre ne s'applique pas aux sources de données de géodatabases d'entreprise. Pour convertir les données des géodatabases d'entreprise, définissez convert_arcsde_data = 'CONVERT_ARCSDE'. PRESERVE —Les formats de données seront conservés lorsque cela est possible. Il s'agit de l'option par défaut. Remarque : Font exception à cette règle les formats qui ne sont pas pris en charge dans un environnement 64x (données de géodatabases personnelles .mdb, données VPF et tables basées sur des feuilles de calcul Excel ou connexions OLEDB) et les formats raster qu'ArcGIS ne peut pas écrire en mode natif (ADRG, CADRG/ECRG, CIB et RPF).	Boolean
convert_arcsde_data (Facultatif)	Spécifie si les couches de géodatabases d'entreprise en entrée sont converties en une géodatabase fichier ou si leur format original est conservé. CONVERT_ARCSDE — Les données de géodatabases d'entreprise sont converties en une géodatabase fichier et incluses dans le dossier ou paquetage consolidé. Il s'agit de l'option par défaut. PRESERVE_ARCSDE — Les données de géodatabases d'entreprise sont conservées et référencées dans le dossier ou paquetage consolidé obtenu.	Boolean
extent (Facultatif)	Indiquez l'étendue en saisissant manuellement les coordonnées dans le paramètre d'étendue à l'aide du format X-Min Y-Min X-Max Y-Max. Pour utiliser l'étendue d'une couche spécifique, indiquez le nom de la couche. MAXOF —Union des entrées MINOF —Intersection des entrées DISPLAY —Etendue identique à l'affichage actuel <Layer> —Etendue identique à la couche spécifiée	Extent
apply_extent_to_arcsde (Facultatif)	Détermine si l'étendue spécifiée sera appliquée uniquement à toutes les couches ou uniquement aux couches de géodatabases d'entreprise. ALL — L'étendue spécifiée est appliquée à toutes les couches. Il s'agit de l'option par défaut. ARCSDE_ONLY —L'étendue spécifiée est appliquée uniquement aux couches de géodatabases d'entreprise.	Boolean
schema_only (Facultatif)	Spécifie si seule la structure des jeux de données en entrée et en sortie est consolidée ou empaquetée. ALL — Tous les enregistrements des jeux de données en entrée et en sortie sont consolidés ou empaquetés. Il s'agit de l'option par défaut. SCHEMA_ONLY — Seule la structure des jeux de données en entrée et en sortie est consolidée ou empaquetée.	Boolean
arcgisruntime (Facultatif)	Spécifie si le paquetage prend en charge ArcGIS Runtime. Pour assurer la prise en charge d'ArcGIS Runtime, toutes les sources de données sont converties en une géodatabase fichier et un fichier de définition du service de carte (.msd) est créé dans le paquetage en sortie. DESKTOP —Le paquetage en sortie ne prend pas en charge ArcGIS Runtime. RUNTIME — Le paquetage en sortie prend en charge ArcGIS Runtime.	Boolean
additional_files (Facultatif)	Ajoute des fichiers à un paquetage. Les fichiers supplémentaires, aux formats .doc, .txt, .pdf et autres, fournissent davantage d'informations sur le contenu et la fonction du paquetage.	File
summary (Facultatif)	Ajoute un récapitulatif aux propriétés du paquetage.	String
tags (Facultatif)	Ajoute des informations sur les balises aux propriétés du paquetage. Vous pouvez ajouter plusieurs balises ou les séparer par une virgule ou un point-virgule.	String
version [version,...] (Facultatif)	Spécifie la version des géodatabases qui vont être créées dans le paquetage obtenu. En indiquant une version, les paquetages peuvent être partagés avec les versions précédentes d'ArcGIS et la compatibilité avec les versions ultérieures est assurée. Remarque : Les paquetages de géotraitement peuvent uniquement être créés pour la version actuelle. CURRENT — Le paquetage contient des géodatabases et une boîte à outils compatibles avec la version actuelle.	String

Exemple de code

Exemple 1 d'utilisation de l'outil PackageResult (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil PackageResult à partir de la fenêtre Python :

import arcpy
arcpy.env.workspace = "C:/ResultFiles" 
arcpy.PackageResult_management('Parcel.rlt', 'Parcel.gpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", r"C:\docs\readme.txt", "Summary text", "Tag1; tag2; tag3")

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

Le script de fenêtre Python ci-dessous illustre l'utilisation de l'outil PackageResult à partir de la fenêtre Python ou d'un script avec l'objet de résultat d'un outil personnalisé.

import arcpy
# Import toolbox with custom model inside
arcpy.ImportToolbox("c:/gisworkflows/ParcelTools.tbx")
# Run the tool and assign to a result variable
parcelUpdate = arcpy.ParcelUpdater_ParcelTools("c:/data/parcels.gdb/ward3", "UPDATE")
arcpy.PackageResult_management(parcelUpdate, "c:/gpks/parcelgpk.gpkx", "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", #, "Summary text", "Tag1")

Exemple 3 d'utilisation de l'outil PackageResult (script Python autonome)

Recherche et crée des paquetages de géotraitement individuels pour tous les fichiers de résultats d'un dossier spécifié.

# Name: PackageResultEx1.py
# Description:  Find all the result files that reside in a specified folder and create a geoprocessing package for each result file.
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/ResultFiles" 
# Loop through the workspace, find all the result files (.rlt) and create a geoprocessing package using the same name as the original result file.
for rlt in arcpy.ListFiles("*.rlt"):
    print("Packaging " + rlt)
    arcpy.PackageResult_management(rlt, os.path.splitext(lyr)[0] + '.gpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", r"C:\docs\readme.txt", "Summary text", "Tag1; tag2; tag3")

Exemple 4 d'utilisation de l'outil PackageResult (script Python autonome)

Recherche et crée un paquetage de géotraitement pour tous les fichiers de résultats d'un dossier spécifié.

# Name: PackageResultEx2.py
# Description:  Find all the result files that reside in a specified folder and create a single geoprocessing package.
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/ResultFiles" 
# Find all the result files (.rlt) in a workspace and create a single geoprocessing package.
rlts = arcpy.ListFiles("*.rlt")
arcpy.PackageResult_management(rlts, 'all_layers.gpk', "PRESERVE", "CONVERT_ARCSDE", "#", "ALL", "ALL", "DESKTOP", r"C:\docs\readme.txt", "Summary text", "Tag1; tag2; tag3")

Environnements

Cet outil n'utilise aucun environnement de géotraitement

Informations de licence

• ArcGIS Desktop Basic: Oui
• ArcGIS Desktop Standard: Oui
• ArcGIS Desktop Advanced: Oui