Planifier les outils de géotraitement

Exécutez immédiatement un outil de géotraitement ou planifiez son exécution à un stade ultérieur ou pour la répéter. La planification d’un outil de géotraitement permet d’effectuer les opérations suivantes :

  • Automatiser un outil à exécuter régulièrement.
  • Exécuter un traitement long ou exigeant de nombreux calculs à une heure adaptée.
  • Exécuter plusieurs outils de géotraitement en parallèle à l’aide d’un script Python autonome.

Remarque :

La planification d’un outil de géotraitement est possible avec tous les niveaux de licences ArcGIS Pro. Dans le cas d’une licence d’utilisateur nommé, vous devez cocher la case Sign me in automatically (Me connecter automatiquement) lorsque vous vous connectez au compte d’utilisateur. Cette opération est obligatoire pour exécuter l’outil en dehors de ArcGIS Pro dans le processus Python d’exécution planifiée d’outil.

Planifier l’exécution de l’outil

L’exécution de chaque outil de géotraitement peut être planifiée. Pour planifier un outil de géotraitement, procédez comme suit :

  1. Recherchez l’outil de géotraitement et ouvrez-le.
    Remarque :

    Bien que tous les outils puissent être planifiés, le traitement de ceux qui mettent à jour les couches ou les cartes, par exemple Select Layer By Attribute (Sélectionner une couche par attributs), Select Layer By Location (Sélectionner une couche par emplacement) ou Make Feature Layer (Générer une couche) n’est pas effectif dans le projet. Par exemple, lorsque l’outil planifié Select Layer By Attribute (Sélectionner une couche par attributs) s’exécute, la sélection ne s’affiche pas dans le projet. Le processus Python indépendant qui exécute les outils planifiés n’apporte pas de mises à jour aux couches et aux cartes d’un projet. Néanmoins, si ces outils font partie d’un processus plus large dans un outil de modèle ou de script planifié, les outils s’exécutent comme prévu et leurs résultats sont utilisés pour le traitement ultérieur.

  2. Spécifiez les paramètres de l’outil.

    Les valeurs de paramètres que vous définissez seront utilisées à chaque exécution de l’outil planifié.

    Remarque :

    Lors de la planification d’un outil, utilisez le chemin d’accès complet au jeu de données au lieu des couches d’une carte. L’utilisation du chemin complet garantit que l’outil fonctionne indépendamment de la disponibilité et du statut de la couche et du projet. L’utilisation d’une couche implique que le projet soit enregistré et disponible à l’emplacement où se trouvait le projet lors de la planification de l’outil. Dans le cas contraire, l’exécution de l’outil planifié échoue avec une erreur indiquant que l’entrée n’existe pas.

    Ceci vaut aussi pour la planification d’un outil qui utilise une carte en entrée. Indiquez un paramètre de carte sous forme de chemin d’accès complet au projet et à la carte comme C:\Projects\City.aprx\StreetMap. Enregistrez le projet avant la planification afin que le contenu de la carte actuelle soit disponible pour une utilisation dans le traitement externe. L’utilisation du seul nom de carte en entrée ne permet pas l’exécution et peut entraîner une erreur ou des résultats inattendus.

  3. Si vous le souhaitez, vous pouvez spécifier les environnements de l’outil.
  4. Cliquez sur le menu fractionné du bouton Run (Exécuter) Exécuter et sélectionnez Schedule (Planifier) Calendrier.
  5. Dans la fenêtre Schedule (Planifier), spécifiez le nom de la tâche, la date et l’heure de début, la répétition, l’expiration et les autres options définissant la manière et la date à laquelle l’outil planifié doit être exécuté. Cliquez sur OK pour terminer et planifier l’outil.

    L’outil planifié est ajouté à la section Scheduled Tools (Outils planifiés) de l’onglet Geoprocessing (Géotraitement) de la fenêtre History (Historique), la planification de l’outil est activée et l’outil est exécuté aux date et heure indiquées.

Gérer les outils planifiés

La section Scheduled Tools (Outils planifiés) de l’onglet Geoprocessing (Géotraitement) de la fenêtre History (Historique) affiche tous les outils dont l’exécution est planifiée sur la machine via votre compte d’utilisateur, quel que soit le projet à partir duquel les outils ont été planifiés. Vous devez être connecté sur la machine pour que l’exécution des outils planifiés soit possible.

Chaque outil figurant dans la section Scheduled Tools (Outils planifiés) inclut une liste de l’historique de l’outil. Chaque fois que l’outil planifié est exécuté, un nouvel horodatage est ajouté sous l’entrée de l’outil planifié, avec une icône signalant si l’outil a abouti ou non.

