# 83. Interogare: Colectează 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/documentatia-api/inceput-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: 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/ro/documentatia-api/prezentarea-generala-a-solicitarilor-api-geopard/83.-interogare-colecteaza-contextul-platformei.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.