Partager un paquetage (Gestion des données)

Résumé

Permet de partager un paquetage en le téléchargeant sur ArcGIS Online ou ArcGIS Enterprise

Utilisation

  • Parmi les types de paquetages pris en charge, on compte les suivants :

    • Paquetages de géotraitement (.gpk, .gpkx)
    • Paquetages de couche (.lpk, .lpkx)
    • Paquetages de localisateur (.gcpk)
    • Paquetages de carte (.mpk, .mpkx)
    • Paquetages de tuiles (.tpk, .tpkx)
    • Paquetages de cartes mobiles (.mmpk)
    • Paquetages de couche de scènes (.slpk)
    • Paquetages de tuiles vectorielles (.vtpk)
    • Paquetages de projet et modèles de projet (.ppkx, .aptx)

  • Vous ne pourrez pas saisir votre nom d’utilisateur et votre mot de passe ArcGIS Online ou ArcGIS Enterprise si vous utilisez cet outil dans ArcGIS Pro. L’outil obtiendra lui-même vos identifiants de connexion dans ArcGIS Pro. Vous devez être connecté à ArcGIS Online ou ArcGIS Enterprise pour partager un paquetage avec cet outil.

  • Pour partager un paquetage avec ArcGIS Online ou ArcGIS Enterprise, un résumé et une ou plusieurs balises sont requis. Le résumé et les balises requis, ainsi que la description facultative du paquetage et les crédits permettent de rechercher des paquetages en ligne.

  • Si un paquetage portant ce nom existe déjà dans votre organisation ArcGIS Online ou ArcGIS Enterprise, il sera remplacé.

  • Si vous partagez un paquetage de tuiles, un paquetage de couche de scènes ou un paquetage de tuiles vectorielles, vous avez la possibilité de publier le paquetage automatiquement comme couche Web du type correspondant. (Un paquetage de tuiles est publié sous forme de couche de tuiles Web, un paquetage de couche de scènes l’est sous forme de couche de scènes Web, et un paquetage de tuiles vectorielles l’est sous forme de couche de tuiles vectorielles.) Pour publier une couche Web, vous devez détenir les privilèges nécessaires dans votre compte de portail actif.

  • Pour partager un paquetage sur ArcGIS Online avec un compte public, votre compte global Esri doit être inscrit en tant que membre d'ArcGIS Online. Pour créer et inscrire un compte global Esri, accédez au site arcgis.com/home/signup.html.

  • Remarque :

    L’utilisation de cet outil peut être limitée dans un script Python exécuté en dehors d’applications ArcGIS lors du partage d’un paquetage sur un portail requérant une authentification OAUTH2. ArcGIS Online, par exemple, utilise cette méthode d’authentification. Pour vous authentifier, vous devez vous connecter directement au portail à partir de l'application. Vous ne pouvez utiliser cet outil dans un script Python que si l’application est ouverte et connectée au portail ou si vous vous connectez à un portail qui utilise des mécanismes d’authentification traditionnels et qui autorise la transmission du nom d’utilisateur et du mot de passe.

Syntaxe

arcpy.management.SharePackage(in_package, username, password, summary, tags, {credits}, {public}, {groups}, {organization}, {publish_web_layer}, {portal_folder})
ParamètreExplicationType de données
in_package

Fichier de paquetage de couche en entrée (.lpk, .lpkx), de couche de scènes (.slpk), de carte (.mpk, .mpkx), de géotraitement (.gpk, .gpkx), de tuiles (.tpk, .tpkx), de cartes mobiles (.mmpk), de tuiles vectorielles (.vtpk), de localisateur d’adresses (.gcpk) ou de projet (.ppkx, .aptx).

File
username

Nom d’utilisateur ArcGIS Online ou ArcGIS Enterprise. L'utilisation de ce paramètre sera limitée dans un script Python lors du partage d'un paquetage sur un portail requérant une authentification OAUTH2. Pour en savoir plus, reportez-vous aux remarques d'utilisation.

String
password

