Empaqueter des résultats (Gestion des données)

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 Maps SDKs est sélectionnée, le paquetage de géotraitement créé peut être utilisé dans l’environnement ArcGIS Maps SDKs. Pour prendre en charge l’environnement ArcGIS Maps SDKs, 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 Maps SDKs.

  • 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 pour le paramètre É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, un jeu de données de topologie peut référencer 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 et les 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

ÉtiquetteExplicationType 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é.

  • Activé - toutes les données sont converties en une géodatabase fichier. Cette option ne s'applique pas aux sources de données de géodatabases d'entreprise. Pour inclure des données de géodatabases d’entreprise, activez le paramètre Inclure les données de géodatabase d’entreprise plutôt que de référencer les données.
  • Désactivé : les formats de données sont conservés lorsque cela est possible. Il s’agit de l’option par défaut.
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é.

  • Activé - Toutes les sources de données de géodatabase d'entreprise sont converties en une géodatabase fichier. Il s’agit de l’option par défaut.
  • Désactivé - Toutes les sources de données de géodatabases d'entreprise sont conservées et référencées dans le paquetage obtenu.
Boolean
Étendue
(Facultatif)

Spécifie l'étendue utilisée pour sélectionner ou découper les entités.

  • Current Display Extent (Étendue actuellement affichée) Vue cartographique : l’étendue repose sur la carte ou la scène active.
  • Dessiner l’étendue Terminer avec mise à l’équerre : 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) 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 :

    • Toutes les entités Sélectionner tout : étendue de toutes les entités.
    • Entités sélectionnées Zone à partir des entités sélectionnées : étendue de toutes les entités sélectionnées.
    • Entités visibles Extent Indicator : étendue de toutes les entités visibles.

  • Parcourir Parcourir : l’étendue repose sur un jeu de données.
  • Intersection des entrées Intersection : l’étendue est l’étendue d’intersection de toutes les entrées.
  • Union des entrées Agréger : l’étendue est l’étendue combinée de toutes les entrées.
  • Presse-papiers Coller : l’étendue peut être copiée depuis et vers le Presse-papiers.
    • Copier l’étendue Copier : copie l’étendue et le système de coordonnées dans le Presse-papiers.
    • Coller l’étendue Coller : colle l’étendue et le système de 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) Réinitialiser : 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
Appliquer l’étendue aux couches de géodatabase 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.

  • Désactivé : l'étendue spécifiée est appliquée à toutes les couches. Il s’agit de l’option par défaut.
  • Activé : l'étendue spécifiée n'est appliquée qu'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.

  • Désactivé - Toutes les entités et tous les enregistrements des jeux de données en entrée et en sortie sont inclus dans le dossier ou le paquetage consolidé. Il s’agit de l’option par défaut.
  • Activé - Seule la structure des jeux de données en entrée et en sortie est consolidée ou empaquetée. Aucune entité ou aucun enregistrement n'est consolidé ou empaqueté dans le dossier en sortie.
Boolean
Prendre en charge ArcGIS Maps SDKs
(Facultatif)

Spécifie si le paquetage prend ArcGIS Maps SDKs en charge. Pour assurer la prise en charge de ArcGIS Maps SDKs, 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.

  • Désactivé : le paquetage en sortie ne prend pas ArcGIS Maps SDKs en charge. Il s’agit de l’option par défaut.
  • Activé : le paquetage en sortie prend ArcGIS Maps SDKs en charge.
Boolean
Fichiers supplémentaires
(Facultatif)

Fichiers supplémentaires qui seront inclus dans le paquetage.

File
Résumé
(Facultatif)

Texte qui sera utilisé comme propriété récapitulative du paquetage en sortie.

String
Balises
(Facultatif)

Les informations sur les balises seront ajoutées 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)

Indique la version de ArcGIS Pro avec laquelle certains objets tels que des projets, cartes et couches seront compatibles et dans laquelle ils seront conservés. L’enregistrement dans une version antérieure peut être utile si le projet est utilisé avec un logiciel plus ancien.

Attention :

Un paquetage enregistré sous une version antérieure peut perdre les fonctions ou propriétés qui ne sont pas prises en charge dans la version antérieure.

  • Toutes les versionsLe contenu du paquetage est compatible avec toutes les versions (ArcGIS Pro 2.1 et versions ultérieures).
  • Version actuelleLe contenu du paquetage est compatible avec la version actuelle de ArcGIS Pro.
  • ArcGIS Pro 2.2Le contenu du paquetage est compatible avec ArcGIS Pro version 2.2.
  • ArcGIS Pro 2.3Le contenu du paquetage est compatible avec ArcGIS Pro version 2.3.
  • ArcGIS Pro 2.4Le contenu du paquetage est compatible avec ArcGIS Pro version 2.4.
  • ArcGIS Pro 2.5Le contenu du paquetage est compatible avec ArcGIS Pro version 2.5.
  • ArcGIS Pro 2.6Le contenu du paquetage est compatible avec ArcGIS Pro version 2.6.
  • ArcGIS Pro 2.7Le contenu du paquetage est compatible avec ArcGIS Pro version 2.7.
  • ArcGIS Pro 2.8Le contenu du paquetage est compatible avec ArcGIS Pro version 2.8.
  • ArcGIS Pro 2.9Le contenu du paquetage est compatible avec ArcGIS Pro version 2.9.
  • ArcGIS Pro 3.0Le contenu du paquetage est compatible avec ArcGIS Pro version 3.0.
  • ArcGIS Pro 3.1Le contenu du paquetage est compatible avec ArcGIS Pro version 3.1.
  • ArcGIS Pro 3.2Le contenu du paquetage est compatible avec ArcGIS Pro version 3.2.
  • ArcGIS Pro 3.3Le contenu du paquetage est compatible avec ArcGIS Pro version 3.3.
  • ArcGIS Pro 3.4Le contenu du paquetage est compatible avec ArcGIS Pro version 3.4.
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.

  • Désactivée - Les sources de données associées sont consolidées dans leur globalité. Il s’agit de l’option par défaut.
  • Activée - Seules les données associées correspondant aux enregistrements situés dans l’étendue définie sont consolidées.
