September 2020

September 22, 2020

What is IBM Business Automation Workflow?
IBM Business Automation Workflow combines business process management and case management capabilities in one workflow solution. It unites information, process, and users to provide a 360 degree view of work.

IBM BAW is the product that has replaced IBM Case Manager. It includes; case features, to create, test, manage, deploy, and work with your business solutions created in previous Case Manager versions.

Version 19.0.0.1 of BAW is the minimum required version required if you want to upgrade from Case Manager. Always use the latest BAW release when upgrading from Case Manager.

Note: IBM Case Manager end of support (EoS) is 30 April, 2021.

Licensing Concerns
Case Manager customers need to trade up to BAW licenses through the project office. You can contact your IBM account team for additional details. When integrates with an external Content Platform Engine (CPE) or external Content Navigator (ICN) server, then their licenses are maintained separately.

Support Process
After upgrading to this, you can open support cases against the Business Automation Workflow product, and specify the Case Manager component.

IBM BAW Lifecycle

The following diagram illustrates the components that are used in the process lifecycle.

ibm business automation workflow lifecycle

Process design and modeling
Development and testing
Deployment
Process participation and performance monitoring
Process improvements

For more details, please visit:

IBM Case Manager (ICM), IBM Case Manager Client

Open Work Detail Page After Create a Case

September 11, 2020

There is a requirement that, whether the user could be taken to the case immediately after the Add Case action so that they could continue to add more content without having to go back to the case list and search for it. To implement this, please visit this tech note: https://www.ibm.com/support/pages/opening-case-after-creation

Similarly, you can also open work detail page after create a case by doing the following steps:

Add a script adaptor widget to the hidden widgets area on Add Case page and rename it some distinguish.
Wire an inbound event from the Page Container’s Send new case information to the Script adaptor’s Receive Event.

Go to script adator settings, and put the following code:

var self = this;
var coord = payload.coordination;

require(["icm/base/Constants", "icm/util/Coordination"],
    function (Constants, Coordination) {
        console.log("Open new case begin");
        self.caseEdt = payload.caseEditable;
		
		// replace In-basket name in which case created. 
        var workListName = "SDW_My Work";
		
        console.log("part to aftersave");
        console.log(Constants.CoordTopic.AFTERSAVE);
        console.log(coord);
        coord.participate(Constants.CoordTopic.AFTERSAVE, function (context, complete, abort) {
            debugger;
            //Entered Form Info
            console.log("part call back");
            self.checkCount = 0;
            self.caseCreatedFlag = false;
            self.statusChecker = setInterval(function () {
                self.caseEdt.retrieveAttributes(function () {
                    self.checkCount++;
                    console.log("check case states");
                    console.log("checkCount :" + self.checkCount);
                    var caseState = self.caseEdt.caseObject.attributes["CmAcmCaseState"];
                    console.log("caseState : " + caseState);
                    //Working (2) // Completed (3)
                    if (caseState == 2 && !self.caseCreatedFlag) {
                        self.caseCreatedFlag = true;
                        clearInterval(self.statusChecker);
                        delete self.statusChecker;
var caseUniqueField = self.caseEdt.caseObject.attributes["CmAcmCaseIdentifier"];
                        subsVar = {
                            "substitution_vars": [{
                                "name": "CmAcmCaseIdentifier",
                                "value": [caseUniqueField],
                                "type": "xs:string"
                            }]
                        };
                        function retrieveAttributes(myItemFull) {
                            console.log("Inside Retrieve Attributes");
                            myEdit = myItemFull.createEditable();
                            payload = {};
                            payload.workItemEditable = myEdit;
                            payload.coordination = new icm.util.Coordination();
                            payload.UIState = new dojo.Stateful();
                            payload.openInNewTab = false;
                            broadcastResult = self.onBroadcastEvent(
                                "icm.OpenWorkItem", payload);
                            console.log(broadcastResult);
                            setTimeout(complete, 1000);
                        }
                        var workitem;
                        function retrieveWorkItem(payload) {
                            console.log("Retrieve Work Item");
                            workitem = payload;
                            retrieveWorkItemFlag = false;
                            // Search for the specific workItem
                            console.log("Found " + workitem.fetchCount + " item(s) in the work basket");
                            for (var i = 0; i < workitem.fetchCount; i++) {
                                retrieveWorkItemFlag = true;
                                myItem = icm.model.WorkItem.fromWorkItem(workitem.getItem(i));
                                myItem.lockStep(retrieveAttributes);
                                //systemResponseDialogHelper.hideLoadingIndicator();
                                return;
                            }
console.log("Could not find Step, Retrying in 1 second");
                            if (!retrieveWorkItemFlag) {
                                setTimeout(function () {                                   selectedWorkList.retrieveWorkItems(
                                        retrieveWorkItem, null,
                                        false, true, null,
                                        "(CmAcmCaseIdentifier=:A)",
                                        subsVar, null);
                                }, 1000);
                            }
                        }
                        function retrieveWorkList(payload) {
                            console.log("Retrieve Work List");
                            debugger;
                            worklist = payload;
                            if (worklist != null) {
                                for (var i = 0; i < worklist.length; i++) {
                                    debugger;
                                    console.log("Work List Name: " + worklist[i].auth_name);
                                    if (worklist[i].auth_name == workListName) {
                                        selectedWorkList = worklist[i];
                                        selectedWorkList.retrieveWorkItems(
                                            retrieveWorkItem,
                                            null, false,
                                            true, null,
                                            "(CmAcmCaseIdentifier=:A)",
                                            subsVar, null);
                                        break;
                                    }
                                }
                                console.log("End of WorkList Search");
                            } else {
                                console.warn("No Worklist Found");
                            }
                        }
                        self.getRole().retrieveWorklists(retrieveWorkList);
                    }
                    if (self.checkCount > 5 && !self.caseCreatedFlag) {

                        console.log("Can't open the case");

                        clearInterval(self.statusChecker);

                        delete self.statusChecker;

abort({ "message": "Case Created. Please close this tab and find the case in your in-basket." });
                    }
                });

            }, 2500);
        });
    });
