83. Query: Sesbírat kontext platformy

Při velkém počtu (stovky nebo tisíce) zpracovaných datasetů (např. „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ atd.) je vždy potřeba vědět, v jakém stavu je zpracování každého datasetu a shromáždit souhrn zpracování. Tyto informace jsou poskytovány pomocí getPlatformContext dotazu.

Běžné scénáře:

• Sledovat průběh zpracování

• Shromáždit souhrn a statistiky zpracování

• Sledovat chyby a varování během zpracování pro další hlubší prověření postižených datasetů

dotaz 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
     volitelně
   }
 }
}

Podporované vstupní filtry:

• dateFrom jako datum a čas ve formátu ISO 8601 (např.: "2023-05-25T12:49:00.000Z")

• dateTo jako datum a čas ve formátu ISO 8601 (např.: "2023-05-30T06:35:00.000Z")

• operationIds jako pole identifikátorů operací (Řetězce)

• statuses jako pole obsahující hodnoty z ContextEventStatus výčtu se všemi stavy zpracování včetně mezistavů; doporučuje se používat klíčové stavy [Start, Done, Warning, Error, Ignored]

• subFieldTypes jako pole obsahující hodnoty typu TreeNodeEntity výčet se všemi entitami GeoPard

• subFieldUuids jako pole UUID napojených na vybrané entity v subFieldTypes

• userUuids jako pole UUID uživatelů k vyhledávání

Musí být inicializován alespoň jeden z následujících filtrů: userUuids, fieldUuids, subFieldUuids, nebo operationIds.

Pokud dateFrom a dateTo nejsou zadány, výchozí doba dotazu je nastavena na 12 hodin. Maximální doporučené časové rozpětí pro načítání dat je 24 hodin.

Je omezení na maximálně 10 000 vrácených řádků.

Pro zobrazení všech dostupných nejnovějších hodnot výčtů (např.: TreeNodeEntity, ContextEventStatus, ContextMessageKey), se doporučuje použít Altair.

Výstupní objekt obsahuje následující atributy:

• fieldUuid označuje UUID souvisejícího pole (Field)

• subFieldUuid označuje UUID propojeného zpracovaného datasetu (např. „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ atd.)

• subFieldType jako výčet navázaný na TreeNodeEntity

• operationId jako řetězec, který drží identifikátor operace; zůstává konzistentní napříč všemi souvisejícími zpracovatelskými řetězci; doporučuje se seskupovat podle tohoto identifikátoru, abyste sledovali všechny fáze zpracování

• status jako výčet navázaný na ContextEventStatus

• executionDate jako řetězec ve formátu ISO 8601, který udává okamžik provedení

• messageKey jako výčet navázaný na ContextMessageKey který popisuje výsledek provedení

• volitelně jako řetězec, který poskytuje technický popis (pokud relevantní); používá se především k ladění a hlášení chyb