Configuring provider actions

To configure provider actions in classic Smart IT

1. Click Configuration > Screen Configuration.
2. Click Add/Remove Actions from the specific view.
   For example, to configure a provider action for a Problem Investigation, click Add/Remove Actions of the Problem Investigation.
   By default, the list of actions is alphabetically ordered. You can customize the ordering using the Custom Order option.
3. Click Add Action.
4. In Action Type section, click Provide Action.
5. Select the options for Supported Platforms.
6. Enter a name for the action in the Action Name field.
7. In the Localized Labels to Show section, select languages that are supported and enter the Label Text for localization. The Label Text will be shown as a menu item in the More menu of an Incident.
8. Click Save.
   
   
   
9. To complete the provider action configuration, see To configure and add business logic of provider actions section.

To configure and add business logic of provider actions

To complete the provider action configuration, you need to associate the Action Request System forms in Developer Studio.

1. In the Developer Studio, select the related server and log in.
   The server name is displayed in the AR System Navigator tab.
2. Click All Objects.
3. Right-click Filters and click New Filter.
4. In the Associated Form section, click Add.
5. In the Filtering option dialog box, type the form name in the Name field. 
   For example, CHG:Infrastructure Change.
6. Select the form and click OK.
7. Under Execution section, select the Service check box.
8. (Optional) In Run if qualification, build a query with the action name and the Action name=attributes.
9. Click OK.
10. In the If action pane, right-click Add Action, and select the appropriate option and complete the steps based on the added action.
    For example, if you select Set Field action, you can set the fields and the corresponding values in the Set Fields section. You can set the values from the available Selection Values or from any field.
11. Provide a filter name and click OK. 
    The provider action is set. You can open a ticket in classic Smart IT and from the More menu, you can execute the provider action. You can also configure this provider action at a specific field. For details, see To configuring provider action for a specific field section.

To configure automatic provider actions based on logical conditions

In addition to configuring provider actions which are triggered by the direct action of the user, as a BMC Helix ITSM administrator, you can configure provider actions on incident, change, work order and task tickets which are executed dynamically based on logical conditions. You can also configure provider action by using expression for incident tickets in edit mode. If the information provided or modified by the classic Smart IT users in the ticket meet the condition that is configured by the BMC Helix ITSM administrator, the provider action is executed and the following message is displayed:

Provider actions with expressions can be configured in the Universal Client (UC), and users can execute it in the UC as well as in the Android or iOS classic Smart IT applications.

Follow these tasks to configure the provider action:

1. To configure a template for provider actions.
2. To configure provider actions in classic Smart IT.
3. To configure and add business logic of provider actions in IT Service Management.

For an example, see Example-Configuring-provider-actions-to-automate-data-entry-for-high-priority-tickets.

You should check the arfilter.log to ensure that the back end filter is executed. The arfilter.log is available in the database folder under the AR Server installation directory (<AR System install directory/db/>). In addition, you can check the Console log to see the fields that have changed while executing the provider action.

Before configuring the provider action by using expression, you need to define the expressions at the field level. For more information about expression, see Dynamic expressions for configuration.

To configure a template for provider actions

1. Open SMT:SmartIT_Provider Action Template Configuration form in create mode.
2. Click New.
3. In the Provider Action Template Name field enter the name of the template.
4. Click the drop down list of the Source Form field and select the form.
5. Select the ticket type from Data Source field as per your requirement.

6. Enter the View Id of the specific view. The fields in the User Prompt appears based on the View ID.
   You can check the view Id from the Basic properties in Developers studio. 
   For example, for Best Practice View, the View ID is 399990344.

   Adding a field to the multiple views

   You can add a field to the multiple views. For more information see Adding a field to the multiple views section in the Adding-custom-fields-to-your-views topic.

7. Select Online radio button.
8. For Input field, select Input from the Mapping Type drop down list.
9. (Optional) Select Sequence. 
   This sequence is maintained in the Mapping Type panel in the template.
   For example 1.
10. From the Select SourceField drop-down list, select the source field.
    After selection, the selected source field is displayed in the Source DB Field Name.
