Skip to main content
Wenn Iru Benutzer aus einer verbundenen Quelle liest, muss es wissen, welches eingehende Feld welches Iru-Profilattribut befüllt und manchmal auch, wie der Wert unterwegs umgeformt werden soll. Dies beschreiben Sie mit einer Attributzuordnung: Für jedes Iru-Profilattribut schreiben Sie einen Ausdruck, der dessen Wert aus den Feldern der Quelle erzeugt.
Wo die Attributzuordnung gilt. Sie schreiben Attributzuordnungen, wenn Sie ein Quellsystem verbinden (die Konnektoren für Workday und BambooHR, die ihre eigenen Felder zur Zuordnung bereitstellen. Sie gilt nicht für den CSV-Import: Eine CSV-Datei verwendet einen festen Satz vordefinierter Spalten, daher müssen keine Ausdrücke geschrieben werden.
Zuordnungsausdrücke werden in IQL geschrieben, derselben Ausdruckssprache, die Iru für die Claim- und Attributzuordnung von Anwendungen, Auto Group-Regeln und Listenfilter verwendet. Hier ordnen Sie die Felder eines verbundenen Quellsystems den Profilattributen Ihres Verzeichnisses zu; die vollständige Syntax finden Sie unter IQL-Ausdrücke.

So funktioniert eine Zuordnung

Jede Zeile einer Zuordnung verknüpft ein Ziel (ein Iru-Profilattribut) mit einem Ausdruck, der auf die Quellfelder zugreift.
1

Quellfelder ermitteln

Iru liest den Satz von Feldern, den Ihre Quelle bereitstellt. Diese Feldnamen werden zu den Bezeichnern, auf die Sie in Ausdrücken verweisen können. Wie die Ermittlung in die Einrichtung passt, erfahren Sie unter Directory Sync.
2

Einen Ausdruck pro Attribut schreiben

Schreiben Sie für jedes Iru-Attribut, das Sie befüllen möchten, einen IQL-Ausdruck. Ein gültiger Feldname kann für sich allein stehen. Jeder andere Name wird über __source nachgeschlagen. Längere Ausdrücke kombinieren oder transformieren diese Werte.
3

Iru validiert ihn

Ausdrücke werden während der Eingabe und erneut beim Speichern geprüft, sodass Fehler (ein unbekanntes Feld, ein Typfehler) sichtbar werden, bevor sie jemals eine Synchronisierung erreichen.
4

Er wird bei jeder Synchronisierung ausgeführt

Bei der Synchronisierung wertet Iru jeden Ausdruck für die eingehende Zeile aus und schreibt das Ergebnis in das Attribut.
Wählen Sie für die Kennung, die einen Quelldatensatz mit einem Iru-Benutzer verknüpft, ein stabiles, eindeutiges Quellfeld, damit jede Synchronisierung genau einem Benutzer zugeordnet wird.

Ausdrücke schreiben

Ausdrücke verweisen auf die Felder Ihrer Quelle und können sie transformieren: Groß-/Kleinschreibung, Aufteilen, Verketten, Auswählen eines Listenelements und so weiter. Die vollständige Referenz (Objekte, Funktionen, Operatoren und Beispiele) finden Sie auf der Seite IQL-Ausdrücke, da dieselbe Sprache sowohl die Verzeichniszuordnung als auch die Anwendungszuordnung steuert. Ein Feldname kann für sich allein stehen, wenn er ein gültiger IQL-Bezeichner ist. Er beginnt mit einem ASCII-Buchstaben oder einem Unterstrich, und der Rest besteht aus ASCII-Buchstaben, Ziffern und Unterstrichen. Ein Name wie prénom fällt nicht in diesen Bereich und wird daher aus __source gelesen.
Wenn der Name ein Leerzeichen, einen Bindestrich, einen Doppelpunkt oder ein anderes Symbol enthält oder wenn er ein IQL-Schlüsselwort wie in, null, true oder if ist, schlagen Sie ihn über seinen exakten Namen in __source nach. __source ist eine Map aller Felder der Quelle. Ein Punkt zwischen gültigen Namen greift auf einen verschachtelten Wert zu, wie in name.givenName. Ein Feldname, der einen Punkt enthält, ist dennoch ein einzelner Schlüssel: __source["name.givenName"]. Ohne Klammern geschrieben ist Email - Work eine Subtraktion und in der Mitgliedschaftsoperator.
Der Zuordnungseditor schreibt diese Felder in __source["…"] um, wenn Sie sie auswählen oder eingeben. Ein gültiger Name bleibt ohne Klammern. Sie können __source["…"] dennoch auch für einen gültigen Namen schreiben. Wenn der Name " oder \ enthält, setzen Sie innerhalb der Klammern einen Backslash vor jedes dieser Zeichen, wie in __source["Title \"Legal\""]. Der Editor fügt dieses Escaping hinzu, wenn er das Feld umschreibt. Wie dies auf dem Tab „Mapping“ funktioniert, erfahren Sie unter Werte mit IQL transformieren.

Leere zugeordnete Werte

Ein leerer oder Null-Wert in der Zuordnung löscht den vorhandenen Wert dieses benutzerdefinierten Attributs. Die Synchronisierung wird fortgesetzt. Bei einem benutzerdefinierten Attribut vom Typ Boolean, Date, Integer oder Decimal führt ein leerer oder Null-Wert in der Zuordnung nicht zum Fehlschlagen der Synchronisierung. Wenn Sie ein Textfeld transformieren, das leer sein kann, etwa beim Aufteilen einer E-Mail-Adresse, sichern Sie den Wert auf dem Tab „Mapping“ ab.

Nächste Schritte

IQL-Ausdrücke

Die vollständige IQL-Referenz: Objekte, Funktionen, Operatoren und Beispiele.

Verzeichnissynchronisierung

Verbinden Sie ein HR-System und richten Sie die Zuordnungen ein, die diese Ausdrücke steuern.

Profilattribute

Die Ziele, in die Ihre Ausdrücke schreiben.

Automatische Gruppen

Ein weiterer Bereich, in dem Attribute die Automatisierung in Ihrem Verzeichnis steuern.