IcôneStatut
Coche

L’exécution de l’outil a réussi.

Avertissement

L’outil a été exécuté, mais a généré des avertissements. Cliquez sur View Details (Afficher les détails) ou positionnez le pointeur sur l’icône d’état Avertissement pour consulter les messages d’avertissement.

Erreur

L’exécution de l’outil a échoué. Cliquez sur View Details (Afficher les détails) ou positionnez le pointeur sur l’icône d’état Erreur pour consulter les messages d’erreur.

Vous pouvez gérer les outils de géotraitement planifiés des manières suivantes à l’aide du menu contextuel des outils planifiés ou avec les commandes rapides disponibles lorsque vous survolez un outil planifié :

  • Cliquez sur Edit Schedule (Mettre à jour la planification) pour modifier les options de planification, telles que la date et l’heure, la récurrence, l’expiration et d’autres options.
  • Cliquez sur Run (Exécuter) pour exécuter immédiatement l’outil planifié. Il est utile de tester les traitements à exécution rapide que vous avez programmés à une date ultérieure afin de vous assurer que l’outil fonctionne correctement.
  • Cliquez sur Pause Schedule (Suspendre la planification) pour arrêter les exécutions futures de l’outil planifié. Lorsqu’un outil planifié est suspendu, son exécution n’a pas lieu tant que vous ne cliquez pas sur Resume Schedule (Reprendre la planification).
  • Cliquez sur Clear Run Log (Effacer le journal d’exécution) pour effacer l’historique d’un outil planifié. Cela n’a pas d’effet sur les exécutions futures de l’outil.
  • Cliquez sur Delete Schedule (Supprimer la planification) pour désactiver et retirer l’outil planifié et supprimer les scripts, les fichiers journaux et les dossiers associés. Cette opération arrête toute exécution planifiée de l’outil, efface l’historique de l’outil planifié et supprime l’outil de la section Scheduled (Planifié).

Outils planifiés des journaux

Les options de consignation des opérations de géotraitement s’appliquent aux outils planifiés. Outre la section Scheduled (Planifié), ces fonctionnalités de consignation peuvent être utiles pour suivre les outils planifiés. Si l’option Write geoprocessing operations to XML log file (Consigner les opérations de géotraitement dans un fichier journal XML) est activée, les outils planifiés créent des fichiers journaux dans le répertoire %APPDATA%\ESRI\ArcGISPro\ArcToolbox\History. Si l’option Write geoprocessing operations to dataset metadata (Consigner les opérations de géotraitement dans les métadonnées du jeu de données) est activée, les outils planifiés mettent à jour la section Geoprocessing History (Historique du géotraitement) des métadonnées du jeu de données avec des détails sur les outils planifiés.

Étendre le géotraitement planifié

Planifier un outil de géotraitement crée un dossier et plusieurs fichiers notamment un script Python dans le répertoire utilisateur %localappdata%\Esri\ArcGISPro\Geoprocessing\<your scheduled tool name>. Vous pouvez étendre l’opération planifiée afin d’inclure plusieurs outils de géotraitement en modifiant le script Python dans le dossier de l’outil planifié et en ajoutant des outils de géotraitement supplémentaires au script.

En savoir plus sur l’ajout d’outils de géotraitement à un script Python

Remplacer ou créer des jeux de données en sortie

Lors de la planification d’un outil de géotraitement qui crée un jeu de données en sortie, vous devez décider si l’outil planifié doit remplacer le même jeu de données à chaque fois qu’il est exécuté ou créer un jeu de données en sortie à chaque exécution.

  • Si vous souhaitez que le même jeu de données en sortie soit remplacé à chaque exécution de l’outil planifié, utilisez un chemin de jeu de données standard dans la zone de texte du paramètre en sortie, par exemple, C:\Data\MyOutput.gdb\Output.
  • Pour créer un jeu de données en sortie à chaque exécution de l’outil planifié, utilisez la variable d’horodatage %t% dans le chemin du jeu de données, dans la zone de texte du paramètre en sortie, pour nommer automatiquement le jeu de données en sortie en fonction de l’heure de l’exécution de l’outil.

    Vous pouvez ainsi spécifier le chemin vers le jeu de données en sortie C:\Data\MyOutput.gdb\Output_%t%. Si l’outil est exécuté le 13 mars 2020 à 08:30:00, le jeu de données en sortie créé est le suivant : C:\Data\MyOutput.gdb\Output_03132020083000.

