Charger une définition de service (Serveur)

Synthèse

Télécharge et partage une couche Web, un localisateur, un outil Web ou un service sur ArcGIS Online, ArcGIS Enterprise ou ArcGIS Server.

Utilisation

  • Cet outil télécharge et partage une couche Web, un localisateur, un outil Web ou un service en fonction de la définition de service en entrée.

  • Cet outil ne télécharge et ne partage aucun fichier préliminaire de définition de service (.sddraft). Si vous disposez d’un fichier préliminaire de définition de service, vous pouvez le convertir en définition de service organisée à l’aide de l’outil Organiser le service.

  • Les outils Web peuvent uniquement être partagés sur ArcGIS Enterprise. Les services de géotraitement ne peuvent être publiés que sur ArcGIS Server.

  • Les localisateurs ne peuvent être partagés que sur ArcGIS Enterprise. Les services de géocodage ne peuvent être publiés que sur ArcGIS Server.

Paramètres

ÉtiquetteExplicationType de données
Définition de service

Le fichier de définition de service (.sd) qui contient toutes les informations nécessaires au partage d’une couche Web, d’un outil Web ou d’un service.

File
Serveur

Le type de serveur Les types de serveur suivants sont pris en charge :

  • Mes services hébergés : utilisez ce type lorsque vous partagez une couche Web hébergée sur ArcGIS Online ou sur ArcGIS Enterprise. Entrez My Hosted Services pour la connexion au serveur. Écrivez la première lettre de chaque mot en majuscule et séparez les mots par un espace.
  • HOSTING_SERVER : utilisez ce type lorsque vous partagez une couche Web hébergée sur ArcGIS Online ou sur ArcGIS Enterprise.
  • URL renvoyant au serveur fédéré avec le portail ArcGIS Enterprise : utilisez ce type lorsque vous partagez un outil Web ou une couche d’images de carte sur un serveur fédéré avec le portail ArcGIS Enterprise.
  • Connexion ArcGIS Server : utilisez ce type lorsque vous partagez un service de carte ou de géotraitement sur ArcGIS Server. Vous pouvez utiliser les connexions ArcGIS Server répertoriées sous le nœud Serveurs de la fenêtre Projet ou accéder à un dossier dans lequel sont stockés les fichiers de connexion au serveur.
  • URL d’accès à ArcGIS Server : utilisez ce type lorsque vous partagez un service de carte ou de géotraitement sur ArcGIS Server. Vous pouvez spécifier l’URL d’accès à ArcGIS Server dans la mesure où une connexion éditeur à ArcGIS Server a été ajoutée au projet ArcGIS AllSource et que vous ouvrez le projet dans le script ou que vous exécutez l’outil dans ArcGIS AllSource.

ServerConnection
Nom du service
(Facultatif)

Le nom du service qui remplacera le nom de service actuel spécifié dans la définition de service.

String
Agrégat
(Facultatif)

Le nom de l’agrégat qui remplacera l’agrégat actuel auquel le service a été assigné. Vous devez choisir parmi les agrégats se trouvant sur le serveur spécifié.

Héritage :

Les agrégats sont obsolètes à partir de ArcGIS Enterprise 10.5.1. Ce paramètre sera ignoré pour les serveurs qui ne prennent pas en charge plusieurs agrégats.

String
Type de dossier
(Facultatif)

Spécifie le type de dossier qui sera utilisé pour déterminer la source du dossier. Par défaut, le dossier provient de la définition de service. Vous pouvez également obtenir la liste des dossiers présents sur le serveur en ligne spécifié, ou vous pouvez indiquer un dossier à créer une fois la couche Web ou le service partagé.

  • NouveauUn nouveau dossier sera créé.
  • ExistantUn dossier existant sur le serveur sera utilisé.
  • Depuis la définition de serviceLe dossier de la définition de service sera utilisé. Il s’agit de l’option par défaut.
String
Dossier
(Facultatif)

Dossier qui sera utilisé pour la couche Web ou le service. Si aucun dossier n’est fourni, le dossier spécifié dans la définition de service sera utilisé. Si vous avez spécifié le type de dossier Nouveau comme Type de dossier, utilisez ce paramètre pour fournir un nom de dossier. Si vous avez spécifié Existant comme Type de dossier, vous pouvez choisir un dossier parmi ceux qui figurent sur le serveur.

