Creating AIFs from templates

BMC Service Request Management ships with three advanced interface forms (AIFs) that you can copy and then modify, as needed. This enables you to use the AIFs provided as templates. As a result, you can create an SRD and attach one of these AIFs as shipped with your service request.

The following AIFs are included:

The AIFs include requestable offering data. This data is passed when AIFs are displayed in the Request Entry console. The following fields are automatically copied from the Service Request Definition form to the AIFs when you upgrade to BMC Service Request Management 8.1.00 and later versions:

To create advanced interface forms from templates

1. Log on to BMC Remedy Developer Studio.
2. From the AR System Navigator, open one of the sample advanced interface forms.
   For example, open the SRS:AdvancedInterface_WithBackendMapping form.
   When opening the SRS:AdvancedInterface_WithBackendMapping form in BMC Remedy Developer Studio, you should modify only the fields on the Your Fields tab and only the field labels on the Mapped tab. Following is a description of the tabs and the fields on those tabs:
   • The Your Fields tab contains the fields that are saved to the form. This tab and all of its fields should be visible to users.
   • The Mapped tab contains fields that are pre-defined to map to fulfillment application fields on the Details tab of a work order. The labels on these fields can be changed to pose questions to users. This tab and any fields used to pose questions to users should be visible. Any fields not used should be hidden from users.
     These fields are mainly character and integer type fields. If a user response requires a selection field, data/time field, or a currency field, those fields can be placed on the Your Fields tab, and additional workflow with an execution order of 0 can be created to set the field values on the Mapped tab to the value of those fields. This would be done with the hidden fields that are not used to pose questions to the users. This enables those data types to be mapped automatically by using the predefined mapping.

   • The Mapped 10-27, Mapped 28-47, and Mapped 48- tabs contain additional fields that can be mapped to fulfillment application fields by using the Question Selection and Fulfillment Application Field Mapping dialog box during SRD configuration. These tabs should be hidden to users.
     
     The fields on the Mapped tab can also be mapped in this manner if the target fulfillment application field is not on a work order, that is, an incident or change request.

     Warning

     Do not modify the other fields on this form — they are the core set of fields that map to the service request, and are needed to create the service request. You can, however, add specific workflow to the advanced interface fields for validation, and so on.

3. Save a copy.
   1. Choose File > Save Form As.
   2. Enter a new name for the copy.
      To ensure that a URL that contains the form name is not interrupted, do not use a plus sign (+) in the form name.
4. Add your advanced interface form to the form attach list in the BMC workflow.
   1. Open the packing list you created in BMC Remedy Developer Studio.
   2. Open all the workflow objects from your packing list (for example, Active Links) and associate your form, exceptfor the four following active links:
      • SRS:ADN:WithMapping_OnSubmit_109_SubmitRequest_CheckReqFields
      • SRS:ADN:WithMapping_OnSubmit_109_AddToCart_SetFlag
      • SRS:ADN:WithoutMapping_OnSubmit_109_SubmitRequest_CheckReqFields
      • SRS:ADN:WithoutMapping_OnSubmit_109_AddToCart_SetFlag
   3. Check the Filters, Active Link Guides, Menus, and Filter Guides, and associate the new advanced interface form to them as well.
5. Perform the following actions to the preceding active links.
   You must modify this workflow to set the flag in the Required Questions Answered field that determines whether the user entered all of the required information to submit the service request or the cart.

   1. Copy and rename the active links.

      Important

      Do not use the BMC prefix (SRS:ADN) when you rename the active links.

   2. Modify the form name to your own interface form.
   3. Modify the Run If qualification to match the required fields on your form.

6. Edit the SRS:ADN:SHR_OnSubmit_SubmitInReview active link guide by adding your submit request active links to it. Add the new AIF form to the associated form for the associated active link to be displayed on the Add Active Link (s) selection form.
   Add your active links under the SRS:ADN:WithMapping_OnSubmit_109_SubmitRequest_CheckReqFields and SRS:ADN:WithoutMapping_OnSubmit_109_SubmitRequest_CheckReqFields active links.
   

7. Edit the SRS:ADN:SHR_OnSubmit_SubmitInCart active link guide by adding your cart active links to it.
   Add your active links under the SRS:ADN:WithMapping_OnSubmit_109_AddToCart_SetFlag and SRS:ADN:WithoutMapping_OnSubmit_109_AddToCart_SetFlag active links.
   

8. Test your copied version of the advanced interface form.
   It should work just as the original form.

9. Modify your copy of the advanced interface form.
   If you used the SRS:AdvancedInterface_WithBackendMapping or SRS:AdvancedInterface_WithoutBackendMapping form as a template, you can modify the fields in the Your Fields data fields sections.

   Warning

   Do not delete or modify any other fields on these forms. BMC supports only changes to appearance items, such as the header, background, labels, and so on.