Skip to main content

Configurer des couches de limites

Esri fournit des couches contenant des informations relatives à la démographie et aux limites de 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 de l’organisation peuvent utiliser dans leurs cartes, scènes, applications et outils d’analyse d’entités.

Envisagez de publier ces couches si votre organisation n’a pas accès au contenu ArcGIS Living Atlas of the World depuis ArcGIS Online.

En tant qu’administrateur, vous pouvez télécharger les fichiers de la définition du service de la couche de limites (.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 une instance Web Adaptor 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’une instance Web Adaptor ou 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. Assurez-vous que le compte utilisé pour installer Portal for ArcGIS dispose d’un accès en lecture à ce répertoire.

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. Assurez-vous que le compte utilisé pour exécuter le service Portal for ArcGIS dispose d’un accès en lecture à ce dossier.

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

  • Chaque fichier .sd est ajouté en tant qu’élément de définition du service. Ces fichiers doivent rester dans l’organisation si vous souhaitez mettre à jour les couches de limites 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 de l’organisation 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 ont accès aux couches d’entités de limites hébergées. Les membres de l’organisation peuvent accéder aux couches de limites en procédant comme suit :

    • Recherchez des éléments de couche de limites dans l’organisation via l’onglet My Organization (Mon organisation) de la page Content (Contenu).

    • Ajoutez des couches de limite individuelles aux outils d’analyse d’entités dans Map Viewer.

    • Ajoutez des couches de limites à Scene Viewer dans le volet Content (Contenu).

Publier des couches de limites

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

Les conditions d’utilisation suivantes sont importantes :

  • Ces couches font l’objet d’une licence à usage interne dans ArcGIS Enterprise et dans les applications ArcGIS connectées.

    • Il n’est pas autorisé 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’autorisation écrite préalable d’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 limites et les héberger en tant que couches d’entités :

  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 dans votre organisation. 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. Ouvrez une invite de commande sur la machine Portal for ArcGIS.

  5. Définissez les répertoires sur l'emplacement de l'outil.

  6. 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>]

    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 d’un compte d’administration. Cet utilisateur doit être membre du rôle Administration par défaut dans l’organisation.

    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 limites à publier.

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

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

    publishboundarylayers --folder d:\data\boundaryfiles --url https://portal.example.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 --folder /usr/data/boundaryfiles --files USA_Boundaries,WOR_Boundaries --url https://portal.example.com:7443/arcgis --username portaladmin

    publishboundarylayers --folder d:\data\boundaryfiles --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.example.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.

    Dans cet exemple, un fichier texte (boundarysubset.txt) 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 --folder /usr/data/boundaryfiles --file /usr/tmp/boundarysubset.vi --url https://portal.example.com:7443/arcgis --username portaladmin

    publishboundarylayers --folder d:\data\boundaryfiles --file c:\temp\boundarysubset.txt --url https://portal.example.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ée sont présents pour chaque fichier .sd publié.

Pour vérifier l’existence des éléments, vous pouvez rechercher dans l’organisation tous les éléments détenus par un membre interne nommé esri_boundaries. Saisissez owner:esri_boundaries dans le champ de recherche et sélectionnez Search All Content (Rechercher dans tout le contenu).

Mettre à jour les couches de limites

Dans la plupart des cas, les mises à jour sont apportées à une couche de limites en tant que nouveau fichier de définition du service que vous publiez 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.

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

Procédez comme suit pour mettre à jour les couches d’entités de limite :

  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 sur la machine Portal for ArcGIS.

    Supprimez les fichiers que vous ne souhaitez ni charger ni publier. 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. Ouvrez une invite de commande sur la machine Portal for ArcGIS.

  5. Définissez les répertoires sur l'emplacement de l'outil.

  6. 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>]

    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 d’un compte d’administration. Cet utilisateur doit être membre du rôle Administration par défaut.

    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 limites à publier.

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

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

    updateboundarylayers --folder d:\data\boundaryfiles --url https://portal.example.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 --folder /usr/data/boundaryfiles --files WOR_Boundaries --url https://portal.example.com:7443/arcgis --username portaladmin

    updateboundarylayers --folder d:\data\boundaryfiles --files WOR_Boundaries --url https://portal.example.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.

    Dans cet exemple, un fichier texte (boundaryupdatesubset.txt) 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 --folder /usr/data/boundaryfiles --file /usr/tmp/boundaryupdatesubset.vi --url https://portal.example.com:7443/arcgis --username portaladmin

    updateboundarylayers --folder d:\data\boundaryfiles --file c:\temp\boundaryupdatesubset.txt --url https://portal.example.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 limites

Si vous pensez qu’une couche de limites ne présente plus d’intérêt, vous pouvez la supprimer. Vous pouvez rechercher la couche dans l’organisation 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 limites 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 élément avec un nouvel identifiant.

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 https://portal.example.com:7443/arcgis en tant qu’administrateur de l’organisation nommé portaladmin, saisissez ce qui suit :

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

deleteboundarylayers --files USA_Boundaries_2015,WOR_Boundaries_2015 --url https://portal.example.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 de l’organisation dont l’URL est https://portal.example.com/portal.

Dans l’exemple ci-après, le fichier boundarylist.txt se trouve dans c:\data\boundaries. Il contient la liste des couches à supprimer de l’organisation dont l’URL est https://portal.example.com/portal.

./deleteboundarylayers --file /usr/data/boundaries/boundarylist --url https://portal.example.com/portal --username portaladmin

deleteboundarylayers --file c:\data\boundaries\boundarylist.txt --url https://portal.example.com/portal --username portaladmin