4.8. Erweiterung von UMC-Modulen mit erweiterten Attributen

Die UMC-Module für die Domänenverwaltung ermöglichen die umfassende Verwaltung der Daten einer Domäne. Erweiterte Attribute bieten eine Möglichkeit, neue Attribute in die Domänenverwaltung zu integrieren, die durch den UCS-Standardumfang nicht abgedeckt sind. Erweiterte Attribute werden auch von Drittanbietern für die Integration von Lösungen in UCS eingesetzt.

Erweiterte Attribute werden über das Modul LDAP-Verzeichnis verwaltet. Sie befinden sich im Container univention und dessen Untercontainer custom attributes. Hier können bestehende Attribute bearbeitet werden oder mit Hinzufügen ein Objekt vom Typ Einstellungen: Erweitertes Attribut angelegt werden.

Erweiterte Attribute können internationalisiert werden. In diesem Fall sollten Namen und Beschreibungen in Englisch verfasst werden, da dies der Standardsprache von UMC-Modulen entspricht.

4.8.1. Erweiterte Attribute - Reiter Allgemein

Tab. 4.1 Reiter Allgemein

Attribut	Beschreibung
Eindeutiger Name	Der Name des LDAP-Objektes, als welches das erweiterte Attribut gespeichert wird. Innerhalb eines Containers muss der Name eindeutig sein.
UDM CLI Name	Der angegebene Attributname ist bei der Verwendung der Kommandozeilenschnittstelle Univention Directory Manager zu verwenden. Beim Anlegen des erweiterten Attributs wird hier automatisch Eindeutiger Name von der Karteikarte Allgemein übernommen und kann nachträglich modifiziert werden.
Kurzbeschreibung	Wird als Überschrift des Eingabefelds in UMC-Modulen oder als Attribut-Beschreibung in der Kommandozeilenschnittstelle verwendet.
Übersetzungen der Kurzbeschreibung	Damit der Titel von erweiterten Attributen auch mit anderen Spracheinstellungen in der jeweiligen Landessprache ausgegeben wird, können übersetzte Kurzbeschreibungen für mehrere Sprachen hinterlegt werden. Dazu kann in diesem Eingabefeld über einen Sprachcode (z.B. de_DE oder fr_FR) die entsprechend übersetzte Kurzbeschreibung zugeordnet werden.
Ausführliche Beschreibung	Diese erweiterte Beschreibung wird für die Eingabefelder in UMC-Modulen als Tooltip angezeigt.
Übersetzungen der ausführlichen Beschreibung	Zusätzliche Hinweise, die im Tooltip für ein erweitertes Attribut angezeigt werden, können ebenfalls für mehrere Sprachen hinterlegt werden. Dazu kann in diesem Eingabefeld über einen Sprachcode (z.B. de_DE oder fr_FR) die entsprechend übersetzte Langbeschreibung zugeordnet werden.

4.8.2. Erweiterte Attribute - Reiter Modul

Tab. 4.2 Reiter Modul

Attribut	Beschreibung
Zu erweiternde Module	Das Univention Directory Manager-Modul, welches durch das erweiterte Attribut ergänzt werden soll. Ein erweitertes Attribut kann auch für mehrere Module gelten.
Benötigte Optionen/Objektklassen	Einige erweiterte Attribute können nur sinnvoll verwendet werden, wenn auf der Karteikarte (Optionen) bestimmte Objektklassen aktiviert sind. In diesem Eingabefeld können optional eine oder mehrere Optionen hinterlegt werden, die am betreffenden Objekt aktiviert sein müssen, damit dieses erweiterte Attribut angezeigt wird oder editierbar ist.
Hook-Klasse	Die Funktionen der hier angegebenen Hook-Klasse werden während des Anlegens, Modifizierens und Löschens von Objekten mit dem erweitertem Attribut aufgerufen. Weiterführende Dokumentation findet sich in der Entwickler-Dokumentation Univention Developer Reference [3].

4.8.3. Erweiterte Attribute - Reiter LDAP-Abbildung

Tab. 4.3 Reiter LDAP-Abbildung

