> For the complete documentation index, see [llms.txt](https://docs.geopard.tech/geopard-tutorials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geopard.tech/geopard-tutorials/de/api-dokumentation/geopard-api-requests-overview/83.-query-collect-platform-context.md).

# 83. Abfrage: Plattformkontext erfassen

Bei einer großen Anzahl verarbeiteter Datensätze (Hunderte oder Tausende), etwa „SatelliteImage“, „AsAppliedDataset“, „YieldDataset“, „SoilDataset“ usw., besteht immer der Bedarf, den Verarbeitungsstatus jedes Datensatzes nachzuvollziehen und eine Verarbeitungsübersicht zu erfassen. Diese Details werden über die `getPlatformContext` -Abfrage bereitgestellt.

Häufige Anwendungsfälle:

* Verarbeitungsfortschritt nachverfolgen
* Verarbeitungsübersicht und Statistiken erfassen
* Fehler und Warnungen während der Verarbeitung beobachten, um betroffene Datensätze genauer zu untersuchen

{% 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 Eingabefilter:

* `dateFrom` als Datum und Uhrzeit im ISO-8601-Format (z. B.: `"2023-05-25T12:49:00.000Z"`)
* `dateTo` als Datum und Uhrzeit im ISO-8601-Format (z. B.: `"2023-05-30T06:35:00.000Z"`)
* `operationIds` als Array mit den Bezeichnern der Vorgänge (`Strings`)
* `statuses` als Array mit Werten aus `ContextEventStatus` Enum mit allen Verarbeitungsstatus, einschließlich Zwischenstatus; empfohlen wird die Verwendung der wichtigsten Status `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` als Array mit Werten aus dem `TreeNodeEntity` Enum mit allen GeoPard-Entitäten
* `subFieldUuids` als Array mit UUIDs, die den ausgewählten Entitäten in `subFieldTypes`
* `userUuids` als Array mit UUIDs von „User“, nach denen gesucht werden soll

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

{% hint style="info" %}
Wenn `dateFrom` und `dateTo` nicht angegeben sind, beträgt der Standardzeitraum der Abfrage 12 Stunden. Der maximal empfohlene Zeitraum für den Datenabruf beträgt 24 Stunden.
{% endhint %}

{% hint style="info" %}
Die Anzahl der gelieferten Zeilen ist auf maximal 10.000 begrenzt.
{% endhint %}

{% hint style="info" %}
Um alle verfügbaren aktuellen Enum-Werte zu ermitteln (wie z. B.: `TreeNodeEntity`, `ContextEventStatus, ContextMessageKey`), wird die Verwendung von [Altair](https://docs.geopard.tech/geopard-tutorials/de/api-dokumentation/getting-started-with-the-geopard-api.md).
{% endhint %}

Das Ausgabeobjekt umfasst 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 `TreeNodeEntity`
* `operationId` als Zeichenfolge, die den Bezeichner des Vorgangs enthält. Dieser bleibt über alle zugehörigen Verarbeitungsketten hinweg gleich. Es empfiehlt sich, nach diesem Bezeichner 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` und das Ausführungsergebnis beschreibt
* `optional` als Zeichenfolge mit einer technischen Beschreibung (falls relevant), die hauptsächlich zum Debugging und zur Fehlerberichterstattung dient


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.geopard.tech/geopard-tutorials/de/api-dokumentation/geopard-api-requests-overview/83.-query-collect-platform-context.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
