83. Query: verzamel platformcontext

Bij een groot aantal (honderden of duizenden) verwerkte datasets (zoals "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", enz.) bestaat er altijd een behoefte om de verwerkingsstatus van elke dataset te begrijpen en een verwerkingssamenvatting te verzamelen. Deze details worden geleverd met behulp van getPlatformContext query.

De veelvoorkomende gevallen:

• Het volgen van de voortgang van de verwerking

• Verzamelen van verwerkingssamenvatting en statistieken

• Observeren van fouten en waarschuwingen tijdens verwerking voor verdere diepgaandere onderzoek van getroffen datasets

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

Ondersteunde invoerfilters:

• dateFrom als datetime in ISO 8601-formaat (bijv.: "2023-05-25T12:49:00.000Z")

• dateTo als datetime in ISO 8601-formaat (bijv.: "2023-05-30T06:35:00.000Z")

• operationIds als array van de operatie-identificatoren (Strings)

• statuses als array met waarden afkomstig van ContextEventStatus enum met alle verwerkingsstatussen inclusief tussenliggende; het is aan te raden de belangrijkste sleutels te gebruiken [Start, Done, Warning, Error, Ignored]

• subFieldTypes als array met waarden van TreeNodeEntity enum met alle GeoPard-entiteiten

• subFieldUuids als array met UUID's gekoppeld aan de geselecteerde entiteiten in subFieldTypes

• userUuids als array van "User" UUID's om te doorzoeken

Ten minste één van de volgende filters moet worden ingesteld: userUuids, fieldUuids, subFieldUuids, of operationIds.

Als dateFrom en dateTo niet zijn opgegeven, wordt de standaard queryduur ingesteld op 12 uur. De maximaal aanbevolen tijdspanne voor gegevensopvraging is 24 uur.

Er is een limiet van maximaal 10.000 geleverde rijen.

Om alle beschikbare nieuwste waarden van enums te bekijken (zoals: TreeNodeEntity, ContextEventStatus, ContextMessageKey), wordt aanbevolen om Altair.

Het uitvoerobject bevat de volgende attributen:

• fieldUuid vertegenwoordigt de UUID van het gekoppelde perceel (Field)

• subFieldUuid duidt de UUID aan van de gekoppelde verwerkte dataset (zoals "SatelliteImage", "AsAppliedDataset", "YieldDataset", "SoilDataset", enz.)

• subFieldType als enum gekoppeld aan de TreeNodeEntity

• operationId als string die de identificator van de operatie bevat; deze blijft consistent in alle gerelateerde verwerkingsketens. Het is aan te raden te groeperen op deze identificator om alle verwerkingsstadia te traceren

• status als enum gekoppeld aan ContextEventStatus

• executionDate als string in ISO 8601-formaat die het moment van uitvoering aangeeft

• messageKey als enum gekoppeld aan ContextMessageKey dat het resultaat van de uitvoering beschrijft

• optioneel als string die een technische beschrijving geeft (indien relevant); het wordt voornamelijk gebruikt voor debugging en foutmelding