# 83. Forespørgsel: Indsaml platformkontekst

Ved et stort antal (hundreder eller tusinder) behandlede datasæt (som "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" osv.) er der altid behov for at forstå status for behandlingen af hvert datasæt og indsamle en behandlingsopsummering. Disse oplysninger leveres ved hjælp af `getPlatformContext` forespørgsel. 

De almindelige tilfælde: 

* Spor behandlingsfremskridt
* Indsaml behandlingsopsummering og statistikker
* Observer fejl og advarsler under behandlingen for yderligere dybere undersøgelse af berørte datasæt

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

{% endcode %}

Understøttede inputfiltre:

* `dateFrom` som dato/tid i ISO 8601-format (f.eks.: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` som dato/tid i ISO 8601-format (f.eks.: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` som array af operationens identifikatorer (`Strenge`)
* `statuses` som array der indeholder værdier fra `ContextEventStatus` enum med alle behandlingsstatusser inklusive mellemliggende; det anbefales at bruge hovednøgleværdierne `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` som array der indeholdt værdier af `TreeNodeEntity` enum med alle GeoPard-enheder
* `subFieldUuids` som array med UUID’er knyttet til de valgte enheder i `subFieldTypes`&#x20;
* `userUuids` som array af "User" UUID’er til søgning

{% hint style="info" %}
Mindst ét af følgende filtre skal være initialiseret: `userUuids`, `fieldUuids`, `subFieldUuids`, eller `operationIds`.
{% endhint %}

{% hint style="info" %}
Hvis `dateFrom` og `dateTo` ikke er angivet, er standardforespørgselsperioden sat til 12 timer. Den maksimalt anbefalede tidsperiode for dataudtræk er 24 timer.
{% endhint %}

{% hint style="info" %}
Der er en grænse på maks. 10.000 leverede rækker.
{% endhint %}

{% hint style="info" %}
For at se alle tilgængelige seneste værdier af enums (som: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), anbefales det at bruge [Altair](/geopard-tutorials/dnk/api-dokumentation/kom-i-gang-med-geopard-api.md).
{% endhint %}

Output-objektet indeholder følgende attributter:

* `fieldUuid` repræsenterer UUID’en for den tilknyttede mark (Field)
* `subFieldUuid` angiver UUID’en for det tilknyttede behandlede datasæt (som "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" osv.)
* `subFieldType` som enum knyttet til `TreeNodeEntity`
* `operationId` som streng, der indeholder operationens identifikator; den forbliver konsistent på tværs af alle relaterede behandlingskæder, og det anbefales at gruppere efter denne identifikator for at spore alle behandlingsstadier
* `status` som enum knyttet til `ContextEventStatus`
* `executionDate` som streng i ISO 8601-format, der angiver tidspunktet for udførelsen
* `messageKey` som enum knyttet til `ContextMessageKey` der beskriver resultatet af udførelsen
* `valgfri` som streng, der giver en teknisk beskrivelse (hvis relevant); den bruges primært til fejlsøgning og fejlrapportering


---

# 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/dnk/api-dokumentation/oversigt-over-geopard-api-anmodninger/83.-foresporgsel-indsaml-platformkontekst.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.