Sources de données à distance

Les données en entrée provenant des sources de données à distance comme les géodatabases d’entreprise ou les services d’entités peuvent être utilisées dans les outils de géotraitement planifiés. Vous pouvez naviguer jusqu’au chemin complet vers ces sources de données en entrée, ou le spécifier, ou utiliser les couches de carte pour y faire référence. Pour utiliser les sources de données à distance qui nécessitent des autorisations ou des identifiants dans un outil planifié, lorsque vous vous connectez au serveur, au portail ou à la source de géodatabase d’entreprise des données, vous devez enregistrer votre nom d’utilisateur et votre mot de passe.

  • Pour les services autonomes qui nécessitent des identifiants, lors de la connexion au serveur ou lors de l’invite à saisir les identifiants, cochez la case Save Username / Password (Enregistrer le nom d’utilisateur / Mot de passe).
  • Pour les couches Web du portail, lors de la connexion au portail, cochez la case Sign in Automatically (Se connecter automatiquement).
  • Pour les données de la géodatabase d’entreprise, lors de la connexion à la base de données, cochez la case Save User/Password (Enregistrer l’utilisateur/le mot de passe).
Remarque :

Utilisez ces options pour enregistrer les identifiants d’accès aux données à distance avant de planifier un outil. Sinon, l’outil planifié risque d’échouer et d’afficher un message d’erreur indiquant que les données ne sont pas valides ou n’existent pas.

Options de planification supplémentaires

Les outils de géotraitement planifiés utilisent le Planificateur de tâches Windows pour exécuter les outils sélectionnés au moment approprié. Les outils de géotraitement que vous avez planifiés depuis ArcGIS Pro se trouvent dans le Planificateur de tâches Windows, sous le nom de la tâche que vous avez spécifiée dans la fenêtre Schedule (Planifier). Les paramètres de planification que vous avez spécifiés dans ArcGIS Pro s’affichent dans le Planificateur de tâches Windows.

Le Planificateur de tâches Windows offre des options de planification supplémentaires qui ne sont pas disponibles dans la fenêtre Schedule (Planifier) de ArcGIS Pro.

Remarque :

Pour modifier des options de planification supplémentaires dans le Planificateur de tâches Windows, vous devez être connecté via un compte d’utilisateur dans le groupe administrateur local de l’ordinateur. Pour utiliser l’option Run whether user is logged on or not (Exécuter même si l’utilisateur n’est pas connecté), le compte associé à l’exécution de la tâche doit se trouver dans le compte administrateur local de l’ordinateur. Pour des raisons de sécurité, votre administrateur système a pu appliquer une stratégie de groupe à votre ordinateur afin d’empêcher l’exécution d’outils planifiés lorsque votre compte utilisateur n’est pas connecté. Contactez votre administrateur système pour plus d’informations.

Les options de planification supplémentaires suivantes sont également à votre disposition :

  • Exécuter même si l’utilisateur n’est pas connecté.
  • Exécuter avec des privilèges élevés ou d’administration.
  • Arrêter la tâche si son exécution dépasse une durée spécifiée.
  • Démarrer la tâche lors de la connexion, au démarrage de l’ordinateur, ou en fonction d’autres événements.
  • Envoyer un courrier électronique ou afficher un message avant le début de la tâche ou après sa fin (les deux options sont considérées comme obsolètes par Windows).
  • Exécuter uniquement si l’ordinateur est inactif.
  • Sortir l’ordinateur du mode veille pour exécuter cette tâche.
  • Exécuter uniquement si l’ordinateur est branché.
  • Si la tâche échoue, réessayer après une période indiquée.
  • Choisissez ce qui se produit si une tâche est toujours en cours d’exécution alors que sa planification prévoit de l’exécuter à nouveau.

Remarque :

Si cela est autorisé, envisagez d’exécuter des tâches planifiées critiques avec un compte d’utilisateur générique. Ceci évite de lier le traitement au compte d’un utilisateur en particulier.

Outils d’extension

Si vous utilisez une licence flottante et un outil d’extension, directement ou avec un outil de modèle ou de script, tenez compte des points suivants :

  • Pour planifier un outil d’extension directement, ou un outil de modèle qui comprend un outil d’extension, aucune étape spéciale n’est requise.
  • Si vous souhaitez planifier un outil de script qui comprend un outil d’extension, le script doit inclure des appels CheckOutExtension pour extraire les extensions appropriées.

Avec une licence d’utilisateur nommé ou une licence fixe, il est possible d’utiliser les outils d’extension sans condition particulière.