マッピング式は IQL で記述します。これは、Iru がアプリケーションのクレームと属性のマッピング、Auto Group ルール、リストフィルターに使用するのと同じ式言語です。ここでは、接続されたソースシステムのフィールドをディレクトリのプロファイル属性にマッピングします。完全な構文については IQL 式を参照してください。
マッピングの仕組み
マッピングの各行は、1 つのターゲット (Iru プロファイル属性) と、ソースフィールドから値を取得する式を組み合わせたものです。1
ソースフィールドを検出する
Iru は、ソースが提供するフィールドのセットを読み取ります。これらのフィールド名は、式で参照できる識別子になります。検出がセットアップにどのように組み込まれるかについては、Directory Sync を参照してください。
2
属性ごとに式を記述する
埋めたい Iru 属性ごとに IQL 式を記述します。有効なフィールド名は単独で使用できます。それ以外の名前は
__source で検索されます。より長い式では、これらの値を組み合わせたり変換したりします。3
Iru が検証する
式は入力中と保存時に再度チェックされるため、誤り (不明なフィールド、型エラー) は同期に到達する前に表示されます。
4
すべての同期で実行される
同期が実行されると、Iru は受信した行に対して各式を評価し、結果を属性に書き込みます。
式の記述
式はソースのフィールドを参照し、変換できます。大文字/小文字の変換、分割、連結、リスト項目の選択などです。同じ言語がディレクトリマッピングとアプリケーションマッピングの両方を支えているため、完全なリファレンス (オブジェクト、関数、演算子、例) は IQL 式ページにあります。 フィールド名が有効な IQL 識別子である場合は、単独で使用できます。有効な識別子は ASCII 文字またはアンダースコアで始まり、残りは ASCII 文字、数字、アンダースコアで構成されます。prénom のような名前はこのセットに含まれないため、__source から読み取られます。
in、null、true、if などの IQL キーワードである場合は、__source で正確な名前を指定して検索します。__source はソースのすべてのフィールドのマップです。有効な名前の間のドットは、name.givenName のようにネストされた値にアクセスします。ドットを含むフィールド名は 1 つのキーのままです: __source["name.givenName"]。そのまま記述すると、Email - Work は減算になり、in はメンバーシップ演算子になります。
__source["…"] に書き換えます。有効な名前はそのまま残ります。有効な名前でも __source["…"] と記述できます。名前に " または \ が含まれる場合は、__source["Title \"Legal\""] のように、括弧内でそれぞれの前にバックスラッシュを付けます。エディターはフィールドを書き換える際にそのエスケープを追加します。Mapping タブでの動作については、IQL で値を変換するを参照してください。
空のマッピング値
空または null のマッピング値は、そのカスタム属性の既存の値をクリアします。同期は続行されます。 Boolean、Date、Integer、または Decimal のカスタム属性の場合、空または null のマッピング値で同期が失敗することはありません。メールアドレスの分割など、空になる可能性のあるテキストフィールドを変換する場合は、Mapping タブで値をガードしてください。次のステップ
IQL 式
IQL の完全なリファレンス: オブジェクト、関数、演算子、例。
ディレクトリ同期
HR システムを接続し、これらの式が支えるマッピングを設定します。
プロファイル属性
式の書き込み先となるターゲット。
自動グループ
ディレクトリで属性が自動化を推進するもう 1 つの場所。