# 83. Užklausa: surinkti platformos kontekstą

Kai apdorojamų duomenų rinkinių yra daug (šimtai ar tūkstančiai) (pvz., „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ ir kt.), visuomet yra poreikis suprasti kiekvieno duomenų rinkinio apdorojimo būklę ir surinkti apdorojimo santrauką. Šie duomenys pateikiami naudojant `getPlatformContext` užklausą. 

Dažniausi atvejai: 

* Stebėti apdorojimo eigą
* Surinkti apdorojimo santrauką ir statistiką
* Stebėti klaidas ir įspėjimus apdorojimo metu tolimesniam paveiktų duomenų rinkinių išsamesniam tyrimui

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

Palaikomi įvesties filtrai:

* `dateFrom` kaip datos ir laiko reikšmė ISO 8601 formatu (pvz.: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` kaip datos ir laiko reikšmė ISO 8601 formatu (pvz.: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` kaip masyvas su operacijų identifikatoriais (`Eilutės`)
* `statuses` kaip masyvas su reikšmėmis iš `ContextEventStatus` išvardinimas su visomis apdorojimo būklėmis, įskaitant tarpinės; rekomenduojama naudoti pagrindines reikšmes `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` kaip masyvas, turintis reikšmes iš `TreeNodeEntity` išvardinimas su visomis GeoPard entitetų reikšmėmis
* `subFieldUuids` kaip masyvas su UUID, susietais su pasirinktomis reikšmėmis `subFieldTypes`&#x20;
* `userUuids` kaip masyvas „User“ naudotojų UUID paieškai

{% hint style="info" %}
Turi būti nustatytas bent vienas iš šių filtrų: `userUuids`, `fieldUuids`, `subFieldUuids`, arba `operationIds`.
{% endhint %}

{% hint style="info" %}
Jei `dateFrom` ir `dateTo` nenurodyti, numatytasis užklausos laikotarpis yra 12 valandų. Maksimalus rekomenduojamas duomenų gavimo laikotarpis yra 24 valandos.
{% endhint %}

{% hint style="info" %}
Yra ribojimas – perduodama ne daugiau kaip 10 000 eilučių.
{% endhint %}

{% hint style="info" %}
Norint peržiūrėti visas galimas naujausias išvardinimų reikšmes (pvz.: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), rekomenduojama naudoti [Altair](/geopard-tutorials/ltu/api-dokumentacija/darbo-pradzia-su-geopard-api.md).
{% endhint %}

Išvesties objektas apima šiuos atributus:

* `fieldUuid` reiškia susieto lauko UUID
* `subFieldUuid` reiškia susieto apdoroto duomenų rinkinio UUID (pvz., „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ ir kt.)
* `subFieldType` kaip išvardinimas susietas su `TreeNodeEntity`
* `operationId` kaip eilutė, kuri saugo operacijos identifikatorių; jis išlieka nuoseklus visuose susijusiuose apdorojimo grandinėse, rekomenduojama grupuoti pagal šį identifikatorių, kad būtų galima sekti visas apdorojimo stadijas
* `status` kaip išvardinimas susietas su `ContextEventStatus`
* `executionDate` kaip eilutė ISO 8601 formatu, nurodanti vykdymo momentą
* `messageKey` kaip išvardinimas susietas su `ContextMessageKey` kuri apibūdina vykdymo rezultatą
* `optional` kaip eilutė, suteikianti techninį aprašymą (jei aktualu); ji yra naudojama daugiausia klaidų derinimui ir pranešimams apie klaidas


---

# 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/ltu/api-dokumentacija/geopard-api-uzklausu-apzvalga/83.-uzklausa-surinkti-platformos-konteksta.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.