This documentation supports the 22.1 version of BMC Helix Digital Workplace Basic and BMC Helix Digital Workplace Advanced. Icons distinguish capabilities available only for the Advanced and External license levels. For more information, see License types and features.

Managing service actions

Service actions are light services associated with completed service requests or assets. End users access service actions from the Actions list of a service or an asset on their My Stuff page. For more details about how items are displayed on the My Stuff page, see Setting up the My Stuff page.

Catalog administrators and internal service suppliers create and manage service actions to associate them with services.

You can associate service actions with services, service categories, and asset classes from configured external systems.


You can manage service actions from the Service Actions page, which you can access by selecting Services > Service Actions in the Catalog console. Here, you can add, edit, and delete service actions.

By default, all newly created service actions are inactive and are displayed on the Inactive tab. You can activate service actions to make them available for end users, and deactivate them as needed.

If you have more than one environment with BMC Helix Digital Workplace Catalog, you can share service actions among them by exporting and importing service actions to and from local files.  

Comparison of service actions and services

Service actions are similar to services because they have the following resembling components:

Component propertyServiceService action
Catalog profileSupportedNot supported
Versions and revisionsSupportedNot supported
WorkflowSupportedSupported
QuestionnaireSupportedSupported
Service level agreementSupportedSupported
Costs and pricesSupportedSupported
CMDB detailsSupportedSupported
Association with asset classNot supportedSupported
Association with asset groupSupportedSupported

Components of service actions

A service action uses the same UI template as a service. You complete the required details for a service action in the same way as you do when you create or edit a service.

Service action componentRequired or optionalReference topic
WorkflowRequiredWorkflows for service fulfillment
QuestionnaireRequired if a workflow includes process input variablesCreating service questionnaires
Dependency MappingOptionalSpecifying dependent services
Service Level AgreementOptionalSetting service level agreements
CostingOptionalAdjusting service cost and quantity
Asset MappingOptionalAssociating service actions with services and assets

Process of adding service actions

Perform the following steps to add and enable a service action:

  1. Create a service action.
  2. Associate the service action with one or more of the following items available on the My Stuff page:
  3. Activate the service action so that the action becomes available for selection in the Actions list of service requests and assets to which it is mapped.

The following image shows a completed service request and a list of actions associated with it:    

To create a service action

  1. Log in to the Catalog console.
  2. Select Services > Service Actions.
  3. Click Create Action.
  4. In the Action Name field, enter a descriptive action name, such as Replace hardware.
  5. Click Confirm.
    The Actions Options pane is displayed.
  6. In the appropriate section of the Action Options pane, complete the required details for the service action components.

  7. (Optional) You can publish service actions and their translations for end users in different locales. For more information, see Localizing catalog items.

  8. Save the changes.

To make a service action available to end users, you must associate it with services or assets, and then activate it.

To associate a service action with services

  1. Open a service action that you want to map to services.

  2. On the Action Options panel, click Edit next to Asset Mapping.

    The following example shows the Service Requests section:

  3. (Optional) Map categories of services to a selected service action:

    1. In the Service Requests section, click Add next to Categories.
    2. From the Service Catalog, select one or more service categories, and click Save.
  4. (Optional) Map services to a selected service action:

    1. In the Service Requests section, click Add next to Services.
    2. From the Service Catalog, select one or more services, and click Add.

Tip

You can also map a service to a service action on the Service Options panel of the selected service. Both active and inactive service actions are available in the Action Library list.

For details about how to associate a service with service actions, see Associating service actions with services.

To associate a service action with assets

You can associate service actions only with those asset classes that are retrieved from connections configured in the Application Settings > Asset Management. For details about how to configure asset connections, see Configuring services and assets to be available on the My Stuff page.

The following example shows the Asset connections sections of a service action:

Perform one or more of the following procedures to associate service actions with assets:

To map an asset class to a selected service action

  1. Open a service action that you want to map to assets.
  2. On the Action Options panel, click Edit next to Asset Mapping.

  3. On the Asset Connections panel, click Add next to a selected connection.
  4. Select one or more asset classes, and click Add.
    The added asset classes are displayed below the selected connection on the Asset Connections panel.

    To delete the added class, click the x button.

To map a subset of assets in an asset class to a selected service action

To restrict the number of assets that will be associated with a service action, you can create a query that will search for assets that match the query condition.

  1. Open a service action that you want to map to assets.
  2. On the Action Options panel, click Edit next to Asset Mapping.

  3. Map an asset class to a selected service action:
    1. On the Asset Connections panel, click Add.
    2. Select one or more asset classes, and click Add.
  4. Click Add next to the selected asset class, and create a condition for the selected asset class.

 

    1. In the Condition name field, enter a descriptive condition name.

    2. In the Expression field, select a field, and build a condition as follows:

Tip

The list with expression variables is generated automatically from the available out-of-the-box attributes provided by BMC Helix CMDB.

      • On the left side of the expression, select an expression variable.
      • Select an operator (for example, IS, IS NOT, CONTAINS, DOES NOT CONTAIN, STARTS WITH, ENDS WITH are operators for strings)
      • For strings, type a free text value.
      • (Available in version 22.1.06 and later) For integers, type a number value.
      • (Available in version 22.1.06 and later) For selections, select a variable from the list.

                  c. Click Save.

The added query is displayed below the asset class on the Asset Connections panel:

The following image shows a query with the string data type that enables you to add a service action only to keyboards located in America:

You can create a complex query with several conditions for a single class; for example, you can create a query that will display a designated service action only for printers that match the following condition:

Important

We recommend that you create simple queries for service actions associated with a large number of assets.


To map all asset classes from the configured connections to a selected service action

  1. Open a service action that you want to map to assets.
  2. On the Action Options panel, click Edit next to Asset Mapping.

  3. On the Asset connections panel, select All beside a connection from which you want to pull out all asset classes.

To activate and deactivate a service action

After you create a service action and map it to services and assets, activate it to make it available to end users. You can deactivate service actions to make them temporarily unavailable for selection by end users, such as when a service action is undergoing some changes.

To activate or deactivate a service action, perform one of the following steps:

  • From the Action Options pane, change the Active toggle to activate or deactivate a service.
  • Open the Service Actions page and select a service action on the Active or Inactive tab. Click Actions and select one of the following options:
    • Activate—Makes an inactive service action available to end users. This option is available on the Inactive tab.
    • Deactivate —Makes an active service action unavailable to end users. This option is available on the Active tab.

To edit a service action

You might need to edit the details of a service action or its name, or add translations.

  1. From the Service Actions page, select a service action that you want to modify, and select Actions > Open.
    The Actions Options pane is displayed.

  2. Make the necessary changes to the service action, and click Save.

To delete a service action

You can delete active and inactive service actions at any time.

From the service actions list, select one or more service actions, and click Actions > Delete.

If a service action is associated with a service, service category, or asset class, a message appears to notify you of potential risks.

To export and import a service action

To export a service action to a local zip file, select a service and click Actions > Export.

To import a saved service action, select Actions > Import, and upload the service action zip file. 

Important

All asset connections, services, and service categories must exist in the destination environment for your imported mappings to be preserved.

Was this page helpful? Yes No Submitting... Thank you

Comments