Depuis la version 10.8.1, vous pouvez créer des tâches pour planifier l’exécution automatique d’un notebook. Chaque fois que le notebook est exécuté selon la planification définie, le site ouvre un nouveau conteneur et exécute le notebook sans intervention de l’utilisateur.
Dans la fenêtre Tasks (Tâches) de l’éditeur de notebooks, vous pouvez créer une ou plusieurs tâches planifiées pour l’exécution du notebook. Vous pouvez planifier une exécution future unique ou récurrente, d’une par minute à une tous les cinq mois.
Si vous préparez un notebook pour l’exécution automatique, par exemple de manière récurrente, vous devez garder plusieurs éléments à l’esprit.
Préparer le notebook
Le planificateur permet d’insérer des paramètres en tant que nouvelle cellule au moment de l’exécution, notamment des identifiants de connexion de compte ou des variables à définir.
L’opération utilise l’option de la barre d’outils de la cellule Tags (Balises) , ce qui vous permet de créer et de gérer des balises pour chaque cellule dans l’espace de travail du notebook. Pour modifier les options de la barre d’outils de la cellule, cliquez sur View (Afficher) et sélectionnez Cell Toolbar (Barre d’outils de la cellule).
Vous pouvez définir l’emplacement dans le notebook où insérer cette nouvelle cellule en ajoutant la balise injected-parametersà une cellule du notebook. La nouvelle cellule est insérée après cette cellule. Une seule cellule comportant la balise injected-parameters est reconnue par l’opération.
Considérations relatives au contenu
En dehors de l’insertion de la cellule de paramètres, la planification d’un notebook ne prévoit aucune interaction de l’utilisateur avec les notebooks. Évitez d’ajouter du contenu qui nécessite une interaction de l’utilisateur pendant l’exécution de votre notebook, par exemple cliquer sur un point de la carte.
Les identifiants de connexion et les nouvelles variables à ajouter lors de l’exécution automatique doivent être insérés dans la cellule des paramètres, comme indiqué ci-dessus. Assurez-vous que le notebook ne renferme pas de contenu empêchant son exécution complète.
Remarque :
Lors de la création de notebooks, utilisez les chemins d’accès complets vers les répertoires et fichiers du répertoire de l’espace de travail.
Par exemple, utilisez /arcgis/home/test.gdb au lieu de home/test.gdb.
Créer une tâche
Lorsque le notebook est prêt, vous pouvez créer une tâche pour planifier son exécution. Dans la fenêtre Tasks (Tâches) de l’éditeur de notebooks, vous pouvez créer une ou plusieurs tâches afin d’automatiser l’exécution du notebook et spécifier la planification de la tâche.
- Si vous ne l’avez pas déjà fait, enregistrez votre notebook et donnez-lui un titre.
Le bouton Tasks (Tâches) devient accessible sur le ruban supérieur de l’éditeur de notebooks.
- Cliquez sur Create Task (Créer une tâche) pour ouvrir la boîte de dialogue.
Remarque :
Vous pouvez également créer des tâches dans l’onglet Tasks (Tâches) de la page des détails des éléments du notebook. - Fournissez un titre dans la zone de texte Title (Titre) pour décrire la planification de la tâche, par exemple Weekly data cleaning run (Nettoyage hebdomadaire des données).
- Si vous souhaitez ajouter des paramètres dans le notebook lors de son exécution par la tâche, indiquez-les dans la section Parameters (Paramètres). Indiquez une clé dans le champ Key (Clé) et sa valeur associée dans le champ Value (Valeur) pour chaque paramètre, puis cliquez sur Add Parameter (Ajouter un paramètre) pour enregistrer le paramètre.
Une fois que vous avez ajouté au moins un paramètre, l’option Save Parameters to Notebook (Enregistrer les paramètres dans le notebook)s apparaît. Si cette option est activée, la cellule insérée avec votre nouveau paramètre est enregistrée dans le notebook pendant son exécution.
- Cliquez sur Next (Suivant) pour passer à la page Set task schedule details (Détailler la planification de la tâche).
C’est sur cette page que vous pouvez définir la planification précise de cette tâche.
Conseil :
Lorsque vous modifiez la valeur du champ Repeat Every (Répéter chaque), les options ci-dessous changent pour s’adapter à cette dénomination. Par exemple, si vous sélectionnez Repeat Every Week (Répéter Chaque semaine), des cases à cocher s’affichent pour chaque jour de la semaine. - Pour mettre à jour le notebook avec les résultats de chaque exécution, laissez l’option Update Item on Completion (Mettre à jour l’élément à la fin du processus) sélectionnée. Si vous ne voulez pas mettre à jour le notebook automatiquement, désélectionnez l’option.
- Lorsque vous êtes satisfait du titre, les paramètres facultatifs et de la planification de la tâche, cliquez sur Create Task (Créer une tâche).
La tâche est active et exécute le notebook conformément à la planification que vous avez définie.
Si vous avez besoin de plusieurs planifications, éventuellement avec des paramètres insérés différents, vous pouvez créer d’autres tâches pour le notebook en suivant le même processus.
Utiliser des tâche existantes
Après avoir créé une tâche pour votre notebook, vous pouvez consulter ses détails, la mettre à jour ou la supprimer à tout moment. Vous pouvez modifier les tâches dans la fenêtre Tasks (Tâches) de l’éditeur de notebooks ou dans l’onglet Tasks (Tâches) de la page des détails des éléments du notebook. Aux deux endroits, vous pouvez consulter toutes les tâches du notebook avec la date et l’heure de création de chaque tâche, quand elle a été modifié pour la dernière fois et son état actuel.
- Dans le ruban supérieur de l’éditeur de notebooks, cliquez sur Tasks (Tâches).
- Dans la section Scheduled Tasks (Tâches planifiées), recherchez la tâche que vous voulez utiliser.
- Cliquez sur Actions
en regard de la tâche et procédez de l’une des façons suivantes :- Cliquez sur Details (Détails) pour examiner les résultats de chaque exécution de la tâche.
- Cliquez sur Edit (Mise à jour) pour modifier le titre, les paramètres ou la planification de la tâche.
- Cliquez sur Pause (Interrompre) pour interrompre une tâche active. Une fois la tâche interrompue, cliquez sur Resume (Reprendre) pour la reprendre.
- Cliquez sur Delete (Supprimer) pour supprimer la tâche.
Remarque :
Lorsqu’une tâche est supprimée, l’historique de ses exécutions l’est également. Pour conserver l’historique d’une tâche active, vous pouvez interrompre la tâche afin d’empêcher toute exécution ultérieure.
Le changement de propriété d’un notebook change également la propriété de ses tâches. Les tâches sont transférées au nouvel utilisateur dans un état désactivé. Le nouveau propriétaire peut activer les tâches depuis la fenêtre Tasks (Tâches) de l’éditeur de notebooks ou dans l’onglet Tasks (Tâches) de la page des détails des éléments du notebook.
Vous avez un commentaire à formuler concernant cette rubrique ?