custom fields constants

lam/HISTORY

@@ -3,6 +3,7 @@ September 2017 6.1
   - LAM Pro:
    -> Custom fields: support wildcards in text fields such as $firstname
    -> Custom fields: specify minimum/maximum count for multi-value entries
+   -> Custom fields: new type for constant values
   - Fixed bugs:
    -> Password modify page reports error on password change when posixAccount is present for users
    -> Nginx configuration files did not include "fastcgi_param SCRIPT_FILENAME $request_filename;" (193)

lam/docs/manual-sources/chapter-modules.xml

@@ -5130,9 +5130,17 @@ OK (10 msec)</programlisting>
     <para><emphasis role="bold">Constant value</emphasis></para>
 
     <para>This will set the attribute to a constant value. You can also
-    specify wild cards to inject other attribute's values:</para>
+    specify wildcards to inject other attribute's values.</para>
 
-    <para>Wildcards</para>
+    <screenshot>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/customFields28.png" />
+        </imageobject>
+      </mediaobject>
+    </screenshot>
+
+    <para>Wildcards:</para>
 
     <itemizedlist>
       <listitem>
@@ -5160,7 +5168,7 @@ OK (10 msec)</programlisting>
       </listitem>
 
       <listitem>
-        <para>(attribute): space if attribute is set</para>
+        <para>((attribute)): space if attribute is set</para>
       </listitem>
 
       <listitem>
@@ -5173,45 +5181,53 @@ OK (10 msec)</programlisting>
     memberUid=("user1", "user2") (specified value -&gt; resulting LDAP
     value):</para>
 
-    <itemizedlist>
+    <table border="1">
-      <listitem>
+      <caption></caption>
-        <para>"my constant" -&gt; "my constant"</para>
-      </listitem>
 
-      <listitem>
+      <tr>
-        <para>"%gn%" -&gt; "Steve"</para>
+        <th>Constant value</th>
-      </listitem>
 
-      <listitem>
+        <th>Resulting LDAP value</th>
-        <para>"%gn%(gn)%sn%" -&gt; "Steve Miller" (would be "Miller" if gn is
+      </tr>
-        empty)</para>
-      </listitem>
 
-      <listitem>
+      <tr>
-        <para>"§memberUid|, §" -&gt; "user1, user2"</para>
+        <td>my constant</td>
-      </listitem>
-    </itemizedlist>
 
-    <para id="customFields_validation_expressions_admin"><emphasis
+        <td>my constant</td>
-    role="bold">Validation expressions:</emphasis></para>
+      </tr>
 
-    <para>The validation expressions follow the standard of <ulink
+      <tr>
-    url="http://perldoc.perl.org/perlre.html">Perl regular
+        <td>%gn%</td>
-    expressions</ulink>. They start and end with a "/". The beginning of a
-    line is specified by "^" and the end by "$".</para>
 
-    <para>Examples:</para>
+        <td>Steve</td>
+      </tr>
 
-    <para>/^[a-z0-9]+$/ allows small letters and numbers. The value must not
+      <tr>
-    be empty ("+").</para>
+        <td>%gn%((gn))%sn%</td>
 
-    <para>/^[a-z0-9]+$/i allows small and capital letters ("i" at the end
+        <td>Steve Miller (would be "Miller" if gn is empty)</td>
-    means ignore case) and numbers. The value must not be empty ("+").</para>
+      </tr>
 