Mot de passe ArcGIS Online ou ArcGIS Enterprise. L'utilisation de ce paramètre sera limitée dans un script Python lors du partage d'un paquetage sur un portail requérant une authentification OAUTH2. Pour en savoir plus, reportez-vous aux remarques d'utilisation.

Encrypted String
summary

Résumé du paquetage. Le résumé est affiché dans les informations d'élément du paquetage sur ArcGIS Online ou ArcGIS Enterprise.

String
tags

Balises utilisées pour décrire et identifier le paquetage. Les balises individuelles sont séparées à l'aide d'une virgule ou d'un point-virgule.

String
credits
(Facultatif)

Crédits pour le paquetage. Il s'agit en général du nom de l'organisation qui a les crédits nécessaires pour créer et fournir du contenu pour le paquetage.

String
public
(Facultatif)

Spécifie si le paquetage en entrée est partagé et accessible à tout le monde.

  • EVERYBODY Le paquetage est partagé avec tout le monde.
  • MYGROUPS Le paquetage est partagé avec son propriétaire et le groupe sélectionné. Il s’agit de l’option par défaut.
Boolean
groups
[group_name,...]
(Facultatif)

Liste des groupes avec lesquels partager le paquetage.

String
organization
(Facultatif)

Indique si le paquetage en entrée est accessible uniquement au sein de votre organisation ou partagé publiquement avec tout le monde.

  • EVERYBODY Le paquetage est partagé avec tout le monde. Il s’agit de l’option par défaut.
  • MYORGANIZATION Le paquetage sera partagé au sein de votre organisation uniquement.
Boolean
publish_web_layer
(Facultatif)

Détermine si le paquetage est publié sous forme de couche Web sur votre portail. Seuls les paquetages de tuiles, les paquetages de tuiles vectorielles et les paquetages de couche de scènes sont pris en charge.

  • FALSELe paquetage est chargé sans publication. Il s’agit de l’option par défaut.
  • TRUELe paquetage est chargé et publié sous forme de couche Web avec le même nom.
Boolean
portal_folder
(Facultatif)

Indique le nom d’un dossier existant ou d’un nouveau dossier sur le portail correspondant au paquetage. La couche Web publiée, le cas échéant, est stockée dans ce même dossier.

String

Sortie dérivée

NomExplicationType de données
out_results

Résultat du chargement du paquetage, et de la publication de la couche Web le cas échéant. Renvoie la valeur True (Vrai) en cas d’aboutissement.

Booléen
package_item_id

ID d’élément de portail du paquetage.

Chaîne
publish_results

Réponse JSON contenant l’URL de service et l’ID d’élément de portail de la couche Web.

Chaîne

Exemple de code

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

Le script suivant charge un paquetage de couche sur le portail actif.

import arcpy
arcpy.SharePackage_management(r"C:\states.lpkx", "username", "password", 
                              "My Summary", "tag1, tag2", "My Credits", 
                              "MYGROUPS", "My Group")
Exemple 2 d’utilisation de l’outil SharePackage (fenêtre Python)

Le script suivant charge un paquetage de tuiles sur le portail actif et le publie sous forme de couche Web.

import arcpy
arcpy.SharePackage_management(r"C:\states.tpk", "username", "password", 
                              "My Summary", "tag1, tag2", "My Credits", 
                              "MYGROUPS", "My Group", "MYORGANIZATION", "TRUE", 
                              "My Folder")
Exemple 3 d’utilisation de l’outil SharePackage (script autonome)

Le script suivant recherche tous les paquetages de carte qui résident dans un dossier spécifié et les charge sur le portail actif.

# Name: SharePackageExample.py
# Description:  Find all map packages that reside in a specified folder 
#               and upload them to the active portal.
# import system modules
import os
import arcpy
# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/data/my_packages" 
# Loop through the workspace to find all map packages 
for mpkx in arcpy.ListFiles("*.mpkx"):
    print("Uploading " + mpkx)
    arcpy.SharePackage_management(mpkx, "username", "password", 
                                  "My Summary", "tag1, tag2", 
                                  "My Credits", "MYGROUPS", "My Group")

Informations de licence

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

Rubriques connexes