Working with callouts

A callout is a special kind of domain object that enables you to alter the flow of an operation by executing a remote procedure before or after the operation. The remote procedure can be a BMC Atrium Orchestrator workflow or a web service call. A callout can be a precallout, which is executed before the requested operation, or a postcallout, which is executed after the requested operation. 

This topic describes the steps to register, edit, or delete callouts from the Administration Console. Currently, you can create only BMC Atruim Orchestrator and HTTP types of callouts from the application. You can add multiple operations for the callout from the console. 

The following BMC Communities video (5:26) describes how to use callouts in BMC Cloud Lifecycle Management.

 https://youtu.be/33kJzGPiS98

To register a BMC Atrium Orchestrator callout

1. Go to BMC Cloud Lifecycle Management — Administration Console and from the vertical Workspaces menu, click Configuration.  
2. Click the Callouts tab. 
3. Click Register Callout . 
4. In the Register Callout dialog box, enter the requested information.
   Fields marked with an asterisk (*) are mandatory. 
   
   1. In the Callout Type list, select AO. 
   2. In the Name field, enter a name for the callout. 
      BMC recommends that you use a unique name to distinguish between callouts.  
   3. In the Workflow Name field, enter the name of the workflow in the :module:path:workflowName format.
      Example: :CSM_Customization:My_Services_Portal:Actions:Create Instance Snapshot
   4. Use the controls in the weight field to select the weight to be assigned to the callout. 
   5. Select the Is Notification check box if it is a notification-style callout. For details about notification-style callouts, see Callouts. 
   6. From the Class Selection list, select the operation that you want to run by using this callout. 
      The options in the Provided Operation and the Provider Selection lists are populated based on the Class Selection list. 
      For example, from the Class Selection list, select ComputeContainer and then from the Provided Operation list, select ComputeContainer_START. 
      In the Provider Selection list, the available providers are displayed.
   7. From the Operation Type list, select whether the callout is a precallout or a postcallout. 
   8. Click Add Operation to add the operation to the callout. 
      The button is disabled until you select the operation type. 
5. Click Submit. 

To register an HTTP callout

1. Go to BMC Cloud Lifecycle Management — Administration Console and from the vertical Workspaces menu, click Configuration.  
2. Click the Callouts tab.
3. Click Register Callout . 
4. On the Register Callout dialog box, enter the requested information.
   Fields marked with an asterisk (*) are mandatory. 
   
   1. In the Callout Type list, select HTTP.
   2. In the Name field, enter a name for the callout. 
   3. In the URL field, enter the URL for the web service to be used by the callout.
      Example: http://pcsm-fqa-psrvm1:9091 
   4. In the Data field, enter the relevant data.
   5. Use the controls in the weight field to select the weight to be assigned to the callout. 
      The weight is useful in determining the sequence of the callouts if multiple callouts are being called for a given operation. 
   6. Select the Is Notification check box if it is a notification-style callout. For details about notification-style callouts, see Callouts. 
   7. From the Class Selection list, select the operation that you want to run by using this callout. 
      The options in the Provided Operation and the Provider Selection lists are populated based on the Class Selection list. 
      For example, from the Class Selection list, select ComputeContainer and then from the Provided Operation list, select ComputeContainer_START. 
      In the Provider Selection list, the available providers are displayed.
   8. From the Operation Type list, select whether the callout is a precallout or a postcallout. 
   9. Click Add Operation to add the operation to the callout. 
      The button is disabled until you select the operation type. 
5. Click Submit. 

To edit a callout

You cannot edit a callout type or callout name after it is created. You can edit all the rest of the fields. 

1. Go to BMC Cloud Lifecycle Management — Administration Console and from the vertical Workspaces menu, click Configuration.  
2. Click the Callouts tab.
3. From the list of callouts, select the callout that you want to modify and click Edit. 
4. You can change anything except the Callout Type and the Name fields. 
5. Click Submit.

To delete a callout

1. Go to BMC Cloud Lifecycle Management — Administration Console and from the vertical Workspaces menu, click Configuration.
2. Click the Callouts tab.
3. From the list of callouts, select the callout that you want to delete and click Delete.
   The following message is displayed: Do you want to delete the selected callout? 
4. Click Yes.