83. Forespørsel: Samle 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

circle-info

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

circle-info

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

circle-info

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

circle-info

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

Sist oppdatert

Var dette nyttig?