Active Directory Feld mapping

Wenn Sie linqi auf einer On-Premise Umgebung installiert haben und Active Directory als Quelle für Personen und Gruppen nutzen, ist es möglich die Felder welcher in Platzhaltern zur Verfügung stehen selbstständig anzupassen.
So ist es Ihnen z.B. möglich die Telefonnummer, Abteilung oder auch den SAM Account Name als Platzhalter anzubieten.

Um die Platzhalter anzupassen gehen Sie wie folgt vor:

• Verbinden Sie sich auf den Server auf welchen linqi installiert ist
• Navigieren Sie zum linqi Installationspfad (z.B. C:\inetpub\wwwroot\linqi)
• Öffnen Sie den Ordner ConfigFiles
• Öffnen Sie die Datei UserAdPlaceholderMapping.json mit einem Editor (z.B. Notepad)

In dieser Datei finden Sie die verfügbaren Felder aus dem Active Directory in JSON Format. Dabei sieht ein einzelner Eintrag wie folgt aus:

{
    "Key": "GivenNameOfUser",
    "DisplayName": {
        "de": "Vorname",
        "en": "Firstname",
        "fr": "Prénom",
        "es": "Nombre"
    },
    "AdField": "givenName",
    "isSelectable": true
}

Die verschiedenen Eigenschaften haben folgende Bedeutung:

• Key: Dies ist der Schlüssel des Platzhalters. Er wird von linqi genutzt, um die Platzhalter zu identifizieren.
  Dieser Schlüssel muss eindeutig sein und sollte nicht mehr geändert werden. Wenn Sie den Schlüssel später ändern können bestehende Platzhalter in Prozessen kaputtgehen.
• DisplayName: Hier können Sie den Anzeigenamen des Platzhalters für die verschiedenen Sprachen definieren. Diese werden genutzt um beim Einfügen eines Platzhalters den Nutzenden den Namen anzuzeigen.
  Sie können diesen Namen frei wählen.
• AdField: Hier müssen Sie den internen Namen des AD Feldes nehmen welches als Wert für den Platzhalter genutzt wird. Im oberen Beispiel wurde Beispielsweise givenName ausgewählt. Dies bedeutet, dass die Platzhalter bei der Ausführung zum Vornamen aufgelöst werden. Eine Liste von Feldern finden Sie hier. Den internen Namen finden Sie dort, wenn Sie auf einen Eintrag klicken unter Ldap-Display-Name.
• isSelectable: Wenn dieser Wert auf true steht, können Personen diesen Platzhalter in Prozessen einfügen. Wenn Sie diesen Wert auf false setzen, können Personen diesen Platzhalter nicht länger einfügen, bestehende Platzhalter funktionieren jedoch weiterhin. So können Sie einen Platzhalter löschen, ohne das alte Prozesse kaputtgehen.

Nachdem Sie einen neuen Eintrag eingefügt haben müssen Sie die Datei speichern. Achten Sie hierbei darauf, dass das JSON gültig ist, sprich eine Kommatrennung zwischen den Einträgen vorliegt. Anschließend müssen Sie den Service neu starten (z.B. den Anwendungspool von linqi im IIS). Sobald dies erfolgt ist, kann das neue Feld bei Personen Platzhaltern ausgewählt werden.