> 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/prezentare-generala-a-cererilor-api-geopard/83.-interogare-colectati-contextul-platformei.md).

# 83. Interogare: Colectați contextul platformei

La un număr mare (sute sau mii) de seturi de date procesate (cum ar fi "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" etc.) există întotdeauna o cerere de a înțelege starea procesării fiecărui set de date și de a colecta sumarul procesării. Aceste detalii sunt furnizate folosind `getPlatformContext` interogare. 

Cazurile comune: 

* Urmărirea progresului procesării
* Colectarea sumarului și a statisticilor procesării
* Observarea erorilor și avertismentelor apărute în timpul procesării pentru investigații ulterioare mai profunde ale 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 suportate:

* `dateFrom` ca datetime în format ISO 8601 (ex: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` ca datetime în format ISO 8601 (ex: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` ca un tablou de identificatori ai operațiunilor (`Șiruri`)
* `statuses` ca un tablou care conține valori din `ContextEventStatus` enum cu toate stările procesării, inclusiv intermediare; este recomandat să se folosească pe cele cheie `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` ca un tablou care conține valori ale `TreeNodeEntity` enum cu toate entitățile GeoPard
* `subFieldUuids` ca un tablou cu UUID-uri legate de entitățile selectate în `subFieldTypes`&#x20;
* `userUuids` ca un tablou de UUID-uri ale „User” pentru căutare

{% hint style="info" %}
Cel puțin unul dintre următoarele filtre trebuie inițializat: `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 recuperarea 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 cele mai recente disponibile ale enumurilor (cum ar fi: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), este recomandat să folosiți [Altair](/geopard-tutorials/ro/documentatie-api/incepeti-cu-api-ul-geopard.md).
{% endhint %}

Obiectul de ieșire include următoarele atribute:

* `fieldUuid` reprezintă UUID-ul Câmpului asociat
* `subFieldUuid` denotă UUID-ul setului de date procesat legat (cum ar fi "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" etc.)
* `subFieldType` ca enum legat de `TreeNodeEntity`
* `operationId` ca șir care conține identificatorul operațiunii; rămâne consecvent în toate lanțurile de procesare asociate; este recomandat să grupați după acest identificator pentru a urmări toate etapele procesării
* `status` ca enum legat de `ContextEventStatus`
* `executionDate` ca șir în format ISO 8601 care indică momentul executării
* `messageKey` ca enum legat de `ContextMessageKey` care descrie rezultatul execuției
* `opțional` ca șir care oferă o descriere tehnică (dacă este relevantă), este folosit î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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.geopard.tech/geopard-tutorials/ro/documentatie-api/prezentare-generala-a-cererilor-api-geopard/83.-interogare-colectati-contextul-platformei.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.