83. Query: 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

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

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

• userUuids como arreglo de UUIDs de "User" para buscar

Al menos uno de los siguientes filtros debe inicializarse: userUuids, fieldUuids, subFieldUuids, o operationIds.

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.

Hay un límite de máximo 10.000 filas entregadas.

Para observar todos los valores más recientes disponibles de los enums (como: TreeNodeEntity, ContextEventStatus, ContextMessageKey), se recomienda usar Altair.

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