Ecriture de scripts d'administration de Portal for ArcGIS
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.
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 relations 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.