Configurer des couches de contours

Esri fournit des couches contenant des informations démographiques et de contours pour différentes parties du monde. Ces couches (telles que la région, la province, la zone de recensement et les limites associées aux codes postaux) contiennent des informations locales connexes que les membres du portail peuvent utiliser dans leurs cartes, scènes, applications et outils d’analyse d’entités, ainsi que dans ArcGIS Insights.

Publiez ces couches sur votre portail si ArcGIS Insights est installé ou si votre portail n'a pas accès au contenu ArcGIS Living Atlas of the World depuis ArcGIS Online.

En tant qu'administrateur du portail, vous pouvez télécharger les fichiers de la définition du service de la couche de contours (.sd) de votre choix depuis My Esri et utiliser l'outil publishboundarylayers pour publier les couches d'entités hébergées à partir de ces fichiers.

Remarque :

Lorsque vous exécutez les outils décrits dans cette rubrique, vous devez utiliser un compte d’administration du portail intégré. L’URL que vous utilisez pour ces outils dépend de l’emplacement dans lequel vous déployez ArcGIS Enterprise.

• Si vous exécutez les outils sur un déploiement ArcGIS Enterprise sur site, vous devez accéder au portail par l’intermédiaire du port 7443 et non via un adaptateur Web ou un équilibreur de charge.
• Si vous exécutez les outils sur un déploiement ArcGIS Enterprise dans le cloud, vous devez accéder au portail par l’intermédiaire d’un adaptateur Web ou d’un équilibreur de charge ; n’utilisez pas le port 7443.

Vous pouvez publier à partir d'un dossier contenant tous les fichiers souhaités, publier des fichiers individuels ou fournir une liste de fichiers au format texte. Vérifiez que le compte utilisé pour installer Portal for ArcGIS dispose d'un accès en lecture sur ce répertoire.

La publication de ces fichiers de définition du service de la couche de contours (.sd) dans votre portail entraîne les conséquences suivantes :

