# 83. クエリ: プラットフォームコンテキストを収集

大量（数百または数千）の処理済みデータセット（「SatelliteImage」「AsAppliedDataset」「YieldDataset」「SoilDataset」など）において、各データセットの処理状況を把握し処理サマリーを収集する需要が常にあります。これらの詳細は次を使用して提供されます `getPlatformContext` query。 

一般的なケース： 

* 処理の進捗を追跡する
* 処理のサマリーと統計を収集する
* 影響を受けたデータセットのさらなる詳細調査のために、処理中のエラーや警告を観察する

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

サポートされる入力フィルター：

* `dateFrom` ISO 8601形式の日時として（例： `"2023-05-25T12:49:00.000Z"`)
* `dateTo` ISO 8601形式の日時として（例： `"2023-05-30T06:35:00.000Z"`)
* `operationIds` 操作識別子の配列として（`文字列`)
* `statuses` 次の値を含む配列として `ContextEventStatus` 中間を含むすべての処理ステータスを持つ列挙型で、主要なキーを使用することが推奨されます `[Start, Done, Warning, Error, Ignored]`
* `subFieldTypes` 次の値を持つ配列として `TreeNodeEntity` GeoPardのすべてのエンティティを含む列挙型
* `subFieldUuids` 選択されたエンティティにリンクされたUUIDの配列として `subFieldTypes`&#x20;
* `userUuids` 検索する「User」UUIDの配列として

{% hint style="info" %}
次のフィルターの少なくともいずれかが初期化されている必要があります： `userUuids`, `fieldUuids`, `subFieldUuids`, または `operationIds`.
{% endhint %}

{% hint style="info" %}
もし `dateFrom` と `dateTo` が指定されていない場合、デフォルトのクエリ期間は12時間に設定されます。データ取得に推奨される最大の時間範囲は24時間です。
{% endhint %}

{% hint style="info" %}
提供される行数は最大10,000行に制限されています。
{% endhint %}

{% hint style="info" %}
enumの最新の利用可能な値すべて（例： `TreeNodeEntity`,  `ContextEventStatus、ContextMessageKey`)を確認するには、次を使用することを推奨します [Altair](/geopard-tutorials/jpn/apidokyumento/geopard-apinohajimeni.md).
{% endhint %}

出力オブジェクトには以下の属性が含まれます：

* `fieldUuid` 関連するFieldのUUIDを表します
* `subFieldUuid` リンクされた処理済みデータセットのUUIDを示します（例：「SatelliteImage」「AsAppliedDataset」「YieldDataset」「SoilDataset」など）
* `subFieldType` にリンクされた列挙型として `TreeNodeEntity`
* `operationId` 操作の識別子を保持する文字列として、関連するすべての処理チェーンで一貫性があり、この識別子でグループ化してすべての処理段階を追跡することが推奨されます
* `status` にリンクされた列挙型として `ContextEventStatus`
* `executionDate` 実行の時点を示すISO 8601形式の文字列として
* `messageKey` にリンクされた列挙型として `ContextMessageKey` 実行の結果を説明するもの
* `optional` 技術的な説明を提供する文字列として（該当する場合）、主にデバッグやバグ報告に使用されます


---

# 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/jpn/apidokyumento/geopard-apirikuesuto/83-kueri-purattofmukontekisutowo.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.