# 83. Consulta: Coletar Contexto da Plataforma

Com um grande número (centenas ou milhares) de conjuntos de dados processados (como "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc) sempre há demanda para entender o status do processamento de cada conjunto de dados e coletar o resumo do processamento. Esses detalhes são fornecidos usando `getPlatformContext` consulta. 

Os casos comuns: 

* Rastrear o progresso do processamento
* Coletar resumo e estatísticas do processamento
* Observar erros e avisos durante o processamento para investigação mais aprofundada dos conjuntos de dados afetados

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

{% endcode %}

Filtros de entrada suportados:

* `dateFrom` como datetime em formato ISO 8601 (ex: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` como datetime em formato ISO 8601 (ex: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` como array dos identificadores da operação (`Strings`)
* `statuses` como array contendo valores de `ContextEventStatus` enum com todos os status de processamento incluindo intermediários, recomendado usar os principais `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` como array contendo valores de `TreeNodeEntity` enum com todas as entidades do GeoPard
* `subFieldUuids` como array com UUIDs vinculados às entidades selecionadas em `subFieldTypes`&#x20;
* `userUuids` como array de UUIDs de "User" para busca

{% hint style="info" %}
Pelo menos um dos seguintes filtros deve ser inicializado: `userUuids`, `fieldUuids`, `subFieldUuids`, ou `operationIds`.
{% endhint %}

{% hint style="info" %}
Se `dateFrom` e `dateTo` não forem especificados, a duração padrão da consulta é definida para 12 horas. O período máximo recomendado para recuperação de dados é de 24 horas.
{% endhint %}

{% hint style="info" %}
Há um limite de no máximo 10.000 linhas entregues.
{% endhint %}

{% hint style="info" %}
Para observar todos os valores mais recentes disponíveis de enums (como: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), é recomendado usar [Altair](/geopard-tutorials/pt-br/docs-da-api/primeiros-passos-com-a-api-do-geopard.md).
{% endhint %}

O objeto de saída inclui os seguintes atributos:

* `fieldUuid` representa o UUID do Campo associado
* `subFieldUuid` denota o UUID do conjunto de dados processado vinculado (como "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc)
* `subFieldType` como enum vinculado a `TreeNodeEntity`
* `operationId` como string que contém o identificador da operação, permanece consistente em todas as cadeias de processamento relacionadas, é recomendável agrupar por esse identificador para rastrear todas as etapas do processamento
* `status` como enum vinculado a `ContextEventStatus`
* `executionDate` como string no formato ISO 8601 que indica o momento da execução
* `messageKey` como enum vinculado a `ContextMessageKey` que descreve o resultado da execução
* `opcional` como string que fornece uma descrição técnica (se relevante), é usada principalmente para depuração e relato de bugs


---

# 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/pt-br/docs-da-api/visao-geral-das-solicitacoes-da-api-do-geopard/83.-consulta-coletar-contexto-da-plataforma.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.