console.log("Open new case end");

Note: please change the in-basket name var workListName = “SDW_My Work”

Save and close the solution once you applied these changes.
Deploy the solution and test the case. You will see, right after creating a new case, work detail page will be opened without go back to in-basket as described in these screenshots:

open-work-detail-page-after-create-a-case

IBM Case Manager (ICM), IBM Case Manager Client

Attachment Validation in IBM Case Manager 5.2

September 9, 2020

There is a requirement to validate attachment in IBM Case Manager Client (ICM) before dispatching the workflow to next node. Because sometimes, user skip attach document in the case. If you want to mandatory user must add document before clicking on particular step than attachment validation in IBM Case Manager can be achieved be performing following steps:

Add a script adaptor widget to the hidden widgets area on a work details page and rename it some distinguish.
Wire an inbound event from the Page Container’s Send Work Item to the Script adaptor’s Receive Event.

The additional data validation will be triggered when the appropriate response button is clicked.

function validateWItemAttachments(propertiesCollection) 
{
var emptyattachment = false;
console.log("emptyattachment Flag is--" + emptyattachment);
if (propertiesCollection) 
{
var k;
for (k in propertiesCollection) 
{
if (propertiesCollection.hasOwnProperty(k)) 
{
var p = propertiesCollection[k];
if (p.dataType == "xs:attachment") 
{
console.log("Found Attachment Field--" + k);
console.log(p);
console.log(p.value);
p.retrieveAttachmentContents(function(items) 
{
console.log(items);
if (items.length == 0) 
{
emptyattachment = true;
}
});
}
}
}
}
return emptyattachment;
}
var workItemEdt = payload.workItemEditable;
var coord = payload.coordination;
var propertiesCollection = payload.workItemEditable.propertiesCollection;
require(["icm/model/properties/controller/ControllerManager", "icm/base/Constants", "dojo/date"],
function(ControllerManager, Constants, date) {
// use the validate coordination topic to handle validation of the
// the attachments
coord.participate(Constants.CoordTopic.VALIDATE, function(context, complete, abort) 
{
if (context[Constants.CoordContext.WKITEMRESPONSE] === "Forward") 
{
var inValidAttachmentsFlag = validateWItemAttachments(propertiesCollection);
if (inValidAttachmentsFlag) 
{
var messageDialog = new ecm.widget.dialog.MessageDialog(
{
text: "Attachment missing, please attach document to proceed further."
});
messageDialog.show();
abort(
{
'silent': true
});
} else {
complete();
}
}
else{
complete();
}
});
});

Save and close the solution once you applied these changes.
Deploy the solution and test the case. You will see when user forward case without attachment, a pop-up window will appear according to your message in the script adaptor code.
Below is the screenshot for demonstration:

Note: This code works for both ICM 5.2.x and 5.3.x versions.

For more information about attachment validation in IBM Case Manager, please check this tech note: https://www.ibm.com/support/pages/attachment-validation-based-which-step-response-selected

M	T	W	T	F	S	S
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30

IBM Business Automation Workflow

IBM BAW Lifecycle

Open Work Detail Page After Create a Case

Attachment Validation in IBM Case Manager 5.2

Subscribe