Attribut	Beschreibung
LDAP-Objektklasse	Die Objektklasse, zu welcher das unter LDAP-Abbildung eingetragene Attribut gehört. Für erweiterte Attribute stehen mit der Objektklasse univentionFreeAttributes vordefinierte LDAP-Schema-Erweiterungen zur Verfügung. Weitere Hinweise finden sich in LDAP-Schema-Erweiterungen. Jedes LDAP-Objekt, das um ein Attribut erweitert werden soll, wird automatisch um die hier angegebene LDAP-Objektklasse erweitert, wenn vom Benutzer ein Wert für das erweiterte Attribut angegeben wurde.
LDAP-Attribut	Der Name des LDAP-Attributs, in dem die Werte am LDAP-Objekt gespeichert werden sollen. Das LDAP-Attribut muss in der angegebenen Objektklasse enthalten sein.
Objektklasse löschen, wenn das Attribut entfernt wird	Wird der Wert für ein erweitertes Attribut in einem UMC-Module gelöscht, wird das Attribut vom LDAP-Objekt entfernt. Werden an diesem LDAP-Objekt keine weiteren Attribute der angegebenen Objektklasse verwendet, wird auch die Objektklasse vom LDAP-Objekt entfernt, sofern diese Option aktiviert ist.

4.8.4. Erweiterte Attribute - Reiter UMC

Tab. 4.4 Reiter UMC

Attribut	Beschreibung
Dieses erweiterte Attribut nicht in UMC-Modulen anzeigen	Wenn ein Attribut anstatt durch den Administrator nur intern verwaltet werden soll, - z.B. indirekt durch Skripte - kann diese Option aktiviert werden. Das Attribut kann dann nur über das Kommandozeilen-Interface Univention Directory Manager gesetzt werden und wird in UMC-Modulen nicht angezeigt.
Von der UMC-Suche ausschließen	Soll im Suchdialog eines Assistenten nicht nach einem erweiterten Attribut gesucht werden können, kann diese Option aktiviert werden, um das erweiterte Attribut aus der Liste der möglichen Sucheigenschaften zu entfernen. Dies ist nur in Sonderfällen nötig.
Ordnungsnummer	Sollen mehrere erweiterte Attribute auf einer Karteikarte verwaltet werden, kann anhand dieser Positionsnummer die Reihenfolge der Attribute beeinflusst werden. Sie werden in aufsteigender Reihenfolge bestimmt und durch diese Positionsnummer jeweils am Ende der betreffenden Gruppe und Karteikarte angehängt. Fortlaufend vergebene Positionsnummern führen dazu, dass die Attribute jeweils abwechselnd links und rechts zweispaltig angeordnet werden. Ansonsten beginnt die Platzierung in der linken Spalte. Weisen erweiterte Attribute die gleiche Positionsnummer auf, ist deren Reihenfolge zufällig.
Existierendes Eingabefeld überschreiben	In einigen Fällen ist es sinnvoll, vorgegebene Eingabefelder mit erweiterten Attributen zu überschreiben. Wird hier der interne UDM-Name eines Attributs konfiguriert, wird dessen Eingabefeld von diesem erweiterten Attribut überschrieben. Der UDM-Attributname kann mit dem Befehl univention-directory-manager ermittelt werden (siehe Kommandozeilenschnittstelle der Domänenverwaltung (Univention Directory Manager)). Es ist zu beachten, dass diese Option bei Pflichtfeldern zu Problemen führen kann.
Beide Spalten umfassen	Alle Eingabefelder werden standardmäßig in zwei Spalten gruppiert. Diese Option kann für überlange Eingabefelder verwendet werden, die sich über die komplette Breite beider Spalten erstrecken sollen.
Name der Karteikarte	Der Name der Karteikarte in UMC-Modulen, auf der das erweiterte Attribut angezeigt werden soll. Hier können auch neue Karteikarten hinzugefügt werden. Wird kein Karteikartenname angegeben, wird Benutzerdefiniert verwendet.
Übersetzung des Karteikartennamens	Um den Namen der Karteikarte zu übersetzen, können in diesem Eingabefeld übersetzte Karteikartennamen zum entsprechenden Sprachcode (z.B. de_DE oder fr_FR) hinterlegt werden.
Existierende Karteikarte überschreiben	Ist diese Option aktiviert, wird die betreffende Karteikarte überschrieben, bevor erweiterte Attribute darauf platziert werden. Mit Hilfe dieser Option können alle vorhandenen Eingabefelder auf einer vorgegebenen Karteikarte ausgeblendet werden. Es ist zu beachten, dass diese Option bei Pflichtfeldern zu Problemen führen kann. Verwendet die zu überschreibende Karteikarte Übersetzungen muss die überschreibende Karteikarte ebenfalls identische Übersetzungen mitbringen.
Karteikarte mit erweiterten Einstellungen	Einstellungsmöglichkeiten, die selten verwendet werden, können auf Karteikarten in den erweiterten Einstellungen platziert werden
Gruppenname	Gruppen ermöglichen die Strukturierung einer Karteikarte. Eine Gruppe wird durch einen grauen Querbalken abgetrennt und kann ein- und ausgeklappt werden. Wird bei einem erweiterten Attribute kein Gruppenname angegeben, wird das erweiterte Attribut oberhalb der ersten Gruppe platziert.
Übersetzung des Gruppennamens	Um den Namen der Gruppe zu übersetzen, können in diesem Eingabefeld übersetzte Gruppennamen zum entsprechenden Sprachcode (z.B. de_DE oder fr_FR) hinterlegt werden.
Gruppen-Ordnungsnummer	Sollen mehrere Gruppen auf einer Karteikarte verwaltet werden, kann anhand dieser Positionsnummer die Darstellungsreihenfolge beeinflusst werden. Sie werden in aufsteigender Reihenfolge ihrer Positionsnummern dargestellt.

