検索

API による学習項目の公開ステータスの変更

  • 更新

Learn365 では、Learn365 管理センターまたは Learn365 API を使用して、ラーニング モジュールやクイズの公開 / 未公開を変更することができます。

Learn365 管理センターでは、ラーニング モジュールやクイズの編集により、公開の構成（開始日、終了日）を設定することができます。

ここでは、Learn365 API を通じて、コースのラーニングモジュール、クイズの公開ステータスを変更する方法について説明します。

注記：

ラーニングモジュールは特定のコースに固有の学習項目であるため、公開ステータスの変更はこのコースのみに適用されます。

クイズの公開ステータスを変更すると、カタログ内でこのクイズを使用するすべてのコースに適用されます。

 

事前準備

ラーニングモジュールとクイズの公開ステータスの変更に必要な情報を取得します。

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

 

ラーニングモジュールの場合：

1．LearningModules セクションに移動し、GET /odata/v2/LearningModules Returns the list of Learning Modules エンドポイントを選択し、右上の「Try it out」をクリックします。

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

  • $expand：フィールドに「Configuration,Publishing」と入力します。

    これにより、レスポンスにテナントのラーニングモジュールの公開設定と、ラーニングモジュール内のアイテムに関するデータを含めます。

必要に応じて、ラーニングモジュールの ID またはタイトルで、レスポンスを絞り込むことができます。以下のパラメータを入力します。

  • $filter： フィールドに 「Id eq item ID」または「Title eq 'item title'」を入力します。
    例：「Id eq 90796418-a6e5-446c-96e5-00733621f771」、「Title eq 'フィッシング認識ガイドライン'」

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

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

  • Code 2xx（200など）は、リクエストが正しく動作したことを示します。
  • Response body には、テナント全体のラーニングモジュールに関する情報が表示されます。
  • Download で結果を.JSONフォーマットで保存し、公開ステータスの変更時にこの情報を引用することができます。

クイズの場合：

1．Quizzes セクションに移動し、GET ​/odata​/v2​/Quizzes Returns the list of Quizzes  を選択し、右上の「Try it out」をクリックします。

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

  • $expand：フィールドに「Courses」と入力します。

    これにより、レスポンスにクイズが使用されているコースの情報が含まれます。

必要に応じて、クイズの ID またはタイトルで、レスポンスを絞り込むことができます。以下のパラメータを入力します。

  • $filter： フィールドに 「Id eq item ID」または「Title eq 'item title'」を入力します。
    例：「Id eq 90796418-a6e5-446c-96e5-00733621f771」、「Title eq 'フィッシング認識ガイドラインテスト'」

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

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

  • Code 2xx（200など）は、リクエストが正しく動作したことを示します。
  • Response body には、テナント全体のクイズに関する情報が表示されます。
  • Download で結果を.JSONフォーマットで保存し、公開ステータスの変更時にこの情報を引用することができます。

 

公開ステータスを更新する

ラーニング モジュール

注記：

ラーニング モジュールの情報の更新に使用する PUT メソッドは、入力された更新情報だけでなく、すべてのラーニング モジュールの情報を更新します。

そのため、パラメータの現在の情報を維持するには、それらをすべて入力する必要があります。

「Edit Value」フィールドで入力されていないパラメータは、null（つまり、元の情報は削除されます）で上書きされますので注意してください。

 

1．LearningModules セクションに移動し、 PUT /odata/v2/LearningModules({Id})  Updates Learning Module エンドポイントを選択し、右上の「Try it out」をクリックします。

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

  • Id＊：「key: Id」フィールドに、公開設定を更新するラーニングモジュールの ID を入力します。
  • learningModule＊：「Edit Value」フィールドで各パラメータを入力します。事前準備でダウンロードした.JSONファイルを引用します。

”IsEnabled” パラメータで公開を設定します。「true」は公開、「false」は未公開です。

 

入力例：

 

