# 83. Spørring: Hent plattformkontekst

Når et stort antall (hundrevis eller tusenvis) behandlede datasett (som "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" osv.) finnes det alltid et behov for å forstå statusen til behandlingen for hvert datasett og samle en behandlingsoppsummering. Disse detaljene leveres ved hjelp av `getPlatformContext` spørring. 

De vanlige tilfellene: 

* Spor behandlingsframdriften
* Samle behandlingsoppsummering og statistikk
* Observer feil og advarsler under behandling for videre dypere undersøkelse av berørte datasett

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

{% endcode %}

Støttede inndatafiltre:

* `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 av operasjonsidentifikatorer (`Strenger`)
* `statuses` som en array med verdier hentet fra `ContextEventStatus` enum med alle behandlingsstatusser inkludert mellomliggende; det anbefales å bruke nøkkelstatusene `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` som en array som inneholder verdier av `TreeNodeEntity` enum med alle GeoPard-enheter
* `subFieldUuids` som en array med UUID-er knyttet til de valgte enhetene i `subFieldTypes`&#x20;
* `userUuids` som en array med "User" UUID-er å søke etter

{% hint style="info" %}
Minst ett av følgende filtre må være initialisert: `userUuids`, `fieldUuids`, `subFieldUuids`, eller `operationIds`.
{% endhint %}

{% hint style="info" %}
Hvis `dateFrom` og `dateTo` ikke er spesifisert, settes standard spørringsvarighet til 12 timer. Den maksimalt anbefalte tidsperioden for datainnhenting er 24 timer.
{% endhint %}

{% hint style="info" %}
Det er en grense på maks 10 000 rader levert.
{% endhint %}

{% hint style="info" %}
For å se alle tilgjengelige siste verdier av enum-typer (som: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), anbefales det å bruke [Altair](/geopard-tutorials/nor/api-dokumentasjon/kom-i-gang-med-geopard-api.md).
{% endhint %}

Utdataobjektet inkluderer følgende attributter:

* `fieldUuid` representerer UUID-en til det tilknyttede feltet
* `subFieldUuid` angir UUID-en til det tilknyttede behandlede datasettet (som "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" osv.)
* `subFieldType` som enum knyttet til `TreeNodeEntity`
* `operationId` som streng som inneholder identifikatoren til operasjonen; den er konsistent på tvers av alle relaterte behandlingskjeder, det er lurt å gruppere etter denne identifikatoren for å spore alle behandlingsstadier
* `status` som enum knyttet til `ContextEventStatus`
* `executionDate` som streng i ISO 8601-format som angir tidspunktet for utførelsen
* `messageKey` som enum knyttet til `ContextMessageKey` som beskriver utfallet av utførelsen
* `valgfritt` som streng som gir en teknisk beskrivelse (hvis relevant); den brukes primært til feilsøking og feilrapportering


---

# 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/nor/api-dokumentasjon/geopard-api-foresporsler-oversikt/83.-sporring-hent-plattformkontekst.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.