Étiquette | Explication | Type de données |
Résultat | Résultat empaqueté. L’entrée peut être un résultat de l’historique du projet actuel ou la propriété resultID d’un objet Result lorsque l’outil est utilisé dans un script Python. | File; String |
Fichier en sortie | Nom et emplacement du fichier de paquetage en sortie (.gpkx). | File |
Convertir les données en géodatabase fichier (Facultatif) | Spécifie si les couches en entrée seront converties en une géodatabase fichier ou si leur format original sera conservé.
| Boolean |
Inclure les données de géodatabase d'entreprise plutôt que de référencer les données (Facultatif) | Spécifie si les couches de géodatabases d'entreprise en entrée seront converties en une géodatabase fichier ou si leur format original sera conservé.
| Boolean |
Étendue (Facultatif) | Spécifie l'étendue utilisée pour sélectionner ou découper les entités.
| Extent |
Appliquer l'étendue aux couches de géodatabases d'entreprise uniquement (Facultatif) | Indique si l’étendue spécifiée est appliquée à toutes les couches ou aux couches de géodatabases d’entreprise.
| Boolean |
Structure uniquement (Facultatif) | Spécifie si tous les enregistrements et entités des jeux de données en sortie ou uniquement la structure des jeux de données en entrée et en sortie sont consolidés ou empaquetés.
| Boolean |
Prendre en charge l’exécution ArcGIS (Facultatif) | Spécifie si le paquetage prend ArcGIS Runtime en charge. Pour assurer la prise en charge de ArcGIS Runtime, toutes les sources de données sont converties en une géodatabase fichier et un outil compatible avec le serveur est créé dans le paquetage.
| Boolean |
Fichiers supplémentaires (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 |
Résumé (Facultatif) | Ajoute un récapitulatif des propriétés du paquetage. | String |
Balises (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 de paquetage (Facultatif) | Spécifie la version des géodatabases qui vont être créées dans le paquetage obtenu. Lorsqu’une version est spécifiée, les paquetages peuvent être partagés avec les versions précédentes d’ArcGIS et la compatibilité avec les versions antérieures est assurée. Remarque :Un paquetage enregistré sous une version antérieure peut perdre les propriétés qui sont disponibles uniquement dans la version ultérieure.
| String |
Keep only the rows which are related to features within the extent (Conserver uniquement les lignes associées aux entités dans l’étendue) (Facultatif) | Détermine si l’étendue définie est appliquée aux sources de données associées.
| Boolean |
Synthèse
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 compressé (.gpkx).
Utilisation
Lorsqu’un outil est exécuté, un élément d’historique du géotraitement est ajouté à la section Historique de géotraitement de la fenêtre Catalogue. Utilisez cet élément en entrée dans l'outil Package Result (Empaqueter des résultats).
Lorsqu’un outil est exécuté depuis Python, un objet Result est renvoyé. La propriété resultID de l’objet Result peut servir d’entrée à cet outil. Le second exemple de code montre comment utiliser la propriété resultID d’un objet Result.
Lorsque l’option Prendre en charge ArcGIS Runtime est sélectionnée, le paquetage de géotraitement créé peut être utilisé dans l’environnement ArcGIS Runtime SDK. Pour prendre en charge l'environnement d'exécution, voici ce qui se produit :
- Toutes les sources de données n’étant pas des géodatabases sont converties en une géodatabase fichier.
- Une copie de l'outil empaqueté est créée dans une nouvelle boîte à outils configurée à des fins de publication.
Remarque :
Depuis ArcGIS Pro 2.1, il est possible de créer des paquetages de géotraitement prenant en charge ArcGIS Runtime.
Si le paramètre Convertir les données en géodatabase fichier est coché, voici ce qui se passe :
- Chaque source de données unique correspond à 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.
Si le paramètre Convertir les données en géodatabase fichier n’est pas coché, voici ce qui se passe :
- Le format source des données des couches en entrée est préservé lorsque cela est possible.
- Les formats raster ADRG, CADRG/ECRG, CIB et RPF sont convertis en rasters de géodatabase fichier. ArcGIS ne peut pas écrire ces formats de manière native. Ils sont 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 dans 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 Extent (Étendue).
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 sont consolidées dans le dossier en sortie. Par défaut, les sources de données jointes ou associées sont consolidées dans leur intégralité ou, en fonction du paramètre Sélectionner les lignes associées, selon l’étendue spécifiée à l’aide du paramètre Étendue.
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 référençant 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.
Lorsque le paramètre Schema only (Structure uniquement) est sélectionné, seule la structure des sources de données en entrée et en sortie est consolidée ou empaquetée. 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 sont ni consolidées, ni empaquetées. Si le paramètre Schema only (Structure uniquement) est sélectionné 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.
Pour décompresser un paquetage de géotraitement, utilisez l’outil Extraire un paquetage pour extraire le contenu dans un dossier. Vous pouvez ensuite accéder au répertoire et explorer l’outil ainsi que les données. Vous pouvez également cliquer avec le bouton droit sur le paquetage à partir d'un dossier dans la fenêtre Catalogue et l'extraire dans la carte actuelle. L'outil est accessible depuis la section Geoprocessing History (Historique du géotraitement).
Par défaut, lors de l'extraction d'un paquetage à partir de la fenêtre Catalog (Catalogue), le contenu est extrait dans votre profil utilisateur.
Paramètres
arcpy.management.PackageResult(in_result, output_file, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {arcgisruntime}, {additional_files}, {summary}, {tags}, {version}, {select_related_rows})
Nom | Explication | Type de données |
in_result [in_result,...] | Résultat empaqueté. L’entrée peut être un résultat de l’historique du projet actuel ou la propriété resultID d’un objet Result lorsque l’outil est utilisé dans un script Python. | File; String |
output_file | Nom et emplacement du fichier de paquetage en sortie (.gpkx). | File |
convert_data (Facultatif) | Spécifie si les couches en entrée seront converties en une géodatabase fichier ou si leur format original sera conservé.
| Boolean |
convert_arcsde_data (Facultatif) | Spécifie si les couches de géodatabases d'entreprise en entrée seront converties en une géodatabase fichier ou si leur format original sera conservé.
| Boolean |
extent (Facultatif) | Spécifie l'étendue utilisée pour sélectionner ou découper les entités.
| Extent |
apply_extent_to_arcsde (Facultatif) | Indique si l’étendue spécifiée est appliquée à toutes les couches ou aux couches de géodatabases d’entreprise.
| Boolean |
schema_only (Facultatif) | Spécifie si tous les enregistrements des jeux de données en sortie ou uniquement la structure des jeux de données en entrée et en sortie sont consolidés ou empaquetés.
| Boolean |
arcgisruntime (Facultatif) | Spécifie si le paquetage prend ArcGIS Runtime en charge. Pour assurer la prise en charge de ArcGIS Runtime, toutes les sources de données sont converties en une géodatabase fichier.
| Boolean |
additional_files [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 des 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. Lorsqu’une version est spécifiée, les paquetages peuvent être partagés avec les versions précédentes d’ArcGIS et la compatibilité avec les versions antérieures est assurée. Remarque :Un paquetage enregistré sous une version antérieure peut perdre les propriétés qui sont disponibles uniquement dans la version ultérieure.
| String |
select_related_rows (Facultatif) | Détermine si l’étendue définie est appliquée aux sources de données associées.
| Boolean |
Exemple de code
Le script Python ci-dessous illustre l’utilisation de la fonction PackageResult dans la fenêtre Python.
import arcpy
arcpy.env.workspace = "C:/ResultFiles"
arcpy.management.PackageResult('Parcel.rlt', 'Parcel.gpk', "PRESERVE",
"CONVERT_ARCSDE", "#", "ALL", "ALL",
"DESKTOP", r"C:\docs\readme.txt",
"Summary text", "Tag1; tag2; tag3")
Le script Python ci-dessous illustre l’utilisation de la fonction PackageResult à partir de la fenêtre Python ou d’un script avec l’objet Result 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.management.PackageResult(parcelUpdate.resultID, "c:/gpks/parcelgpk.gpkx",
"PRESERVE", "CONVERT_ARCSDE", "#", "ALL",
"ALL", "DESKTOP", "#", "Summary text", "Tag1")
Environnements
Vous avez un commentaire à formuler concernant cette rubrique ?