83. Interogare: Colectați contextul platformei

La un număr mare (sute sau mii) de seturi de date procesate (cum ar fi "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" etc.) există întotdeauna o cerere de a înțelege starea procesării fiecărui set de date și de a colecta sumarul procesării. Aceste detalii sunt furnizate folosind getPlatformContext interogare.

Cazurile comune:

• Urmărirea progresului procesării

• Colectarea sumarului și a statisticilor procesării

• Observarea erorilor și avertismentelor apărute în timpul procesării pentru investigații ulterioare mai profunde ale seturilor de date afectate

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
     opțional
   }
 }
}

Filtre de intrare suportate:

• dateFrom ca datetime în format ISO 8601 (ex: "2023-05-25T12:49:00.000Z")

• dateTo ca datetime în format ISO 8601 (ex: "2023-05-30T06:35:00.000Z")

• operationIds ca un tablou de identificatori ai operațiunilor (Șiruri)

• statuses ca un tablou care conține valori din ContextEventStatus enum cu toate stările procesării, inclusiv intermediare; este recomandat să se folosească pe cele cheie [Start, Done, Warning, Error, Ignored]

• subFieldTypes ca un tablou care conține valori ale TreeNodeEntity enum cu toate entitățile GeoPard

• subFieldUuids ca un tablou cu UUID-uri legate de entitățile selectate în subFieldTypes

• userUuids ca un tablou de UUID-uri ale „User” pentru căutare

Cel puțin unul dintre următoarele filtre trebuie inițializat: userUuids, fieldUuids, subFieldUuids, sau operationIds.

Dacă dateFrom și dateTo nu sunt specificate, durata implicită a interogării este de 12 ore. Intervalul maxim recomandat pentru recuperarea datelor este de 24 de ore.

Există o limită de maximum 10.000 de rânduri livrate.

Pentru a observa toate valorile cele mai recente disponibile ale enumurilor (cum ar fi: TreeNodeEntity, ContextEventStatus, ContextMessageKey), este recomandat să folosiți Altair.

Obiectul de ieșire include următoarele atribute:

• fieldUuid reprezintă UUID-ul Câmpului asociat

• subFieldUuid denotă UUID-ul setului de date procesat legat (cum ar fi "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" etc.)

• subFieldType ca enum legat de TreeNodeEntity

• operationId ca șir care conține identificatorul operațiunii; rămâne consecvent în toate lanțurile de procesare asociate; este recomandat să grupați după acest identificator pentru a urmări toate etapele procesării

• status ca enum legat de ContextEventStatus

• executionDate ca șir în format ISO 8601 care indică momentul executării

• messageKey ca enum legat de ContextMessageKey care descrie rezultatul execuției

• opțional ca șir care oferă o descriere tehnică (dacă este relevantă), este folosit în principal pentru depanare și raportarea erorilor