83. Query : collecter le contexte de la plateforme

Pour un grand nombre (des centaines ou des milliers) d'ensembles de données traités (comme "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc.), il existe toujours un besoin de comprendre l'état du traitement de chaque ensemble de données et de collecter le résumé du traitement. Ces détails sont fournis en utilisant getPlatformContext query.

Les cas courants :

• Suivre la progression du traitement

• Collecter le résumé et les statistiques du traitement

• Observer les erreurs et les avertissements pendant le traitement afin d'investiguer plus en profondeur les ensembles de données affectés

query CollectPlatformContext {
 getPlatformContext(input: {
   userUuids: ["<placeholder_of_user_uuid>"],
   statuses: [Start, Done, Warning, Error, Ignored],
   dateFrom: "2023-05-25T12:49:00.000Z", 
   dateTo: "2023-05-30T06:35:00.000Z", 
 }) {
   events {
     fieldUuid
     subFieldUuid
     subFieldType
     operationId
     status 
     executionDate
     messageKey
     optionnel
   }
 }
}

Filtres d'entrée pris en charge :

• dateFrom en tant que datetime au format ISO 8601 (ex : "2023-05-25T12:49:00.000Z")

• dateTo en tant que datetime au format ISO 8601 (ex : "2023-05-30T06:35:00.000Z")

• operationIds en tant que tableau d'identifiants d'opération (Chaînes)

• statuses en tant que tableau contenant des valeurs de ContextEventStatus énumération avec tous les statuts de traitement y compris intermédiaires, il est recommandé d'utiliser les principaux [Start, Done, Warning, Error, Ignored]

• subFieldTypes en tant que tableau contenant les valeurs de TreeNodeEntity énumération avec toutes les entités GeoPard

• subFieldUuids en tant que tableau d'UUID liés aux entités sélectionnées dans subFieldTypes

• userUuids en tant que tableau d'UUID d'"Utilisateur" à rechercher

Au moins un des filtres suivants doit être initialisé : userUuids, fieldUuids, subFieldUuids, ou operationIds.

Si dateFrom et dateTo ne sont pas spécifiés, la durée de requête par défaut est fixée à 12 heures. La plage de temps maximale recommandée pour la récupération des données est de 24 heures.

Il y a une limite de 10 000 lignes livrées au maximum.

Pour observer toutes les dernières valeurs disponibles des énumérations (comme : TreeNodeEntity, ContextEventStatus, ContextMessageKey), il est recommandé d'utiliser Altair.

L'objet de sortie inclut les attributs suivants :

• fieldUuid représente l'UUID du Champ associé

• subFieldUuid désigne l'UUID de l'ensemble de données traité lié (comme "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc.)

• subFieldType comme énumération liée à TreeNodeEntity

• operationId comme chaîne qui contient l'identifiant de l'opération, il reste cohérent à travers toutes les chaînes de traitement liées ; il est conseillé de regrouper par cet identifiant pour suivre toutes les étapes de traitement

• status comme énumération liée à ContextEventStatus

• executionDate comme chaîne au format ISO 8601 qui indique le moment d'exécution

• messageKey comme énumération liée à ContextMessageKey qui décrit le résultat de l'exécution

• optionnel comme chaîne qui fournit une description technique (si pertinent), elle est principalement utilisée pour le débogage et le signalement des bugs