User templates

6.7. User templates#

A user template can be used to preset settings when creating a user. If at least one user template is defined, it can be selected when creating a user.

Selecting a user template

Fig. 6.13 Selecting a user template#

User templates are administrated in the UMC module LDAP directory. There one needs to switch to the univention container and then to the templates subcontainer. A new user template can be created here via the Add with the object type Settings: User template.

In a user template, either a fixed value can be specified (e.g., for the address) or an attribute of the user management referenced. Attributes are then referenced in chevrons.

A list of possible attributes can be displayed with the following command in the section users/user variables of the output:

$ univention-director-manager users/user

If a user template is used for adding a user, this template will overwrite all the fields with the preset values of the template. In doing so, an empty field is set to "".

It is also possible to only use partial values of attributes or convert values in uppercase/lowercase.

For example, the UNIX home directory can be stored under /home/<title>.<lastname> or the primary email address can be predefined with <firstname>.<lastname> Substitutions are generally possibly for any value, but there is no syntax or semantics check. So, if no first name is specified when creating a user, the above e-mail address would begin with a dot and would thus be invalid according to the e-mail standard. Similar sources of error can also occur when handling file paths etc. Non-resolvable attributes (for instance due to typing errors in the template) are deleted.

If only a single character of an attribute is required instead of the complete attribute value, the index of the required character can be entered in the user template in square parentheses after the name of the attribute. The count of characters of the attribute begins with 0, so that index 1 corresponds to the second character of the attribute value. Accordingly, <firstname>[0].<lastname> means an e-mail address will consist of the first letter of the first name plus the last name.

A sub string of the attribute value can be defined by entering a range in square parentheses. In doing so, the index of the first required character and the index of the last required character plus one are to be entered. For example, the input <firstname>[2:5] returns the third to fifth character of the first name.

Adding :lower or :upper to the attribute name converts the attribute value to lowercase or uppercase, e.g., <firstname:lower>. If a modifier like :lower is appended to the entire field, the complete value is transformed, e.g. <lastname><:lower>.

The option :umlauts can be used to convert special characters such as è, ä or ß into the corresponding ASCII characters.

The option :alphanum can be used to remove all non alphanumeric characters such as ` (backtick) or # (hash). A whitelist of characters that are ignored by this option can be defined in the UCR variable directory/manager/templates/alphanum/whitelist. If this option is applied to an entire field, even manually placed symbols like the @ in an email address are removed. To avoid that, this option should be applied to specific attributes only or needed symbols should be entered into the whitelist.

The options :strip or :trim remove all white space characters from the start and end of the string.

It is also possible to combine options, e.g: :umlauts,upper.