String
Démarrer le service immédiatement
(Facultatif)

Indique si le service doit être démarré après le partage.

  • Activé : le service sera démarré après le partage. Il s’agit de l’option par défaut.
  • Désactivé : le service ne sera pas démarré après le partage.
Boolean
Remplacer les propriétés de partage de la définition de service
(Facultatif)

Indique si les propriétés de partage définies dans la définition de service seront remplacées par de nouvelles valeurs. Ces propriétés déterminent si (et comment) vous partagez votre couche Web ou votre outil Web avec ArcGIS Online ou ArcGIS Enterprise. Le fait de partager la couche Web permet à d’autres utilisateurs de l’utiliser.

  • Activé : les propriétés de partage définies dans la définition de service seront remplacées.
  • Désactivé : les propriétés de partage définies dans la définition de service ne seront pas remplacées, elles seront utilisées. Il s’agit de l’option par défaut.

Vous devez être connecté à ArcGIS Online ou à ArcGIS Enterprise pour remplacer les propriétés de partage.

Ce paramètre n’est pas respecté en cas de partage sur ArcGIS Server.

Boolean
Partager sur ArcGIS Online
(Facultatif)

Indique si les couches Web et les outils Web seront partagés.

Tous les outils web et couches web partagés sont disponibles par le biais de My Content (Mon contenu). Même si vous souhaitez uniquement les partager avec un groupe spécifique de votre organisation, la couche web ou l’outil web sont également partagés via My Content (Mon contenu).

  • Activé : la couche Web ou l’outil Web seront partagés sur ArcGIS Online ou ArcGIS Enterprise. La couche web ou l’outil web sont répertoriés sous My Content (Mon contenu).
  • Désactivé : la couche Web ou l’outil Web ne seront pas partagés sur ArcGIS Online ou ArcGIS Enterprise, et les autres utilisateurs et clients ArcGIS Online ou ArcGIS Enterprise sur le Web ne pourront pas y accéder. Il s’agit de l’option par défaut.

Vous devez être connecté à ArcGIS Online ou à ArcGIS Enterprise pour remplacer les propriétés de partage.

Ce paramètre n’est pas respecté en cas de partage sur ArcGIS Server.

Boolean
Partager avec tout le monde (Public)
(Facultatif)

Détermine si la couche web ou l’outil web est accessible au public.

  • Activé : la couche Web ou l’outil Web sont accessibles au public.
  • Désactivé : la couche Web ou l’outil Web n’est pas accessible au public. Il s’agit de l’option par défaut.

Vous devez être connecté à un portail pour remplacer les propriétés de partage.

Ce paramètre n’est pas respecté en cas de partage sur ArcGIS Server.

Boolean
Partager avec votre organisation
(Facultatif)

Détermine si la couche Web ou l’outil Web seront partagés avec votre organisation.

  • Activé : la couche Web ou l’outil Web seront partagés avec votre organisation.
  • Désactivé : la couche Web ou l’outil Web ne seront pas partagés avec votre organisation. Il s’agit de l’option par défaut.

Vous devez être connecté à ArcGIS Online ou à ArcGIS Enterprise pour remplacer les propriétés de partage.

Ce paramètre n’est pas respecté lors du partage d’un service de carte ou de géotraitement sur ArcGIS Server.

Boolean
Partager avec ces groupes
(Facultatif)

Indique si la couche Web ou l’outil Web sera partagé avec les groupes spécifiés au sein de votre organisation.

  • Activé : la couche Web ou l’outil Web seront partagés avec les groupes spécifiés.
  • Désactivé : la couche Web ou l’outil Web ne seront pas partagés avec les groupes spécifiés.

Vous devez être connecté à ArcGIS Online ou à ArcGIS Enterprise pour remplacer les propriétés de partage.

Ce paramètre n’est pas respecté en cas de partage sur ArcGIS Server.

String

Sortie obtenue

ÉtiquetteExplicationType de données
URL de service SOAP

URL SOAP d’un service publié sur le serveur.

String
URL de service REST

URL REST d’un service publié sur le serveur.

String
ID de l'élément du service de cartes hébergé

ID de l’élément de la couche d’images de carte partagée sur le portail.

