Les problèmes les plus courants rencontrés par les services de géotraitement peuvent être détectés à l'aide d'une ou plusieurs des techniques suivantes :
- Activez les messages de géotraitement dans le service, réexécutez la tâche et consultez les messages.
- Exécutez la tâche et consultez le répertoire arcgisjobs.
- Vérifiez que la limite de transfert n'a pas été dépassée.
Activation des messages de géotraitement de niveau Infos
Les messages relatifs aux outils de géotraitement contiennent une explication pas à pas de l'exécution des tâches de géotraitement. En cas d'échec, les messages de géotraitement peuvent contribuer à l'identification du point de défaillance exact de la tâche de géotraitement. Les messages de géotraitement envoyés au client sont déterminés par lapropriété de niveau du message du service de géotraitement. Les quatre niveaux de message sont les suivants : Aucun, Erreur, Avertissement et Info. Si le niveau du message est défini sur Aucun, l'exécution ou la soumission de la tâche de géotraitement ne renvoie aucun message autre que la confirmation du succès ou de l'échec de la tâche. Le niveau Info fournit tous les messages de géotraitement générés par la tâche. C'est le niveau recommandé pour le dépannage. Vous pouvez définir la propriété du Niveau du message du service de géotraitement sur Info via le gestionnaire ArcGIS Server ou ArcMap et continuer à rechercher la cause de la défaillance.
Inspection du répertoire arcgisjobs
Vous pouvez également résoudre les problèmes relatifs aux services de géotraitement en utilisant le mode d'exécution asynchrone à des fins de débogage. Vous pouvez modifier la propriété du mode d'exécution du service de géotraitement via le gestionnaire ArcGIS Server ou ArcMap. En mode d'exécution asynchrone, le serveur crée un répertoire unique pour chaque tâche soumise par son client dans le répertoire arcgisjobs. Chaque répertoire dispose d'un dossier scratch temporaire qui fait office d'espace de travail temporaire pour la tâche de géotraitement qui s'exécute sur le serveur. Les données en sortie, les données intermédiaires et les messages de géotraitement générés par la tâche asynchrone sont écrits dans l'espace de travail temporaire. Vous pouvez donc examiner ces données pour identifier les problèmes susceptibles d'être à l'origine de la défaillance.
Le répertoire arcgisjobs est une propriété configurable du service de géotraitement qui peut être modifiée pendant la publication ou ultérieurement. Le chemin par défaut vers le répertoire arcgisjobs est <server_directories>\directories\arcgisjobs. L'espace de travail temporaire par défaut d'une tâche asynchrone sera <arcgis-jobs-folder>\<server_folder_if_any>\<gpservice_name>\<jobid>\scratch.
Contenus d'un espace de travail temporaire du serveur
- Dossier scratch - Le dossier scratch contient des données de fichier en sortie, comme des fichiers de formes, des rasters, etc, qui dépendent de la fonctionnalité de l'outil.
- scratch.gdb - La géodatabase scratch.gdb est contenue dans le dossier scratch, et les jeux de données en sortie, comme les classes d'entités et les rasters de géodatabase, sont écrites dans la géodatabase scratch.gdb.
- messages.xml - Le fichier message.xml est situé dans le dossier scratch et contient tous les messages de géotraitement qui ont été consignés pour les tâches de géotraitement. Les messages du fichier XML dépendent de la propriété de Niveau du message du service de géotraitement.
Dépasser la limite de transfert
Il arrive parfois qu'une tâche synchrone ou asynchrone aboutisse, mais que le jeu d’entités en sortie ou les paramètres du jeu d'enregistrements retournés par le serveur n'incluent aucune entité ou enregistrement. Dans ces cas, vous devez augmenter la valeur de la propriété Nombre maximal d'enregistrements renvoyés par le serveur du service de géotraitement dans ArcMap ou dans le gestionnaire ArcGIS Server. Le nombre maximal d'entités et d'enregistrements en sortie renvoyés par une tâche de géotraitement est déterminé par la propriété Nombre maximal d’enregistrements renvoyés par le serveur. La valeur par défaut de cette propriété est 1 000 enregistrements ou entités. Lorsque le nombre d'entités ou d'enregistrements de la tâche est supérieur au Nombre maximal d’enregistrements renvoyés par le serveur, la tâche de géotraitement ne renvoie aucun enregistrement ni entité, même si la tâche aboutit.