\paragraph{\ucsUDM{ Syntax-Definitionen}}~
\label{udm:syntaxdef}

Mit den erweiterten \ucsUDM{ Syntax-Definitionen} ist es möglich,
gültige Werte für ein Attribut über eine LDAP-Suche zu ermitteln.
Außerdem können damit benutzerdefinierte Attribute angelegt werden,
deren Werte zur Information als Liste an einem fremden Objekt
angezeigt, jedoch nicht gespeichert werden. (Siehe z.B. die
Karteikarte \ucsMenuEntry{Referenzierende Objekte} in Kapitel
\ref{richtlinien-anwenden}).

Erstellt werden können die Syntax-Definitionen über das Navigations-Menü des
\ucsUDM{s}. Dabei ist zu beachten, dass das Erstellen lediglich unterhalb des
Containers \ucsName{cn=univention} möglich ist.

Um eine neue Syntax-Definition zu erstellen, ist im gewünschen Container ein
neues Objekt vom Typ \ucsName{Einstellungen: Syntax-Definition} anzulegen. Im daraus resultierenden Dialog
sind die folgenden Werte anzugeben: 


\begin{ucsTabbox}{Karteikarte 'Allgemein'}
\ucsTabentry{Syntax-Name (*)}
Der eindeutige Name der Syntax-Definition.

\ucsTabentry{Kurzbeschreibung} 
Eine optionale Beschreibung der Syntax-Definition.

\ucsTabentry{LDAP Suchfilter (*)}
Mittels dieses Suchfilters werden die Objekte selektiert, die die Menge der
gültigen Werte bestimmen.\\

\ucsExample{(\&(objectClass=univentionHost)(cn=a*))\\sucht alle Rechner"=Objekte, deren Name mit 'a' beginnt.}

\ucsTabentry{Anzuzeigende Attribute}
Hier werden in zwei Auswahlfeldern das Objekt sowie das davon anzuzeigende
Attribut ausgewählt. Bei der Verwendung der Syntax"=Definition in einem benutzerdefinierten Attribut in
\ucsUDM{} wird nur das hier ausgewählte Attribut angezeigt. Es kann \emph{DN} ausgewählt werden, um den
LDAP-DN des Objekts anzuzeigen.

\ucsTabentry{Anzuzeigende LDAP-Attribute}
Anstatt in \ucsMenuEntry{Anzuzeigende Attribut} die Auswahl des zu
anzuzeigenden Attributs über die \ucsUDM{}-Module
vorzunehmen, kann auch eine Liste von LDAP-Attributsnamen definiert
werden.

\ucsTabentry{Zu speicherndes Attribut}
Mittels der zwei Auswahlfelder wird das Attribut ausgewählt, das bei Auswahl eines LDAP-Objekts gespeichert
wird. Das zu speichernde Attribut kann von dem anzuzeigenden Attribut abweichen. So kann in \ucsUDM{}
z.B. die Mitarbeiternummer der über den Suchfilter bestimmten Benutzer angezeigt werden, im LDAP"=Verzeichnis
wird jedoch die Pager"=Rufnummer abgespeichert. Auch hier kann \emph{DN} angegeben werden, um den LDAP-DN des
Objektes zu speichern.

\ucsTabentry{Zu speicherndes LDAP-Attribut}
Anstatt in \ucsMenuEntry{Zu speicherndes Attribut} die Auswahl des zu
speichernden Attributs über die \ucsUDM{}-Module vorzunehmen, kann
auch direkt der Name eines LDAP-Attributs definiert werden.

\ucsTabentry{LDAP Basis}
Der Basis-Eintrag im LDAP-Verzeichnisdienst, ab dem gesucht werden soll.\\
\ucsExample{\ucsName{cn=standort2,cn=users,dc=ucs,dc=local}}

\ucsTabentry{Nur Anzeigen}
Wird diese Option aktiviert, wird das Attribut lediglich als Liste am zugehörigen Objekt angezeigt. Die
Listenelemente sind dabei Verweise, die zur Ansicht dieser Objekte führen.
\end{ucsTabbox}

Soll eine so angelegte Syntax-Definition in einem benutzerdefinierten Attribut
verwendet werden, reicht es aus, in diesem den Syntax-Namen der
Syntax-Definition im Feld \ucsMenuEntry{Syntax} des benutzerdefinierten
Attributs anzugeben.



\paragraph{Univention Directory Manager syntax definitions}
\label{udm:syntaxdef}

The extended \ucsUDM{} syntax definitions make it
possible to establish the permitted values  for an attribute via an
LDAP search. Moreover, user-defined attributes can be created the
values of which are displayed for information purposes, but not
stored, as a list at a foreign object (see, for example, the
\ucsMenuEntry{Referencing objects} tab in chapter \ref{richtlinien-anwenden}).

The syntax definitions can be created via the LDAP browser of the
\ucsUDM{} beneath the container \ucsName{cn=univention}.

For creating a new syntax definition, a new object of the type
\ucsName{Settings: Syntax Definition} is to be created in the desired
container. In the subsequent dialogue, the following values are to be
entered:

\begin{ucsTabbox}{'General' tab}
\ucsTabentry{Syntax name (*)}
The unique name of the syntax definition.

\ucsTabentry{Short description}
An optional description of the syntax definition.

\ucsTabentry{LDAP search filter (*)}
This search filter is used for selecting the objects which define the
set of permitted values.

\ucsExample{(\&(objectClass=univentionHost)(cn=a*))\\sucht alle Rechner"=Objekte, deren Name mit 'a' beginnt.}

\ucsTabentry{Displayed attributes}
Two select fields allow the selection of the object and the attribute
to be displayed. When using the syntax definition in a user-defined
attribute in \ucsUDM{}, solely the attribute
selected here will be displayed. DN can be selected for displaying the
LDAP DN of the object.

\ucsTabentry{Displayed LDAP attributes}
Instead of setting \ucsMenuEntry{Displayed Attributes} via the
\ucsUDM{} modules in Attributes to be displayed, a
list of LDAP attribute names can also be defined.

\ucsTabentry{Stored attribute}
The attribute to be stored when selecting an LDAP object, is selected
via two fields. The attribute to be stored can differ from the
attribute to be displayed. Example: In \ucsUDM{},
the staff member number of the users specified by a search filter can
be displayed, whereas in the LDAP directory the pager number is
stored. DN can also be stated for storing the LDAP DN of the object.

\ucsTabentry{Stored LDAP attribute}
Instead of setting the selection of attributes to be stored via the
\ucsUDM{} modules in \ucsMenuEntry{Stored Attribute}, the
name of the LDAP attribute can also be directly defined.

\ucsTabentry{LDAP base}
The base entry in the LDAP directory service where the search is to start.\\
\ucsExample{\ucsName{cn=branch2,cn=users,dc=ucs,dc=local}}

\ucsTabentry{Show only}
If this option is activated, the attribute will only be displayed as a
list at the related object. The list elements are references pointing
to the view of these objects.
\end{ucsTabbox}

If a syntax definition thus created is to be used in a user-defined
attribute, it is sufficient to state the syntax name of the syntax
definition in the field \ucsMenuEntry{Syntax} of the  user-defined attribute.
