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