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

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

一般的なケース：

• 処理の進捗を追跡する

• 処理のサマリーと統計を収集する

• 影響を受けたデータセットのさらなる詳細調査のために、処理中のエラーや警告を観察する

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

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

• 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

• userUuids 検索する「User」UUIDの配列として

次のフィルターの少なくともいずれかが初期化されている必要があります： userUuids, fieldUuids, subFieldUuids, または operationIds.

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

提供される行数は最大10,000行に制限されています。

enumの最新の利用可能な値すべて（例： TreeNodeEntity, ContextEventStatus、ContextMessageKey)を確認するには、次を使用することを推奨します Altair.

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

• fieldUuid 関連するFieldのUUIDを表します

• subFieldUuid リンクされた処理済みデータセットのUUIDを示します（例：「SatelliteImage」「AsAppliedDataset」「YieldDataset」「SoilDataset」など）

• subFieldType にリンクされた列挙型として TreeNodeEntity

• operationId 操作の識別子を保持する文字列として、関連するすべての処理チェーンで一貫性があり、この識別子でグループ化してすべての処理段階を追跡することが推奨されます

• status にリンクされた列挙型として ContextEventStatus

• executionDate 実行の時点を示すISO 8601形式の文字列として

• messageKey にリンクされた列挙型として ContextMessageKey 実行の結果を説明するもの

• optional 技術的な説明を提供する文字列として（該当する場合）、主にデバッグやバグ報告に使用されます