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
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:
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.
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"
Copy