# 83. Requête : 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

{% code overflow="wrap" lineNumbers="true" %}

```graphql
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
   }
 }
}
```

{% endcode %}

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`&#x20;
* `userUuids` en tant que tableau d'UUID d'"Utilisateur" à rechercher

{% hint style="info" %}
Au moins un des filtres suivants doit être initialisé : `userUuids`, `fieldUuids`, `subFieldUuids`, ou `operationIds`.
{% endhint %}

{% hint style="info" %}
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.
{% endhint %}

{% hint style="info" %}
Il y a une limite de 10 000 lignes livrées au maximum.
{% endhint %}

{% hint style="info" %}
Pour observer toutes les dernières valeurs disponibles des énumérations (comme : `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), il est recommandé d'utiliser [Altair](/geopard-tutorials/fr/docs-api/premiers-pas-avec-lapi-geopard.md).
{% endhint %}

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.geopard.tech/geopard-tutorials/fr/docs-api/vue-densemble-des-requetes-de-lapi-geopard/83.-requete-collecter-le-contexte-de-la-plateforme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.