{
"Id": "90796418-a6e5-446c-96e5-00733621f771",
"CourseId": "7bb988b8-140a-4ee5-9141-5863868e719f",
"Title": "Phishing awareness guidelines, introduction",
"Description": "In this learning module you will be given an introduction to some of the most common phishing attack types.",
"IsPublished": true,
"Order": 4,
"HasPrerequisite": false,
"Configuration": {
"LearningModuleId": "90796418-a6e5-446c-96e5-00733621f771",
"Items": "[{\"ScormId\":\"0ff0c1db-886c-4ea7-b4d4-883ad86e9956\",\"ItemType\":2,\"PackageType\":0,\"Id\":\"0ff0c1db-886c-4ea7-b4d4-883ad86e9956\",\"Title\":\"Phishing awareness guidelines\",\"IsAvailable\":null,\"IsDeleted\":null}]"
},
"Publishing": {
"Id": "90796418-a6e5-446c-96e5-00733621f771",
"IsEnabled": false,
"StartDate": "2023-02-12T09:40:56Z",
"EndDate": null
}
}

 

update lm request1.png

 

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

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

  • Code 2xx（204など）は、リクエストが正しく動作したことを示します。
  • Learn365管理センター＞トレーニング管理＞コース設定パネルのコンテンツセクションで、該当するラーニングモジュールの公開列（公開：はい／未公開：いいえ）で確認できます。

update lm request2.png

 

クイズ

注記：

クイズの情報の更新に使用する PUT メソッドは、入力された更新情報だけでなく、すべてのクイズの情報を更新します。

そのため、パラメータの現在の情報を維持するには、それらをすべて入力する必要があります。

「Edit Value」フィールドで入力されていないパラメータは、null（つまり、元の情報は削除されます）で上書きされますので注意してください。

クイズの公開ステータスの変更は、そのクイズを含むカタログ内のすべてのコースに適用されます。

 

1．Quizzes セクションに移動し、PUT  /odata/v2/Quizzes({Id})  Updates a Quiz エンドポイントを選択し、右上の「Try it out」をクリックします。

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

  • Id＊：「key: Id」フィールドに、公開設定を更新するクイズの ID を入力します。
  • Quiz＊：「Edit Value」フィールドで各パラメータを入力します。事前準備でダウンロードした.JSONファイルを引用します。

”IsPublished” パラメータで公開を設定します。「true」は公開、「false」は未公開です。

 

入力例：

 

{
"Id": "7bd0e56d-c512-402d-bcf6-7895a5f8fc37",
"Title": "Test yourself",
"Description": null,
"MaxAttemptsLimit": null,
"PassingPercentage": 10,
"IsPublished": false,
"PublishingStartDate": "2021-11-04T13:47:00Z",
"PublishingEndDate": null,
"Randomize": false,
"ShowScore": true,
"ShowCompletionScore": true,
"ShowPoints": false,
"AllowReview": true,
"AllowNavigation": false,
"ShowCorrectAnswers": false,
"ReviewMode": "DoNotShowAnyAnswers",
"TimeLimit": null,
"ShowTimer": false,
"Questions": "[{\"RightAnswer\":false,\"QuestionType\":2,\"Id\":\"bd64d7ec-262f-4d94-a41c-8e49235e3129\",\"Title\":\"Information Security \",\"Description\":\"\\\"You should never copy any content to a learning module - instead, link to the\\nonline content.\\\" - Is that so?\",\"Points\":3,\"PositiveFeedback\":\"That's correct! If\\na learning item is not expected to be updated - as is often the case with\\ndocuments or presentations - you can safely add a copy of that item to the\\nlearning module.\",\"NegativeFeedback\":\"That's incorrect - please try again!\",\"SemiPositiveFeedback\":null,\"Tags\":[]}]",
"ModifiedAt": "2022-08-16T10:43:30.603Z",
"CreatedAt": "2021-11-04T13:48:36.327Z"
}

 

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

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

  • Code 2xx（204など）は、リクエストが正しく動作したことを示します。
  • Learn365管理センター＞コンテンツ＞クイズで、該当するクイズの公開列（公開：はい／未公開：いいえ）で確認できます。