> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Attributzuordnung

> Ordnen Sie Felder aus einer verbundenen Verzeichnisquelle den Profilattributen von Iru Identity zu und transformieren Sie Werte mit IQL-Ausdrücken, bevor sie in Benutzerprofile gelangen.

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.

<Note>
  **Wo die Attributzuordnung gilt.** Sie schreiben Attributzuordnungen, wenn Sie
  **ein Quellsystem verbinden** (die Konnektoren für [Workday](/de/identity/directory/hris-workday)
  und [BambooHR](/de/identity/directory/hris-bamboohr), die
  ihre eigenen Felder zur Zuordnung bereitstellen. Sie gilt **nicht** für den
  [CSV-Import](/de/identity/directory/importing-users): Eine CSV-Datei verwendet einen festen Satz
  vordefinierter Spalten, daher müssen keine Ausdrücke geschrieben werden.
</Note>

<Info>
  Zuordnungsausdrücke werden in **IQL** geschrieben, derselben Ausdruckssprache, die Iru
  für die [Claim- und Attributzuordnung von
  Anwendungen](/de/identity/getting-started/iql-expressions), Auto Group-Regeln und
  Listenfilter verwendet. Hier ordnen Sie die Felder eines verbundenen **Quellsystems**
  den [Profilattributen](/de/identity/directory/schema) Ihres Verzeichnisses zu;
  die vollständige Syntax finden Sie unter [IQL-Ausdrücke](/de/identity/getting-started/iql-expressions).
</Info>

## So funktioniert eine Zuordnung

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

```mermaid theme={null}
flowchart LR
  subgraph source["Quellfelder"]
    a["first_name"]
    b["email_work"]
  end
  expr["IQL-Ausdruck"] --> target["Iru-Profilattribut"]
  a --> expr
  b --> expr
```

<Steps>
  <Step title="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](/de/identity/directory/directory-sync).
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Tip>
  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.
</Tip>

## 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](/de/identity/getting-started/iql-expressions), 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.

```
// Use a field as-is
work_email

// Combine fields into a display name
first_name + " " + last_name

// The local part of an email, before the @
work_email.split("@")[0]
```

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.

```
__source["Email - Work"]
__source["Email - Work"].lowerAscii()
```

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](/de/identity/directory/directory-sync#transform-values-with-iql).

## 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“](/de/identity/directory/directory-sync#transform-values-with-iql) ab.

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="IQL-Ausdrücke" icon="brackets-curly" href="/de/identity/getting-started/iql-expressions">
    Die vollständige IQL-Referenz: Objekte, Funktionen, Operatoren und Beispiele.
  </Card>

  <Card title="Verzeichnissynchronisierung" icon="building-user" href="/de/identity/directory/directory-sync">
    Verbinden Sie ein HR-System und richten Sie die Zuordnungen ein, die diese Ausdrücke steuern.
  </Card>

  <Card title="Profilattribute" icon="table-list" href="/de/identity/directory/schema">
    Die Ziele, in die Ihre Ausdrücke schreiben.
  </Card>

  <Card title="Automatische Gruppen" icon="wand-magic-sparkles" href="/de/identity/directory/auto-groups">
    Ein weiterer Bereich, in dem Attribute die Automatisierung in Ihrem Verzeichnis steuern.
  </Card>
</CardGroup>
