83. Fråga: Samla plattformscontext

När ett stort antal (hundratals eller tusentals) bearbetade dataset (som "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc.) hanteras finns alltid ett behov av att förstå status för bearbetningen av varje dataset och samla en sammanfattning av bearbetningen. Dessa detaljer tillhandahålls med hjälp av getPlatformContext query.

De vanliga fallen:

• Spåra bearbetningsförloppet

• Samla bearbetningssammanfattning och statistik

• Observera fel och varningar under bearbetning för vidare djupare undersökning av påverkade dataset

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

Stödda indatafilter:

• dateFrom som datumtid i ISO 8601-format (t.ex.: "2023-05-25T12:49:00.000Z")

• dateTo som datumtid i ISO 8601-format (t.ex.: "2023-05-30T06:35:00.000Z")

• operationIds som en array av operationens identifierare (Strängar)

• statuses som en array innehållande värden från ContextEventStatus enum med alla bearbetningsstatus inklusive mellanstatus, rekommenderas att använda de viktigaste nycklarna [Start, Done, Warning, Error, Ignored]

• subFieldTypes som en array med värden av TreeNodeEntity enum med alla GeoPard-enheter

• subFieldUuids som en array med UUID:er länkade till de valda enheterna i subFieldTypes

• userUuids som en array av "User"-UUID:er att söka efter

Minst ett av följande filter måste initieras: userUuids, fieldUuids, subFieldUuids, eller operationIds.

Om dateFrom och dateTo inte anges, sätts standardfrågeperioden till 12 timmar. Den rekommenderade maximala tidsperioden för datahämtning är 24 timmar.

Det finns en gräns på max 10 000 rader som levereras.

För att se alla tillgängliga senaste värden av enum-typer (som: TreeNodeEntity, ContextEventStatus, ContextMessageKey), rekommenderas det att använda Altair.

Utdataobjektet innehåller följande attribut:

• fieldUuid representerar UUID för det associerade fältet

• subFieldUuid anger UUID för det länkade bearbetade datasetet (som "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", etc.)

• subFieldType som enum kopplad till TreeNodeEntity

• operationId som sträng som innehåller identifieraren för operationen, den är konsekvent över alla relaterade bearbetningskedjor; det är lämpligt att gruppera efter denna identifierare för att spåra alla bearbetningssteg

• status som enum kopplad till ContextEventStatus

• executionDate som sträng i ISO 8601-format som anger tidpunkten för körningen

• messageKey som enum kopplad till ContextMessageKey som beskriver resultatet av körningen

• optional som sträng som ger en teknisk beskrivning (om relevant), den används främst för felsökning och buggrapportering