Field Properties on a Profile Screen

You select a field to edit its properties. Each field style has different properties, which define the display, permissions, and defaults for that property.
cim1268
You select a field to edit its properties. Each field style has different properties, which define the display, permissions, and defaults for that property.
Note:
The option that you select in the Style field determines the properties that are displayed in the Field Properties screen. You may not see all of the properties described in this list.
You can set the following properties (in alphabetical order) for a field:
  • Attribute Name
    Specifies the name of the object attribute.
  • Available Values Label
    Sets the text that appears above the list box, which contains the items that are available for selection in the option selector.
  • Checked Value
    Specifies the value of a field when its check box is selected. For example, the checked value for the Enabled field is true.
    The default value is true.
    Note:
    This field is visible when the checkbox style is selected.
  • Columns
    Specifies the width in characters for the text area.
    Note:
    This field is available only when you select the Text Area style.
  • CSS Class
    Specifies the Cascading Style Sheet class that controls the presentation of this field.
  • CSS Style
    Specifies the Cascading Style Sheet rules that control the presentation of this field.
    You can use this field to set the width of a field. For example, to set the width of a field with a Drop Down style to 300 pixels, specify width:300px in the CSS Style field:
    Note:
    By default, the width of fields that include a list of values, such as a drop down or multi-selector box, is set to auto ({width:auto}). This setting sizes the field to accommodate the largest value in the field. For example, if the largest value in the City option selector field is San Francisco, the option list is sized to display the entire value. 
    You can also use the CSS Style field to control other display properties, such as text size and background color.
  • Current Values Label
    Sets the text that appears above the list box that contains selected items in the object selector.
  • Date Display Pattern
    Determines the format of dates displayed in a field and in the Date Picker control.
  • Date Storage Pattern
    Determines how
    Identity Manager
    stores dates in user stores.
  • Default
    Indicates the value that is displayed by default, and that is stored in the profile if no other value is provided. For a checkbox, enter true to make the default enabled; enter false to make the default disabled.
    Note
    : Default values apply to Create tasks only. If you set a default value for a field that is used in a Modify or View task, the default value will not appear in the screen.
  • Default JavaScript
    Enables you to use JavaScript to set the default value for a field. Using JavaScript, you can set the value dynamically. For example, you can set a default value based on other attributes.
    Use this field for Create tasks only.
  • Disable AutoComplete
    Disables the AutoComplete feature in Internet Explorer. If this check box is selected, Internet Explorer does not attempt to provide suggestions for the field values based on previous entries.
    For more information on the AutoComplete feature, see the documentation for Internet Explorer.
  • Initialization JavaScript
    Enables you to use JavaScript to set the default value for a field. Use this field for any task type.
  • Note:
    The JavaScript in this field executes after the JavaScript in the Default JavaScript field for Create tasks.
  • Field span
    Specifies the number of columns that the field spans (excluding the label)
  • Field to Match Against
    Specifies the field that
    Identity Manager
    checks for a matching value. You can use this feature to verify that the value of two fields on a screen match. This field is typically used to verify that a password or other critical information is entered correctly. For example, a profile screen can include Password and Confirm Password fields. For the Confirm Password field, the value of the Field to the Match Against field would be the Password field.
    Note:
     
    Identity Manager
    uses a screen-defined logical attribute to verify that the value of two fields on a screen match. For the Field to Match Against field to appear, the Attribute Name field must be set to (Screen Logical Attribute).
  • Label right
    Specifies text that appears to the right of the field. You can use the Label right field to provide a description or help text for fields on a Profile screen.
  • Label span
    Specifies the number of columns that the label spans.
  • Max Length
    Sets the maximum number of characters that can be entered for this field.
  • Name
    Specifies the label that you want for this attribute in the screen.
  • Permission
    Determines the privilege level for the field.
    Note:
    If a field is required, choose a Required setting. Required fields are indicated by a dot in the screen.
  • Preserve non-options
    Controls whether
    Identity Manager
    preserves existing values for an attribute, if those values are not valid. For example, a State field includes the options Massachusetts and New York. However, an existing user is from California. If this option is selected,
    Identity Manager
    displays California as if it was a valid option for that user. If this option is not selected,
    Identity Manager
    displays the first option in the list (Massachusetts). If the field is not required, the value is blank.
    • Default
      Identity Manager
      forces the user to select only the valid options.
  • Rows
    Specifies the number of rows that a text area for user input should include.
    For example, you can want to define a text area for the Description field, which allows users to enter four rows of text.
    Note:
    This field is available only when you select the Text Area style.
  • Show Time Picker
    Displays a calendar control that users can use to select a date and time.
  • Show Typing
    Data is displayed as text while typing if the cursor is placed in the field. Data is displayed as asterisks (*) if the cursor is outside the field. 
    Note:
    This configuration is available only when Style of the field is Password.
  • Size
    Specifies the size of the field. Enter a number based on the style of field. For text and password, enter the number of characters. For drop-down, select, multi-select, and multi-text, enter the number of rows.
  • Source of Selection Options
    Specifies how a field that contains multiple options is populated.
    • None
      Identity Manager
      does not use an external source for selection options.
    • Select Box Data
      Specifies that
      Identity Manager
      populates the options in the field using select box data.
    • Simple List
      Allows you to enter a list of options in a text box. If you select this option, the following field appears:
      Selection Options
      Enter options on separate rows. If the option has separate display and storage values, enter them as "storage-value;display-value".
    • Depends on the value of another field
      Specifies that
      Identity Manager
      populates the options in the field based on options in another field on the task screen. The other field must also be populated using select box data, or also depend on the value of another field.
      Dependency on another field is defined in the select box data configuration.
    • Javascript
      Specifies JavaScript that contains the options for the field. If you select this option, the following field appears:
      Selection Options (JavaScript)
      This JavaScript must contain a function with the signature "function getOptions(FieldContext)," and return a pipe delimited string of options. If the option has separate display and storage values, they must be separate by a semicolon (;).
  • Style
    Determines the presentation of the field.
    Style Options lists styles that you can select for a field.
  • Tip Text
    Specifies text that describes a field. The text appears on the screen next to the field to which it applies.
  • Unchecked Value
    Specifies the value of a field when its check box is cleared. For example, the unchecked value for the Enabled field is false.
    The default value is false.
    Note:
    This field is visible when the checkbox style is selected.
    • Allow Other Unchecked Values
      When unchecked, sets the value of the attribute to false in the user store if the attribute is empty. When checked,
      Identity Manager
      allows the attribute to be empty.
      Use this field to automatically set empty attributes to false in the user store.
  • Validation Expression
    Contains a regular expression that performs task-level validation.
  • Validation Java Class
    Contains the fully-qualified name of a Java class that performs the validation, for example:
    com.mycompany.MyJavaValidator
    Identity Manager
    expects the class file to be located in the root directory designated for custom Java class files.
  • Validation JavaScript
    Contains the complete JavaScript code that performs the validation.
    You can also use this field to specify JavaScript code that dynamically hides/shows and enables/disables particular fields based on current values of other fields.
    Note:
    You must provide JavaScript code in this field. With task-level validation, you cannot reference a file containing JavaScript code.