Text Fields

Attributes

The following Text field attributes can be modified for default fields in projects and transition fields. Attributes set for fields in the Default Fields list apply to all transitions; attributes set for fields for a transition apply only to that transition.

Allow Override
For projects, select this check box to override field properties inherited from the parent project or workflow.
Required
Indicates that users are required to provide a value for this field. If a value was previously set for the field, the field label appears in green, italic text on forms.
Allow Mass Update
Indicates that the field is available when users mass update items in a project. Mass updates allow users to simultaneously transition, update, or delete multiple primary items and to simultaneously update or delete multiple auxiliary items.
Read Only
Indicates that users can view but not edit the field.

Defaults

Set or override a default value for the field as needed.

Note: You cannot change the default value for the system Item ID field.

You can use a Rich Text Editor to format default values for Memo and Journal fields if the Enable Rich Text check box is selected in the Display Options section.

If you choose to manually enter HTML as a default value, be aware that obviously "suspicious" ("dangerous") HTML is not rendered at runtime.

The following tags are considered suspicious:

<applet, </applet
<embed, </embed
<form, </form
<frame, </frame
<iframe, </iframe
<input, </input
<script, </script
<textarea, </testarea

The following tags may not be rendered at runtime unless they are added using the Rich Text Editor. These tags will not be rendered if they contain suspicious attributes, such as onload or onclick:

<a, </a
<img, </img (Rendered only when added at runtime)

Remember: Improper or invalid HTML could have a negative impact on the field and possibly on the entire form. Refer to the World Wide Web Consortium Web site at http://www.w3.org for information about HTML syntax.

If the Enable Rich Text check box is cleared for the field, only plain text is allowed. Carriage or hard returns can be entered in the default values for Memo and Journal fields, but not for Fixed Length fields.

Transition Actions

The following options are available for fields when you are editing a transition and enable you to control field values for the transition. For example, you may want to clear an existing value for a required field when a transition is executed, forcing users to provide a new value. These options apply to all field types for transitions.

Leave Value Unchanged
Select to retain the field's current value when the transition is complete.
Clear Value
Select to clear the field's current value.
Set Value to Default Value
Select to use a default value for the field as the user executes the transition. You can then select a default value.

Note: For Text fields that are set as Journal fields, the default value is always appended to current values, if they exist.

Display Options

You can also view the following settings, which are defined in SBM Composer. These settings cannot be modifed in Application Administrator.

Style — Indicates the field's style:
- Memo
  Allows users to enter up to approximately 64,000 unicode characters.
- Journal
  Automatically inserts a date, time, and user ID when users add text to the field. The Journal field's timestamp entry is stored in the database as the modified Julian date, which is the number of seconds since Jan. 1, 1970 in UTC.
- Fixed Length of n characters
  Indicates the number of allowed unicode characters, up to a maximum of 255.
Require Appended Text
Available for Journal fields only. Indicates that users are required to append text to information already provided for the field.
Append Only
Available for Journal fields only. Indicates that users can only append text to existing Journal entries. If this check box is cleared, users can modify data in existing entries.
Prefix and Suffix
Indicates provided prefix and suffix for values for the field. The prefix and suffix can contain formatting HTML or plain text.
Include Field in Keyword Searches
Indicates that users can search for data in this field using Basic Search, Advanced Search, Global Search, and the Knowledge Base.
Enable Rich Text
Indicates that the Rich Text Editor is enabled for the field. This enables users to apply basic formatting to text in the field, and for you to format default values.

If HTML5 features are disabled for your system, HTML tags added to the field are rendered at runtime if this option is selected.

The Enable Rich Text option applies only to Memo and Journal fields. This setting can be changed in SBM Composer.

Note: If you enable Rich Text for a field, but HTML5 features are disabled for your system, users can manually type HTML tags into the field, and they will be rendered on State form.