-    <para>Special characters that must be escaped with "\": "\", ".", "(",
+      <tr>
-    ")"</para>
+        <td>§memberUid|, §</td>
 
-    <para>E.g. /^[a-z0-9\.]$/i</para>
+        <td>user1, user2</td>
+      </tr>
+    </table>
+
+    <para></para>
+
+    <para>Presentation:</para>
+
+    <para>The LDAP value will be shown as text.</para>
+
+    <screenshot>
+      <mediaobject>
+        <imageobject>
+          <imagedata fileref="images/customFields29.png" />
+        </imageobject>
+      </mediaobject>
+    </screenshot>
 
     <literallayout>
 </literallayout>
@@ -5240,6 +5256,30 @@ OK (10 msec)</programlisting>
         </imageobject>
       </mediaobject>
     </screenshot>
+
+    <literallayout>
+</literallayout>
+
+    <para id="customFields_validation_expressions_admin"><emphasis
+    role="bold">Validation expressions:</emphasis></para>
+
+    <para>The validation expressions follow the standard of <ulink
+    url="http://perldoc.perl.org/perlre.html">Perl regular
+    expressions</ulink>. They start and end with a "/". The beginning of a
+    line is specified by "^" and the end by "$".</para>
+
+    <para>Examples:</para>
+
+    <para>/^[a-z0-9]+$/ allows small letters and numbers. The value must not
+    be empty ("+").</para>
+
+    <para>/^[a-z0-9]+$/i allows small and capital letters ("i" at the end
+    means ignore case) and numbers. The value must not be empty ("+").</para>
+
+    <para>Special characters that must be escaped with "\": "\", ".", "(",
+    ")"</para>
+
+    <para>E.g. /^[a-z0-9\.]$/i</para>
   </section>
 
   <section>

lam/docs/manual-sources/chapter-selfService.xml

@@ -1549,27 +1549,110 @@
         </mediaobject>
       </screenshot>
 
-      <para id="customFields_validation_expressions"><emphasis
+      <literallayout>
-      role="bold">Validation expressions:</emphasis></para>
+</literallayout>
 
-      <para>The validation expressions follow the standard of <ulink
+      <para><emphasis role="bold">Constant value</emphasis></para>
-      url="http://perldoc.perl.org/perlre.html">Perl regular
-      expressions</ulink>. They start and end with a "/". The beginning of a
-      line is specified by "^" and the end by "$".</para>
 
-      <para>Examples:</para>
+      <para>This will set the attribute to a constant value. You can also
+      specify wildcards to inject other attribute's values.</para>
 
-      <para>/^[a-z0-9]+$/ allows small letters and numbers. The value must not
+      <screenshot>
-      be empty ("+").</para>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="images/customFields28.png" />
+          </imageobject>
+        </mediaobject>
+      </screenshot>
 
-      <para>/^[a-z0-9]+$/i allows small and capital letters ("i" at the end
+      <para>Wildcards:</para>
-      means ignore case) and numbers. The value must not be empty
-      ("+").</para>
 
-      <para>Special characters that must be escaped with "\": "\", ".", "(",
+      <itemizedlist>
-      ")"</para>
+        <listitem>
+          <para>%attribute%: attribute value</para>
+        </listitem>
 
-      <para>E.g. /^[a-z0-9\.]$/i</para>
+        <listitem>
+          <para>@attribute@: first character of attribute</para>
+        </listitem>
+
+        <listitem>
+          <para>?attribute?: first character of attribute in lower case</para>
+        </listitem>
+
+        <listitem>
+          <para>!attribute!: first character of attribute in upper case</para>
+        </listitem>
+
+        <listitem>
+          <para>??attribute??: attribute in lower case</para>
+        </listitem>
+
+        <listitem>
+          <para>!!attribute!!: attribute in upper case</para>
+        </listitem>
+
+        <listitem>
+          <para>((attribute)): space if attribute is set</para>
+        </listitem>
+
+        <listitem>
+          <para>§attribute|;§; attribute values separted by ";" (you can set
+          other separators if you want)</para>
+        </listitem>
+      </itemizedlist>
+
+      <para>Examples for attributes gn="Steve", sn="Miller" and
+      memberUid=("user1", "user2") (specified value -&gt; resulting LDAP
+      value):</para>
+
+      <table border="1">
+        <caption></caption>
+
+        <tr>
+          <th>Constant value</th>
+
+          <th>Resulting LDAP value</th>
+        </tr>
+
+        <tr>
+          <td>my constant</td>
+
+          <td>my constant</td>
+        </tr>
+
+        <tr>
+          <td>%gn%</td>
+
+          <td>Steve</td>
+        </tr>
+
+        <tr>
+          <td>%gn%((gn))%sn%</td>
+
+          <td>Steve Miller (would be "Miller" if gn is empty)</td>
+        </tr>
+
+        <tr>
+          <td>§memberUid|, §</td>
+
+          <td>user1, user2</td>
+        </tr>
+      </table>
+
+      <para></para>
+
+      <para>Presentation:</para>
+
+      <para>The LDAP value will be shown as text.</para>
+
+      <screenshot>
+        <mediaobject>
+          <imageobject>
+            <imagedata fileref="images/customFields29.png" />
+          </imageobject>
+        </mediaobject>
+      </screenshot>
 
       <literallayout>
 </literallayout>
@@ -1598,6 +1681,31 @@
           </imageobject>
         </mediaobject>
       </screenshot>
+
+      <literallayout>
+</literallayout>
+
+      <para id="customFields_validation_expressions"><emphasis
+      role="bold">Validation expressions:</emphasis></para>
+
+      <para>The validation expressions follow the standard of <ulink
+      url="http://perldoc.perl.org/perlre.html">Perl regular
+      expressions</ulink>. They start and end with a "/". The beginning of a
+      line is specified by "^" and the end by "$".</para>
+
+      <para>Examples:</para>
+
+      <para>/^[a-z0-9]+$/ allows small letters and numbers. The value must not
+      be empty ("+").</para>
+
+      <para>/^[a-z0-9]+$/i allows small and capital letters ("i" at the end
+      means ignore case) and numbers. The value must not be empty
+      ("+").</para>
+
+      <para>Special characters that must be escaped with "\": "\", ".", "(",
+      ")"</para>
+
+      <para>E.g. /^[a-z0-9\.]$/i</para>
     </section>
   </section>