検索

【API】 外部トレーニングの記録と認定証のインポート

  • 更新

Learn365 では、Learn365 管理センターまたは Learn365 API を通じてユーザーの外部コースレコードとその認定証をインポートすることができます。

ここでは、API を通じて外部トレーニングの記録と関連する認定証のインポートについて説明します。

 

外部トレーニング 記録のインポート

Learn365 API を通じた外部コース レコードのインポートは、以下の手順に沿って行います。

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

2．ExternalTrainings セクションに移動し、POST  /externalTrainings/importCourse with the Import course を選択し［Try it out］をクリックします。 

Import external course1.png

 

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

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

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

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

 

{"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"
}

 

Import external course2.png

 

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

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

  • Code の下の2xx（202など）は、リクエストが正しく動作したことを示します。
  • Response body には、テナントに作成された外部コースの情報が表示されます。この段階では、この外部トレーニング（コース）に関連するユーザーの進捗情報はありません。
    レスポンスから、このコースのIDをコピーします。コースIDは、ユーザの進捗の追加と、認定証の付与に必要となります。
     
  • Downloadオプションを使用して、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。

Import external course3.png

 

インポートした外部コース レコードにユーザーの完了情報を追加する

ユーザーの完了情報の追加は、以下の手順に沿って行います。

1．ExternalTrainings セクションに移動し、POST  /externalTrainings/importProgress Import progress を選択し、右上の［Try it out］をクリックします。 

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

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

  • "CourseId": "guid"＊：「guid」 を外部コース レコードのインポートの手順.5 で（Response body から）コピーしたコース 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"
}

 

Import external course4.png

 

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

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

  • Code の下の2xx（202など）は、リクエストが正しく動作したことを示します。
  • Downloadオプションを使用して、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。

  • Response body では、外部コースに、ユーザーの完了日とCEU（設定した場合）が追加されたことが確認できます。この結果は Learn365 管理センター＞「ユーザー」ページで選択したユーザーの「受講者の進捗を閲覧」で確認することができます。

    レスポンスから、ID をコピーします。この ID は、外部コースのユーザーの登録 ID で、ユーザーの認定証の追加で必要となります。

Import external course5.png

 

インポートした外部コース レコードに関連する認定証を追加する

関連するユーザーの認定証の追加は、以下の手順に沿って行います。

1．ExternalTrainings セクションに移動し、 POST  /externalTrainings/importCourse Import certificate を選択し、右上の［Try it out］をクリックします。 

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

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

  • "EnrollmentId": "guid"＊：「guid」 を、ユーザーの完了情報の追加の手順.4 で（Response body から）コピーしたユーザーの登録 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"
}

 

Import external course6.png

 

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

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

  • Code の下の2xx（202など）は、リクエストが正しく動作したことを示します。
  • Downloadオプションを使用して、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。
  • Response body では、外部トレーニング コースに設定したテンプレートの認定証がユーザーに付与されたことが確認できます。この結果は Learn365 管理センター＞「ユーザー」ページで選択したユーザーの「受講者の履歴を表示」＞「認定証」タブで確認することができます。

Import external course7.png