Toute requête effectuée auprès d’un service de géotraitement asynchrone publié sur votre site ArcGIS Server initie une tâche, qui est une tâche asynchrone affectée à une machine de votre site. ArcGIS Server conserve les informations relatives à chaque tâche actuelle. L’onglet Jobs (Tâches) dans ArcGIS Server Manager permet d’interroger vos tâches actuelles et d’afficher des informations les concernant pour chacun des services de votre site.
Une fois qu’une tâche est terminée, avec succès ou non, ArcGIS Server en conserve un enregistrement dans le répertoire arcgisjobs pendant un certain temps. Cette durée est définie par le paramètre Maximum file age (Âge maximal de fichier) du répertoire de la tâche. La durée par défaut est de 6 heures (360 minutes) ; vous pouvez modifier cette valeur en mettant à jour le répertoire dans Manager.
Sur l’onglet Jobs (Tâches), vous pouvez annuler des tâches non terminées ou supprimer une tâche, ce qui l’annule si applicable et la supprime des enregistrements du serveur.
Voici les scénarios pour lesquels l’onglet Jobs (Tâches) peut s’avérer utile :
- Vous devez calculer la durée d’exécution des tâches sur un service particulier.
- Une tâche semble bloquée et vous souhaitez vérifier son statut.
- Vous avez soumis une tâche à priorité élevée et souhaitez annuler les tâches qui figurent devant elle dans la file d’attente.
Faire une requête
La procédure suivante permet d’accéder à l’onglet Jobs (Tâches) et d’afficher, d’identifier et de gérer les tâches :
- Vérifiez que vous êtes connecté à ArcGIS Server Manager en tant qu’administrateur.
- Dans Manager, cliquez sur Site > Server Configuration (Configuration du serveur) > Jobs (Tâches).
L’onglet Jobs (Tâches) n’affiche aucune information sur les tâches tant que vous n’avez pas effectué de requête.
- Sélectionnez un service publié sur votre site ArcGIS Server à partir du menu déroulant afin de l’interroger sur les tâches en cours.
- Si vous le souhaitez, utilisez les paramètres Status (Statut), Age (Âge) et Machine pour filtrer les tâches en fonction de leur statut, leur âge et d’une machine spécifique respectivement, afin d’affiner la portée de votre requête.
- Pour choisir les informations à afficher dans les résultats de la requête, cliquez sur le bouton Settings (Paramètres) et activez ou désactivez les paramètres.
Vous trouverez davantage d’informations sur chaque paramètre ci-après.
- Cliquez sur Query (Requête) pour exécuter la recherche.
Les résultats de la requête s’affichent. Selon le nombre de tâches renvoyées par la requête et le nombre de tâches par page que vous avez indiqué, vous pouvez obtenir plusieurs pages de résultats.
- Cliquez sur les boutons Next (Suivant) et Back (Retour) pour vous déplacer d’une page à l’autre.
- Cliquez sur le bouton pour afficher les informations d’une tâche.
Les sections suivantes décrivent les types d’informations que vous pouvez afficher.
- Cliquez sur le bouton Cancel (Annuler) pour annuler une tâche, ou cliquez sur le bouton Delete (Supprimer) pour supprimer une tâche. Lorsque vous cliquez sur l’un de ces boutons, une boîte de dialogue de confirmation s’ouvre.
Modifier les paramètres de requête
Lorsque vous ouvrez la boîte de dialogue Settings (Paramètres) sur l’onglet Jobs (Tâches), vous pouvez modifier les paramètres des requêtes que vous effectuez. Sept propriétés sont renvoyées par une requête de tâches, et chacune d’entre elles peut être affichée ou masquée dans la table de requête comme suit :
- Status (Statut) : statut actuel de la tâche. Les statuts possibles sont New (Nouveau), Submitted (Envoyé), Executing (Exécution), Succeeded (réussie), Failed (Échec), Cancelling (Annulation), Cancelled (Annulé) et Waiting (Attente).
- Start Time (Heure de début) : heure à laquelle la tâche a été envoyée au serveur.
- End Time (Heure de fin) : heure à laquelle la tâche a acquis le statut Succeeded (réussie), Failed (Échec) ou Cancelled (Annulé).
- Duration (Durée) : durée écoulée depuis le début de la tâche (Start Time (Heure de début)) jusqu’à l’heure de la requête (si la tâche n’est pas encore terminée) ou jusqu’à sa fin (End Time (Heure de fin)) (si elle a atteint cette propriété en ayant réussi, échoué ou en étant annulée).
- Machine : machine de votre site ArcGIS Server à laquelle la tâche a été affectée. Les tâches ayant un statut New (Nouveau) ou Submitted (Envoyé) n’ont pas encore de valeur pour cette propriété.
- User (Utilisateur) : utilisateur ArcGIS Server à l’origine de la requête relative à la tâche.
- ID : ID unique de la tâche.
Vous pouvez également spécifier l’option Number of jobs per page (Nombre de tâches par page) qui apparaît lorsque vous effectuez une requête.
Informations sur une tâche
Chaque tâche renvoyée dans votre requête apparaît sous forme de ligne dans la table de requête. Les propriétés que vous sélectionnez dans la boîte de dialogue Settings (Paramètres) sont affichées. Si le statut actuel de la tâche est Submitted (Envoyé) ou Executing (Exécution), vous pouvez annuler la tâche. Vous pouvez également supprimer la tâche quel que soit son statut actuel (cette opération annule la tâche, le cas échéant, et supprime toute trace d’elle du service).
Lorsque vous cliquez sur le bouton d’information sur une tâche renvoyée par votre requête, la boîte de dialogue des informations relatives à la tâche s’affiche. Les sept propriétés mentionnées précédemment s’affichent pour la tâche.
La propriété ID est un lien, qui, lorsque vous cliquez dessus, vous amène à la page des détails de la tâche dans le répertoire des services REST ArcGIS. Cette page vous permet d’annuler ou de supprimer la tâche, comme vous le faites dans Manager.
Actions supplémentaires disponibles dans ArcGIS REST API
Le répertoire administrateur ArcGIS Server contient la ressource Jobs (Tâches), qui fournit chacune des opérations disponibles sur l’onglet Jobs (Tâches) dans Manager, avec des opérations supplémentaires. Cette ressource d’API REST permet d’effacer la file d’attente de tâches d’un service de géotraitement asynchrone et d’en supprimer toutes les tâches. Vous pouvez également afficher des statistiques sur le nombre total de tâches en cours d’un service donné.
Vous avez un commentaire à formuler concernant cette rubrique ?