83. Abfrage: Plattformkontext erfassen

Bei einer großen Anzahl (Hunderte oder Tausende) verarbeiteter Datensätze (wie „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ usw.) besteht stets Bedarf, den Verarbeitungsstatus jedes Datensatzes nachzuvollziehen und eine Zusammenfassung der Verarbeitung zu sammeln. Diese Details werden bereitgestellt mithilfe getPlatformContext Abfrage.

Die typischen Anwendungsfälle:

• Verfolgung des Verarbeitungsfortschritts

• Erfassung von Verarbeitungszusammenfassungen und Statistiken

• Beobachtung von Fehlern und Warnungen während der Verarbeitung zur weitergehenden Untersuchung betroffener Datensätze

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

Unterstützte Eingabe-Filter:

• dateFrom als Datum/Uhrzeit im ISO-8601-Format (z. B.: "2023-05-25T12:49:00.000Z")

• dateTo als Datum/Uhrzeit im ISO-8601-Format (z. B.: "2023-05-30T06:35:00.000Z")

• operationIds als Array mit Operationserkennungen (Strings)

• statuses als Array mit Werten aus ContextEventStatus Enum mit allen Verarbeitungsstatus einschließlich Zwischenzuständen; empfohlen wird die Verwendung der Schlüsselwerte [Start, Done, Warning, Error, Ignored]

• subFieldTypes als Array mit Werten von TreeNodeEntity Enum mit allen GeoPard-Entitäten

• subFieldUuids als Array mit UUIDs, die mit den ausgewählten Entitäten in Verbindung stehen subFieldTypes

• userUuids als Array von „User“-UUIDs zur Suche

Mindestens einer der folgenden Filter muss gesetzt werden: userUuids, fieldUuids, subFieldUuids, oder operationIds.

Wenn dateFrom und dateTo nicht angegeben sind, wird die Standardabfrage-Dauer auf 12 Stunden gesetzt. Die maximal empfohlene Zeitspanne für die Datenabfrage beträgt 24 Stunden.

Es gibt ein Limit von maximal 10.000 gelieferten Zeilen.

Um alle verfügbaren aktuellen Werte von Enums zu sehen (z. B.: TreeNodeEntity, ContextEventStatus, ContextMessageKey), wird empfohlen, Altair.

Das Ausgabeobjekt enthält die folgenden Attribute:

• fieldUuid steht für die UUID des zugehörigen Feldes

• subFieldUuid bezeichnet die UUID des verknüpften verarbeiteten Datensatzes (z. B. „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ usw.)

• subFieldType als Enum verknüpft mit dem TreeNodeEntity

• operationId als Zeichenfolge, die die Kennung der Operation enthält; sie bleibt in allen zugehörigen Verarbeitungsabläufen konsistent. Es ist ratsam, nach dieser Kennung zu gruppieren, um alle Verarbeitungsstufen nachzuverfolgen

• status als Enum verknüpft mit ContextEventStatus

• executionDate als Zeichenfolge im ISO-8601-Format, die den Ausführungszeitpunkt angibt

• messageKey als Enum verknüpft mit ContextMessageKey das das Ergebnis der Ausführung beschreibt

• optional als Zeichenfolge, die eine technische Beschreibung liefert (falls relevant); sie dient in erster Linie zum Debugging und zur Fehlerberichterstattung