> For the complete documentation index, see [llms.txt](https://docs.geopard.tech/geopard-tutorials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geopard.tech/geopard-tutorials/nor/api-dokumentasjon/oversikt-over-geopard-api-foresporsler/83.-sporring-hent-plattformkontekst.md).

# 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.&#x20;

De vanlige tilfellene:&#x20;

* 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.geopard.tech/geopard-tutorials/nor/api-dokumentasjon/oversikt-over-geopard-api-foresporsler/83.-sporring-hent-plattformkontekst.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
