# 83. Vaicājums: iegūt platformas kontekstu

Apstrādājot lielu skaitu (simtiem vai tūkstošiem) datu kopu (piem., "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" utt.), vienmēr pastāv vajadzība izprast katras datu kopas apstrādes statusu un apkopt apstrādes kopsavilkumu. Šie dati tiek nodrošināti, izmantojot `getPlatformContext` query. 

Biežākie gadījumi: 

* Izsekot apstrādes gaitu
* Savākt apstrādes kopsavilkumu un statistiku
* Novērot kļūdas un brīdinājumus apstrādes laikā, lai veiktu padziļinātu ietekmēto datu kopu izmeklēšanu

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

Atbalstītie ievades filtri:

* `dateFrom` kā datuma-laika vērtība ISO 8601 formātā (piem.: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` kā datuma-laika vērtība ISO 8601 formātā (piem.: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` kā darbību identifikatoru masīvs (`Virknes`)
* `statuses` kā masīvs, kas satur vērtības no `ContextEventStatus` enumerācija ar visiem apstrādes statusiem, ieskaitot starpposma — ieteicams izmantot galvenos atslēgvārdus `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` kā masīvs ar vērtībām no `TreeNodeEntity` enumerācija ar visām GeoPard entītijām
* `subFieldUuids` kā masīvs ar UUID, kas saistīti ar izvēlētajām entītijām `subFieldTypes`&#x20;
* `userUuids` kā "User" UUID masīvs meklēšanai

{% hint style="info" %}
Ir jāinicializē vismaz viens no šādiem filtriem: `userUuids`, `fieldUuids`, `subFieldUuids`, vai `operationIds`.
{% endhint %}

{% hint style="info" %}
Ja `dateFrom` un `dateTo` nav norādīti, noklusējuma vaicājuma ilgums tiek iestatīts uz 12 stundām. Maksmāli ieteicamais laika intervāls datu izgūšanai ir 24 stundas.
{% endhint %}

{% hint style="info" %}
Ir ierobežojums — tiek piegādātas maksimums 10 000 rindas.
{% endhint %}

{% hint style="info" %}
Lai apskatītu visas pieejamās jaunākās enum vērtības (piem., `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), ieteicams izmantot [Altair](/geopard-tutorials/lva/api-dokumentacija/darba-saksana-ar-geopard-api.md).
{% endhint %}

Izejas objekts iekļauj šādus atribūtus:

* `fieldUuid` apzīmē saistītā lauka (Field) UUID
* `subFieldUuid` norāda saistītās apstrādātās datu kopas UUID (piem., "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" utt.)
* `subFieldType` kā enumerācija saistīta ar `TreeNodeEntity`
* `operationId` kā virkne, kas satur darbības identifikatoru; tas saglabā konsekvenci visās saistītajās apstrādes ķēdēs — ieteicams grupēt pēc šī identifikatora, lai izsekotu visām apstrādes stadijām
* `status` kā enumerācija saistīta ar `ContextEventStatus`
* `executionDate` kā virkne ISO 8601 formātā, kas norāda izpildes brīdi
* `messageKey` kā enumerācija saistīta ar `ContextMessageKey` kas apraksta izpildes rezultātu
* `optional` kā virkne, kas sniedz tehnisku aprakstu (ja attiecināms); galvenokārt tiek izmantota atkļūdošanai un kļūdu ziņošanai


---

# 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/lva/api-dokumentacija/geopard-api-pieprasijumu-parskats/83.-vaicajums-iegut-platformas-kontekstu.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.