String
ID de l'élément du service d'entités hébergé

ID de l’élément de la couche du service d’entités qui est hébergé sur le portail.

String
Service mis en cache

Service d’imagerie ou service de carte pour lequel la mise en cache est activée.

Image Service; Map Server
URL du service d'entités

URL de service REST d’une couche d’entités hébergée et partagée sur le portail.

String
URL du service de carte

URL de service REST d’une couche d’images de carte partagée sur le portail.

String
ID de la couche

Couches publiées et leur ID respectif au format Layer1|ID1;Layer2|ID2; et ainsi de suite.

String
URL du service

Tables autonomes publiées et leur ID respectif au format Table1|ID1 ; Table2|ID2, etc.

String
ID de l'élément du service de tuiles vectorielles hébergé

ID de l’élément du service de tuiles vectorielles.

String
URL du service de tuiles vectorielles

URL du service REST du service de tuiles vectorielles.

String

arcpy.management.UploadServiceDefinition(in_sd_file, in_server, {in_service_name}, {in_cluster}, {in_folder_type}, {in_folder}, {in_startupType}, {in_override}, {in_my_contents}, {in_public}, {in_organization}, {in_groups})
NomExplicationType de données
in_sd_file

Le fichier de définition de service (.sd) qui contient toutes les informations nécessaires au partage d’une couche Web, d’un outil Web ou d’un service.

File
in_server

Le type de serveur Les types de serveur suivants sont pris en charge :

  • Mes services hébergés : utilisez ce type lorsque vous partagez une couche Web hébergée sur ArcGIS Online ou sur ArcGIS Enterprise. Entrez My Hosted Services pour la connexion au serveur. Écrivez la première lettre de chaque mot en majuscule et séparez les mots par un espace.
  • HOSTING_SERVER : utilisez ce type lorsque vous partagez une couche Web hébergée sur ArcGIS Online ou sur ArcGIS Enterprise.
  • URL renvoyant au serveur fédéré avec le portail ArcGIS Enterprise : utilisez ce type lorsque vous partagez un outil Web ou une couche d’images de carte sur un serveur fédéré avec le portail ArcGIS Enterprise.
  • Connexion ArcGIS Server : utilisez ce type lorsque vous partagez un service de carte ou de géotraitement sur ArcGIS Server. Vous pouvez utiliser les connexions ArcGIS Server répertoriées sous le nœud Serveurs de la fenêtre Projet ou accéder à un dossier dans lequel sont stockés les fichiers de connexion au serveur.
  • URL d’accès à ArcGIS Server : utilisez ce type lorsque vous partagez un service de carte ou de géotraitement sur ArcGIS Server. Vous pouvez spécifier l’URL d’accès à ArcGIS Server dans la mesure où une connexion éditeur à ArcGIS Server a été ajoutée au projet ArcGIS AllSource et que vous ouvrez le projet dans le script ou que vous exécutez l’outil dans ArcGIS AllSource.

ServerConnection
in_service_name
(Facultatif)

Le nom du service qui remplacera le nom de service actuel spécifié dans la définition de service.

String
in_cluster
(Facultatif)

Le nom de l’agrégat qui remplacera l’agrégat actuel auquel le service a été assigné. Vous devez choisir parmi les agrégats se trouvant sur le serveur spécifié.

Héritage :

Les agrégats sont obsolètes à partir de ArcGIS Enterprise 10.5.1. Ce paramètre sera ignoré pour les serveurs qui ne prennent pas en charge plusieurs agrégats.

String
in_folder_type
(Facultatif)

Spécifie le type de dossier qui sera utilisé pour déterminer la source du dossier. Par défaut, le dossier provient de la définition de service. Vous pouvez également obtenir la liste des dossiers présents sur le serveur en ligne spécifié, ou vous pouvez indiquer un dossier à créer une fois la couche Web ou le service partagé.

  • NEWUn nouveau dossier sera créé.
  • EXISTINGUn dossier existant sur le serveur sera utilisé.
  • FROM_SERVICE_DEFINITIONLe dossier de la définition de service sera utilisé. Il s’agit de l’option par défaut.
String
in_folder
(Facultatif)

