IBM BPM version 8570 cumulative fix 2017.06

Using IBM ODM business rules

You can call IBM® Operational Decision Manager decision services in IBM Business Process Manager as a SOAP web service or by using OpenAPI and REST. The instructions in this topic describe how to call IBM ODM decision services by using OpenAPI and REST. If you want to call decision services as a SOAP web service, see Calling a decision service as a SOAP web service.

What you do in IBM ODM

To create a business rule, deploy it as a decision service, and download the OpenAPI specification for the service:
  1. Use the Rule Designer to create a business rule.
  2. Use the Decision Center to deploy your decision service project to the Rule Execution Server.
  3. In the Rule Execution Server console:
    1. Navigate to the Ruleset View of the project that you want to use in your IBM BPM process.
    2. Click Retrieve HTDS Description File.
    3. For the service protocol type, select REST.
    4. For the format, select OpenAPI - JSON or OpenAPI - YAML.
    5. Click Download.
    6. Save the OpenAPI specification locally. You must specify this file later in IBM BPM web Process Designer to discover the IBM ODM decision service as an external REST service.

What you do in IBM BPM to discover the IBM ODM decision service

In web Process Designer:
  1. From the library, click to create a new External Service.
  2. In the New External Service page, select Java, REST or Web service and click Next.
  3. Select Browse local files (Swagger) and browse to select the OpenAPI specification file that you downloaded from IBM ODM then click Next.
  4. If you see a list of operations that require JavaScript to invoke them, click Next.
  5. You see a list of discovered operations. Select the operations that you want to include in the external service then click Next.
  6. Select Create a new server and click Finish. You will configure the server in a later step. An external service is created.
  7. To explore the generated artifacts:
    • To display the business objects that were discovered in the OpenAPI specification, in the library, click Data .
    • To display an operation with its input and output parameters, in the library, click Services, then select the external service that you created.
  8. To configure the server:
    1. Under Process App Settings click Server.
    2. For the server type, select REST Server.
    3. For Host name, specify the hostname of the IBM ODM server.
    4. Make sure that Secure server is selected and that SSL configuration is specified.
    5. Select Authentication machanism and specify values for User name and Password.
You can now use the external service in a service flow.

What you do in IBM BPM to use the IBM ODM decision service in a service flow

In web Process Designer:
  1. Create a service flow.
  2. Use a service task to invoke an operation of the external service.
  3. For Implementation, specify the external service.
  4. For Operation, select the operation to use.
  5. Specify data mappings as required by the operation.
You can now use the service flow in your business process.
Parent topic: IBM BPM version 8570 cumulative fix 2016.09External services