属性マッピングの参照

属性マッピングを使用すると、ServiceNow のテーブルフィールドに対するリソースの単一のソースとして属性を使用できます。

属性

マッピングを定義する必要のある属性。userName など。

サブ属性

マッピングを定義する必要のあるサブ属性を選択します (ある場合)。

たとえば、name.familyName のような複合的なタイプ属性がある場合、属性は name で、サブ属性は familyName となります。

ユーザー名のような単純な属性の場合、[サブ属性] の値は [なし] になります。

フィルター条件

複数値の属性には、フィルター条件を使用して指定可能な追加情報を設定できます。フィルター条件の選択肢は、SCIM プロバイダーによって定義されたスキーマを使用して入力されます。

たとえば、phoneNumbers 属性には、職場、モバイル、自宅といった複数のタイプがあります。

一連の可能な値からフィルター条件を指定できます。たとえば、phoneNumber 属性にはフィルター条件を type eq "mobile" として設定できます。

phoneNumber 属性には type eq "work" のフィルター条件を設定することもできます。

データベースフィールド名

直接の属性マッピングのオプションを選択した場合は、この属性を定義する必要があります。[データベースフィールド名] フィールドには SCIM 属性がマッピングされた ServiceNow フィールド名が表示されます。

たとえば、usernameという SCIM 属性は、ユーザーには [データベーステーブル名] フィールドとして、ユーザー ID フィールドには [データベースフィールド名] フィールドとしてマッピングできます。

[データベースフィールド名]を使用してドット連結することもできます。たとえば、部門という SCIM 属性は [部門名] フィールドにマッピングできます。

ここでは、[データベーステーブル] は [ユーザー] で、[データベースフィールド名] は [部門名] です。

デフォルト値

そのフィールドの直接の属性マッピングが null を返すと、デフォルト値が SCIM プロバイダーに渡されます。そのデフォルト値を使用してハードコードされた値を返すこともできます。

ハードコードされた値の場合は、データベーステーブル名とフィールド名を [なし] にする必要があります。

たとえば、仕事用メールのプライマリサブ属性の値は trueとしてハードコードできます。

スクリプト

属性値をフェッチするためにはスクリプトを使用します。スクリプトの戻り値のタイプは常に、文字列、または文字列として変換された JSON である必要があります。スクリプトの出力は、その属性に対してプロバイダーが想定する適切な形式である必要があります。

複数値の属性のサンプルスクリプトは次のとおりです。

スクリプトの出力には、文字列化された JSON アレイが必要です。

単純な値の属性のサンプルスクリプトは次のとおりです。

スクリプトの出力は文字列である必要があります。