# 83. Заявка: Събиране на контекст на платформата

При голям брой (стотици или хиляди) обработвани набори от данни (като „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ и др.) винаги има необходимост да се разбере статусът на обработката на всеки набор и да се събере обобщение на обработката. Тези подробности се предоставят чрез `getPlatformContext` заявка. 

Честите случаи: 

* Проследяване на напредъка на обработката
* Събиране на обобщение и статистика за обработката
* Наблюдение на грешки и предупреждения по време на обработката за по-нататъшно по-задълбочено разследване на засегнатите набори от данни

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

Поддържани входни филтри:

* `dateFrom` като дата и час в ISO 8601 формат (напр.: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` като дата и час в ISO 8601 формат (напр.: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` като масив от идентификатори на операции (`Низове`)
* `statuses` като масив съдържащ стойности от `ContextEventStatus` изброим тип с всички статуси на обработка, включително междинни; препоръчва се да се използват основните ключови `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` като масив съдържал стойности на `TreeNodeEntity` изброим тип с всички GeoPard ентити
* `subFieldUuids` като масив с UUID-та свързани с избраните ентити в `subFieldTypes`&#x20;
* `userUuids` като масив от UUID-та на „User“ за търсене

{% hint style="info" %}
Трябва да е инициализиран поне един от следните филтри: `userUuids`, `fieldUuids`, `subFieldUuids`, или `operationIds`.
{% endhint %}

{% hint style="info" %}
Ако `dateFrom` и `dateTo` не са зададени, по подразбиране периодът за заявката е 12 часа. Максималният препоръчителен времеви интервал за извличане на данни е 24 часа.
{% endhint %}

{% hint style="info" %}
Има ограничение от максимум 10 000 върнати реда.
{% endhint %}

{% hint style="info" %}
За да се видят всички налични най-нови стойности на изброими типове (като: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), се препоръчва да се използва [Altair](/geopard-tutorials/bg/api-dokumenti/prvi-stpki-s-geopard-api.md).
{% endhint %}

Изходният обект включва следните атрибути:

* `fieldUuid` представлява UUID на свързаното поле
* `subFieldUuid` означава UUID на свързания обработен набор от данни (като „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ и др.)
* `subFieldType` като изброим тип свързан с `TreeNodeEntity`
* `operationId` като низ, който съдържа идентификатора на операцията; той остава постоянен във всички свързани вериги на обработка, препоръчително е да се групира по този идентификатор, за да се проследят всички етапи на обработка
* `status` като изброим тип свързан с `ContextEventStatus`
* `executionDate` като низ в ISO 8601 формат, който указва момента на изпълнение
* `messageKey` като изброим тип свързан с `ContextMessageKey` който описва резултата от изпълнението
* `optional` като низ, който предоставя техническо описание (ако е релевантно); основно се използва за отстраняване на грешки и докладване на бъгове


---

# 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/bg/api-dokumenti/obsh-pregled-na-zayavkite-km-geopard-api/83.-zayavka-sbirane-na-kontekst-na-platformata.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.