Add (plus) button

Click this button to add new fields that will be displayed on the Approval Requests page.

Order column

This column displays the number denoting the order in which to place the corresponding field.

On the larger screens fields are displayed in two columns and ordered left, right, left, right, and so on based on this field.

For example, they are displayed like this:

1 2

3 4

5 6

On smaller screens (i.e. mobile devices), there is only one column of fields and they are ordered by this field value.

Source column

The column contains the system from where the corresponding field originates. This can either be one of the issue tracking systems defined for this profile or Internal to denote that this field is a SAM internal field.

Source Field column

This column contains the name of the field (from the system selected in the source column) whose value is used to populate the corresponding field.

You can optionally select the <DIVIDER> option in the System fields to add a line to the approval profile to separate the fields on the page.

Mapped System Field column

This column contains the SAM field where the external system data, as identified in the two previous columns, will be stored.

NOTE:  The Mapped System Field is inactive if the Source column is set to Internal.

This column value is optional. If it is not specified, then the external field value is only displayed and will not be stored within SAM.

Override Label column

This column contains the override field label that is optional and will be displayed next to the corresponding field on the Approval Request page. If no value is entered here, then the default field label is used as the label. These default labels are specified in the Field Administration page.

For example, suppose that you select the following field values:

• The Source is Sample Bug System.
• The Source Field is ID.
• The Mapped System Field is Bug Number.
• Override Label is Bug #.

That means that the SAM application will pull the ID field from Sample Bug System, display it in a field labeled Bug # on the Approval Request page, and then store it in Bug Number internal field.

Default View column

If this check box is selected, then the field is displayed in the expanded record.

NOTE:  If Multiple Issue Approval is not enabled, then this field can be ignored.

Header column

If this check box is selected, then the field is displayed in the header of the collapsed record.

NOTE:  If Multiple Issue Approval is not enabled, then this field can be ignored.

Enable URL column

If this check box is selected, then the drilldown icon will be displayed next to this field on the Approval Request page.

Validation Values and Message columns

These columns display the validation values and corresponding messages. When no value is added, the column displays None. A regular expression can be optionally entered in the Validations Values field. When the Approval Request page is loaded, the value of the field is compared with this regular expression and the following happens:

1. If the value matches with the regular expression, then the field is displayed with a check mark (in Green).
2. If the value does not match, then:
   • The field is displayed with an alert symbol (in Red)
   • The buttons for any actions that have the Validate? flag selected will be disabled
   • The message selected for Validation Message is displayed for the field.

Validation Values and Message columns (continued)

The following are a few examples of regular expressions:

• Regular Expression: 1.([0-9]|1[0-9])

  Description: Range from 1.0 to 1.19

  Examples: 1.2, 1.18

• Regular Expression: 1.2

  Description: Equals the value 1.2 exactly

  Examples: 1.2

• Regular Expression: 1.2|1.3

  Description: Either of the two values, 1.2 or 1.3

  Examples: 1.2,1.3

• Regular Expression: Siebel \s+Engineering

  Description: Two strings, Siebel and Engineering, separated by a white space

  Examples: Siebel Engineering

• Regular Expression: Siebel \s+Engineering*

  Description: Two strings, Siebel and Engineering, separated by a white space and followed by any other characters (wildcard)

  Examples: Siebel Engineering Tools

• Regular Expression: .*(Engineering|Installer).*

  Description: Any string that contains either the string Engineering or the string Installer

  Examples: Siebel Installer for IP

For more information on how to add new message into the SAM application, see Specifying Messages.

Delete button

Click the Delete button to delete the corresponding field from the Fields list. The deleted field will not be displayed on the Create Approval Requests page.