Blueworks Live

Blueworks Live

Connect with IBM subject matter experts and get answers to your biggest concerns. Also, share ideas, benchmarks, best practices, and lessons learned with other users. As a member of this online user community

 View Only

Part 2: A technical walkthrough of the integration between Blueworks Live and IBM OpenPages

By Filip Lou posted Thu June 15, 2023 02:59 AM

  

Part 2: Tech guide: Blueworks Live & OpenPages: Integration Options

 

In this guide we’ll discuss the technical steps to make integration between Blueworks Live and OpenPages possible.

 

Option 1: Hyperlinks

The most simple way to connect Blueworks live to OpenPages is to use hyperlinks:

This can work both ways:

OpenPages to Blueworks: Grab the deep-link to the process diagram from Blueworks Live and paste it into OpenPages.

Blueworks Live linking to content in OpenPages:

Here there are several locations for a hyperlink.

The first one is in the documentation field:

The second location for a hyperlink would be to enter it as a glossary value:

Option 2: Using REST APIs

Publish Blueworks Live data to OpenPages:

Use the processData API to retrieve all process details from a diagram and use the OpenPages API to publish this data to OpenPages.

Use the get processData API to retrieve all elements of a process map:

https://www.ibm.com/support/knowledgecenter/en/SS2MKC/com.ibm.bwl.doc/topics/process_data.html

A step by step tutorial of how to use the Blueworks Live APIs is published here:

https://community.ibm.com/community/user/automation/blogs/stephanie-wilkerson1/2020/12/15/do-more-with-the-rest-api-testing-tool

The Blueworks Live data can then be published into OpenPages using its APIs.

There are presently no APIs to update Blueworks Live properties, however there are APIs to update the glossary.

The Glossary Update API can be used to publish and update Risk and Control data into Blueworks Live as Glossary values.

https://www.ibm.com/support/knowledgecenter/SS2MKC/com.ibm.bwl.doc/topics/glossary_values_category.html

Glossary values are used to pre-populate the values a user can choose from when interacting with a custom property. The Custom property list can be locked down to a fixed enumeration to prevent users from inputting random content.

Overview of functionality at 7:01 mark:

https://www.youtube.com/watch?v=5lg_CVA1MMk&feature=youtu.be

Step 1: Create a custom property: You have the option of locking down the enumeration to avoid custom data entry.

Step 2: Setup the glossary value and create the link to the OpenPages page:
Step 3: Select a risk value from the list during process mapping.
Step 4: the risk is now visible in the analysis view. ID and Rating can be embedded in the name field.
Step 5: the referenced hyperlink loads when clicking on the name in the Reference section.

Using the REST APIs to update Blueworks Live glossary values:

Sample CURL commands to update the glossary:

Enter a new glossary value:

curl -i -H "Authorization: Bearer dKbFvKy34rw8AkDSnOshMZhrtExmmHAYslReUgjF" -H "Version:1.0" -H "Content-Type:application/json"-H "X-IBM-BWL-Account-Id:IBM172" -X PUT --data "[{\"name\":\"Risk 99: IR:H RR:H PA 5.3 NEW Failure\",\"description\":\"Failure to adhere to Responsible Lending obligations\"}]" "https://ibm.blueworkslive.com/bwl/glossary-values/My%20Risk"

value ID: "becd022aa" is returned

Update the description using the glossary ID "becd022aa"

curl -i -H "Authorization: Bearer dKbFvKy34rw8AkDSnOshMZhrtExmmHAYslReUgjF" -H "Version:1.0" -H "Content-Type:application/json"-H "X-IBM-BWL-Account-Id:IBM" -X PUT --data "[{\"id\":\"becd022aa\",\"description\":\"This is the updated description\"}]" "https://ibm.blueworkslive.com/bwl/glossary-values/My%20Risk"

0 comments
57 views

Permalink