API によるコース/ラーニングモジュールへのSCORMの追加

  • 更新

Learn365では、Learn365 管理センターまたは Learn365 API を通じて、SCORM をコースまたはコースの学習項目に追加することができます。

ここでは、Learn365 API を用いて、SCORM コンテンツパッケージを Postman を通じて コースに追加する方法、Swagger を通じてラーニング モジュールに追加する方法について説明します。

 

コースに SCORM コンテンツパッケージを追加する

 

注記:

コースへのSCORM コンテンツパッケージの追加は、Swagger から実行することはできません。
代わりに、Postman、Power Automate フロー、またはコードからこのリクエストを呼び出す必要があります。
この記事の最後に、次のファイルが添付されています。

  • a Postman collection with a request that attaches a SCORM to a course.
  • a Power Automate flow that attaches a SCORM to a course.

 

Postman を通じて SCORM コンテンツパッケージをコースに追加します。

Postman で以下のHTTPリクエストを実行します。

/odata/v2/Courses(COURSE_ID)/Scorms/$ref

以下をBodyに記述します。

{ \"@odata.id\" :\"https://api.365.systems/odata/v2/Scorms(SCORM_ID)\"}

ここで、「SCORM_ID」はコースに追加する SCORM の ID に置き換えます。

 

注記:

SCORM コンテンツパッケージを Learn365 コースに学習項目として直接追加するためには、正確なコースID、SCORM ID、フルコントロールタイプの Learn365 APIキーが必要です。

 

ラーニング モジュールに SCORM コンテンツパッケージを追加する

Swagger を通じたコース内のラーニングモジュールへの SCORM コンテンツパッケージの追加は、以下の手順に沿って行います。

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

2.LearningModules セクションに移動し、POST /odata/v2/LearningModules  Creates Learning Module を選択し、右上の「Try it out」を選択します。

 

Attach a SCORM to a course or learning module1.png

 

3.パラメータを入力します。

「Edit Value」フィールドで、以下を入力します。

必須のパラメータ情報は以下のエンドポインで取得できます。

 

以下は、必須パラメータです。

  • "CourseId": "guid":「guid」を SCORM コンテンツパッケージ追加するコースの ID に置き換えます。
  • "Title": "string":「string」をSCORM コンテンツパッケージ追加するラーニングモジュールのタイトルに置き換えます。
  • "Configuration":ネストされたプロパティのパラメータを設定します。
    • LearningModuleId  string:「string」をSCORM コンテンツパッケージ追加するラーニングモジュールの IDに置き換えます。
    • Items string  JSON string with array of LM items:「JSON string with array of LM items」を追加するSCORMコンテンツパッケージの情報に置き換えます。
      パラメータを記述する際、 各ダブルクォーテーションの直前にバックスラッシュを追加する必要があります。ご使用の環境によって、バックスラッシュは円記号¥で表示されることがあります。

以下の例では、該当する必須のパラメータを赤色で示しています。
オレンジ色の「SCORM_TITLE」パラメータは任意ですが、SCORMにタイトルを提供するために入力することを推奨します。


{
"CourseId": "COURSE_ID",
"Title": "LEARNING_MODULE_TITLE",
"Description": null,
"Publishing": {
"IsEnabled": true
},
"Order": 0,
"HasPrerequisite": false,
"Configuration": {
"LearningModuleId": "00000000-0000-0000-0000-000000000000",
"Items": "[{\"ScormId\":\"SCORM_ID\",\"ItemType\":2,\"PackageType\":0,\"Id\":\"00000000-0000-0000-0000-000000000000\",\"Title\":\"SCORM_TITLE\",\"IsAvailable\":null,\"IsDeleted\":null}]"
}
}

 

Attach a SCORM to a course or learning module2.png

”Order” パラメータが0の場合、追加された SCORM はコースの学習項目リストの一番上に表示されます。

Learn365 管理センターで学習項目の順序を変更するか、既定値 (0) を適切な整数に変更することで、順位を設定することができます。

 

4.「Execute」を選択してリクエストを実行します。

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

  • Code の下の2xx(202など)は、リクエストが正しく動作したことを示します。
  • Response body には、SCORMが追加されたラーニングモジュールの情報が表示されます。

 

Attach a SCORM to a course or learning module3.png

 

  • ラーニングモジュールに追加されたSCORMは、コースコンテンツパネルに表示されます。

 

Attach a SCORM to a course or learning module4.png