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

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

Nagyszámú (több száz vagy több ezer) feldolgozott adatkészlet esetén (például „SatelliteImage”, „AsAppliedDataset”, „YieldDataset”, „SoilDataset” stb.) mindig felmerül az igény az egyes adatkészletek feldolgozási állapotának nyomon követésére és a feldolgozás összefoglalójának lekérésére. Ezek az információk a következő lekérdezéssel kérhetők le: `getPlatformContext` lekérdezéssel.

Gyakori felhasználási esetek:

* A feldolgozás előrehaladásának nyomon követése
* A feldolgozás összefoglalójának és statisztikáinak lekérése
* A feldolgozás során fellépő hibák és figyelmeztetések megfigyelése az érintett adatkészletek alaposabb vizsgálata érdekében

{% 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` dátum és idő ISO 8601 formátumban (például: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` dátum és idő ISO 8601 formátumban (például: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` a műveletazonosítók tömbjeként (`Strings`)
* `statuses` a következő értékeket tartalmazó tömbként: `ContextEventStatus` enum, amely az összes feldolgozási állapotot tartalmazza, beleértve a köztes állapotokat is; ajánlott a főbb állapotkulcsokat használni `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` a következő értékeit tartalmazó tömbként: `TreeNodeEntity` enum, amely az összes GeoPard-entitást tartalmazza
* `subFieldUuids` a subFieldTypes mezőben kiválasztott entitásokhoz tartozó UUID-k tömbjeként `subFieldTypes`
* `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` nincs megadva, az alapértelmezett lekérdezési időtartam 12 óra. Az adatlekéréshez ajánlott maximális időtartam 24 óra.
{% endhint %}

{% hint style="info" %}
A visszaadott sorok száma legfeljebb 10 000 lehet.
{% endhint %}

{% hint style="info" %}
Az enumok (például: `TreeNodeEntity`, `ContextEventStatus, ContextMessageKey`) összes elérhető legfrissebb értékének megtekintéséhez ajánlott a következő használata: [Altair](https://docs.geopard.tech/geopard-tutorials/hu/api-dokumentacio/getting-started-with-the-geopard-api.md).
{% endhint %}

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

* `fieldUuid` a kapcsolódó tábla UUID-azonosítója
* `subFieldUuid` a kapcsolódó, feldolgozott adatkészlet UUID-azonosítója (például „SatelliteImage”, „AsAppliedDataset”, „YieldDataset”, „SoilDataset” stb.)
* `subFieldType` enumként, amely a következőhöz kapcsolódik: `TreeNodeEntity`
* `operationId` karakterláncként, amely a művelet azonosítóját tartalmazza. Ez azonos marad az összes kapcsolódó feldolgozási láncban. Az összes feldolgozási szakasz nyomon követéséhez ajánlott ez alapján azonosító szerint csoportosítani.
* `status` enumként, amely a következőhöz kapcsolódik: `ContextEventStatus`
* `executionDate` ISO 8601 formátumú karakterláncként, amely a végrehajtás időpontját jelzi
* `messageKey` enumként, amely a következőhöz kapcsolódik: `ContextMessageKey` és a végrehajtás eredményét írja le
* `optional` karakterláncként, amely műszaki leírást ad meg (ha van ilyen). Elsősorban hibakereséshez és hibajelentéshez használatos.


---

# 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/hu/api-dokumentacio/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.
