Udemy BusinessとのxAPI レポート設定

  • 更新

Learn365 は xAPI レポート機能をサポートしており、Udemy Business での学習の進捗や完了情報を Learn365 に連携することが可能です。

Udemy Business との xAPI レポートを設定するには、先に Microsoft Azure で Udemy Business をアプリケーションとして登録し、その後 Udemy Business ポータルにて xAPI の設定を行う必要があります。

ここでは、xAPI レポートの設定について説明します。

xAPI の機能や詳細については、こちらをご参照ください。

 

目次

 

xAPI レポート機能と要件

学習の進捗を Learn365 に正しく反映させるためには、Udemy Business のコースが Learn365 にインポートされており、ユーザーがそのコースに登録されている必要があります。また、ユーザーの Udemy Business プロファイル情報は、Microsoft Azure ポータルに記録されている情報と一致している必要があります。

xAPI レポート機能では、Learn365 プレイヤー経由で起動されたコースの進捗、および完了情報を Learn365 に送信することができます。

受講者が Udemy Business 上で直接コースを受講した場合(Learn365 プレイヤーを経由せずに受講した場合)、その進捗および完了情報は Learn365 に送信されません。

Udemy Business 上で未開始または完了済みのコースは、Learn365 上ではそれぞれ「未開始」、「完了」として表示されます。

 

注記:

現時点では、Udemy Business におけるコースの部分的な進捗(例:50%完了など)は Learn365 に反映されません。
Udemy Business 上で「進行中」となっているコースは、Learn365 の「ステータス」列では「進行中」と表示されますが、「進捗」列では 0% と表示されます。

 

同じ Udemy Business のコースが Learn365 に複数回インポートされた場合でも、ユーザーが各コースに受講者登録されていれば、それぞれのインスタンスに対して学習の進捗が送信されます。

つまり、ユーザーが複数のインポート済みコースに受講者登録されている場合、それぞれのコースに対して進捗情報が個別に反映されます。

重要!

ユーザーが Udemy Business 上でコースを完了した後で、そのコースが Learn365 にインポートされ、ユーザーがそのコースに登録されて再受講した場合でも、進捗情報は Learn365 に送信されません。

そのため、過去に Udemy Business 上 で完了したコースを Learn365 上で再度受講しても、進捗や完了情報は Learn365 に反映されませんのでご注意ください。

 

Microsoft Azure ポータルでアプリを登録する

この操作に必要なロールMicrosoft Entra ID における「アプリケーション開発者」以上

xAPI レポート機能を利用するためには、Microsoft Azure ポータルで以下を行う必要があります。

これらの設定により、Udemy Business と Learn365 間で進捗の連携が可能になります。

アプリケーションの登録方法についての詳細は、こちらの Microsoft Learn のガイドをご参照ください。

 

Azure エンタープライズ アプリケーションを作成する

xAPI レポート機能を設定するために、Microsoft Azure ポータルで新しいアプリケーションを作成します。

手順:

1.組織の Microsoft Azure ポータルのホームページにアクセスします。

2.左側のメニューから「アプリの登録」>「+新規登録」 を選択します。

xAPI report Udemy Business-1.jpg

 

3.アプリケーションの名前を入力します。その他は既定の設定のままにします。

4.「登録」 をクリックしてアプリケーションを作成します。

xAPI report Udemy Business-2.jpg

 

作成したアプリケーションに Learn365 API のアクセス許可を付与する

Microsoft Azure ポータルで作成したアプリケーションに、Learn365 API へのアクセス許可を付与します。

手順:

1.左側のメニュー>アプリの登録で作成したアプリケーションを選択し、管理> API のアクセス許可> 「+アクセス許可の追加」 を選択します。

2.表示されたパネルで、「所属する組織で使用している API 」タブを選択し、Learn365 API アプリケーション を選択します。

「API アクセス許可の要求」パネルが開きます。

3.「アプリケーションのアクセス許可」を選択します。

4.「FullAccess - Access LMS365 APIs」 のチェックボックスをオンにし、「アクセス許可の追加」をクリックします。

5.「管理者の同意の付与」確認ダイアログが表示されたら、「はい」を選択します。これにより、アプリケーションに対して Learn365 テナントへの完全な API アクセス許可が付与されます。

xAPI report Udemy Business-3.jpg

 

クライアント シークレットの資格情報を生成する

アプリケーションの認証情報の設定に使用するための「クライアント シークレット」を生成します。

手順:

