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

# 83. Interogare: Colectează contextul platformei

Pentru un număr mare (sute sau mii) de seturi de date procesate (precum „SatelliteImage”, „AsAppliedDataset”, „YieldDataset”, „SoilDataset” etc.), este întotdeauna necesar să înțelegeți starea procesării fiecărui set de date și să colectați rezumatul procesării. Aceste detalii sunt furnizate prin intermediul `getPlatformContext` interogării.

Cazuri de utilizare frecvente:

* Urmărirea progresului procesării
* Colectarea rezumatului și a statisticilor procesării
* Observarea erorilor și avertismentelor apărute în timpul procesării, pentru investigarea mai aprofundată a seturilor de date afectate

{% 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
     opțional
   }
 }
}
```

{% endcode %}

Filtre de intrare acceptate:

* `dateFrom` ca dată și oră în format ISO 8601 (ex.: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` ca dată și oră în format ISO 8601 (ex.: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` ca tablou cu identificatorii operațiilor (`Strings`)
* `statuses` ca tablou cu valori din `ContextEventStatus` enumerația care conține toate stările de procesare, inclusiv cele intermediare; se recomandă utilizarea stărilor principale `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` ca tablou cu valori din enumerația `TreeNodeEntity` care conține toate entitățile GeoPard
* `subFieldUuids` ca tablou cu UUID-uri asociate entităților selectate din `subFieldTypes`
* `userUuids` ca tablou cu UUID-urile utilizatorilor care trebuie căutați

{% hint style="info" %}
Trebuie inițializat cel puțin unul dintre următoarele filtre: `userUuids`, `fieldUuids`, `subFieldUuids` sau `operationIds`.
{% endhint %}

{% hint style="info" %}
Dacă `dateFrom` și `dateTo` nu sunt specificate, durata implicită a interogării este de 12 ore. Intervalul maxim recomandat pentru preluarea datelor este de 24 de ore.
{% endhint %}

{% hint style="info" %}
Există o limită de maximum 10.000 de rânduri livrate.
{% endhint %}

{% hint style="info" %}
Pentru a observa toate valorile recente disponibile ale enumerărilor (precum: `TreeNodeEntity`, `ContextEventStatus, ContextMessageKey`), se recomandă utilizarea [Altair](https://docs.geopard.tech/geopard-tutorials/ro/documentatie-api/getting-started-with-the-geopard-api.md).
{% endhint %}

Obiectul rezultat include următoarele atribute:

* `fieldUuid` reprezintă UUID-ul câmpului asociat
* `subFieldUuid` indică UUID-ul setului de date procesat asociat (precum „SatelliteImage”, „AsAppliedDataset”, „YieldDataset”, „SoilDataset” etc.)
* `subFieldType` ca enumerare asociată cu `TreeNodeEntity`
* `operationId` ca șir de caractere care conține identificatorul operațiunii; acesta rămâne constant în toate lanțurile de procesare asociate. Se recomandă gruparea după acest identificator pentru a urmări toate etapele de procesare.
* `status` ca enumerare asociată cu `ContextEventStatus`
* `executionDate` ca șir de caractere în format ISO 8601, care indică momentul execuției
* `messageKey` ca enumerare asociată cu `ContextMessageKey` care descrie rezultatul execuției
* `optional` ca șir de caractere care oferă o descriere tehnică (dacă este relevantă); este utilizat în principal pentru depanare și raportarea erorilor


---

# 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/ro/documentatie-api/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.
