Utiliser l’environnement de scripts

Remarque :

L’environnement de script Insights est disponible dans Insights in ArcGIS Enterprise et Insights desktop. La connexion principale peut utiliser Insights in ArcGIS Enterprise ou Insights in ArcGIS Online.

Les connexions Jupyter Kernel Gateway peuvent être désactivées pour une organisation Insights in ArcGIS Enterprise au cours du processus d’installation. Contactez votre administrateur si les connexions Jupyter Kernel Gateway ne sont pas disponibles. Pour plus d’informations, reportez-vous à la rubrique Installer Insights in ArcGIS Enterprise.

Une fois la connexion à Jupyter Kernel Gateway établie, vous pouvez accéder à l’environnement de script et l’utiliser pour créer et exécuter des scripts dans Python et R. L’environnement de script se compose d’une cellule In[ ], où les scripts sont chargés ou écrits, d’une cellule Out[ ], où les résultats sont affichés, et d’une barre d’outils.

Ouvrir l’environnement de scripts

Pour utiliser l’environnement de script, vous devez d’abord configurer un serveur Jupyter Kernel Gateway et créer une connexion à la passerelle. Une fois la connexion établie avec la passerelle, procédez comme suit pour ouvrir l’environnement de script et commencer à écrire des scripts :

1. Ouvrez un classeur. Ajoutez des données à votre classeur, le cas échéant.

   Conseil :

   Vous pouvez également charger des données depuis l’environnement de scripts.

2. Cliquez sur le bouton Scripting (Scripts)  dans la barre d’outils du classeur.
3. Si une connexion n’a pas été enregistrée dans le classeur par le passé, effectuez l’une des opérations suivantes :
   • Dans Insights desktop, si la fenêtre New Jupyter Kernel Gateway connection (Nouvelle connexion à Jupyter Kernel Gateway) s’ouvre, cela signifie que vous n’avez pas créé de connexion avec la passerelle. Saisissez l’URL et l’adresse de socket web de votre passerelle pour créer la connexion. Reportez-vous à la rubrique Se connecter à un serveur Kernel Gateway pour plus d’informations.
   • Dans Insights in ArcGIS Enterprise, si la fenêtre Kernel Gateway connection (Connexion à un serveur Kernel Gateway) s’ouvre, sélectionnez une connexion existante à un serveur Kernel Gateway dans le menu Environment name (Nom de l’environnement). Vous pouvez également créer une connexion dans l’onglet Add new (Ajouter nouveau). Reportez-vous à la rubrique Se connecter à un serveur Kernel Gateway pour plus d’informations.

   L’environnement de script s’ouvre et un en-tête Scripts est ajouté à la fenêtre de données.

4. Utilisez le menu Select Kernel (Sélectionner Kernel) pour choisir le noyau à utiliser pour les scripts. Selon la connexion Kernel Gateway que vous utilisez, les options sont Python, R, ou les deux.

   L’environnement de scripts est mis à jour de façon à inclure une cellule In[ ] et une barre d’outils.

L’environnement de scripts est désormais prêt à créer, charger et exécuter des scripts.

Votre script est enregistré automatiquement sous l’en-tête Scripts dans la fenêtre de données avec le nom Insights Script (Script Insights). Le script peut être renommé à l’aide du bouton Rename script (Renommer le script) .

Les options de script suivantes sont également disponibles à l’aide du bouton Dataset options (Options de jeu de données) :

• Ouvrir : charger le script dans une cellule In[ ].
• Exécuter : exécuter le script sans ouvrir l’environnement de script.
• Télécharger : télécharger le script en tant que fichier Jupyter Notebook(.ipynb).
• Publier : publiez le script pour créer un élément de script Insights (disponible dans Insights in ArcGIS Enterprise).
• Supprimer : supprimer le script de la fenêtre de données.

Mettre à jour un script