1.左側のメニュー>アプリの登録で作成したアプリケーションを選択し、管理> 証明書とシークレット>「+新しいクライアント シークレット」 を選択します。

2.説明を入力し、有効期限を選択します。

  • 説明:シークレットの用途など、識別しやすい説明を入力します。例:「外部API連携用」など
  • 有効期限:ドロップダウンメニューから選択します。
xAPI report Udemy Business-5.jpg

 

3.「追加」 をクリックすると、クライアント シークレットが生成されます。

4.画面に表示される「クライアント シークレット 値」をコピーして、任意の場所に保存します。

重要!

生成されたクライアント シークレット 値は後から再表示することはできません。シークレットの作成を閉じる前に、必ずコピーして安全な場所に保存してください。

保存する情報は、 シークレット値 です。 シークレット値には、文字、数字、記号が含まれます。シークレットID と間違えないように十分注意してください。

xAPI report Udemy Business-4.jpg

 

Azure ポータル での設定を完了する

アプリケーションを登録後、以下の手順に従って必要な認証情報を取得し保存します。

1.左側のメニュー>アプリの登録で作成したアプリケーションを選択し、アプリケーションの「概要」を開きます。

2.概要ページに表示されている以下の情報を確認し、コピーまたはメモして保存しておきます。

  • アプリケーション(クライアント)ID
  • ディレクトリ(テナント) ID

これらの ID は、Udemy Business ポータルで xAPI レポートを設定する際に使用します。

 

Udemy Business ポータルで xAPI レポートを設定する

この操作に必要なロール:Udemy Business 管理者

Udemy Business ポータルで xAPI レポートの設定を行います。

手順:

1.組織専用の Udemy Business ポータルにアクセスして管理者としてログインします。

URL は通常、以下の形式です:https://<お客様のテナント名>.udemy.com

2..左側のメニューから、設定> 「APIと統合」を選択します。

3.統合を選択ドロップダウンリストから「Learn365」を選択します(リストにある場合)。Learn365 が見当たらない場合は、「その他」を選択します。

4.LMS/LXP 名前フィールドに Learn365 と入力し、「学習者アクティビティ追跡(xAPI)」トグルを有効にします。

5.「OAuth トークン URL」フィールドに、次の URL を貼り付けます。

https://ne-api.365.systems/xAPI/<テナント ID>/OAuthServerToken

注記:

ne-api.365.systems は、テナントで選択した地域に関連するドメイン名に置き換えます。ソフィアでご契約のお客様は 「 je-api.365.systems 」  になります。

<テナントID>はお客様のテナントIDに置き換えます。

 

6.「クライアント ID」と「クライアント シークレット」フィールドに、Azure ポータル で生成したそれぞれの資格情報を貼り付けます。

7.「OAuth スコープ」フィールドに 「xapi:write」 と入力します。

8.「xAPIステートメントURL」フィールドに、次のURLを貼り付けます。

https://ne-api.365.systems/xAPI/<Tenant ID>/Udemy/ActivityStatement

注記:

ne-api.365.systems は、テナントで選択した地域に関連するドメイン名に置き換えます。ソフィアでご契約のお客様は 「 je-api.365.systems 」  になります。

<テナントID>はお客様のテナントIDに置き換えます。

 

9. xAPI の認証情報を入力したら、「認証情報をテスト」をクリックし、Udemy Business が Oauth トークンURLにアクセスできることを確認します。このテストでは、Udemy Business が トークン エンドポイントにアクセス可能かどうかのみを検証します。

10.正常に認証されたら、「保存」を選択します。

これで Udemy Business ポータルでの設定は完了です。

保存後、ポータル画面に 構成の概要が表示されます。

内容を確認し、問題がなければこのページを閉じます。

Udemy Business xAPI 統合の詳細については、こちらの Udemy Business のガイドをご参照ください。

 

xAPI レポート設定を確認する

次の方法で、xAPI レポートが正しく設定されているかを確認できます。

手順:

1.Learn365 管理センターで Udemy Business からコースをインポートします。

2.インポートした Udemy Business コースを公開し、受講者を登録します。

3.受講者として登録したアカウントで、このコースの受講を開始します。

4.管理者として、Learn365 管理センター> トレーニング管理 でこのコースを選択し、「コースの進捗」で受講者の進捗を確認します。

コースの進捗ダッシュボードで受講者の進捗が正しく表示されていれば、xAPI レポート設定は正常に機能しています。

 受講者の進捗が正しく表示されない場合は、xAPI 設定や OAuth URL、クライアント シークレットの再確認をおすすめします。