トレーニング所要時間レポートは、Learn365 管理センターまたは API を使用して生成することができます。
レポートに表示する所要時間は、以下のいずれかを選択できます。
- 推定時間（既定）：トレーニング設定パネルの「所要時間（標準形式）」フィールドに設定された値。
- 実際の時間：Learn365 プレイヤー上で表示されるコンテンツの閲覧時間に基づき追跡された、e ラーニング コースの実際の受講時間。Learn365 プレイヤー外で起動または閲覧されたコンテンツの利用時間は追跡されません。
ここでは、API を使用して、トレーニング所要時間レポートを生成する手順について説明します。
トレーニング所要時間レポートの生成 ー 推定時間
注記：推定時間 レポートの留意点
- このレポートには、すでに完了したトレーニングのみ表示されます。
- 表示されるのは、パラメータ「startDate」～「endDate」で指定した期間に完了したトレーニングに限ります。
- ユーザーおよび完了したトレーニングが現在アクティブかどうか（有効・無効）は関係なく、該当するすべてのデータが含まれます。
- このレポートに表示されるのは、「所要時間 (標準形式) 」が設定されているトレーニングのみです。この設定は、Learn365 管理センター＞トレーニング管理＞該当するトレーニングの設定パネルの 基本情報 セクション＞「所要時間 (標準形式) 」 フィールドで確認できます。また、コースの場合、GET odata/v2/Courses リクエストのレスポンスから関連するコースの「DurationInMinutes」でも確認できます。
推定時間のレポートを API 経由で生成するには、対象となるトレーニングが含まれるコースカタログ ID が必要です。
コースカタログ ID は API を使用して取得できます。詳細な手順についてはこちらのドキュメントをご参照ください。
手順：
1．API にアクセスし、認証を行います。
https://api.365.systems/ にアクセスし、適切な API キーで認証されていることを確認してください。
2．エンドポイントを選択します。
Reports セクション で以下のエンドポイントを選択し、右上の［Try it out］をクリックします。
GET /reports/trainingDuration/learnersTrainingDuration
3．「courseCatalogId＊」フィールドに コースカタログ ID を入力しします。
4．「startDate＊」フィールドに、集計の開始日、「endDate＊」フィールドに、集計の終了日を入力します。
入力例：2026-05-15T15:00:00.00Z
時間を省略して、m-d-yyyy（1-15-2024）または m/d/yyyy（1/15/2024）フォーマットで入力することもできます。
※ レポートには、ここで指定期間内に完了したトレーニングだけが含まれます。
5．［Execute］をクリックしてリクエストを実行します。
6．「Responses」ブロックで結果を確認します。
- ステータスコード 200 が返され、レスポンス本文に受講者とトレーニングデータの一覧が表示された場合は成功です。
- ステータスコード 200 で、レスポンス本文が空の場合は、表示できるデータが存在しないことを示します。リクエストのパラメータ（例：日付範囲を広げるなど）を変更して再実行できます。
- エラーが発生した場合は、レスポンス本文にエラーオブジェクトが含まれます。このオブジェクトには、エラー内容を示す code と message が含まれており、問題の原因を確認できます。
成功したレスポンスには、受講者ごとに次の情報が表示されます。
- LearnerName：受講者のフルネーム
- Email：受講者のEメールアドレス
- Department：受講者が所属する部署
- TotalDuration：受講者に関するレポート内のすべてのトレーニングの合計時間（分）
-
CourseInfo 配列：指定された期間内に受講者が完了したすべてのトレーニングが含まれ、各コースまたはトレーニングプランの詳細情報が含まれています。
- CourseCatalogName：カタログ名
- CourseName：受講者が完了したトレーニングの名前
- CourseCategory：トレーニングのカテゴリー
- CourseDuration：所要時間（分）。これは、コース / トレーニングプラン設定パネルの「所要時間（標準形式）」フィールドの値です。レポートには、受講者がトレーニングに登録した時点で設定されていた値が表示されます。
- CompletionDate：受講者がトレーニングを完了した日時
トレーニング所要時間レポートの生成 ー 実際の時間
注記：実際の時間 レポートの留意点
- 実際の時間は、Learn365 管理センター＞グローバル設定＞ LMS 設定＞詳細設定で、「リアルタイム追跡を使用する」オプションが有効になっている場合に追跡できます。
- このレポートには、すでに完了したトレーニングのみ表示されます。
実際の時間のレポートを API 経由で生成するには、対象となるユーザーの登録 ID が必要です。
登録 ID は API を使用して取得できます。詳細な手順については、こちらのドキュメントをご参照ください。
手順：
1．API にアクセスし、認証を行います。
https://api.365.systems/ にアクセスし、適切な API キーで認証されていることを確認してください。
2．エンドポイントを選択します。
Reports セクション で以下のエンドポイントを選択し、右上の［Try it out］をクリックします。
3．「enrollmentId＊」フィールドに、対象のトレーニングにおけるユーザーの 登録 ID を入力しします。同じトレーニングでユーザーに複数の登録がある場合は、レポートの対象となる 登録 ID を入力します。
4．［Execute］をクリックしてリクエストを実行します。
5．「Responses」ブロックで結果を確認します。
- ステータスコード 200 が返され、レスポンス本文に学習セッションとその所要時間が表示された場合は成功です。
- ステータスコード 404 エラーが返された場合は、指定した登録 ID に対して表示できるデータが存在しないことを示します。
- エラーが発生した場合は、レスポンス本文にエラーオブジェクトが含まれます。このオブジェクトには、エラー内容を示す code と message が含まれており、問題の原因を確認できます。
成功したレスポンスには、以下の情報が表示されます。
- UserName：受講者のユーザー名
- CourseId：コース ID
- CourseName：コース名
- CourseStatus：Completed（完了）
- RealDurationMinutes：受講者が学習セッションに費やした実際の時間（分）。
- StartDateTime：受講者が学習セッションを開始した日時。
- EndDateTime：受講者 Learn365 プレイヤーを離れた日時、またはコースを完了した日時。