4.8.5. Erweiterte Attribute - Reiter Datentyp

Tab. 4.5 Reiter Datentyp

Attribut	Beschreibung
Syntax-Klasse	Bei der Eingabe von Werten nimmt das UMC-Modul eine Syntaxprüfung vor. Neben Standard-Syntaxdefinitionen für Zeichenketten (string), Zahlen (integer) gibt es drei Möglichkeiten einen binären Zustand auszudrücken: Die Syntax TrueFalse wird auf LDAP-Ebene durch die Zeichenketten true und false abgebildet, die Syntax TrueFalseUpper verwendet dagegen die Werte TRUE und FALSE. Die Syntax boolean dagegen speichert keinen Wert oder die Zeichenkette 1. Standardmäßig wird die Syntax string verwendet. Eine Übersicht über die weiteren verfügbaren Syntax-Definitionen und eine Anleitung zur Integration eigener Syntaxen sind in Univention Developer Reference [3] zu finden.
Vorgabewert	Ist hier ein Vorgabewert definiert, werden Objekte beim Anlegen mit diesem Wert initialisiert. Der Wert kann während des Anlegens noch manuell bearbeitet werden. Bereits bestehende Objekte werden nicht verändert.
Mehrfachwert	Diese Option legt fest, ob ein einzelner Wert oder mehrere Werte in der Eingabemaske eingetragen werden können. Die Einstellung muss zur Schema-Definition passen, in der für das verwendete LDAP-Attributes festgelegt ist, ob nur eine oder mehrere Instanzen des Attributs an einem LDAP-Objekt verwendet werden dürfen.
Wert wird benötigt	Ist diese Option aktiv, muss ein gültiger Wert für das erweiterte Attribut eingetragen sein, um das betreffende Objekt anzulegen oder zu speichern.
Nachträglich modifizierbar	Diese Option legt fest, ob der im erweiterten Attribut gespeicherte Wert nur während des Anlegens eines Objektes oder auch nachträglich modifiziert werden kann.
Wert wird nur intern verwaltet	Ist diese Option aktiviert, kann das Attribut nicht manuell gesetzt werden, weder beim Anlegen des Objekts, noch nachträglich. Dies ist sinnvoll für automatisch generierte interne Zustände, die über Hook-Funktionen oder intern in einem Modul gepflegt werden.
Kopierbar	Werte dieses erweiterten Attributs werden beim Kopieren eines Objekts automatisch in das Formular eingesetzt.