Sun Identity Manager Deployment Reference

Form Components

The following table identifies form components in the order in which they appear in the form. Each form component is discussed in greater detail below.

Table 2–7 Form Components

Form Component  



Introduces information about the form object definition. Includes start tags for <Form>, <Extension>, and <Configuration> elements and defines form properties (such as title, subtitle, titleWidth displayed when the form is launched).

form body 

Contains field definitions, form functions, form variables. This is the part of the form that you will edit. 


Closing tags for <Form>, <Extension>, and <Configuration> elements.


The form header includes:

The header contains information about the form, including internal identification such as date of creation, login of whoever last modified the file, and the form type. The page processor typically generates this information.

Note –

The system generates the following information for internal use only. Do not edit these attributes.

Table 2–8 Form Header Components




Required to wrap the <Form> element.



Contains information that the system uses internally when processing the form object, including the date of last modification and login of the user who last modified this form. Most of this information is typically associated with any persistent object that is stored in the Identity Manager repository. You typically do not need to edit this information. 

Configuration id=’#ID#UserForm:EndUserMenu’ name=’End User Menu’ createDate=’1012185191296’ lastModifier=’Configurator’ lastModDate=’1013190499093’ lastMod=’44’ counter=’0’ wstype=’UserForm’>

Form Body

The form body is composed of:

The following table lists form header properties.

Table 2–9 Form Header Properties




Identifies the text that appears at the top of the form. Typically, this title is in a bold font typically larger than the other font on the screen. The form title appears under the Identity Manager page. You cannot edit the display characteristics of title.

In the example given in the section titled Form Components, the value of title is User Self Service


Identifies text that appears under title of the form on the page defined by this form. You cannot edit the display characteristics of title. 

In the preceding example, the value of subtitle is Select one of the following options


Defines the width in pixels of the value of title in the browser window. 

The following table lists all elements that can occur within the form body.

Table 2–10 Elements that Can Occur within the Form Body





Defines an XPRESS function. This element can be called by any field element in a form. 

<defun name=’add100’>

<def arg name=’x’/>





Defines an XPRESS variable that is used to hold the results of a computation. 

<defvar name=’nameLength’






Identifies the display components that will define the appearance of the field. See the section titled Display Element for more information.

<Display class=’LinkForm’>

<Property name=’title’ value=’User Self Service’/>

<Property name=’subtitle’ value=’Select one of the following options’/>



Main element used within the form body. See the section titled Field Element for more information.

<Field name=’fullname’/>


Provides a reference to a field defined in an included form. 

<FieldRef name=’fieldName’/>


Provides a reference to another form object. Once included in the current form, the fields defined in the form can be referenced and displayed. 


<ObjectRef type=’UserForm’ id=’#ID#UserForm:UserFormLibrary’/>



Provides a reference to another form object. 

<FormRef name=’formName’/>


Provides a way to define a shortcut to a view. The shortened name can then be used in field names and references instead of the longer name. When using the name substitution, use a colon (:) following the name. 

<Namespace name=’w’ value=’waveset’/>

Form Element

The <Form> element must surround all Field elements and contains the unique name of the form. The elements listed on the previous page are contained within the beginning and ending Form tags.

Example 2–4 Sample Form Element

<Form name=’Create User Form’
   <Field name=’waveset.accountId’>

additional fields


Additional example:

<Form name=’Task Launch Form’>
   <Display class=’EditForm’>
      <Property name=’title’ value=’Task Launch’/>
      <Property name=’subTitle’ value=’Enter task launch parameters’/>

Display Element

A Display element within the Form element describes the component that will be used to render the form. By default, this Display element is the used EditForm component. You will rarely need to change the Form component class, but you can set component properties. The two most common properties to specify are title and subTitle.

EditForm also supports the adjacentTitleWidth property, which can be used to set the width of the titles of adjacent fields. If this property is not defined, it defaults to zero.

If you define adjacentTitleWidth as equal to zero, columns titles will automatically resize. If set to a non-zero value, then the title width of adjacent columns (for example, the second and third columns) will be the value of adjacentTitleWidth.

<Form name=’Default User Form’ help=’account/modify-help.xml’>
   <Display class=’EditForm’>
     <Property name=’titleWidth’ value=’120’>
     <Property name=’adjacentTitleWidth’ value=’60’>

Field Element

The Field element is the main element used within the form body. Fields are used to define each of the user’s attributes. You can use Field elements to include XPRESS logic in form fields. For more information on working with form field elements, refer to the section titled Defining Fields.

The following example creates an editing field with the label Email address.

<Field name=’’>
   <Display class=’Text’>
      <Property title=’Email Address’/>
      <Property size=’60’/>
      <Property maxLength=’128’/>

The name of an editing field is typically a path expression within a view that is being used with the form. In this example, refers to the email address associated with a user object in the Identity Manager repository.


The footer contains information about the Identity Manager object group or organization with which the form is associated. It also contains the closing tags for the </Form>, </Extension>, and </Configuration> elements or other elements opened in the header. The footer in the preceding example is:

      <ObjectRef type=’ObjectGroup’ id=’#ID#Top’ name=’Top’/>

<MemberObjectGroups> identifies the object group or organization into which the system stores an object. If you do not specify an object group, by default the system assigns the object to the Top organization. For Configuration objects that contain forms, are typically found in the All group with this syntax:

   <ObjectRef type=’ObjectGroup’ name=’All’/>