Configuring custom case widgets for a container environment

In IBM Business Automation Workflow, you can configure custom case widgets for a container environment.

Procedure

To configure a custom case widget in a container environment:

  1. Add the custom widget package .zip file to the custom plug-ins persistent volume directory of IBM Content Navigator.
  2. Specify the custom widget in a comma-separated list of custom widget names in the Custom Resource(CR) .yaml file used by the operator to configure the environment. The comma-separated list is specified with the custom_package_names key under the spec > workflow_authoring_configuration > case section. For example,
    custom_package_names: "CustomWidget.zip"
  3. Apply the custom resource definition to your Red Hat OpenShift environment.
  4. If you modified 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 Red Hat OpenShift and the system reruns the case Init job and redeploy your custom widget package.
    Note: If you are using custom case widgets that reference IBM Business Automation Workflow Case Management resources, you must update the implementation code and repackage the compressed (.zip) file. This is required for a Cloud Pak for Business Automation environment because the case resources are on the IBM Business Automation Workflow container and your custom widget EAR file is deployed on the Business Automation Navigator container. This is important if you are upgrading from a legacy IBM Case Manager or from an embedded IBM Content Navigator environment where IBM Content Navigator and IBM Business Automation Workflow case components are using the same WebSphere® profile.

    After the custom widget is deployed, it becomes available in Case Builder. Open the Page Designer in Case Builder. The custom widget appears in a new section in the left side pane along with the other out-of-the-box widgets.

What to do next

If you want to see a visual representation of the extended history for a case, see Optional: Enabling the Timeline Visualizer widget to display Business Automation Workflow process activity flow.

After you've done any optional steps and prepared for each capability that you want to install, deploy the custom resource (CR) file. See Creating a production deployment.