Configuring custom case widgets for a container environment

Edit online

 Containers: 
 V20.x:  In IBM® Business Automation Workflow, you can configure custom case widgets for a container environment.

Procedure

To configure a custom case widget in a workflow authoring container environment with Business Automation Studio

  1. Add the custom widget package .zip file to the custom plugins persistent volume directory of IBM Content Navigator.
  2. Specify the custom widget in the comma-separated list of custom widget names in your custom resource definition (CRD) file. For example: 
    custom_package_names: "CustomWidget.zip"
  3. Apply the custom resource definition to your OpenShift environment.
  4. If you made modifications to your custom widget package after initial deployment and you want to redeploy the package, complete the following steps:
    1. Delete the custom_widget_name.ok file from the following folder: 
      “custom_plugins_Navigator_persistent_volume/properties”
    2. Delete the case Init job in OpenShift and the system will rerun the case Init job and redeploy your custom widget package.
    Note:

    To configure a custom case widget in a production workflow container environment where Business Automation Studio is not deployed, it is sufficient to perform Step 1.

    If you are using custom case widgets that reference IBM Case Manager resources, you must update the implementation code and repackage the .zip file. This is required for an IBM Business Automation Workflow container environment because the case resources are located on the Business Automation Workflow container and your custom widget EAR file is deployed on the IBM Content Navigator container. This is especially important if you are upgrading from legacy IBM Case Manager or from an embedded IBM Content Navigator environment where IBM Content Navigator and Business Automation Workflow case components are using the same WebSphere profile.

    For example, if your custom widget bootstrap JavaScript file contains references to the ICMClient web application that is included by default in Business Automation Workflow, update the relative path bootstrap JavaScript file with the absolute path for the ICMClient web application that is running on the Business Automation Workflow server. Typically, this JavaScript file is available in the following location: 

    project_name/project_name_plugin/src/package_name/WebContent