Quest GraphQL API 非推奨のお知らせ

改善された Quest レポートシステム (レポートV2そしてfindQuests (クエスト検索)).これらの変更により、Quest データの取得が合理化され、複数の Quest 選択のサポートが強化されます。

• 非推奨の項目
• 移行ガイド
• 主な違い
• 下位互換性
• 必要なアクション

非推奨の項目

• 地位：廃止
• 交換：使うfindQuests (クエスト検索)や reportV2その代わりに
• 理由：複数のクエストの同時クエリをサポートする、より効率的な実装に置き換えられます
   

• 地位：廃止
• 交換：使う reportV2その代わりに
• 理由：新しい reportV2強化されたフィルタリング機能とより優れたデータ集約を提供します

• 交換：使うquestSourceIds: [String!]!(複数形)QuestFilterInputV22
• 手記：新しいフィールドでは複数の Quest ID が受け入れられ、複数の Quest レポートが可能になります
   

• 交換：何一つ-reportV2常に最新の Quest リビジョンのデータが返されます。
• 手記：リビジョンの追跡が自動的に処理されるようになりました
   

• 交換：のフィルタリングオプションを使用するreportV2
• 手記：タグによるフィルタリングは引き続きサポートされますが、新しい入力構造体を使用します
   

• 交換：のフィルタリングオプションを使用するreportV2
• 手記：チームによるフィルター処理は引き続きサポートされますが、新しい入力構造を使用して

• details: QuestDetails!!→ 用途reportV2.quests
• objectiveCompletion(...)→ 用途レポートV2.objectiveCompletion
• objectiveAccuracy(...)→ 用途reportV2.objectiveAccuracy
• securityConceptObjectiveCompletion(...)→ 用途レポートV2.securityConceptObjectiveCompletion
• learners: QuestLearners→ 用途 reportV2.learners

移行ガイド

変更前 (非推奨 - シングルクエスト)
 

query {
  quests {
    report(filter: {
      questSourceId: "quest-123"
      questRevisionNumber: 5
      tags: ["engineering"]
      teamIds: ["team-1", "team-2"]
    }) {
      details {
        name
        status
      }
      objectiveCompletion(first: 10) {
        edges {
          node {
            category
            completionRate
          }
        }
      }
      learners {
        objectiveAssignedLearners(first: 20) {
          edges {
            node {
              name
              email
            }
          }
        }
      }
    }
  }
}

query {
  quests {
    reportV2(filter: {
      questSourceIds: ["quest-123", "quest-456"]
      tags: ["engineering"]
      teamIds: ["team-1", "team-2"]
    }) {
      quests {
        edges {
          node {
            name
            status
          }
        }
      }
      objectiveCompletion(first: 10) {
        edges {
          node {
            category
            allLearnersCompletedRate
          }
        }
      }
      learners {
        objectiveAssignedLearners(first: 20) {
          edges {
            node {
              name
              email
            }
          }
        }
      }
    }
  }
}
}

主な違い
 

1. 複数のクエスト: レポートV2複数のQuest IDを受け入れます。questSourceIds(複数形)
2. 自動最新リビジョン:指定する必要はありませんクエストリビジョン番号- 常に最新のリビジョンが使用されます
3. 拡張フィールド:一部の補完フィールドの名前が変更されました (例:完了率→allLearnersCompletedRate(すべて学習者完了率))
4. フィルタリング：タグとチームのフィルタリングは、レポートV2

下位互換性

非推奨のフィールドと型は、2025年11月1日.ただし、レポートV2そしてfindQuests (クエスト検索)できるだけ早く:
 

• 複数のQuestレポートを活用する
• 非推奨日以降もサービスが中断されないようにする
• パフォーマンスとデータ精度の向上によるメリット

必要なアクション

• findQuests (クエスト検索)クエストの詳細を取得するため
• レポートV2でクエストフィルター入力V2Questレポートデータの場合