Dossier qui sera utilisé pour la couche Web ou le service. Si aucun dossier n’est fourni, le dossier spécifié dans la définition de service sera utilisé. Si vous avez spécifié NEW pour in_folder_type, utilisez ce paramètre pour fournir un nom de dossier. Si vous avez spécifié EXISTING pour in_folder_type, vous pouvez choisir un dossier parmi ceux qui figurent sur le serveur.

String
in_startupType
(Facultatif)

Indique si le service doit être démarré après le partage.

  • STARTEDLe service sera démarré après le partage. Il s’agit de l’option par défaut.
  • STOPPEDLe service ne sera pas démarré après le partage.
Boolean
in_override
(Facultatif)

Indique si les propriétés de partage définies dans la définition de service seront remplacées par de nouvelles valeurs. Ces propriétés déterminent si (et comment) vous partagez votre couche Web ou votre outil Web avec ArcGIS Online ou ArcGIS Enterprise. Le fait de partager votre couche Web ou outil Web permet à d’autres utilisateurs de les utiliser.

  • OVERRIDE_DEFINITIONLes propriétés de partage définies dans la définition de service seront remplacées.
  • USE_DEFINITIONLes propriétés de partage définies dans la définition de service ne seront pas remplacées, elles seront utilisées. Il s’agit de l’option par défaut.

Vous devez être connecté à ArcGIS Online ou à ArcGIS Enterprise pour remplacer les propriétés de partage.

Ce paramètre n’est pas respecté en cas de partage sur ArcGIS Server.

Boolean
in_my_contents
(Facultatif)

Indique si les couches Web et les outils Web seront partagés.

Tous les outils web et couches web partagés sont disponibles par le biais de My Content (Mon contenu). Même si vous souhaitez uniquement les partager avec un groupe spécifique de votre organisation, la couche web ou l’outil web sont également partagés via My Content (Mon contenu).

  • SHARE_ONLINELa couche Web ou l’outil Web seront partagés sur ArcGIS Online ou ArcGIS Enterprise. La couche web ou l’outil web sont répertoriés sous My Content (Mon contenu).
  • NO_SHARE_ONLINELa couche Web ou l’outil Web ne seront pas partagés sur ArcGIS Online ou ArcGIS Enterprise, et les autres utilisateurs et clients ArcGIS Online ou ArcGIS Enterprise sur le Web ne pourront pas y accéder. Il s’agit de l’option par défaut.

Vous devez être connecté à un portail pour remplacer les propriétés de partage.

Ce paramètre n’est pas respecté en cas de partage sur ArcGIS Server.

Boolean
in_public
(Facultatif)

Détermine si la couche web ou l’outil web est accessible au public.

  • PUBLICLa couche Web ou l’outil Web seront accessibles au public.
  • PRIVATELa couche Web ou l’outil Web ne seont pas accessibles au public. Il s’agit de l’option par défaut.

Vous devez être connecté à ArcGIS Online ou à ArcGIS Enterprise pour remplacer les propriétés de partage.

Ce paramètre n’est pas respecté en cas de partage sur ArcGIS Server.

Boolean
in_organization
(Facultatif)

Détermine si la couche Web ou l’outil Web seront partagés avec votre organisation.

  • SHARE_ORGANIZATIONLa couche Web ou l’outil Web seront partagés avec votre organisation.
  • NO_SHARE_ORGANIZATIONLa couche Web ou l’outil Web ne seront pas partagés avec votre organisation. Il s’agit de l’option par défaut.

Vous devez être connecté à ArcGIS Online ou à ArcGIS Enterprise pour remplacer les propriétés de partage.

Ce paramètre n’est pas respecté en cas de partage sur ArcGIS Server.

Boolean
in_groups
[in_groups,...]
(Facultatif)

La liste des groupes avec lesquels la couche Web ou l’outil Web seront partagés.

Vous devez être connecté à ArcGIS Online ou à ArcGIS Enterprise pour remplacer les propriétés de partage.

Ce paramètre n’est pas respecté en cas de partage sur ArcGIS Server.

String

Sortie obtenue

NomExplicationType de données
out_soap_svc_url

URL SOAP d’un service publié sur le serveur.

String
out_rest_svc_url

URL REST d’un service publié sur le serveur.

String
out_mapServiceItemID

ID de l’élément de la couche d’images de carte partagée sur le portail.

String
out_featServiceItemID

