Learn365 管理センター、または Learn365 API のエンドポイントを直接利用して、コースまたはコース内の学習項目に SCORM コンテンツパッケージを追加することができます。
ここでは、Learn365 の API を利用して、Postman からコースに SCORM コンテンツパッケージを追加する方法、および Swagger からラーニング モジュールにSCORM を追加する方法について説明します。
コースに 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 コンテンツパッケージを追加する
コース内のラーニングモジュールに SCORM コンテンツパッケージを追加するには、Swagger で以下の手順に沿って行います。
1．https://api.365.systems/ にアクセスし、API キーで認証します。
2．LearningModules セクションに移動し、POST /odata/v2/LearningModules Creates Learning Module を選択し、右上の［Try it out］をクリックします。
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コンテンツパッケージの情報に置き換えます。
パラメータを記述する際、 各ダブルクォーテーションの直前にバックスラッシュを追加する必要があります。ご使用の環境によって、バックスラッシュは円記号¥で表示されることがあります。
必須のパラメータ情報は、以下のエンドポインで取得できます。
- CourseId：GET /odata/v2/Courses Returns the list of Courses.
- Title，LearningModuleId：GET /odata/v2/LearningModules Returns the list of Learning Modules
- SCORM_ID．Id：GET /odata/v2/Scorms Returns the list of Scorms
この例では、該当する必須のパラメータを赤色で示しています。
オレンジ色の「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}]"
}
}
参考 💡
”Order” パラメータが ”0” の場合、追加された SCORM はコースの学習項目リストの一番上に表示されます。
Learn365 管理センターで学習項目の順序を変更するか、既定値 (0) を適切な整数に変更することで、順位を設定することができます。
4．［Execute］を選択してリクエストを実行します。
5．Responses ブロックで結果を確認します。
- Code の下の2xx（202など）は、リクエストが正しく動作したことを示します。
- Response body には、SCORMが追加されたラーニングモジュールの情報が表示されます。
- ラーニングモジュールに追加されたSCORMは、コースコンテンツパネルに表示されます。