• Chaque fichier .sd est ajouté en tant qu'élément de définition du service dans le portail. Ces fichiers doivent rester dans le portail si vous souhaitez mettre à jour les couches de contours lorsque du contenu actualisé est disponible.
• Une couche d'entités hébergée est créée pour chaque fichier .sd que vous publiez. Chaque couche d'entités hébergée contient plusieurs couches.
• Les éléments de définition du service et les couches d'entités hébergées sont détenus par un membre du portail interne nommé esri_boundaries. Ne transférez pas la propriété de ces éléments à un autre utilisateur.
• Par défaut, tous les membres de l’organisation de votre portail ont accès aux couches d’entités hébergées de contours sur le portail. Les membres du portail peuvent accéder aux couches de contours en procédant comme suit :
  • Rechercher des éléments de couches de contours dans le portail via l’onglet My Organization (Mon organisation) de la page Content (Contenu)
  • Ajoutez des couches de contours individuelles aux outils d’analyse d’entité dans Map Viewer Classic à partir de la boîte de dialogue Choose Analysis Layer (Sélectionner une couche d'analyse).
  • Ajoutez des couches de contours à Scene Viewer à partir du panneau Content (Contenu).

Publier des couches de contours

Ces couches font l’objet d’une licence dans le cadre du contrat de licence principal de Esri. Veuillez lire le résumé et les conditions d’utilisation avant de publier votre travail.

Recommandations d’usage importantes

• Ces couches font l’objet d’une licence à usage interne dans ArcGIS Enterprise, notamment dans Portal for ArcGIS, ArcGIS Insightset les autres applications ArcGIS connectées.
  • Il n’est pas permis d’utiliser ces couches en dehors de la famille de produits ArcGIS Enterprise ou d’exporter les données en vue de les exploiter en mode déconnecté dans ArcGIS ou d’autres applications.
  • Vous ne pouvez pas non plus partager la couche (par voie publique ou privée) à des fins d’usage externe par des membres d’autres organisations ou du public, sans l’accord écrit préalable de Esri.
• Ces couches sont concédées sous licence pour une durée de deux (2) ans à compter de la date de téléchargement depuis Esri. Vous pouvez télécharger les données les plus récentes chaque année pour prolonger la licence.
• Vous devez impérativement inclure la mention Credits (Attribution) (Crédits (Attribution)) chaque fois que vous affichez l’une de ces couches.

Procédez comme suit pour obtenir des fichiers de contours et les héberger en tant que couches d'entités sur votre portail :

1. Téléchargez les fichiers compressés contenant les définitions de service (.sd) depuis My Esri.
2. Extrayez les fichiers téléchargés et placez-les dans un dossier sur la machine Portal for ArcGIS.

   Les noms de fichiers utilisent un code à trois lettres pour indiquer les régions auxquelles ils s'appliquent. L'année à laquelle les données correspondent est ajoutée à la fin du nom. Par exemple, USA_Boundaries_2015 comporte les contours des Etats-Unis d'Amérique, tels qu'ils apparaissaient l'année 2015.

   Supprimez les fichiers que vous ne souhaitez ni charger ni publier sur votre portail. Vous pouvez également créer un fichier texte contenant une liste de sous-ensembles de fichiers que vous voulez charger et publier. Formatez le fichier texte de façon à ce qu'un fichier apparaisse par ligne. Par exemple, pour charger les contours des Etats-Unis d'Amérique ou du monde, le contenu du fichier texte sera le suivant :

   USA_Boundaries_2015
   WOR_Boundaries_2015

3. Ouvrez un terminal de commande sur la machine Portal for ArcGIS.
4. Définissez les répertoires sur l'emplacement de l'outil.
5. Exécutez l'outil publishboundarylayers.

   L'outil est installé dans <Portal installation directory>/tools/publishboundarylayers. La syntaxe de l'outil est la suivante : publishboundarylayers --folder <location of sd files> [{--files <file names>|--file <name of text file>}] --url <Portal website URL> --username <portal administrator user name> [--password <portal administrator password>]

   Si vous ne spécifiez pas de mot de passe lors de l'exécution de l'outil, vous êtes invité à fournir le mot de passe de l'administrateur du portail. Cet utilisateur doit être membre du rôle d'administrateur par défaut dans le portail.

   Si vous utilisez l'opération --files, spécifiez une liste de fichiers de définition du service, séparés par une virgule. Si vous utilisez l’option --file, spécifiez le nom et l’emplacement d’un fichier texte contenant la liste des fichiers de contours à publier.

   Dans cet exemple, tous les fichiers du répertoire boundaryfiles sont publiés dans un portail sur site :

   ./publishboundarylayers.sh --folder /usr/data/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin

   Dans cet exemple, les fichiers se trouvent dans le même répertoire (boundaryfiles), mais seulement deux fichiers sont publiés :

   ./publishboundarylayers.sh --folder /usr/data/boundaryfiles --files USA_Boundaries,WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin

   Dans cet exemple, un fichier texte (boundarysubset.vi) a été créé dans le répertoire boundaryfiles. L’outil lit la liste de fichiers à partir du fichier texte pour publier un sous-ensemble de couches de contours.

   ./publishboundarylayers.sh --folder /usr/data/boundaryfiles --file /usr/tmp/boundarysubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin

Une fois que la publication est terminée, un élément de définition du service et une couche d'entités hébergées sont présents pour chaque fichier .sd publié.

Pour vérifier l'existence des éléments, vous pouvez rechercher dans le portail tous les éléments détenus par un membre du portail interne nommé esri_boundaries. Saisissez owner:esri_boundaries dans le champ de recherche du portail et sélectionnez Parcourir tout le contenu.

Mettre à jour les couches de contours

Dans la plupart des cas, les mises à jour sont apportées à une couche de contours en tant que nouveau fichier de définition du service que vous publiez sur le portail avec l'utilitaire publishboundarylayers. Ceci vous permet d'utiliser les couches indépendamment et d'analyser les deux versions des données. Par exemple, il peut exister une version de 2015 et de 2017 du fichier des limites mondiales. Il est toutefois rare que les fichiers de définition de service fournis sur My Esri soient mis à jour pour corriger le contenu. Si cela se produit, vous pouvez télécharger les fichiers de mise à jour et les publier à l'aide de l'outil updateboundarylayers. Cette opération remplace la couche d'entités hébergée existante dans votre portail.

Comme indiqué dans l'introduction, vous pouvez uniquement mettre à jour les couches de contours si l'élément de définition du service de la couche est toujours présent dans le portail.

Procédez comme suit pour mettre à jour les couches d'entités de contours sur votre portail :

1. Téléchargez les fichiers compressés contenant les fichiers de définition du service mis à jour (.sd) depuis My Esri.
2. Extrayez les fichiers et placez-les dans un dossier de la machine Portal for ArcGIS.

   Supprimez les fichiers que vous ne souhaitez ni charger ni publier sur votre portail. Vous pouvez également créer un fichier texte contenant une liste de sous-ensembles de fichiers que vous voulez charger et publier. Formatez le fichier texte de façon à ce qu'un fichier apparaisse par ligne. Par exemple, pour charger les contours des Etats-Unis d'Amérique et du monde, le contenu du fichier texte sera le suivant :

   USA_Boundaries_2015
   WOR_Boundaries_2015

3. Ouvrez un terminal de commande sur la machine Portal for ArcGIS.
4. Définissez les répertoires sur l'emplacement de l'outil.
5. Exécutez l'outil updateboundarylayers.

   L'outil est installé dans <Portal installation directory>/tools/publishboundarylayers. La syntaxe de l'outil est la suivante : updateboundarylayers --folder <location of files> [{--files <file names>|--file <name of text file>}] --url <Portal home page URL> --username <portal administrator user name> [--password <portal administrator password>]

   Si vous ne spécifiez pas de mot de passe lors de l'exécution de l'outil, vous êtes invité à fournir le mot de passe de l'administrateur du portail. Cet utilisateur doit être membre du rôle d'administrateur par défaut dans le portail.

   Si vous utilisez l'opération --files, spécifiez une liste de fichiers de définition du service, séparés par une virgule. Si vous utilisez l'option --file, spécifiez le nom d'un fichier texte contenant la liste des fichiers de contours à publier.

   Dans cet exemple, l’outil updateboundarylayers publie tous les fichiers dans le répertoire boundaryfiles et remplace les couches existantes :

   ./updateboundarylayers.sh --folder /usr/data/boundaryfiles --url https://portal.domain.com:7443/arcgis --username portaladmin

   Dans cet exemple, les fichiers se trouvent dans le même répertoire (boundaryfiles), mais un seul fichier est republié :

   ./updateboundarylayers.sh --folder /usr/data/boundaryfiles --files WOR_Boundaries --url https://portal.domain.com:7443/arcgis --username portaladmin

   Dans cet exemple, un fichier texte (boundaryupdatesubset.vi) a été créé dans le répertoire boundaryfiles. L’outil lit la liste de fichiers à partir du fichier texte pour republier un sous-ensemble de couches de contours.

   ./updateboundarylayers.sh --folder /usr/data/boundaryfiles --file /usr/tmp/boundaryupdatesubset.vi --url https://portal.domain.com:7443/arcgis --username portaladmin

Une fois la publication terminée, les couches d'entités hébergées existantes contiennent des données ou métadonnées mises à jour.

Supprimer les couches de contours

Si vous pensez qu'une couche de contour n'est pas nécessaire dans votre portail, vous pouvez la supprimer. Vous pouvez rechercher la couche sur le site Web du portail et la supprimer ou exécuter l'outil deleteboundarylayers. Si vous souhaitez supprimer plusieurs couches de contours, utilisez l'outil deleteboundarylayers.

L’outil deleteboundarylayers ne supprime pas les couches dont la protection contre la suppression est activée.

Attention :

Si vous supprimez une couche de contours qui est actuellement utilisée dans une carte, application ou scène, la couche n'apparaît plus sur la carte, l'application ou la scène. Une nouvelle publication ne remplace pas la couche dans la carte, l'application ou la scène, car elle crée un nouvel élément avec un nouvel ID dans le portail.

Vous pouvez fournir une liste de couches séparées par une virgule à supprimer à l'aide de l'opération --files ou indiquer un fichier texte contenant la liste des couches à supprimer avec l'opération --file.

La syntaxe de la liste des couches séparées par une virgule est la suivante : deleteboundarylayers {--files <layer_name_list> | --file <location_of_text_file>} --url <portalURL> --username <portal_admin> [--password password]

Par exemple, pour supprimer les couches USA_Boundaries_2015 et WOR_Boundaries_2015 du portail https://portal.domain.com:7443/arcgis en tant qu'administrateur du portail nommé portaladmin, saisissez ce qui suit :

./deleteboundarylayers.sh --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.domain.com:7443/arcgis --username portaladmin

La syntaxe qui permet de désigner un fichier texte contenant la liste des couches à supprimer est la suivante : deleteboundarylayers --file <location_of_text_file> --url <portalURL> --username <portal_admin> [--password password]

Par exemple, pour supprimer les mêmes couches à l'aide d'un fichier, créez un fichier texte contenant un nom de couche par ligne (comme illustré ici) et indiquez l'emplacement et le nom du fichier texte lors de l'exécution de l'outil :

USA_Boundaries_2015
WOR_Boundaries_2015

Dans l'exemple ci-après, le fichier boundarylist se trouve dans /usr/data/boundaries. Il contient la liste des couches à supprimer du portail https://webadaptorhost.domain.com/webadaptorname.

./deleteboundarylayers.sh --file /usr/data/boundaries/boundarylist --url https://portal.domain.com:7443/arcgis --username portaladmin