API によるユーザーページ カスタム列の作成

  • 更新

Learn365では、Learn365 グローバル設定>LMS設定>「ユーザーページの列」、または Learn365 API を通じて、ユーザー プロファイル の列の作成できます。また、独自のデータソースから列(「表示名」、「ユーザーはカタログにいます」は除く)に情報を表示することができます。

ここでは、Learn365 API を通じた新しい列の作成と、既存のユーザー プロファイル の列の構成について説明します。

 

注記:

カスタム同期のオプションは、各列に対して個別に有効にできます。

カスタム同期を特定の列で有効にすると、Learn365 はその特定の列については Microsoft Azure AD からのデータを同期しなくなりまが、API を通じてお客様のデータソースからそのフィールドにデータを入力することはできます。カスタム列とシステム列の更新については、こちらを参照ください。

 

Learn365 API を通じた新しいカスタム列の作成は、以下の手順に沿って行います。

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

2.Users セクションに移動し、POST /odata/v2/UserFields Creates new user field  を選択し、右上の「Try it out」を選択します。

 

Create custom columns1.png

 

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

「Edit Value」フィールドで、以下を入力します。これらのパラメータは入力必須です。

  • "Title": "string"列の名前を入力します。「string」を任意の列の名前に置き換えます。
  • "Description": "string"列の説明。「string」を列の説明文に置き換えます。
  • "Type": "integer"列に入るデータの型を指定します。既定のデータ型は「String(文字列)」です。その他、Boolean(Yes/ No)、number(数字)、date(日付形式)を指定できます。
    列の作成後にデータの型を変更することはできません。
    API では次のいずれかの値でデータの型を指定します。
    • String または 0
    • Boolean または 1
    • Number または 2
    • DateTime または 3

例えば、"Type": "Boolean "または "Type":1 "  のどちらでも同じ結果となります。

 

"IsVisible "パラメータを使用して、ユーザーページに列を 表示する/しない を設定することができます。

設定値:true(ユーザーページに表示します),false(ユーザーページに表示しません)

 

以下はこの APIリクエストの例です。

{
"Title":"Department Supervisor",
"Description":"Reporting",
"IsVisible":true,
"Type":"0"
}

 

Create custom columns2.png

 

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

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

  • Code の下の2xx(202など)は、リクエストが正しく動作したことを示します。
  • Response body では、リクエストの結果が表示されます。
    作成された列は、グローバル設定>LMS 設定の「ユーザーページの列」、およびユーザーページで確認、編集(データタイプを除く)ができます。
  • Downloadオプションを使用して、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。

 

Create custom columns3.png