ID de l’élément de la couche du service d’entités qui est hébergé sur le portail.

String
out_cached_service

Service d’imagerie ou service de carte pour lequel la mise en cache est activée.

Image Service; Map Server
out_featureServiceURL

URL de service REST d’une couche d’entités hébergée et partagée sur le portail.

String
out_mapServiceURL

URL de service REST d’une couche d’images de carte partagée sur le portail.

String
out_LayerIDMap

Couches publiées et leur ID respectif au format Layer1|ID1;Layer2|ID2; et ainsi de suite.

String
out_standaloneTableIDMap

Tables autonomes publiées et leur ID respectif au format Table1|ID1 ; Table2|ID2, etc.

String
out_vectorTileServiceID

ID de l’élément du service de tuiles vectorielles.

String
out_vectorTileServiceURL

URL du service REST du service de tuiles vectorielles.

String

Exemple de code

Exemple 1 d'UploadServiceDefinition (script autonome)

Les scripts suivants publient une liste de couches à partir d’une carte en tant que couche de tuiles web vers ArcGIS Enterprise ou ArcGIS Online. Les informations de portail sont obtenues à partir de la page Portails dans ArcGIS AllSource.

import arcpy
import os

# Set output file names
outdir = r"C:\Project\Output"
service = "TileSharingDraftExample"
sddraft_filename = service + ".sddraft"
sddraft_output_filename = os.path.join(outdir, sddraft_filename)

# Reference map to publish
aprx = arcpy.mp.ArcGISProject(r"C:\Project\World.aprx")
m = aprx.listMaps("World")[0]
lyrs = []
lyrs.append(m.listLayers('cities')[0])
lyrs.append(m.listLayers('counties')[0])

# Create TileSharingDraft and set service properties
sharing_draft = m.getWebLayerSharingDraft("HOSTING_SERVER", "TILE", service, lyrs)
sharing_draft.summary = "My Summary"
sharing_draft.tags = "My Tags"
sharing_draft.description = "My Description"
sharing_draft.credits = "My Credits"
sharing_draft.useLimitations = "My Use Limitations"

# Create Service Definition Draft file
sharing_draft.exportToSDDraft(sddraft_output_filename)

# Stage Service
sd_filename = service + ".sd"
sd_output_filename = os.path.join(outdir, sd_filename)
arcpy.server.StageService(sddraft_output_filename, sd_output_filename)

# Share to portal
print("Uploading Service Definition...")
arcpy.server.UploadServiceDefinition(sd_output_filename, "My Hosted Services")

print("Successfully Uploaded service.")
Exemple 2 d'utilisation de l'outil UploadServiceDefinition (script autonome)

Le script suivant télécharge une définition de service existante et utilise des paramètres facultatifs pour modifier certaines propriétés du service.

import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
inSdFile = "myMapService.sd"
inServer = "myServerConnection.ags"
inServiceName = "newServiceName"
inCluster = "myCluster"
inFolderType = "NEW"
inFolder = "newFolder"
inStartup = "STOPPED"

# Run UploadServiceDefinition
arcpy.server.UploadServiceDefinition(inSdFile, inServer, inServiceName, 
                                     inCluster, inFolderType, inFolder, 
                                     inStartup)
Exemple 3 d'UploadServiceDefinition (script autonome)

Le script suivant télécharge une définition de service existante sur ArcGIS Online ou ArcGIS Enterprise et utilise des paramètres facultatifs pour modifier certaines propriétés du service.

import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data"

# Set local variables
inSdFile = "myMapService.sd"
inServer = "HOSTING_SERVER"
inServiceName = "newServiceName"
inCluster = "myCluster"
inFolderType = "EXISTING"
inFolder = "existingFolder"
inStartup = "STOPPED"
inOverride = "OVERRIDE_DEFINITION"
inMyContents = "SHARE_ONLINE"
inPublic = "PRIVATE"
inOrganization = "NO_SHARE_ORGANIZATION"
inGroups = ["My Group", "MyGroup 2"]

# Run UploadServiceDefinition
arcpy.server.UploadServiceDefinition(inSdFile, inServer, inServiceName, 
                                     inCluster, inFolderType, inFolder, 
                                     inStartup, inOverride, inMyContents, 
                                     inPublic, inOrganization, inGroups)

Environnements

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