83. Vaicājums: iegūt platformas kontekstu

Apstrādājot lielu skaitu (simtiem vai tūkstošiem) datu kopu (piem., "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" utt.), vienmēr pastāv vajadzība izprast katras datu kopas apstrādes statusu un apkopt apstrādes kopsavilkumu. Šie dati tiek nodrošināti, izmantojot getPlatformContext query.

Biežākie gadījumi:

• Izsekot apstrādes gaitu

• Savākt apstrādes kopsavilkumu un statistiku

• Novērot kļūdas un brīdinājumus apstrādes laikā, lai veiktu padziļinātu ietekmēto datu kopu izmeklēšanu

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

Atbalstītie ievades filtri:

• dateFrom kā datuma-laika vērtība ISO 8601 formātā (piem.: "2023-05-25T12:49:00.000Z")

• dateTo kā datuma-laika vērtība ISO 8601 formātā (piem.: "2023-05-30T06:35:00.000Z")

• operationIds kā darbību identifikatoru masīvs (Virknes)

• statuses kā masīvs, kas satur vērtības no ContextEventStatus enumerācija ar visiem apstrādes statusiem, ieskaitot starpposma — ieteicams izmantot galvenos atslēgvārdus [Start, Done, Warning, Error, Ignored]

• subFieldTypes kā masīvs ar vērtībām no TreeNodeEntity enumerācija ar visām GeoPard entītijām

• subFieldUuids kā masīvs ar UUID, kas saistīti ar izvēlētajām entītijām subFieldTypes

• userUuids kā "User" UUID masīvs meklēšanai

Ir jāinicializē vismaz viens no šādiem filtriem: userUuids, fieldUuids, subFieldUuids, vai operationIds.

Ja dateFrom un dateTo nav norādīti, noklusējuma vaicājuma ilgums tiek iestatīts uz 12 stundām. Maksmāli ieteicamais laika intervāls datu izgūšanai ir 24 stundas.

Ir ierobežojums — tiek piegādātas maksimums 10 000 rindas.

Lai apskatītu visas pieejamās jaunākās enum vērtības (piem., TreeNodeEntity, ContextEventStatus, ContextMessageKey), ieteicams izmantot Altair.

Izejas objekts iekļauj šādus atribūtus:

• fieldUuid apzīmē saistītā lauka (Field) UUID

• subFieldUuid norāda saistītās apstrādātās datu kopas UUID (piem., "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" utt.)

• subFieldType kā enumerācija saistīta ar TreeNodeEntity

• operationId kā virkne, kas satur darbības identifikatoru; tas saglabā konsekvenci visās saistītajās apstrādes ķēdēs — ieteicams grupēt pēc šī identifikatora, lai izsekotu visām apstrādes stadijām

• status kā enumerācija saistīta ar ContextEventStatus

• executionDate kā virkne ISO 8601 formātā, kas norāda izpildes brīdi

• messageKey kā enumerācija saistīta ar ContextMessageKey kas apraksta izpildes rezultātu

• optional kā virkne, kas sniedz tehnisku aprakstu (ja attiecināms); galvenokārt tiek izmantota atkļūdošanai un kļūdu ziņošanai