83. Spørring: Hent plattformkontekst

Når et stort antall (hundrevis eller tusenvis) behandlede datasett (som "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" osv.) finnes det alltid et behov for å forstå statusen til behandlingen for hvert datasett og samle en behandlingsoppsummering. Disse detaljene leveres ved hjelp av getPlatformContext spørring.

De vanlige tilfellene:

• Spor behandlingsframdriften

• Samle behandlingsoppsummering og statistikk

• Observer feil og advarsler under behandling for videre dypere undersøkelse av berørte datasett

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

Støttede inndatafiltre:

• dateFrom som dato/tid i ISO 8601-format (f.eks.: "2023-05-25T12:49:00.000Z")

• dateTo som dato/tid i ISO 8601-format (f.eks.: "2023-05-30T06:35:00.000Z")

• operationIds som array av operasjonsidentifikatorer (Strenger)

• statuses som en array med verdier hentet fra ContextEventStatus enum med alle behandlingsstatusser inkludert mellomliggende; det anbefales å bruke nøkkelstatusene [Start, Done, Warning, Error, Ignored]

• subFieldTypes som en array som inneholder verdier av TreeNodeEntity enum med alle GeoPard-enheter

• subFieldUuids som en array med UUID-er knyttet til de valgte enhetene i subFieldTypes

• userUuids som en array med "User" UUID-er å søke etter

Minst ett av følgende filtre må være initialisert: userUuids, fieldUuids, subFieldUuids, eller operationIds.

Hvis dateFrom og dateTo ikke er spesifisert, settes standard spørringsvarighet til 12 timer. Den maksimalt anbefalte tidsperioden for datainnhenting er 24 timer.

Det er en grense på maks 10 000 rader levert.

For å se alle tilgjengelige siste verdier av enum-typer (som: TreeNodeEntity, ContextEventStatus, ContextMessageKey), anbefales det å bruke Altair.

Utdataobjektet inkluderer følgende attributter:

• fieldUuid representerer UUID-en til det tilknyttede feltet

• subFieldUuid angir UUID-en til det tilknyttede behandlede datasettet (som "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" osv.)

• subFieldType som enum knyttet til TreeNodeEntity

• operationId som streng som inneholder identifikatoren til operasjonen; den er konsistent på tvers av alle relaterte behandlingskjeder, det er lurt å gruppere etter denne identifikatoren for å spore alle behandlingsstadier

• status som enum knyttet til ContextEventStatus

• executionDate som streng i ISO 8601-format som angir tidspunktet for utførelsen

• messageKey som enum knyttet til ContextMessageKey som beskriver utfallet av utførelsen

• valgfritt som streng som gir en teknisk beskrivelse (hvis relevant); den brukes primært til feilsøking og feilrapportering