# 83. Fråga: Samla plattformscontext

När ett stort antal (hundratals eller tusentals) bearbetade dataset (som "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc.) hanteras finns alltid ett behov av att förstå status för bearbetningen av varje dataset och samla en sammanfattning av bearbetningen. Dessa detaljer tillhandahålls med hjälp av `getPlatformContext` query. 

De vanliga fallen: 

* Spåra bearbetningsförloppet
* Samla bearbetningssammanfattning och statistik
* Observera fel och varningar under bearbetning för vidare djupare undersökning av påverkade dataset

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

Stödda indatafilter:

* `dateFrom` som datumtid i ISO 8601-format (t.ex.: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` som datumtid i ISO 8601-format (t.ex.: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` som en array av operationens identifierare (`Strängar`)
* `statuses` som en array innehållande värden från `ContextEventStatus` enum med alla bearbetningsstatus inklusive mellanstatus, rekommenderas att använda de viktigaste nycklarna `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` som en array med värden av `TreeNodeEntity` enum med alla GeoPard-enheter
* `subFieldUuids` som en array med UUID:er länkade till de valda enheterna i `subFieldTypes`&#x20;
* `userUuids` som en array av "User"-UUID:er att söka efter

{% hint style="info" %}
Minst ett av följande filter måste initieras: `userUuids`, `fieldUuids`, `subFieldUuids`, eller `operationIds`.
{% endhint %}

{% hint style="info" %}
Om `dateFrom` och `dateTo` inte anges, sätts standardfrågeperioden till 12 timmar. Den rekommenderade maximala tidsperioden för datahämtning är 24 timmar.
{% endhint %}

{% hint style="info" %}
Det finns en gräns på max 10 000 rader som levereras.
{% endhint %}

{% hint style="info" %}
För att se alla tillgängliga senaste värden av enum-typer (som: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), rekommenderas det att använda [Altair](/geopard-tutorials/swe/api-dokumentation/kom-igang-med-geopard-api.md).
{% endhint %}

Utdataobjektet innehåller följande attribut:

* `fieldUuid` representerar UUID för det associerade fältet
* `subFieldUuid` anger UUID för det länkade bearbetade datasetet (som "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc.)
* `subFieldType` som enum kopplad till `TreeNodeEntity`
* `operationId` som sträng som innehåller identifieraren för operationen, den är konsekvent över alla relaterade bearbetningskedjor; det är lämpligt att gruppera efter denna identifierare för att spåra alla bearbetningssteg
* `status` som enum kopplad till `ContextEventStatus`
* `executionDate` som sträng i ISO 8601-format som anger tidpunkten för körningen
* `messageKey` som enum kopplad till `ContextMessageKey` som beskriver resultatet av körningen
* `optional` som sträng som ger en teknisk beskrivning (om relevant), den används främst för felsökning och buggrapportering


---

# 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/swe/api-dokumentation/oversikt-over-geopard-api-anrop/83.-fraga-samla-plattformscontext.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.