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 d’écriture de scripts se compose d’une cellule In[ ], dans laquelle les scripts sont chargés ou écrits, d’une cellule Out[ ], dans laquelle 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 et ajoutez des données si nécessaire.

   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 à la passerelle. Saisissez l’URL et l’adresse de socket Web de la 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. Depuis le menu Select Kernel (Sélectionner Kernel), choisissez le noyau à utiliser pour les scripts.

   Selon la connexion Kernel Gateway que vous utilisez, les options sont Python, R, ou les deux.

   L’environnement d’écriture de scripts est mis à jour pour inclure une cellule In[ ] et une barre d’outils.

À présent, l’environnement d’écriture de scripts peut être utilisé pour créer, charger et exécuter des scripts.

Le script est enregistré automatiquement sous l’en-tête Scripts dans la fenêtre de données avec le nom Insights Script (Script Insights). Vous pouvez le renommer à 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) :

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

Mettre à jour un script

Vous pouvez mettre à jour les scripts depuis les 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

Vous pouvez exporter et enregistrer les scripts qui sont écrits dans l’environnement d’écriture de scripts en tant que scripts .py pour Python ou script .R pour R. Pour exporter un script depuis l’environnement d’écriture de scripts, sélectionnez une ou plusieurs cellules, puis cliquez sur le bouton Export (Exporter) .

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

• Download Selected Cell(s) (Télécharger les cellules sélectionnées) : enregistrer uniquement le script dans les cellules In[ ] sélectionnées.
• Download History (Télécharger l’historique) : enregistrer le script depuis toutes les cellules In[ ] dans l’environnement d’écriture de scripts 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 d’écriture de scripts en les saisissant dans la cellule In[ ]. Pour charger des scripts existants dans l’environnement d’écriture de scripts, procédez 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 est ouvert 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 est ouvert dans la cellule In[ ].

Créer une fiche d’image

Vous pouvez exporter les résultats des scripts, tels que les diagrammes, depuis une cellule Out[ ] pour créer une fiche d’image sur votre page Insights. Pour exporter une cellule, vous devez exécuter le 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) pour déplacer 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 le script dans un modèle

Vous pouvez ajouter le script depuis l’environnement d’écriture de scripts à un 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, reportez-vous à la rubrique Relancer votre analyse.

Vider ou fermer l’environnement de scripts

Pour effacer l’environnement d’écriture de scripts, notamment toutes les cellules In[ ] et Out[ ], cliquez sur le bouton Restart (Redémarrer) . Vous ne pouvez pas annuler l’effacement de l’environnement de script.

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

Pour passer de la page Insights à l’environnement d’écriture de scripts et inversement, réduisez l’environnement à l’aide du bouton de réduction au lieu de le fermer. Ainsi, vous ne perdrez pas vos scripts.