A technical walkthrough of the integration between Blueworks Live and IBM OpenPages
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:
A step by step tutorial of how to use the Blueworks Live APIs is published here:
The Blueworks Live data can then be published into OpenPages using its APIs.
Recommended by LinkedIn
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.
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:
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"
Filip - this is great to see! Would love to chat about some of the customers we have done this for, and it doesn't need to stop at BWL! What about being about to mine the process from OpenPages automatically?? We have an accelerator for that. Full circle!