Working with services in BMC MyIT Service Broker

After you configure the BAO connector in BMC MyIT Service Broker, the service exposed by BMC Atrium Orchestrator are displayed in the MyIT Service Broker - Service catalog.

This topic describes how to configure BMC Atrium Orchestrator supported services in BMC MyIT Service Broker.

Import a new service in the service catalog

To make the services supported by BMC Atrium Orchestrator available for end users in BMC MyIT, you must import and then configure the services in BMC MyIT Service Broker before submitting the services for approval. You must be logged in as a Service Catalog Administrator to be able to manage service catalog items.

BMC MyIT Service Broker Integration supports the following out-of-the-box services:

• Unlock Account
• Onboard new employee
• Extend mailbox size

To import a new service

The Catalog Queue lists the service connectors, which contain items that you can import into your service catalog.

1. From the BMC MyIT Service Broker dashboard, go to Import. 
2. Select the BAO connector and then click Catalog Import Options.
   The services exposed by the BMC MyIT Service Broker Integration module are displayed. 
   For more information about the services exposed from BAO, see Configuring BMC Atrium Orchestrator Content. 

3. Select a service and click Configure. 
   For example, select Onboard Employee. 

4. Select a template, and then click Profile Details.
5. Map the connector information fields to the template fields.
6. Click Preview item to test the appearance.
7. Click Queue for Import.

8. Click Import Item to complete the import.
   Imported service catalog items are created in Pending status, and without a version.

For more information, see Importing service catalog items in the BMC MyIT Service Broker online documentation.

Configure a service

 After you import a service successfully, you can now build the service, create questions, and create a workflow to attach to the service before publishing and making it available to end users in BMC MyIT application.

To create a catalog profile

The catalog profile determines how the service is represented in BMC MyIT. 

1. From the BMC MyIT Service Broker dashboard, go to Services.
2. From the list of services, select a service, click Actions and click Open. 
   For example, open the Onboard Employee service. 
3. Upload an image to be used as a service logo. 
4. In the Service Excerpt field, enter up to 105 characters to display on the service tile.
5. In the Service Description field, enter a description for the service.
6. Click Save.

For more information about adding catalog profile information, see Adding and updating services in BMC MyIT Service Broker documentation.

To create or attach a workflow

After you provide catalog information for a service, you can now create a workflow to attach to the service. The workflow is triggered after it receives appropriate inputs from the request and a fulfillment process is invoked.

1. From the BMC MyIT Service Broker dashboard, go to Services.
2. From the list of services, select a service, click Actions and click Open. 
   For example, open the Onboard Employee service.
3.  Click workflow > New Workflow.
   When you create a new workflow, Start and End events are added to the canvas. 
    
4. In the Properties field, enter a name for the workflow. 
   For example, enter Onboard Employee.
5. From the list of activities on the left, from the MyIT Service Broker section, drag and drop the Build Input Setactivity on the canvas to build an input set to be parsed to BAO. 
6. From the BAO section, add the Invoke BAO Service activity after the Build Input Set activity.
7. Connect the activities.
   The following figure how to add activities and connect them to the start and end activities for the workflow. 
    
8. Under the input map, click + Add and create two process variables:
   1. First Name

   2. Last Name

      Note

      Map the variables to the questions created for the service. For example, for the Onboard Employee service, First Name and Last Name questions are created.

9. Click Build Input Set activity and in the Properties pane, perform the following actions.
   The Build Input Set activity enables you to assign key=value pairs that be used as parameters for the Invoke BAO Service activity.
   For more information, see Defining custom parameters in the BMC MyIT Service Broker online documentation. 
   1. Specify the label as 

   2.  Select the following key=value pairs to match the following figure.
       

      Important

      You must match the key1 and key2 elements exactly to the input parameters defined for the service in BMC SDA Fulfillment Cases module. For example, for the out-of-the-box Onboard Employee service, the input parameters for the Do Onboarding workflow are "first name" and "last name".  

10. Click the Invoke BAO Service activity and in the Properties pane, perform the following actions:
    1. From the Connection Instance list, select BAO connector.

    2. In the Service Id field, enter the name of the service. For example, enter Onboard Employee.

       Important

       The Service Id should match the exact service name specified in the BMC MyIT Service Broker module configuration. For more information, see Configuring BMC Atrium Orchestrator Content. 

    3. Click Edit to select the Input Parameters for the service.
    4. From the Property value dialog box, go to Activities > Build Input Set > Inputs to select the value for the input parameters for the service.
    5. Click OK.
        
11. Save the changes made to the workflow. 

For more information, see Workflows in the BMC MyIT Service Broker online documentation.

To build a questionnaire

You can now build a questionnaire for the end users to be specified while submitting a request. Once a workflow is attached to a service, the process questions that we created in the Build Input Set activity are displayed in the Questions form.

1. From the BMC MyIT Service Broker dashboard, go to Services.
2. From the list of services, select a service, click Actions and click Open. 
   For example, open the Onboard Employee service. 
3. Click Questions.
4. Create  to create a new question. 
5. From the right question elements pane, select Text Field and add it to the canvas.
6. On the Question Settings pane, enter the label as First Name. 
   You can add a description for the question, and make the field as required. 
7. Click Save.
   The question is added to the canvas. 
8. Repeat step 4 to step 6 to create the Last Name question.
9. Click Save .

For more information, see Service questionnaires in the BMC MyIT Service Broker online documentation.

Submit a service for approval

A service catalog administrator can approve services submitted for approval.

1. On the Services page, select the My Services tab.
2. Double-click a service with a revision in Draft status.
3. With the Draft status highlighted, select Actions > Submit for approval.

For more information, see Service approval and publishing in BMC MyIT Service Broker online documentation.

Where to go from here

After a service is approved and published, it is now available in BMC MyIT application for end users. To see how an end-to-end service is fulfilled by using BMC Atrium Orchestrator as a fulfillment engine, see User scenario for unlocking user accounts by using BMC MyIT, User scenario for extending mail box size by using BMC MyIT and 
User scenario for onboarding a new employee by using BMC MyIT.