11. Click Save. 
    After you click Save, the New Mapping button becomes active.
12. Click New Mapping.
13. Select Output in the Mapping Type and follow the same process for mapping.
14. Click Save. 
    The input and output fields appear in classic Smart IT when you select the template in the Template Name field of Provider Action.
    

To configure provider actions by using a template in classic Smart IT

After creating the template in Mid Tier, you need to configure the provider action in classic Smart IT. Refer to the following steps for this configuration: 

1. Log in to BMC Helix ITSM as an Administrator.
2. From the Configuration menu, select Screen Configuration.
3. Click Add/Remove Actions in the specific view (For example, Change View, Incident View).
   By default, the provider actions that are already configured appear in alphabetical order in the Add/Remove Actions dialog box. You can click Custom Order and drag and move the provider action to configure the actions as per your preferred order.
4. Click Add Action to configure a new provider action.
5. Under Action Type, click Provider Action and provide any additional basic information.

6. For the Selected Platforms where the action will be displayed, select Desktop Web (UC), Mobile Platforms (iOS/Android), or both.

   Note

   You can configure a provider action in Desktop Web (UC) and then make the action available in Mobile Platforms (iOS/Android).

7. In the Template Name field, start typing the Action Request System template name, and select from the suggested list. This template is used to map the Action Request System template with classic  Smart IT.
8. Under the I/O Mapping section, select Available Mode to configure a provider action for a specific field.
   1. Select View to have the provider action button of a specific field appear in the view mode of the ticket.

1. 1. Select Edit or Both to have the provider action button for a specific field appear in either of those modes in the ticket view.

      Note

      If you are configuring provider action for incident ticket by using expression, classic Smart IT executes the Edit mode only.

      For more information on configuring provider action at a specific field, see Configuring provider action at a specific field section.

2. Under the Input Mapping area, perform the following actions for the input mapping fields:
   1. Select From Ticket and type and select a specific field of the classic Smart IT ticket to execute the value of the field.
   2. Select User Prompt, if users need to execute the provider action based on a specific information. 

   3. Select Default Value, type and set a default value.

      Notes

      • You can insert text and number as User Prompt. For UC, Date/Time, Selection list and enumerated values are not supported in User Prompt. Enumerated values and Date/Time are also not supported in Default Value.
      • In case you select User Prompt option, you need to select the Synchronous Action. The Complete Action Fields box appears while executing the provider action from a ticket after configuring provider action successfully:
        
3. Select the Synchronous Action check box. 
   The provider action is synchronized and the classic Smart IT screen does not change until the execution is completed. If you don't select this check box, the action becomes Asynchronous and the provider action is executed at the background and don't refresh the data on screen. For Asynchronous actions, you must refresh the ticket after the action completes to see the updates.

1. For Incident tickets, if you want to configure provider action by using expression, select Execute On.
   The On Field Value Change field appears. Start typing the expression that you want to configure and select the expression. 
   To know more about expressions, see Dynamic expressions for configuration.
2. Under Localized Labels to Show, select a supported language and add a label for the action. The label text is displayed under the More menu.
3. If you map the provider action with any specific field, the field is displayed in the Mapped to fields area. For more information on configuring provider action at a field, see Configuring provider action at a specific field section.
4. Click Save to configure actions. 

To configure provider action for a specific field

The provider action at the field is indicated by a button. Users can click this button to execute the provider action.

1. From the Configuration menu, select Screen Configuration.
2. Select the field from the Available Fields section to get it in the Selected Field section if the field is not appearing in the Selected Field section.
3. Click the field where you want to configure the provider action.
4. Select Associate Action.
5. From the menu, select the required provider action.

6. Select an icon to appear as the provider action button beside the selected field in the tickets. 
   

   Note

   You cannot associate the provider action to a field without selecting this icon.

7. Click Save.

   The provider action icon appears at the specified field as a button. Users need to click the button to execute the provider action.

   If you map the provider action with any specific field, the field is displayed in the Mapped to fields area.