83. Lekérdezés: platformkontextus gyűjtése

Nagyszámú (százak vagy ezrek) feldolgozott adatkészletnél (például "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" stb.) mindig igény van az egyes adatkészletek feldolgozási állapotának megértésére és a feldolgozási összegzés gyűjtésére. Ezek az információk a következő segítségével érhetők el: getPlatformContext query.

Gyakori esetek:

• A feldolgozás előrehaladásának nyomon követése

• A feldolgozási összegzés és statisztikák gyűjtése

• Hibák és figyelmeztetések megfigyelése a feldolgozás során, további mélyebb vizsgálathoz az érintett adatkészletek esetén

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

Támogatott bemeneti szűrők:

• dateFrom ISO 8601 formátumú dátumként-időpontként (pl.: "2023-05-25T12:49:00.000Z")

• dateTo ISO 8601 formátumú dátumként-időpontként (pl.: "2023-05-30T06:35:00.000Z")

• operationIds a műveletazonosítók tömbjeként (Sztringek)

• statuses olyan tömbként, amely értékeket tartalmaz a ContextEventStatus felsorolásból, amely tartalmazza az összes feldolgozási állapotot, beleértve a közteseket is; ajánlott a kulcsfontosságúakat használni [Start, Done, Warning, Error, Ignored]

• subFieldTypes olyan tömbként, amely értékei a TreeNodeEntity felsorolásból vannak, amely az összes GeoPard entitást tartalmazza

• subFieldUuids olyan tömbként, amely UUID-ket tartalmaz a kiválasztott entitásokhoz kapcsolódóan subFieldTypes

• userUuids a keresendő "User" UUID-k tömbjeként

A következő szűrők közül legalább egyet meg kell adni: userUuids, fieldUuids, subFieldUuids, vagy operationIds.

Ha dateFrom és dateTo nincsenek megadva, az alapértelmezett lekérdezési időtartam 12 óra. Az ajánlott maximális időintervallum az adatok lekéréséhez 24 óra.

Maximum 10 000 sor kézbesítése engedélyezett.

Az elérhető, legfrissebb felsorolásértékek (például: TreeNodeEntity, ContextEventStatus, ContextMessageKey) megtekintéséhez ajánlott használni Altair.

A kimeneti objektum a következő attribútumokat tartalmazza:

• fieldUuid a kapcsolódó Tábla (Field) UUID-ját jelöli

• subFieldUuid a kapcsolódó feldolgozott adatkészlet UUID-ját jelöli (például "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" stb.)

• subFieldType felsorolásként, amely kapcsolódik a TreeNodeEntity

• operationId sztringként, amely a művelet azonosítóját tartalmazza; ez következetes az összes kapcsolódó feldolgozási láncban, ajánlott ezzel az azonosítóval csoportosítani a feldolgozási lépések követéséhez

• status felsorolásként, amely kapcsolódik ContextEventStatus

• executionDate ISO 8601 formátumú sztringként, amely a végrehajtás pillanatát jelzi

• messageKey felsorolásként, amely kapcsolódik ContextMessageKey amely leírja a végrehajtás eredményét

• optional sztringként, amely technikai leírást ad (ha releváns); elsősorban hibakeresésre és hibajelentésre használatos