> 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/dnk/api-dokumentation/geopard-api-requests-overview/83.-query-collect-platform-context.md).

# 83. Forespørgsel: Indsaml platformkontekst

Når der er et stort antal (hundreder eller tusinder) behandlede datasæt (såsom "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" osv.), er der altid behov for at kende behandlingsstatussen for hvert datasæt og indsamle et behandlingsresumé. Disse oplysninger fås via `getPlatformContext` forespørgslen.

Typiske anvendelser:

* Følg behandlingens fremdrift
* Indsaml behandlingsresuméer og statistik
* Hold øje med fejl og advarsler under behandlingen, så berørte datasæt kan undersøges nærmere

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

{% endcode %}

Understøttede inputfiltre:

* `dateFrom` som dato og klokkeslæt i ISO 8601-format (f.eks. `"2023-05-25T12:49:00.000Z"`)
* `dateTo` som dato og klokkeslæt i ISO 8601-format (f.eks. `"2023-05-30T06:35:00.000Z"`)
* `operationIds` som et array med operationernes identifikatorer (`Strings`)
* `statuses` som et array med værdier fra `ContextEventStatus` enum med alle behandlingsstatusser, inklusive mellemliggende statusser. Det anbefales at bruge de vigtigste statusser `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` som et array med værdier fra `TreeNodeEntity` enum med alle GeoPard-entiteter
* `subFieldUuids` som et array med UUID'er, der er knyttet til de valgte entiteter i `subFieldTypes`
* `userUuids` som et array med UUID'er for de "User", der skal søges efter

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

{% hint style="info" %}
Hvis `dateFrom` og `dateTo` ikke er angivet, er standardforespørgselsperioden 12 timer. Det anbefalede maksimale tidsrum for datahentning er 24 timer.
{% endhint %}

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

{% hint style="info" %}
Hvis du vil se alle tilgængelige, nyeste enum-værdier (såsom: `TreeNodeEntity`, `ContextEventStatus, ContextMessageKey`), anbefales det at bruge [Altair](https://docs.geopard.tech/geopard-tutorials/dnk/api-dokumentation/getting-started-with-the-geopard-api.md).
{% endhint %}

Outputobjektet indeholder følgende attributter:

* `fieldUuid` repræsenterer UUID'et for det tilknyttede felt
* `subFieldUuid` angiver UUID'et for det tilknyttede behandlede datasæt (såsom "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" osv.)
* `subFieldType` som enum knyttet til `TreeNodeEntity`
* `operationId` som en streng med operationens identifikator. Den er ens på tværs af alle relaterede behandlingskæder. Det anbefales at gruppere efter denne identifikator for at spore alle behandlingstrin.
* `status` som enum knyttet til `ContextEventStatus`
* `executionDate` som en streng i ISO 8601-format, der angiver tidspunktet for udførelsen
* `messageKey` som enum knyttet til `ContextMessageKey` der beskriver resultatet af udførelsen
* `optional` som en streng med en teknisk beskrivelse (hvis relevant). Den bruges primært til fejlfinding og fejlrapportering


---

# 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/dnk/api-dokumentation/geopard-api-requests-overview/83.-query-collect-platform-context.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.
