Creating and configuring an SRD

A service request definition (SRD) is a service request template that is available to clients through Self Service. SRDs provide the options required to facilitate the selection and execution of delivery for a service request. These options can include attributes such as categorization, effective start and end dates, or pricing information.

Creating an SRD is a multiphase process. After you create the SRD, additional configuration tasks are required before the SRD is ready for use. The following figure shows the process to create an SRD.

The following video (5:15) describes the procedure to configure service request definitions.

https://youtu.be/jZ1moSSRo0I

The end-to-end process involves the following actions:

Important

Before performing these procedures, ensure that you have completed all the prerequisites for creating an SRD. For more information, see Getting-started-with-service-request-management.

Procedure 1: Create an SRD record

Click the Remedyforce Administration tab.
On the Home page, click the Configure Application tile, and from the menu select Request Definitions.
In the Request Definitions list view, click New.
Enter information in the fields on the page.

Field description
Click Save.
To embed a direct link to the service request definition, use the link in the Self Service Link field. This field is populated automatically only after you save the SRD.
You can embed this direct link on your intranet or send it by using an email message. When the user clicks the link, the corresponding form opens in Self Service. For more information, see Providing-direct-links-for-Self-Service-components.
Note
The Self Service Link field is displayed only if you are using Self Service 2.0.

Procedure 2: Configure entitlement of SRD

By default, an SRD is available to all accounts and all users. You can configure to show an SRD to users of specific accounts, and in those accounts, to users of specific profiles or permission sets.

Users of Customer Portal and Customer Portal Manager license can view the SRD in Self Service based on the accounts assigned to them and the SRDs assigned to accounts.

Click the Entitlement tab of the SRD.
To entitle the accounts whose users will see the SRD, select Selected Accounts.
In the Available Accounts list, select the required accounts, and click the right arrow.
Perform one of the following actions:
- To entitle all users of the selected accounts, from the Within selected accounts, this service request is available to list, verify that All Users is selected, and go to step 5.
- To entitle users of selected profiles or permission sets, from the Within selected accounts, this service request is available to list, select Users of Selected Profiles or Users of Selected Permission Sets.
- Select the profiles or permission sets to whose users within the selected accounts (if selected) the SRD will be shown.
  
  Click here to know when an SRD is shown to a user in Self Service based on the settings that you select in the Entitlement tab.
Click Save.

Procedure 3: Configure request definition information to be shown to clients

Click the Display Options tab of an SRD.
In the Review the Service Request Information section, select the values that you want to show to clients in Self Service before they submit a service request:
Note
The following fields are always shown to staff members in the Remedyforce Console.
- Turnaround Time
- Price
- Date Expected
  The service request calculates the Date Expected of the service request by adding the turnaround time of the SRD to the current date and time.
- Phone
- Email
- Instructions
  The value of the User Instructions field in the Input tab is displayed.
- Assigned To
  The Assigned To field and its value are shown in Self Service only if the service request is assigned to a staff member. If the service request is assigned to a queue, the field is not shown in Self Service.
- Approvals
  If you select this check box, the Approval Status column in the Ticket and Requests tab in Self Service will show the approval status.
  
  About approval details shown to users
  
  The client can view the current status, approvers, and the approval history of the service request. Users with Salesforce Platform license can view the approval history in the Approvals tab of the service request. In this tab, Salesforce Platform license users can view the approver of the service request, the status of the approval, the date when the service request was submitted for approval, and the comments entered in the approval by the approver. The total number of approvals is displayed in the title of the Approvals tab. Users with Customer Portal license can view the approval history of the service request in the Actions Performed tab. These users cannot view the Approvals tab and the approver information.
In the Provide Information section, select check boxes to enable the desired functionality for clients or staff members:
- Date Required
- Quantity
- Attachment
- Make Attachment Required in Self Service
If you want the same Quantity and Price field configurations that you performed for clients in the preceding steps to also apply for staff members, select the Apply above Quantity and Price field settings for staff members check box. If you do not select this check box, the Quantity and Price fields are shown to staff members.
For instance, if you do not select the Quantity check box for clients, and you select this check box, the Quantity field is not shown to clients (in Self Service) and staff members (in the Remedyforce Console).
Click Save.

Procedure 4: Add fields to take information from clients

For example, to fulfill the New Hire Request, you might need the following information from the HR executive. To get this information from the HR executive, configure these fields on the Input tab.The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.

Note

BMC recommends that you create less than 400 input fields for each service request definition.

To add fields to take information from clients

Click the Input tab of a request definition.
In the User Instructions field, type the instructions that you want to show to a client in Self Service.
You can use this field to provide instructions about the type of details that you want to capture. For example, in a service request that enables clients to request a new laptop, you can instruct clients to specify whether they require a mouse and keyboard also.
In the Request Input section, click .
Based on the response type of the input field that you are adding, options in the Prompt/Question Properties section might change and some options are valid for all response types.
In the Input/Prompt field, add the text that will inform clients what inputs are required (such as Enter your location).
In the URL and Tooltip fields, enter the URL associated with the input field and its tooltip.
Select the type of field that you want to create.
For more information about adding a field of response type Header Section, Lookup, Picklist, or Radio Button, see Creating-input-fields.
In the Prompt/Question Properties section, select the required check boxes.
For more information, see Additional-configurations-for-input-fields.
Click Save or Save & New.
The fields are displayed in the service request in the order in which you add them. You can select a field and click the up or down arrow to modify the position of the field in the display order of the service request.
Note
To define the display order of the Input fields, you must save the SRD after you finish adding and reordering the Input fields. If you do not save the SRD, the display order reverts to the previous display order when you last saved the SRD.
To add a field that is similar to an existing field, select that field and click . When you clone an input field, all the field values are cloned, except the conditions to invoke a template (if exist).
Note
After you save the field, you cannot edit the value of Response Type.
If you delete input fields from an SRD, those fields (except Header Section) are not removed from the service requests that have already been creating using the SRD.

Procedure 5: Configure the fulfillment of service requests

The Fulfillment tab is enabled after you save the request definition. On this tab, perform the following actions:The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.

Adding criteria to filter CIs and assets that are shown to staff members

In the Fulfillment Criteria - CMDB section, click New.
In the Fulfillment Criteria - CMDB window, specify the criteria to filter CIs and assets.
In the Filter Logic field, specify the logical operators between conditions.
By default, AND is specified for all conditions.
Best Practice
Criteria must ensure that already assigned CIs and assets are not shown again in the search results. Inform staff members about the action that they must take to follow your condition.
Example: Use the following condition in your criteria: CI Status is not equal to In Stock - Available.
Click Save and close the window.
Click Save.

Linking the change request and task templates with the request definition

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 .

Mapping template fields to input values

(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.
Note
This check box is applicable only for the fields of type Text Area and Text Area (Long).
If you map a check box type input field to a Text Area or Long Text Area type output type field, the question is mapped to the output field even if you do no select this check box.
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.

Valid data types for Response Types

The following table describes the valid data types of each Response Type:

Note
You cannot create mappings for the following fields: Auto Number, Email, Formula, Percent, Phone, Roll-Up Summary, and URL.
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 Save.

Procedure 6: Make the service request definition available in Self Service

On the General Information tab of a request definition, from the Status list, select Deployed.
Select the Online check box.
To show the request definition in BMC MyIT and Self Service on the Salesforce1 mobile platform, select the Mobile check box.
Click Save.
Note
To make multiple service request definitions available in Self Service, you can select those request definitions in the list view, click the , and select Make Online. However, ensure that you select the Status as Deployed and the Mobile check box individually for the required SRDs.