diff --git a/lam/HISTORY b/lam/HISTORY index e234dae9..48fc886b 100644 --- a/lam/HISTORY +++ b/lam/HISTORY @@ -1,5 +1,7 @@ June 2012 - quick (un)lock for users + - LAM Pro: + -> Custom fields module allows to manage custom LDAP attributes in Self Service 25.03.2012 3.7 diff --git a/lam/docs/manual-sources/howto.xml b/lam/docs/manual-sources/howto.xml index 6a4f46d1..2a81cef2 100644 --- a/lam/docs/manual-sources/howto.xml +++ b/lam/docs/manual-sources/howto.xml @@ -3083,6 +3083,245 @@ Run slapindex to rebuild the index. module in slapd.conf to use this feature. +
+ Custom fields (LAM Pro) + + This module allows you to manage LDAP attributes that are not + covered by the other LAM modules (e.g. if you use custom LDAP schemas). + You can fully define how your input fields look like: + + + + Label + + + + LDAP attribute name + + + + Unique name for field + + + + Read-only display + + + + Field type: text, password, text area, checkbox, radio + buttons, select list + + + + Validation via regular expression + + + + Error message if validation fails + + + + Attention: This module is only + available for LAM Pro Self Service. + + To create custom fields for the Self Service please edit your Self + Service profile and switch to tab "Module settings". Here you can add a + new field. Simply fill the fields and press on "Add". + + Please note that the field name cannot be changed later. It is the + unique ID for this field. + + After you created your fields please press on "Sync fields with + page layout". Now you can switch to tab "Page layout" and add your new + fields like any other standard field. + + + + + + + + + + Examples for fields and their representation in Self + Service: + + Text field: + + Text fields can be set read-only. They allow to specify a validation + expression and error message. + + + + + + + + + + Presentation in Self Service: + + + + + + + + + + Password field: + + You can also manage custom password fields. LAM Pro will display + two fields where the user must enter the same password. You can hash the + password if needed. + + + + + + + + + + Presentation in Self Service: + + + + + + + + + + Text area: + + This adds a multi-line field. The options are similar to text + fields. Additionally, you can set the size with the number of columns + and rows. + + Please note that the validation + expression should be set to multi-line. This is done by adding + "m" at the end. + + + + + + + + + + Presentation in Self Service: + + + + + + + + + + Checkbox: + + Sometimes you may want to allow only yes/no values for your LDAP + attributes. This can be represented by a checkbox. You can specify the + values for checked and unchecked. The default value is set if the LDAP + attribute has no value. + + + + + + + + + + Presentation in Self Service: + + + + + + + + + + Radio buttons: + + This displays a list of radio buttons where the user can select + one value. + + You can specify a mapping of LDAP attribute values and their + display (label) on the Self Service page. To add more mapping fields + please press "Add more mapping fields". + + + + + + + + + + Presentation in Self Service: + + + + + + + + + + Select list: + + Select lists allow the user to select a value in a large list of + options. The definition of the possible values and their display is + equal to radio buttons. + + + + + + + + + + Presentation in Self Service: + + + + + + + + + + Validation expressions: + + The validation expressions follow the standard of Perl regular + expressions. They start and end with a "/". The beginning of a + line is specified by "^" and the end by "$". + + Examples: + + /^[a-z0-9]+$/ allows small letters and numbers. The value must not + be empty ("+"). + + /^[a-z0-9]+$/i allows small and capital letters ("i" at the end + means ignore case) and numbers. The value must not be empty + ("+"). + + Special characters that must be escaped with "\": "\", ".", "(", + ")" + + E.g. /^[a-z0-9\.]$/i +
+
Custom scripts (LAM Pro) diff --git a/lam/docs/manual-sources/images/customFields1.png b/lam/docs/manual-sources/images/customFields1.png new file mode 100644 index 00000000..d387c7f5 Binary files /dev/null and b/lam/docs/manual-sources/images/customFields1.png differ diff --git a/lam/docs/manual-sources/images/customFields10.png b/lam/docs/manual-sources/images/customFields10.png new file mode 100644 index 00000000..1bd975bb Binary files /dev/null and b/lam/docs/manual-sources/images/customFields10.png differ diff --git a/lam/docs/manual-sources/images/customFields11.png b/lam/docs/manual-sources/images/customFields11.png new file mode 100644 index 00000000..dcc851c9 Binary files /dev/null and b/lam/docs/manual-sources/images/customFields11.png differ diff --git a/lam/docs/manual-sources/images/customFields12.png b/lam/docs/manual-sources/images/customFields12.png new file mode 100644 index 00000000..0b271d3e Binary files /dev/null and b/lam/docs/manual-sources/images/customFields12.png differ diff --git a/lam/docs/manual-sources/images/customFields13.png b/lam/docs/manual-sources/images/customFields13.png new file mode 100644 index 00000000..49815092 Binary files /dev/null and b/lam/docs/manual-sources/images/customFields13.png differ diff --git a/lam/docs/manual-sources/images/customFields2.png b/lam/docs/manual-sources/images/customFields2.png new file mode 100644 index 00000000..1ac8f6fb Binary files /dev/null and b/lam/docs/manual-sources/images/customFields2.png differ diff --git a/lam/docs/manual-sources/images/customFields3.png b/lam/docs/manual-sources/images/customFields3.png new file mode 100644 index 00000000..218c8360 Binary files /dev/null and b/lam/docs/manual-sources/images/customFields3.png differ diff --git a/lam/docs/manual-sources/images/customFields4.png b/lam/docs/manual-sources/images/customFields4.png new file mode 100644 index 00000000..2935f144 Binary files /dev/null and b/lam/docs/manual-sources/images/customFields4.png differ diff --git a/lam/docs/manual-sources/images/customFields5.png b/lam/docs/manual-sources/images/customFields5.png new file mode 100644 index 00000000..5e2b4457 Binary files /dev/null and b/lam/docs/manual-sources/images/customFields5.png differ diff --git a/lam/docs/manual-sources/images/customFields6.png b/lam/docs/manual-sources/images/customFields6.png new file mode 100644 index 00000000..06f4486d Binary files /dev/null and b/lam/docs/manual-sources/images/customFields6.png differ diff --git a/lam/docs/manual-sources/images/customFields7.png b/lam/docs/manual-sources/images/customFields7.png new file mode 100644 index 00000000..95fbe3ce Binary files /dev/null and b/lam/docs/manual-sources/images/customFields7.png differ diff --git a/lam/docs/manual-sources/images/customFields8.png b/lam/docs/manual-sources/images/customFields8.png new file mode 100644 index 00000000..fbe9bb61 Binary files /dev/null and b/lam/docs/manual-sources/images/customFields8.png differ diff --git a/lam/docs/manual-sources/images/customFields9.png b/lam/docs/manual-sources/images/customFields9.png new file mode 100644 index 00000000..6a5d819a Binary files /dev/null and b/lam/docs/manual-sources/images/customFields9.png differ