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.

Erweitertes Attribut zur Verwaltung von KFZ-Kennzeichen

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.