Attachment 3701 Details for Bug 24236

Zu migrierende Dokumentation

syntax-def.tex (text/x-tex), 6.17 KB, created by Moritz Muehlenhoff on 2011-10-27 13:42 CEST

(hide)

Description:

Filename:

MIME Type:

Creator: Moritz Muehlenhoff

Created: 2011-10-27 13:42 CEST

Size: 6.17 KB

patch

obsolete

>\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.

Actions: View

Attachments on bug 24236: 3701