La rédaction de scripts pour l'administration de Portal for ArcGIS vous permet de programmer l'exécution de tâches courantes et de les automatiser si vous le souhaitez. Cela réduit les risques d'erreur liés à l'exécution d'une tâche complexe ou répétitive. Vous pouvez rédiger des scripts pour les workflows d'administration typiques suivants :
- Gestion de l'appartenance au portail, à savoir ajout ou suppression d'utilisateurs du portail et ajout ou suppression d'utilisateurs de groupes du portail.
- Gestion des éléments du portail, à savoir partage d'éléments avec des groupes, mise à jour des propriétés d'éléments (balises, par exemple) et mise à jour globale des URL d'un service de carte dans des cartes Web.
Toutes les tâches administratives du portail sont exécutées via l'API REST d'ArcGIS. L'API peut être appelée à partir de tout langage de script ou de programmation pouvant émettre des requêtes HTTP.
Portal for ArcGIS intègre des utilitaires de ligne de commande prêts à l'emploi et des scripts Python qui vous aideront à rédiger des scripts destinés à l'administration de votre portail. En comprenant le fonctionnement de l'API REST d'ArcGIS, vous pourrez exploiter les exemples proposés et créer vos propres scripts.
Si vous souhaitez automatiser la configuration du SIG Web dans son intégralité (Portal for ArcGIS, ArcGIS Web Adaptor, ArcGIS for Server, ArcGIS Data Store et les certificats SSL), vous pouvez faire appel à un livre de recettes (Cookbook) de Chef. Par exemple, si vous êtes un consultant et que vous configurez des sites pour vos clients, l'écriture d'un script de configuration vous simplifie la tâche.
Utilitaires de ligne de commande de Portal for ArcGIS
Les quelques utilitaires de ligne de commande inclus permettent d'exécuter des tâches administratives courantes. Vous devez exécuter les utilitaires sur l'ordinateur qui héberge le portail. Ils sont prêts à l'emploi et ne nécessitent aucune connaissance en matière de programmation. Reportez-vous à la section Utilitaires de ligne de commande de Portal for ArcGIS pour obtenir des informations supplémentaires.
Exemples de scripts Python
Portal for ArcGIS inclut des exemples de scripts Python qui permettent de développer les fonctionnalités des utilitaires de ligne de commande. Contrairement aux utilitaires de ligne de commande, vous pouvez exécuter ces scripts à partir de tout ordinateur configuré avec l'environnement Python. L'exécution de ces scripts ne présente aucune difficulté et ne nécessite aucune connaissance approfondie de Python. Vous pouvez exécuter ces scripts tels quels, les utiliser pour mieux comprendre le fonctionnement de l'API REST, les personnaliser ou même créer les vôtres. Reportez-vous à la section Exemples de scripts Python pour obtenir des informations supplémentaires.
PortalPy
PortalPy est un module Python d'Esri qui vous permet de rationaliser la création de tâches administratives complètes. PortalPy propose des classes Python de haut niveau qui facilitent l'utilisation de l'API REST. L'utilisation de PortalPy nécessite un certain niveau de connaissances en matière de programmation Python, mais ce module met à votre disposition un environnement très productif pour automatiser l'administration de votre portail. Comme c'est le cas avec les exemples de scripts Python, vous pouvez accéder au code source pour développer PortalPy, si vous le souhaitez. Pour en savoir plus, reportez-vous à la rubrique Rédaction de scripts avec PortalPy pour l'exécution de tâches administratives.
API REST d'ArcGIS et ses liens avec Portal for ArcGIS
L'API REST d'ArcGIS inclut des ressources et des opérations qui permettent d'administrer Portal for ArcGIS. Vous pouvez appeler toute tâche administrative prise en charge par le portail par l'intermédiaire de cette API. En fait, tous les outils d'administration fournis avec ArcGIS, y compris ArcGIS for Desktop et le site Web Portal for ArcGIS, utilisent cette API.
L'API peut être appelée à partir de tout langage capable d'effectuer un appel de service Web, tel que Python, Java, JavaScript, PowerShell, C#, Ruby, Scala, Perl, etc. Les exemples proposés dans ce système d'aide utilisent le langage Python. Aucun logiciel Esri n'a besoin d'être installé pour exécuter un script qui utilise cette API.
Pour en savoir plus, reportez-vous à la rubrique Ecriture de scripts avec l'API REST d'ArcGIS.
Livres de recettes Chef Cookbook
Esri propose un livre de recettes Chef que vous pouvez automatiser pour l'installation et la configuration d'ArcGIS. Utilisez-le pour installer Portal for ArcGIS, ArcGIS for Server, ArcGIS Web Adaptor et ArcGIS Data Store et les configurer de sorte qu'ils fonctionnent les uns avec les autres. Pour démarrer, suivez les étapes présentées dans le fichier Getting Started.txt. Vous pouvez télécharger cet outil sur le site Esri GitHub ou the Chef Supermarket. Lorsque vous exécutez l'outil, saisissez les informations propres à votre site. Les utilisateurs de Chef plus expérimentés peuvent personnaliser le livre de recettes avant de l'utiliser.
Vous avez un commentaire à formuler concernant cette rubrique ?