83. Query: Raccogli il contesto della piattaforma

Con un gran numero (centinaia o migliaia) di dataset processati (come "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", ecc.) c'è sempre la necessità di comprendere lo stato dell'elaborazione di ogni dataset e raccogliere il riepilogo del processo. Questi dettagli sono forniti usando getPlatformContext query.

I casi comuni:

• Tracciare il progresso dell'elaborazione

• Raccogliere riepiloghi e statistiche di elaborazione

• Osservare errori e avvisi durante l'elaborazione per indagini più approfondite sui dataset interessati

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

Filtri di input supportati:

• dateFrom come data/ora in formato ISO 8601 (es.: "2023-05-25T12:49:00.000Z")

• dateTo come data/ora in formato ISO 8601 (es.: "2023-05-30T06:35:00.000Z")

• operationIds come array di identificatori dell'operazione (Stringhe)

• statuses come array contenente valori da ContextEventStatus enum con tutti gli stati di elaborazione inclusi quelli intermedi; è consigliato usare i principali [Start, Done, Warning, Error, Ignored]

• subFieldTypes come array contenente valori di TreeNodeEntity enum con tutte le entità GeoPard

• subFieldUuids come array con UUID collegati alle entità selezionate in subFieldTypes

• userUuids come array di UUID degli "User" da ricercare

Almeno uno dei seguenti filtri deve essere inizializzato: userUuids, fieldUuids, subFieldUuids, o operationIds.

Se dateFrom e dateTo non sono specificati, la durata predefinita della query è impostata a 12 ore. L'intervallo di tempo massimo consigliato per il recupero dei dati è di 24 ore.

Esiste un limite di massimo 10.000 righe restituite.

Per osservare tutti i valori più recenti disponibili degli enum (come: TreeNodeEntity, ContextEventStatus, ContextMessageKey), è consigliato usare Altair.

L'oggetto di output include i seguenti attributi:

• fieldUuid rappresenta l'UUID del Campo associato

• subFieldUuid indica l'UUID del dataset processato collegato (come "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", ecc.)

• subFieldType come enum collegato a TreeNodeEntity

• operationId come stringa che contiene l'identificatore dell'operazione; resta coerente lungo tutte le catene di elaborazione correlate; è consigliabile raggruppare per questo identificatore per tracciare tutte le fasi di elaborazione

• status come enum collegato a ContextEventStatus

• executionDate come stringa in formato ISO 8601 che indica il momento dell'esecuzione

• messageKey come enum collegato a ContextMessageKey che descrive l'esito dell'esecuzione

• optional come stringa che fornisce una descrizione tecnica (se pertinente), è utilizzata principalmente per il debug e la segnalazione di bug