検索

【API】 ユーザーの SCORM の進捗を完了にする

  • 更新

Learn365 では、Learn365 管理センターまたは Learn365 API を通じて、SCORM コンテンツ パッケージの進捗を変更（未開始、進行中 から「完了」）することができます。

ここでは、API を通じて SCORM コンテンツ パッケージの進捗を完了にする方法について説明します。

 

事前準備

SCORM コンテンツ パッケージの進捗を完了にするには、ユーザーの ID、ユーザーの登録 ID、その SCORM コンテンツパッケージの ID を取得する必要があります。

これらは、以下の方法で取得します。

1．https://api.365.systems/  にアクセスし、API キーで認証します。

2．Courses セクションに移動し、GET /odata/v2/Courses Returns the list of Courses エンドポイントを選択し、右上の［Try it out］をクリックします。

3．クエリ オプション パラメータを入力します。

  • $expand：フィールドに「Enrollments, Scorms」と入力します。これにより、レスポンスにコース内のユーザーの登録と、SCORM に関する情報を含めることができます。

4．［Execute］を選択してリクエストを実行します。

5．Responses ブロックで結果を確認します。

  • Code 2xx（200など）は、リクエストが正しく動作したことを示します。
  • Response body には、SCORM と、登録されているユーザーの情報を含むテナントのすべてのコースがリストされます。
  • Download で結果を .JSON フォーマットで保存してこの情報を引用することができます。

6．SCORM の ID は、”Scorms " 配列内の "Id"  パラメーター値から取得します。

Complete SCORM API-1.png

 

7．ユーザーの ID とユーザーの登録 ID は、”Enrollments " 配列内の "UserId” と "Id" パラメーター値から取得します。

Complete SCORM API-2.png

 

SCORM コンテンツ パッケージを完了にする

必要な情報が取得できたら、リクエストを実行して当該ユーザーの関連するSCORM コンテンツ パッケージの進捗を完了にすることができます。

1．ScormAttempts セクションに移動し、POST method /odata/v2/ScormAttempts Creates new scorm attempt エンドポイントを選択し、右上の［Try it out］をクリックします。

2．パラメータを入力します。

  • ScormAttempt＊：「Edit Value」フィールドに、次のパラメータを入力します。
    • "Id": "guid"＊：必須のパラメータ。「guid」をユーザー ID に置き換えます。
    • "ScormId": "guid"＊：必須のパラメータ。「guid」をSCORM ID に置き換えます。
    • "EnrollmentId": "guid"＊：必須のパラメータ。「guid」をユーザの登録 ID に置き換えます。
    • "CompletionStatus": "boolean"＊：必須のパラメータ。「boolean」を true に置き換えて、SCORM を完了として設定します。
    • "SuccessStatus": "boolean"＊：必須のパラメータ。「boolean」を true に置き換えて、SCORM は正常に完了したとして設定します。
    • "Points": "integer"：省略可能なパラメータ。「integer」をユーザーに付与するポイント（整数）に置き換えます。これは、コンテンツパッケージの受講者の詳細の「スコア」に表示されます。
    • "Scale": "number"：任意のパラメータ。SCORM の最終スコアです。「number」を正の小数点以下（0.89 など）に置き換えると、Learn365 はこれに 100 を掛けてパーセンテージに変換します（0.89 は 89% になります）。これは、受講者の進捗ダッシュボードの「スコア」列と、コンテンツパッケージの受講者の詳細の「スケール」列に表示されます。
    • "Progress": "number"：任意のパラメータ。このパラメータは SCORM1.2 ではサポートされていません。「number」を関連するステータスインジケータに置き換えます。進捗は受講者の進捗ダッシュボードの進捗列にパーセンテージで表示されます。
      • 未開始：1
      • 失敗：2
      • 進行中：3
      • 合格：4
    • "AlternateProgress": "number"：任意のパラメータ。このパラメータは SCORMにSCOのみが存在する場合に使用します。「number」を SCORM 内の SCO 数を表す整数に置き換えます。進捗はユーザの進捗ダッシュボードの進捗欄にパーセンテージで表示されます。
    • "Version": "integer"：任意のパラメータ。「integer」を、ユーザーが完了したとして設定するコンテンツパッケージに対応するバージョンの整数に置き換えます。
    • "StateDetails": {}：任意のパラメータ。ユーザーの試行の詳細を設定することができます。
    • "CreatedAt": "2025-07-10T05:03:17.0000000+00:00"：任意のパラメータ。既定では現在の日付と時刻が入力されています。任意の日時にします。
    • "ModifiedAt": "2025-07-10T05:03:17.0000000+00:00"：任意のパラメータ。既定では現在の日付と時刻が入力されています。任意の日時にします。

入力例：

 

{
"Id": "97ff2327-88f4-43c9-b2ec-ccf458cdd211",
"ScormId": "591a8597-ad46-4b49-8340-fe10c41e2c69",
"EnrollmentId": "c5b0f183-21df-4523-b088-0881d0db1797",
"CompletionStatus": "true",
"SuccessStatus": "true",
"Points": "3",
"Progress": "4",
"Version": "1",
"CreatedAt": "2023-03-10T11:57:06Z",
"ModifiedAt": "2023-03-10T11:57:06Z"
}

 

Complete SCORM API-3.png

 

3．［Execute］を選択してリクエストを実行します。

4．Responses ブロックで結果を確認します。

  • Code 2xx（200など）は、リクエストが正しく動作したことを示します。
  • Response body には、ユーザーの SCORM の完了に関する情報が表示されます。

Complete SCORM API-4.png

 

更新された情報は、Learn365 管理センターで関連するコース、またはユーザー ページで関連するユーザーの「受講の進捗を閲覧」で確認できます。