LMS365では、LMS365 管理センターまたは LMS365 API を使用して、ユーザーの外部トレーニングの記録をインポートすることができます。

LMS365 API を使用した外部トレーニングの記録のインポートは、３つのステップで行います。

ここでは、その方法をステップの順にご説明します。

Step1_外部トレーニング（コース）をインポートする

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

２．ExternalTrainings セクションを展開し、POST  /externalTrainings/importCourse with the Import course を選択し、開いた画面で右上の「Try it out」を選択します。 

３．パラメータを設定します。

• "CourseCatalogId":"guid"：このパラメータは必須です。"guid" を外部のトレーニング（コース）をインポートするカタログのIDに置き換えます。
  
  
• "Title":"string" ：このパラメータは必須です。"string"を次のいずれかに置き換えます。
  
  
  • •  LMS365に作成されていないトレーニング（コース）の場合は、トレーニングのタイトル。
    • トレーニング記録を、既存のLMS365のコースにインポートする場合は該当するコースのID。
      
• "Categories": []：このパラメータは任意です。外部のトレーニング（コース）のカテゴリを指定します。
  カテゴリを指定するには [ ] 内にカテゴリのIDと、カテゴリ名を入力します。カテゴリのIDと名前を取得する方法については「APIでコースカタログからカテゴリを削除する」の手順1、2をご参照ください。
  
  
• "CourseType": "integer"：このパラメータは任意です。外部のトレーニング（コース）のタイプを次のいずれかで設定します。
  
  
  • • 1： eラーニング
    • 3：インストラクター主導型

例：LMS365に作成されていないトレーニング（コース）の場合

{
"CourseCatalogId": "1cc13181-ede9-4756-b13e-f60f8e1fdbfa",
"Title": "Master Of Projects",
"Categories":
[{"Id": "c0a6b190-b7ba-429e-af0e-043c5f1f3c21", "Name": "Imported"},
{"Id": "c60f50d2-bc4d-48e5-b3f8-1bef1c56d134", "Name": "Performance Management"}],
"CourseType": "1"
}

４．準備ができたら「Execute」を選択してリクエストを実行します。

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

• Codeの下にある２ＸＸ（例：200）という数字は、リクエストが正しく動作したことを示します。
• Response body には、テナントに作成された外部トレーニング（コース）の情報が表示されます。この段階では、この外部トレーニング（コース）に関連するユーザーの進捗情報はありません。
  レスポンスから、このコースIDをコピーします。コースIDは、次のステップ、ユーザの進捗（完了日）の追加で必要となります。
  
• Downloadオプションを使用すると、APIリクエストの結果を JSON 形式でローカルデバイスに保存できます。

Step2_外部トレーニング（コース）にユーザーの進捗を追加する

１．Step1でインポートした外部トレーニング（コース）に、ユーザーの進捗を追加します。

ExternalTrainings セクションを展開し、POST  /externalTrainings/importProgress Import progress を選択し、開いた画面で右上の「Try it out」を選択します。 

２．パラメータを設定します。

• "CourseId": "guid"：このパラメータは必須です。"guid" を、Step1の手順5でコピーしたコースIDに置き換えます。
  
  
• "UserId": "guid"：このパラメータは必須です。"guid" を、進捗を追加するユーザーIDに置き換えます。
  
  
• "CompletionDate":"yyyy-mm-ddT00:00:00Z"：このパラメータは必須です。ユーザーがトレーニングを完了した日を入力します。CompletionDate には、予め、既定値として現在の日付と時刻が設定されています。
  
  
• "Ceu": "number"：このパラメータは任意です。"number" を、ユーザーに付与するCEU数の値に置き換えます。

例：

{
"CourseId": "0d35358f-8cd0-456c-ac83-7f1f831f6a09",
"UserId": "0a8b66cc-c591-4d04-b1cb-16a04fd94113",
"CompletionDate": "2023-02-24T05:51:02Z",
"Ceu": "15"
} 

３．準備ができたら「Execute」を選択してリクエストを実行します。

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

• Codeの下にある２ＸＸ（例：200）という数字は、リクエストが正しく動作したことを示します。
• Response body では、外部トレーニング（コース）に、設定したユーザーの完了日とCEU（設定した場合）が追加されたことが確認できます。

  この結果は LMS365 管理センター ＞ユーザー＞ユーザーを選択し「受講の進捗を閲覧」で確認することができます。
  レスポンスから、IDをコピーします。このIDは、外部トレーニング（コース）のユーザーの登録IDで、次のステップ、ユーザーの認定証の追加で必要となります。
  

• Downloadオプションを使用すると、APIリクエストの結果を JSON 形式でローカルデバイスに保存できます。

Step3_外部トレーニング（コース）にユーザーの認定証を追加する

１．Step1でインポートした外部トレーニング（コース）に、ユーザーの認定証を追加します。

ExternalTrainings セクションを展開し、 POST  /externalTrainings/importCourse  Import certificate を選択し、開いた画面で右上の「Try it out」を選択します。 

２．パラメータを設定します。

"EnrollmentId": "guid"：このパラメータは必須です。"guid" を、Step2の手順4でコピーしたユーザーの登録IDに置き換えます。
"ExpiryDate": "yyyy-mm-ddT00:00:00Z"：このパラメータは必須です。証明書の有効期限を設定します。ExpiryDate には、予め、既定値として現在の日付と時刻が設定されています。

"TemplateId": "guid"：このパラメータは任意です。 "guid"を、認定証に使用する認定証テンプレートのID に置き換えます。

　例：

{
"EnrollmentId": "ae92dacf-ddbe-4838-a3ea-0c37277a0e4f",
"ExpiryDate": "2025-04-19T07:36:58Z",
"TemplateId": "139505da-e8f0-4ee7-a50e-9235601e8ce4"
}

３．準備ができたら「Execute」を選択してリクエストを実行します。

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

• Codeの下にある２ＸＸ（例：200）という数字は、リクエストが正しく動作したことを示します。
• Response body では、外部トレーニング（コース）で、ユーザーに設定したテンプレートの認定証が付与されたことが確認できます。
  この結果は LMS365 管理センター ＞ユーザー＞ユーザーを選択し「受講の履歴を閲覧」の認定証タブで確認することができます。
• Downloadオプションを使用すると、APIリクエストの結果を JSON 形式でローカルデバイスに保存できます。