# 83. Consulta: Recopilar contexto de la plataforma

Con un gran número (cientos o miles) de conjuntos de datos procesados (como "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc.) siempre existe la necesidad de entender el estado del procesamiento de cada conjunto de datos y recopilar el resumen del procesamiento. Estos detalles se proporcionan usando `getPlatformContext` consulta. 

Los casos comunes: 

* Rastrear el progreso del procesamiento
* Recopilar el resumen y las estadísticas del procesamiento
* Observar errores y advertencias durante el procesamiento para una investigación más profunda de los conjuntos de datos afectados

{% 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 compatibles:

* `dateFrom` como fecha y hora en formato ISO 8601 (ej.: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` como fecha y hora en formato ISO 8601 (ej.: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` como arreglo de identificadores de operación (`Cadenas`)
* `statuses` como arreglo que contiene valores de `ContextEventStatus` enum con todos los estados de procesamiento, incluidos los intermedios; se recomienda usar los clave `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` como arreglo que tenía valores de `TreeNodeEntity` enum con todas las entidades de GeoPard
* `subFieldUuids` como arreglo con UUIDs vinculados a las entidades seleccionadas en `subFieldTypes`&#x20;
* `userUuids` como arreglo de UUIDs de "User" para buscar

{% hint style="info" %}
Al menos uno de los siguientes filtros debe inicializarse: `userUuids`, `fieldUuids`, `subFieldUuids`, o `operationIds`.
{% endhint %}

{% hint style="info" %}
Si `dateFrom` y `dateTo` no se especifican, la duración predeterminada de la consulta se establece en 12 horas. El intervalo de tiempo máximo recomendado para la recuperación de datos es de 24 horas.
{% endhint %}

{% hint style="info" %}
Hay un límite de máximo 10.000 filas entregadas.
{% endhint %}

{% hint style="info" %}
Para observar todos los valores más recientes disponibles de los enums (como: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), se recomienda usar [Altair](/geopard-tutorials/esp/documentacion-de-la-api/primeros-pasos-con-la-api-de-geopard.md).
{% endhint %}

El objeto de salida incluye los siguientes atributos:

* `fieldUuid` representa el UUID del Campo asociado
* `subFieldUuid` denota el UUID del conjunto de datos procesado vinculado (como "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc.)
* `subFieldType` como enum vinculado a `TreeNodeEntity`
* `operationId` como cadena que contiene el identificador de la operación; permanece consistente a lo largo de todas las cadenas de procesamiento relacionadas; es recomendable agrupar por este identificador para rastrear todas las etapas del procesamiento
* `status` como enum vinculado a `ContextEventStatus`
* `executionDate` como cadena en formato ISO 8601 que indica el momento de la ejecución
* `messageKey` como enum vinculado a `ContextMessageKey` que describe el resultado de la ejecución
* `opcional` como cadena que proporciona una descripción técnica (si procede); se utiliza principalmente para depuración e informe de errores


---

# 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/esp/documentacion-de-la-api/resumen-de-solicitudes-de-la-api-de-geopard/83.-consulta-recopilar-contexto-de-la-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.