83. Kysely: Kerää alustan konteksti

Suurille määrille (satoja tai tuhansia) käsiteltyjä aineistoja (kuten "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" jne.) on aina tarve ymmärtää jokaisen aineiston käsittelyn tila ja kerätä käsittelyn yhteenveto. Nämä tiedot tarjotaan käyttämällä getPlatformContext kysely.

Yleiset tapaukset:

• Seurata käsittelyprosessin etenemistä

• Kerätä käsittelyn yhteenveto ja tilastot

• Havainnoida virheitä ja varoituksia käsittelyn aikana jatkotutkimusta varten vaikutuksille altistuneissa aineistoissa

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

Tuetut syötteen suodattimet:

• dateFrom datetime-muodossa ISO 8601 -standardin mukaisesti (esim.: "2023-05-25T12:49:00.000Z")

• dateTo datetime-muodossa ISO 8601 -standardin mukaisesti (esim.: "2023-05-30T06:35:00.000Z")

• operationIds operaatioiden tunnisteiden taulukossa (Merkkijonot)

• statuses taulukkona, joka sisältää arvoja seuraavasta ContextEventStatus enum, joka sisältää kaikki käsittelytilat mukaan lukien välivaiheet; suositellaan käyttää avaintiloja [Start, Done, Warning, Error, Ignored]

• subFieldTypes taulukkona, joka sisältää arvoja TreeNodeEntity enum, joka sisältää kaikki GeoPard-entiteetit

• subFieldUuids taulukkona, jossa on UUID:ita valittuihin entiteetteihin linkitettynä subFieldTypes

• userUuids taulukkona haettavien "User"-käyttäjien UUID:eista

Vähintään yhden seuraavista suodattimista on oltava määritelty: userUuids, fieldUuids, subFieldUuids, tai operationIds.

Jos dateFrom ja dateTo ei ole määritelty, oletuskyselyn aikaväliksi asetetaan 12 tuntia. Suositeltu enimmäisaika tietojen noutoon on 24 tuntia.

Toimitettujen rivien määrälle on enimmäisraja 10 000 riviä.

Kaikkien käytettävissä olevien enum-arvojen (kuten: TreeNodeEntity, ContextEventStatus, ContextMessageKey), näkemiseksi suositellaan käyttää Altair.

Tulosteen objekti sisältää seuraavat attribuutit:

• fieldUuid edustaa siihen liittyvän lohkon (Field) UUID:ia

• subFieldUuid merkitsee linkitetyn käsitellyn aineiston UUID:ia (kuten "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset" jne.)

• subFieldType enumina linkitettynä TreeNodeEntity

• operationId merkkijonona, joka sisältää operaation tunnisteen; se pysyy yhtenäisenä kaikissa liittyvissä käsittelyketjuissa, ja on suositeltavaa ryhmitellä tämän tunnisteen mukaan seuratakseen kaikkia käsittelyvaiheita

• status enumina linkitettynä ContextEventStatus

• executionDate merkkijonona ISO 8601 -muodossa, joka ilmaisee suoritushetken

• messageKey enumina linkitettynä ContextMessageKey joka kuvaa suorituksen lopputulosta

• optional merkkijonona, joka antaa teknisen kuvauksen (jos relevantti); sitä käytetään ensisijaisesti virheenkorjaukseen ja bugiraportointiin