83. Forespørgsel: Indsaml platformkontekst

Ved et stort antal (hundreder eller tusinder) behandlede datasæt (som "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" osv.) er der altid behov for at forstå status for behandlingen af hvert datasæt og indsamle en behandlingsopsummering. Disse oplysninger leveres ved hjælp af getPlatformContext forespørgsel.

De almindelige tilfælde:

• Spor behandlingsfremskridt

• Indsaml behandlingsopsummering og statistikker

• Observer fejl og advarsler under behandlingen for yderligere dybere undersøgelse af berørte datasæt

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

Understøttede inputfiltre:

• 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 af operationens identifikatorer (Strenge)

• statuses som array der indeholder værdier fra ContextEventStatus enum med alle behandlingsstatusser inklusive mellemliggende; det anbefales at bruge hovednøgleværdierne [Start, Done, Warning, Error, Ignored]

• subFieldTypes som array der indeholdt værdier af TreeNodeEntity enum med alle GeoPard-enheder

• subFieldUuids som array med UUID’er knyttet til de valgte enheder i subFieldTypes

• userUuids som array af "User" UUID’er til søgning

Mindst ét af følgende filtre skal være initialiseret: userUuids, fieldUuids, subFieldUuids, eller operationIds.

Hvis dateFrom og dateTo ikke er angivet, er standardforespørgselsperioden sat til 12 timer. Den maksimalt anbefalede tidsperiode for dataudtræk er 24 timer.

Der er en grænse på maks. 10.000 leverede rækker.

For at se alle tilgængelige seneste værdier af enums (som: TreeNodeEntity, ContextEventStatus, ContextMessageKey), anbefales det at bruge Altair.

Output-objektet indeholder følgende attributter:

• fieldUuid repræsenterer UUID’en for den tilknyttede mark (Field)

• subFieldUuid angiver UUID’en for det tilknyttede behandlede datasæt (som "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" osv.)

• subFieldType som enum knyttet til TreeNodeEntity

• operationId som streng, der indeholder operationens identifikator; den forbliver konsistent på tværs af alle relaterede behandlingskæder, og det anbefales at gruppere efter denne identifikator for at spore alle behandlingsstadier

• status som enum knyttet til ContextEventStatus

• executionDate som streng i ISO 8601-format, der angiver tidspunktet for udførelsen

• messageKey som enum knyttet til ContextMessageKey der beskriver resultatet af udførelsen

• valgfri som streng, der giver en teknisk beskrivelse (hvis relevant); den bruges primært til fejlsøgning og fejlrapportering