Il est possible de mettre à jour les scripts à partir des cellules In[ ], même après l’exécution des cellules. Pour mettre à jour un script, cliquez dans la cellule, apportez les modifications nécessaires, puis exécutez la cellule. Une nouvelle cellule Out[ ] est créée avec les résultats mis à jour.

Exporter un script

Les scripts qui sont écrits dans l’environnement de script peuvent être exportés et enregistrés sous forme de script .py pour Python ou de script .R pour R. Il est possible d’exporter un script depuis l’environnement de script en sélectionnant une ou plusieurs cellules et en cliquant sur le bouton Export (Exporter) .

Les options d’exportation suivantes sont disponibles lorsque vous enregistrez un script :

• Download Selected Cell(s) [Télécharger la ou les cellules sélectionnées] : enregistre uniquement le script dans les cellules In[ ] sélectionnées.
• Download History (Télécharger l’historique) : enregistre le script de toutes les cellules In[ ] dans l’environnement de script en tant que fichier Jupyter Notebook(.ipynb).

Les scripts exportés sont enregistrés dans le dossier de téléchargement par défaut sur votre ordinateur.

Charger un script

Vous pouvez créer des scripts directement dans l’environnement de scripts en les saisissant dans la cellule In[ ]. Vous pouvez également charger des scripts existants dans l’environnement de scripts en procédant comme suit :

1. Ouvrez l’environnement de scripts s’il y a lieu, puis choisissez le noyau approprié au script que vous allez exécuter.
2. Cliquez sur le bouton Import file (Importer un fichier)  dans la barre d’outils de l’environnement de scripts.
3. Accédez au script à exécuter et ouvrez-le.

   Le script s’ouvre dans la cellule In[ ].

4. Cliquez sur le bouton Run (Exécuter)  dans la barre d’outils de l’environnement de scripts.

Le script s’exécute et les résultats apparaissent dans la cellule Out[ ].

Les scripts qui ont été enregistrés dans la fenêtre de données peuvent également être chargés dans l’environnement de script. Pour charger un script à partir de la fenêtre de données, procédez comme suit :

1. Développez l’en-tête Scripts dans la fenêtre de données.
2. Cliquez sur le bouton Dataset options (Options de jeu de données)  en regard du jeu de données à charger.
3. Cliquez sur Open (Ouvrir).

   Le script s’ouvre dans la cellule In[ ].

Créer une fiche d’image

Les résultats des scripts, tels que les diagrammes, peuvent être exportés depuis une cellule Out[ ] pour créer une fiche d’image sur votre page Insights. Pour exporter une cellule, vous devez exécuter votre script à l’aide du bouton Run (Exécuter) , mettre en surbrillance la cellule Out[ ] et cliquer sur le bouton Create Card (Créer une fiche) . Cette opération déplace l’image de la cellule Out[ ] la plus récente vers une fiche d'image.

Remarque :

Les fiches d’image issues de scripts sont statiques et ne bénéficient pas des mêmes fonctionnalités interactives que les fiches de carte, de diagramme et de table créées dans Insights.

Enregistrer un script dans un modèle

Vous pouvez ajouter le script présent dans votre environnement de script à votre modèle en tant que script Insights à l’aide du bouton Add To Model (Ajouter au modèle) . Le script Insights peut être mis à jour depuis Analysis view (Vue de l’analyse) . Pour plus d'informations sur la mise à jour d'un modèle dans Insights, consultez la rubrique Relancer votre analyse.

Vider ou fermer l’environnement de scripts

Vous pouvez effacer le script, notamment toutes les cellules In[ ] et Out[ ] à l’aide du bouton Restart (Redémarrer) . Vous ne pouvez pas annuler l’effacement de l’environnement de script.

Pour fermer l’environnement de script, cliquez sur le bouton de fermeture ou accédez à une autre page dans Insights.

Si vous devez permuter entre la page Insights et l’environnement de script, il est conseillé de réduire l’environnement à l’aide du bouton de réduction plutôt que de le fermer, ceci afin de ne pas perdre vos scripts.