Monday, January 20, 2020

#748 - OIC Feature Flags --> New Connector for Box

Feature Flag - Box adapter (

In order to get the above data - I nee to create a new app in Box -

Login to Box Dev Console here

I create a new app of type - Custom App
and then select the Authentication Method below -

I also enter the redirect URI for OIC -

The format is as follows -


Now back to the connection for Box in OIC -

I click Provide Consent, I am then prompted to enter my OIC credentials.

I then see the following -

I click Grant access to Box

I return to the Box connection page in OIC and click Test/Save.

Upload a file to Box -

This is a csv file containing customer information -

I put this into a folder - Customers

I now create an integration that will leverage the Box connection.

I begin by getting the root folder - Box api requires a folder_id to be passed in this
request. The folder_id for the root folder is 0.

I now run the integration -

Response payload is as follows -

I run the integration again, this time using the id from the Customers folder.

Response is as follows -

Now let's download the file to OIC -

Note the file_id parameter.

Here is the Response -

I now use the Stage File action to read the file -

I run the integration - its Response -

Box Adapter in Detail

Now to some detail on the adapter itself -

The adapter leverages the Box apis under the hood - those apis are detailed

So what does the OIC Box adapter actually support -

Most of these are self-explanatory, except maybe -
Get Enterprise Templates

Box allows one to create Templates via its Admin Console; here's an example -

So let's try this out -

marker can be used for pagination
limit is the max number of templates to be returned per page.

I leave both of these blank - they are optional.

The result is as follows -

Watermarking protects your Box resources from being downloaded and used without your express permission.

#747 - OIC --> Using Visual Builder for Process Task Forms

Good morning to you all on this very fine sunny Winter's morning in Bavaria!

I already posted the basics of leveraging external forms in Process here

Also there are 2 blog posts on the topic of building a simple Process worklist app in VB.

post 1 - surfacing worklist in VB

post 2 completing worklist in VB

But now back to Process Task Forms in VB -

I have a simple scenario - Order Approvals -
The Order is as follows -

The Process is very basic -

Now to the VB form -

I create the relevant page variables and use them as follows -

Now back to Process -

I now configure the Approval Task as follows -

Choose New External UI -

Now add Parameters -

I do not need to add the taskId explicitly.

Create a new instance of the Process -

I enter the following -

Note, I have displayed the task id as READONLY

Now I need to add Approve/Reject buttons to the VB CS page.

Naturally, I then need to call Process to update the task accordingly.
Here is the example for APPROVE -

Note the taskId has been automatically passed to VB -

I set id to "APPROVE"

I then drop a Navigate Back onto the Action Chain

This will return me to the Workspace Task list, once I have approved the order.