Boolean

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})
NomExplicationType 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é.

  • CONVERTLes données sont converties en une géodatabase fichier. Cette option 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 le paramètre convert_arcsde_data sur CONVERT_ARCSDE.
  • PRESERVELes formats de données sont conservés lorsque cela est possible. Il s’agit de l’option par défaut.
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é.

  • CONVERT_ARCSDELes données de géodatabases d'entreprise seront converties en une géodatabase fichier et incluses dans le dossier ou paquetage consolidé. Il s’agit de l’option par défaut.
  • PRESERVE_ARCSDELes 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)

Spécifie l'étendue utilisée pour sélectionner ou découper les entités.

  • 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
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.

  • ALLL’étendue spécifiée est appliquée à toutes les couches. Il s’agit de l’option par défaut.
  • ARCSDE_ONLYL’étendue spécifiée est appliquée uniquement 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.

  • ALLTous 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_ONLYSeule 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 ArcGIS Maps SDKs en charge. Pour assurer la prise en charge de ArcGIS Maps SDKs, toutes les sources de données sont converties en une géodatabase fichier.

  • DESKTOPLe paquetage en sortie ne prend pas ArcGIS Maps SDKs en charge. Il s’agit de l’option par défaut.
  • RUNTIMELe paquetage en sortie prend ArcGIS Maps SDKs en charge.
Boolean
additional_files
[additional_files,...]
(Facultatif)

Fichiers supplémentaires qui seront inclus dans le paquetage.

File
summary
(Facultatif)

Texte qui sera utilisé comme propriété récapitulative du paquetage en sortie.

String
tags
(Facultatif)

Les informations sur les balises seront ajoutées 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)

Indique la version de ArcGIS Pro avec laquelle certains objets tels que des projets, cartes et couches seront compatibles et dans laquelle ils seront conservés. L’enregistrement dans une version antérieure peut être utile si le projet est utilisé avec un logiciel plus ancien.

Attention :

Un paquetage enregistré sous une version antérieure peut perdre les fonctions ou propriétés qui ne sont pas prises en charge dans la version antérieure.

  • ALLLe contenu du paquetage est compatible avec toutes les versions (ArcGIS Pro 2.1 et versions ultérieures).
  • CURRENTLe contenu du paquetage est compatible avec la version actuelle de ArcGIS Pro.
  • 2.2Le contenu du paquetage est compatible avec ArcGIS Pro version 2.2.
  • 2.3Le contenu du paquetage est compatible avec ArcGIS Pro version 2.3.
  • 2.4Le contenu du paquetage est compatible avec ArcGIS Pro version 2.4.
  • 2.5Le contenu du paquetage est compatible avec ArcGIS Pro version 2.5.
  • 2.6Le contenu du paquetage est compatible avec ArcGIS Pro version 2.6.
  • 2.7Le contenu du paquetage est compatible avec ArcGIS Pro version 2.7.
  • 2.8Le contenu du paquetage est compatible avec ArcGIS Pro version 2.8.
  • 2.9Le contenu du paquetage est compatible avec ArcGIS Pro version 2.9.
  • 3.0Le contenu du paquetage est compatible avec ArcGIS Pro version 3.0.
  • 3.1Le contenu du paquetage est compatible avec ArcGIS Pro version 3.1.
  • 3.2Le contenu du paquetage est compatible avec ArcGIS Pro version 3.2.
  • 3.3Le contenu du paquetage est compatible avec ArcGIS Pro version 3.3.
  • 3.4Le contenu du paquetage est compatible avec ArcGIS Pro version 3.4.
String
select_related_rows
(Facultatif)

Détermine si l’étendue définie est appliquée aux sources de données associées.

  • KEEP_ONLY_RELATED_ROWSSeules les données associées correspondant aux enregistrements situés dans l’étendue définie sont consolidées.
  • KEEP_ALL_RELATED_ROWSLes sources de données associées sont consolidées dans leur globalité. Il s’agit de l’option par défaut.
Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction PackageResult (fenêtre Python)

Le script Python suivant montre comment utiliser 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")
Exemple 2 d’utilisation de la fonction PackageResult (script autonome)

Le script Python ci-après 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

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

Informations de licence

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

Rubriques connexes