# 83. Zapytanie: Pobierz kontekst platformy

Przy dużej liczbie (setkach lub tysiącach) przetwarzanych zestawów danych (takich jak "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" itp.) zawsze istnieje potrzeba zrozumienia statusu przetwarzania każdego zestawu danych i zebrania podsumowania przetwarzania. Te informacje są dostarczane za pomocą `getPlatformContext` zapytania. 

Typowe przypadki: 

* Śledzenie postępu przetwarzania
* Zbieranie podsumowań i statystyk przetwarzania
* Obserwacja błędów i ostrzeżeń podczas przetwarzania w celu dalszego, głębszego zbadania dotkniętych zestawów danych

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

Obsługiwane filtry wejściowe:

* `dateFrom` jako data i godzina w formacie ISO 8601 (np.: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` jako data i godzina w formacie ISO 8601 (np.: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` jako tablica identyfikatorów operacji (`Ciagi znaków`)
* `statuses` jako tablica zawierająca wartości z `ContextEventStatus` wyliczenia (enum) ze wszystkimi statusami przetwarzania, w tym pośrednimi; zaleca się używać kluczowych `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` jako tablica zawierająca wartości `TreeNodeEntity` wyliczenia (enum) ze wszystkimi encjami GeoPard
* `subFieldUuids` jako tablica UUID powiązanych z wybranymi encjami w `subFieldTypes`&#x20;
* `userUuids` jako tablica UUID użytkowników ("User"), po których ma być wyszukiwanie

{% hint style="info" %}
Przynajmniej jeden z następujących filtrów musi być zainicjowany: `userUuids`, `fieldUuids`, `subFieldUuids`, lub `operationIds`.
{% endhint %}

{% hint style="info" %}
Jeśli `dateFrom` i `dateTo` nie są określone, domyślny okres zapytania ustawiony jest na 12 godzin. Maksymalny zalecany zakres czasu dla pobierania danych to 24 godziny.
{% endhint %}

{% hint style="info" %}
Istnieje limit maksymalnie 10 000 zwracanych wierszy.
{% endhint %}

{% hint style="info" %}
Aby zobaczyć wszystkie dostępne, najnowsze wartości enumów (np.: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), zaleca się użycie [Altair](/geopard-tutorials/pl/dokumentacja-api/pierwsze-kroki-z-api-geopard.md).
{% endhint %}

Obiekt wyjściowy zawiera następujące atrybuty:

* `fieldUuid` reprezentuje UUID powiązanego pola (Field)
* `subFieldUuid` oznacza UUID powiązanego przetworzonego zestawu danych (takiego jak "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" itp.)
* `subFieldType` jako enum powiązany z `TreeNodeEntity`
* `operationId` jako ciąg znaków, który zawiera identyfikator operacji; pozostaje on spójny w całych powiązanych łańcuchach przetwarzania — zaleca się grupowanie po tym identyfikatorze w celu śledzenia wszystkich etapów przetwarzania
* `status` jako enum powiązany z `ContextEventStatus`
* `executionDate` jako ciąg znaków w formacie ISO 8601, wskazujący moment wykonania
* `messageKey` jako enum powiązany z `ContextMessageKey` który opisuje wynik wykonania
* `optional` jako ciąg znaków zawierający opis techniczny (jeśli istotny); jest on wykorzystywany głównie do debugowania i zgłaszania błędów


---

# 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/pl/dokumentacja-api/przeglad-zapytan-api-geopard/83.-zapytanie-pobierz-kontekst-platformy.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.