Monday, January 20, 2020

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



Feature Flag - Box adapter (oic.cloudadapter.adapters.box)











































































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 -

https://yourOIC:443/icsapis/agent/oauth/callback









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
here

So what does the OIC Box adapter actually support -
I



























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.