# 83. Query: Platformcontext verzamelen

Bij een groot aantal (honderden of duizenden) verwerkte datasets (zoals "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", enz.) bestaat er altijd een behoefte om de verwerkingsstatus van elke dataset te begrijpen en een verwerkingssamenvatting te verzamelen. Deze details worden geleverd met behulp van `getPlatformContext` query. 

De veelvoorkomende gevallen: 

* Het volgen van de voortgang van de verwerking
* Verzamelen van verwerkingssamenvatting en statistieken
* Observeren van fouten en waarschuwingen tijdens verwerking voor verdere diepgaandere onderzoek van getroffen datasets

{% 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
     optioneel
   }
 }
}
```

{% endcode %}

Ondersteunde invoerfilters:

* `dateFrom` als datetime in ISO 8601-formaat (bijv.: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` als datetime in ISO 8601-formaat (bijv.: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` als array van de operatie-identificatoren (`Strings`)
* `statuses` als array met waarden afkomstig van `ContextEventStatus` enum met alle verwerkingsstatussen inclusief tussenliggende; het is aan te raden de belangrijkste sleutels te gebruiken `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` als array met waarden van `TreeNodeEntity` enum met alle GeoPard-entiteiten
* `subFieldUuids` als array met UUID's gekoppeld aan de geselecteerde entiteiten in `subFieldTypes`&#x20;
* `userUuids` als array van "User" UUID's om te doorzoeken

{% hint style="info" %}
Ten minste één van de volgende filters moet worden ingesteld: `userUuids`, `fieldUuids`, `subFieldUuids`, of `operationIds`.
{% endhint %}

{% hint style="info" %}
Als `dateFrom` en `dateTo` niet zijn opgegeven, wordt de standaard queryduur ingesteld op 12 uur. De maximaal aanbevolen tijdspanne voor gegevensopvraging is 24 uur.
{% endhint %}

{% hint style="info" %}
Er is een limiet van maximaal 10.000 geleverde rijen.
{% endhint %}

{% hint style="info" %}
Om alle beschikbare nieuwste waarden van enums te bekijken (zoals: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), wordt aanbevolen om [Altair](/geopard-tutorials/nl/api-docs/aan-de-slag-met-de-geopard-api.md).
{% endhint %}

Het uitvoerobject bevat de volgende attributen:

* `fieldUuid` vertegenwoordigt de UUID van het gekoppelde perceel (Field)
* `subFieldUuid` duidt de UUID aan van de gekoppelde verwerkte dataset (zoals "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", enz.)
* `subFieldType` als enum gekoppeld aan de `TreeNodeEntity`
* `operationId` als string die de identificator van de operatie bevat; deze blijft consistent in alle gerelateerde verwerkingsketens. Het is aan te raden te groeperen op deze identificator om alle verwerkingsstadia te traceren
* `status` als enum gekoppeld aan `ContextEventStatus`
* `executionDate` als string in ISO 8601-formaat die het moment van uitvoering aangeeft
* `messageKey` als enum gekoppeld aan `ContextMessageKey` dat het resultaat van de uitvoering beschrijft
* `optioneel` als string die een technische beschrijving geeft (indien relevant); het wordt voornamelijk gebruikt voor debugging en foutmelding


---

# 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/nl/api-docs/overzicht-van-api-verzoeken-van-geopard/83.-query-platformcontext-verzamelen.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.