Form to attach approval request forms to approval server


The AP:Form form is linked to the Form tab of the AP:Administration form. Process administrators use the AP:Form form to attach approval request forms to the Approval Server.

Basic tab

On the Basic tab, specify the values for the basic form settings as shown in the following image and table:

AP:Form—Basic tab

22_1_approval_form_basic_tab.png

Fields on the AP:Form form—Basic tab

Field

Description

Form Name

Select a form on the current server, or type a form name.

Lookup Keyword

Type a keyword to be used by the Approval Server when searching for this form. The keyword acts as a permanent search term, even if the name of the form changes.

Used By

This field contains the name of the AR System application that uses this form. AR System populates this field with Approval.

Approval Reporting

Enter the name of a form used for reporting, if any.

Assignee Group Permission

The AR System populates this field with the Assignee Group for the request. This field supports the multi-tenancy feature.

Request ID Link Association

The Request ID Link Association has three options to check the link association for the form specified in the Form Name field.

  • Application Request Form—Opens the application request form associated with the form specified in the Form Name field.
    For example, this option opens the CHG:Infrastructure Change form for Change Management users.
  • Approval-Application 3-Way-Join Form—Opens all the join forms associated with the form specified in the Form Name field.
    For example, this option opens the CHG:ChangeAPDetailSignature form for Change Management users.
  • Customize—When you select Customize, you can open any form associated with the form specified in the Form Name field, other than Application Request Form and Approval-Application 3-Way Join Form.
    For example, this option opens the SRS:RequestDetails form for Service Request Management users.

View Label

Select a specific view name on the form. The selected view opens when you click the Request ID.

Save

In Submit mode, click this button to save your changes.

Close

Click this button to close the window.

Advanced tab

As a process administrator, use the Advanced tab to define field mappings for a request form at the application level. These mappings are not mandatory. Not all field types are supported for mapping.

Supported field types

Unsupported field types

  • Character
  • Integer
  • Real
  • Date/Time
  • Currency
  • Date
  • Time
  • Diary
  • Attachment
  • Check box/Radio box


Warning

If you define mappings on the unsupported field types on the AP:Form form, the Approval Server might fail.

AP:Form—Advanced tab

22_1_approval_form_advanced_tab.png

The fields on this form are reserved field IDs in the Approval Server. You can map them to other fields on the application forms by using the corresponding menus. The values from the mapped fields are displayed on Approval Central and AP:Show-Detail.

The following table describes where these values appear:

Fields on the AP:Form form—Advanced tab

Field

Description

Application Request ID

Map to an application ID, which could be the request ID or any other ID field in the application.

For example, Change Management uses its own IDs to represent a particular record, apart from the one generated by AR System. You can map this field to that field from the Change Management application. The value from the mapped field is displayed on Approval Central as the Request ID link. If the value is NULL, the request ID is displayed by default. For more information, see Approval-Central.

Requestor

Map to a user field on the application form. The value from the mapped field is displayed in the Requestor column on Approval Central.

Field 1 {14506}

The value from the mapped field is displayed in the Summary column on Approval Central.

Field 2 {14507}

Currently, the Approval Server does not use Field 2. This field was used in releases earlier than version 7.5.00 to display certain fields on the approval console.

Field 3 {14508}  Field 4 {14509}  Field 5 {14510} Field 6 {14511}

The values from the mapped fields are displayed in the top panel on AP:Show-Detail. For example, for a request of the Lunch Scheduler sample application, these values appear against the following labels:

  • P-C GL Account
  • P-C Cost Center
  • P-C Total Cost
  • P-C Phase

In your application, you can specify the labels that should appear for these fields on AP:Show-Detail.

Field 7 {14512}

The value from the mapped field can be used according to the user's requirement. Currently, the value of this field is not displayed anywhere on Approval Central.

Field 8 {14513}

The value from the mapped field is displayed in the Notes field for a request on Approval Central.

Field 9 {14514}

The value from the mapped field is displayed in the Attachment table on the AP:Show-Detail form.
Important: You can map this field only to other Attachment fields.

Define Labels

Click to define labels for the fields 14508, 14509, 14510, and 14511, for various applications, processes, and locales. The AP:DynamicLabels form is displayed. For more information, see Form-to-set-locale-specific-labels-and-tooltip-labels.

Save

In Submit mode, click this button to save your changes.

Close

Click this button to close the window.

Changing the field mappings on this form only affects new requests. The older requests retain their original field values.

ToolTip Configuration tab

As a process administrator, use the ToolTip Configuration tab to define tooltip field mappings for a request form at the application level. These mappings are not mandatory.

AP:Form—Tooltip Configuration tab

77apFormTooltip.gif

You can map them to fields on the application forms by using the corresponding menus. The values from the mapped fields are displayed in a tooltip on Approval Central. The following table describes where these values appear:

Fields on the AP:Form form—ToolTip Configuration tab

Field

Description

Field 1 {14711}  Field 2 {14712}

Field 3 {14713}

Field 4 {14714}

Field 5 {14715}

Field 6 {14716}

Field 7 {14717}

Field 8 {14718}

Field 9 {14719}

Field 10 {14720}

The values from the mapped fields are displayed in a tooltip that appears when you hover over the summary column of the request on Approval Central.

To display the tooltip, you must also define labels for all the mapped fields. If you have defined labels, but have not mapped any fields, the tooltip will display the labels without corresponding values. If you have mapped the fields, but not defined any labels, the tooltip does not appear.

Define Labels

Click to define labels for the fields 14711, 14712, 14713, 14714, 14715, 14716, 14717, 14718, 14719, and 14720, for various applications, processes, and locales. The AP:DynamicLabels form is displayed.

For more information, see Form-to-set-locale-specific-labels-and-tooltip-labels.

Save

In Submit mode, click this button to save your changes.

Close

Click this button to close the window.

If the value from the mapped fields contains any HTML content, Approval Server renders the content as HTML content.

For information about the Administrative Information tab, see Form-to-create-delete-maintain-and-search-alternative-approvers.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*