# 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

{% code overflow="wrap" lineNumbers="true" %}

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

{% endcode %}

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`&#x20;
* `userUuids` als Array von „User“-UUIDs zur Suche

{% hint style="info" %}
Mindestens einer der folgenden Filter muss gesetzt werden: `userUuids`, `fieldUuids`, `subFieldUuids`, oder `operationIds`.
{% endhint %}

{% hint style="info" %}
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.
{% endhint %}

{% hint style="info" %}
Es gibt ein Limit von maximal 10.000 gelieferten Zeilen.
{% endhint %}

{% hint style="info" %}
Um alle verfügbaren aktuellen Werte von Enums zu sehen (z. B.: `TreeNodeEntity`,  `ContextEventStatus, ContextMessageKey`), wird empfohlen, [Altair](/geopard-tutorials/de/api-dokumentation/erste-schritte-mit-der-geopard-api.md).
{% endhint %}

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.geopard.tech/geopard-tutorials/de/api-dokumentation/uberblick-uber-geopard-api-anfragen/83.-abfrage-plattformkontext-erfassen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.