# 83. Lekérdezés: Platformkontextus összegyűjtése

Nagyszámú (százak vagy ezrek) feldolgozott adatkészletnél (például "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" stb.) mindig igény van az egyes adatkészletek feldolgozási állapotának megértésére és a feldolgozási összegzés gyűjtésére. Ezek az információk a következő segítségével érhetők el: `getPlatformContext` query.&#x20;

Gyakori esetek:&#x20;

* A feldolgozás előrehaladásának nyomon követése
* A feldolgozási összegzés és statisztikák gyűjtése
* Hibák és figyelmeztetések megfigyelése a feldolgozás során, további mélyebb vizsgálathoz az érintett adatkészletek esetén

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

Támogatott bemeneti szűrők:

* `dateFrom` ISO 8601 formátumú dátumként-időpontként (pl.: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` ISO 8601 formátumú dátumként-időpontként (pl.: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` a műveletazonosítók tömbjeként (`Sztringek`)
* `statuses` olyan tömbként, amely értékeket tartalmaz a `ContextEventStatus` felsorolásból, amely tartalmazza az összes feldolgozási állapotot, beleértve a közteseket is; ajánlott a kulcsfontosságúakat használni `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` olyan tömbként, amely értékei a `TreeNodeEntity` felsorolásból vannak, amely az összes GeoPard entitást tartalmazza
* `subFieldUuids` olyan tömbként, amely UUID-ket tartalmaz a kiválasztott entitásokhoz kapcsolódóan `subFieldTypes`&#x20;
* `userUuids` a keresendő "User" UUID-k tömbjeként

{% hint style="info" %}
A következő szűrők közül legalább egyet meg kell adni: `userUuids`, `fieldUuids`, `subFieldUuids`, vagy `operationIds`.
{% endhint %}

{% hint style="info" %}
Ha `dateFrom` és `dateTo` nincsenek megadva, az alapértelmezett lekérdezési időtartam 12 óra. Az ajánlott maximális időintervallum az adatok lekéréséhez 24 óra.
{% endhint %}

{% hint style="info" %}
Maximum 10 000 sor kézbesítése engedélyezett.
{% endhint %}

{% hint style="info" %}
Az elérhető, legfrissebb felsorolásértékek (például: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`) megtekintéséhez ajánlott használni [Altair](/geopard-tutorials/hu/api-dokumentacio/elso-lepesek-a-geopard-api-val.md).
{% endhint %}

A kimeneti objektum a következő attribútumokat tartalmazza:

* `fieldUuid` a kapcsolódó Tábla (Field) UUID-ját jelöli
* `subFieldUuid` a kapcsolódó feldolgozott adatkészlet UUID-ját jelöli (például "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" stb.)
* `subFieldType` felsorolásként, amely kapcsolódik a `TreeNodeEntity`
* `operationId` sztringként, amely a művelet azonosítóját tartalmazza; ez következetes az összes kapcsolódó feldolgozási láncban, ajánlott ezzel az azonosítóval csoportosítani a feldolgozási lépések követéséhez
* `status` felsorolásként, amely kapcsolódik `ContextEventStatus`
* `executionDate` ISO 8601 formátumú sztringként, amely a végrehajtás pillanatát jelzi
* `messageKey` felsorolásként, amely kapcsolódik `ContextMessageKey` amely leírja a végrehajtás eredményét
* `optional` sztringként, amely technikai leírást ad (ha releváns); elsősorban hibakeresésre és hibajelentésre használatos


---

# 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/hu/api-dokumentacio/geopard-api-keresek-attekintese/83.-lekerdezes-platformkontextus-osszegyujtese.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.
