Adding templates to fulfill a request and mapping template fields to input values
The Fulfillment tab is enabled after you save the request definition. On this tab, perform the following actions:
- Link the change and task templates that you have created for the actions that are required to complete the service request.
- Map these fields to the template fields.
If the Automatically Submit for Approval (when matching criteria is met) check box is selected and the service request is approved, BMC Remedyforce creates the change and task records of the templates that you have added.
Note the following important points:
- If the service request is closed before all task templates are closed, the task templates are not created if they are not yet scheduled.
- You cannot configure the order of execution for change templates. If the service request is submitted for approval, the task templates are executed only after the service request is approved.
- If an incident is created by selecting an incident and a request definition template, the tasks of the incident and the request definition templates execute independent of each other.
On the Fulfillment tab, map the fields in which the client will provide information to the fields of the templates that you have attached to the request definition. You can map multiple input fields to one field also.
If you do not want to map all these fields to the out-of-the-box fields of the Incident, Task, or Change Request object, add custom fields to the required object, and then map the input fields to the custom fields.
For example, you add templates that contain the Urgency field. You map the Input lookup field to the Urgency field of each template. In Self Service, when a client selects HIGH as the Urgency of the service request, HIGH is populated in the Urgency fields of the change request, task, and incident records that are created because the template was executed. The staff members fulfilling the service request become aware that the records assigned to them have a high urgency.
Note the following important points about mapping:
- The values of the input fields are concatenated and populated in the selected output field. If the data type of the output field is Text, the concatenated values of the input fields are separated by a semicolon in the output field. If the data type of the output field is Text Area, Text Area (Long), or Text Area (Rich), the concatenated values of the input fields appear on new lines in the output field. The input fields are concatenated in the output field according to the order defined in the Input tab.
- If the length of the concatenated values is greater than the capacity of the output field, the extra text is truncated from the output field. For example, if the length of the concatenated values is greater than 300 characters and you have mapped the input fields to an output field of the Text data type, the extra 45 characters are truncated from the output field. The truncation occurs because the length of a Text data type field is 255 characters.
For example, if the service request uses three input fields to record details from the user, you can map the values of these input fields to the Description field of the Request Detail template. When the staff member is working on the service request, they can view all three input values in a single Description field.
Before you begin
Perform the required steps to create the request definition. For more information, see Creating-and-configuring-an-SRD.
To add templates to fulfill a request and mapping template fields to input values
- Click the Fulfillment tab of a request definition.
- To add the change and task templates to the SRD, perform the following actions:
- In the Add Fulfillment Templates section, click
.
By default, the service request template appears in the templates list. This is the template that you selected in the Service Request Template field on the General tab. You cannot delete the service request template.
You get the options to either create new template (New Template) or link existing templates (Existing Template). - To configure the order in which the task templates are completed, click
.
- (Optional) To not execute all linked task templates at the same time, clear the Ignore Execution Order check box.
- In the Order Number column of the Set Task Execution Order window, select the order number that you want to assign to the tasks.
You can assign the same execution order number to more than one task template. For example, you have four task templates, Task1, Task2, Task3, and Task4. You can assign Task1 and Task2 to be executed first, then Task3, and then Task4. When Task1 and Task2 are running, only these tasks are displayed in the Record Details section of the record. After Task1 and Task2 are closed, Task3 is displayed, and after the closing of Task3, Task4 is displayed. - Click
.
- In the Add Fulfillment Templates section, click
- To map the fields of the object for which you have created a template, such as Incident, Change Request, or Task object, perform the following actions:
(Optional) To prefix the value of the Input field with its Request Input (Prompt/Question), select the Prefix the Prompt/Question to user input mapped to Text Area or Long Text Area output fields check box.
For example, in a request definition, you have mapped the Desk Location (Input field) to the Description (Output field). The value provided by the client user for the Desk Location (Input field) is N 23 D Block. If the Prefix the Prompt/Question to user input mapped to Text Area or Long Text Area output fields check box is selected, the value in the Description field is Desk Location: N 23 D Block.From the Select Template list, select the In the Input Fields (Source) column, select the Input fields that you want to use to create a mapping.
When you select a field in the Select User Input for Prompt/Question column, only valid fields for mapping are listed in the Map to Template Field column.
The following table describes the valid data types of each Response Type:- In the Select User Input for Prompt/Questions column, select the fields that you want to map.
To select multiple Input fields, press the Ctrl key and click the required Input fields. You can select multiple consecutive Input fields by pressing the Shift key and clicking the first and last Input fields of the consecutive Input fields. Clicking a selected Input field clears it. After you map Input fields, the mapped to field is removed from the Map to Template Field column and is no longer available for mapping. - In the Map to Template Field column, select the field in which you want to store the mapped field value.
- Click Map Input to Field.
Click
.
The following table describes the options available in the Prompt/Question Properties section.
Considerations for creating lookup filters for request definitions
Before you create filters, you must review the following points to understand how the lookup filters are implemented in request definitions:
- The lookup filters are applied only on the Fulfillment Input Details page and not on the Salesforce page layouts.
- You can create only one filter for one Lookup type Input field. For example, you create a Lookup type Input field on the Category object, this Lookup type Input field can have only only one lookup filter.
- The default filter criteria applied to Lookup type Input fields cannot be removed from the Incident object. The lookup filters that you create are applied in addition to the default filter criteria. For more information, see Default filtering of records for the Lookup type fields for request definitions.
- If the filter that you create for a Lookup field conflicts with the default filter criteria, no results are shown in the Lookup window. However, for optional filters, staff members can use Show All Results to remove the filter that you have created.
- For the Category Lookup field, if a child category meets the specified filter criteria but its parent category does not meet the filter criteria, both the parent and the child categories are not shown in the Category lookup window.
- If you define a filter criterion on a Date/Time field type by using the =, !=, <=, <, >, or >= operator, the date/time when the form was opened is considered as the default field value in the following scenarios:
- You do not specify a value for the Date/Time field in the filter criterion.
- You map the Date/Time field to a field on the selected console but that field is not populated on the form.
- If you define a filter criterion on a Number, Currency, or Percent field type by using the =, !=, <=, <, >, or >= operator, 0 (zero) is considered as the default field value in the following scenarios:
- You do not specify a value for the Number, Currency, or Percent field in the filter criterion.
- You map the Number, Currency, or Percent field to a field on the selected console but that field is not populated on the form.
Default filtering of records for the Lookup type fields for request definitions
BMC Remedyforce applies default filter criteria for the lookup fields on the Fulfillment Input (or Incident) object. Users cannot remove the default filter criteria.
The following table lists the default filter criteria that are applied to the lookup fields the Incident object.
Related topics
Use-case-Adding-a-picklist-response-type
Use-case-Adding-radio-button-options-to-the-service-request
Use-case-Defining-conditions-to-display-a-field
Use-case-Defining-conditions-to-invoke-a-template
Use-case-Adding-a-Header-section-to-a-service-request
Points-to-consider-when-adding-validation-rules
Points-to-consider-when-adding-input-field-of-type-Text-Area-Rich