83. Užklausa: surinkti platformos kontekstą

Kai apdorojamų duomenų rinkinių yra daug (šimtai ar tūkstančiai) (pvz., „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ ir kt.), visuomet yra poreikis suprasti kiekvieno duomenų rinkinio apdorojimo būklę ir surinkti apdorojimo santrauką. Šie duomenys pateikiami naudojant getPlatformContext užklausą.

Dažniausi atvejai:

• Stebėti apdorojimo eigą

• Surinkti apdorojimo santrauką ir statistiką

• Stebėti klaidas ir įspėjimus apdorojimo metu tolimesniam paveiktų duomenų rinkinių išsamesniam tyrimui

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

Palaikomi įvesties filtrai:

• dateFrom kaip datos ir laiko reikšmė ISO 8601 formatu (pvz.: "2023-05-25T12:49:00.000Z")

• dateTo kaip datos ir laiko reikšmė ISO 8601 formatu (pvz.: "2023-05-30T06:35:00.000Z")

• operationIds kaip masyvas su operacijų identifikatoriais (Eilutės)

• statuses kaip masyvas su reikšmėmis iš ContextEventStatus išvardinimas su visomis apdorojimo būklėmis, įskaitant tarpinės; rekomenduojama naudoti pagrindines reikšmes [Start, Done, Warning, Error, Ignored]

• subFieldTypes kaip masyvas, turintis reikšmes iš TreeNodeEntity išvardinimas su visomis GeoPard entitetų reikšmėmis

• subFieldUuids kaip masyvas su UUID, susietais su pasirinktomis reikšmėmis subFieldTypes

• userUuids kaip masyvas „User“ naudotojų UUID paieškai

Turi būti nustatytas bent vienas iš šių filtrų: userUuids, fieldUuids, subFieldUuids, arba operationIds.

Jei dateFrom ir dateTo nenurodyti, numatytasis užklausos laikotarpis yra 12 valandų. Maksimalus rekomenduojamas duomenų gavimo laikotarpis yra 24 valandos.

Yra ribojimas – perduodama ne daugiau kaip 10 000 eilučių.

Norint peržiūrėti visas galimas naujausias išvardinimų reikšmes (pvz.: TreeNodeEntity, ContextEventStatus, ContextMessageKey), rekomenduojama naudoti Altair.

Išvesties objektas apima šiuos atributus:

• fieldUuid reiškia susieto lauko UUID

• subFieldUuid reiškia susieto apdoroto duomenų rinkinio UUID (pvz., „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ ir kt.)

• subFieldType kaip išvardinimas susietas su TreeNodeEntity

• operationId kaip eilutė, kuri saugo operacijos identifikatorių; jis išlieka nuoseklus visuose susijusiuose apdorojimo grandinėse, rekomenduojama grupuoti pagal šį identifikatorių, kad būtų galima sekti visas apdorojimo stadijas

• status kaip išvardinimas susietas su ContextEventStatus

• executionDate kaip eilutė ISO 8601 formatu, nurodanti vykdymo momentą

• messageKey kaip išvardinimas susietas su ContextMessageKey kuri apibūdina vykdymo rezultatą

• optional kaip eilutė, suteikianti techninį aprašymą (jei aktualu); ji yra naudojama daugiausia klaidų derinimui ir pranešimams apie klaidas