> 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-samle-plattformkontekst.md).

# 83. Spørring: Samle 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 dynamically by asking a question.

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

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
