IBM BPM, V8.0.1, All platforms > Install IBM BPM > IBM BPM Advanced for z/OS: Process Server > Configure IBM BPM Advanced for z/OS: Process Server > Configure components > Configure additional components > Configure Process Portal > Configure the Business Space component for Process Portal > Configure Business Space to work with IBM Case Manager

Registering IBM BPM widgets in IBM Case Manager

Register the widget catalog and endpoints.

This topic applies to the following products:

You have configured IBM BPM Advanced and IBM Case Manager in a cross-cell setup; including a federated realm. single-sign-on, and secure socket layer.


Procedure

  1. If you are using IBM BPM Standard, or an IBM BPM Advanced profile without Business Space, install the human task management widgets application on the IBM BPM server or cluster.

    1. Use the installHumanTaskManagementWidgets command to install the human task management widgets application on the IBM BPM server or cluster.

      For example, to install the human task management widgets application on the Support cluster, you can issue the following Jython commands: 

      AdminTask.installHumanTaskManagementWidgets('-clusterName Support')
AdminConfig.save()

    2. Using the administrative console, locate the human task management widgets application named HumanTaskManagementWidgets _scope, and start it.

  2. If you use BPEL tasks in IBM BPM Advanced, you must also deploy Dojo forms where the human task management widgets application is installed.

  3. On the IBM BPM server, identify the host name and ports for the IBM BPM federated REST API. Because the widgets use both http and https protocols, note the port numbers for both protocols.

    • If you are using an HTTP server to access your web modules for load balancing or high availability, use the host name and port settings of the HTTP server.

    • For a stand-alone IBM BPM server, use the server host name. To identify the port numbers, in the administrative console, click Servers > Server Types > WebSphere application servers > server_name, and then expand the Ports section. The wc_defaulthost port is used for http connections and the wc_defaulthost_secure port is used for the https connections.

  4. Copy the following files from the IBM BPM server to the IBM Case Manager server.

    • INSTALL_ROOT\BusinessSpace\registryData\BPM\BPM_HumanTaskManagement_crosscell.zip

    • If you have IBM BPM Advanced also copy INSTALL_ROOT\BusinessSpace\registryData\BPM\BPM_HumanTaskManagement_Advanced_crosscell.zip

  5. Create a new directory.
  6. Unpack all the ZIP files into the new directory. Verify that the following directories exist:

    • catalog
    • endpoints
    • templates

  7. Define the endpoints for the REST services. Perform the following steps.

    1. Change to the endpoints directory. It should contain the following files.

      • HumanTaskManagementEndpoints.xml, which contains the endpoints for process and task services.
      • HumanTaskManagementWidgetsEndpoint.xml, which contains the endpoints for the human task management widgets and the predefined task forms. They must both be set to the host name and port number for the IBM BPM deployment target where Business Space is deployed or for which the installHumanTaskManagementWidgets command was run.
      • wsumEndpoint.xml, which contains the endpoint for the user membership services.

    2. Edit all the endpoint XML files in the endpoints directory. In each file, search for all <tns:Endpoint> tags, and change the value for <tns:url> to the fully qualified host name and port number for the IBM BPM REST API.

      For example, if your server's host name is bpmserver.example.com and it uses port 9080, you must change the endpoint URLs for Business Flow Manager (BFM) and Human Task Manager (HTM) to the federated versions of the URLs.

      • For BFM: http://bpmserver.example.com:9080/rest/bpm/federated/bfm

      • For HTM: http://bpmserver.example.com:9080/rest/bpm/federated/htm

      You can lookup the URLs for the REST services using the administrative console by clicking Services > REST Services > REST Services.

  8. If you are using IBM BPM Advanced and your own BPEL process applications use Dojo forms, then you must register an endpoint for each web module that contains the Dojo forms. For each web module perform the following steps.

    1. Make a uniquely named copy of INSTALL_ROOT\BusinessSpace\registryData\BPM\endpoints\CustomFormsEndpoint.xml in the endpoints directory that was created in step 6.
    2. Edit the endpoint file that you just copied.
      1. Update the tns:id and tns:type values with a unique name for your web module.

        For example {com.example}myForms.

      2. Update the tns:url value with the identical protocol, host name and port number that you set for the human task management widgets endpoint in step 7. Use the context root of the web module that contains your Dojo forms.

  9. On the IBM Case Manager server, in a wsadmin session, import the widget catalog and endpoint definitions by running the following Jython commands: 
    AdminTask.updateBusinessSpaceWidgets('[-nodeName  node_name -serverName  server_name 
   -catalogs  directory_containing_catalog_file
   -endpoints  directory_containing_endpoints_files 
   -templates  directory_containing_templates_files]')
AdminConfig.save()
    Where node_name and server_name are the names of the node and server for the IBM Case Manager server. For a cluster, use the -clusterName parameter instead of -nodeName and -serverName. For more information about the updateBusinessSpaceWidgets command refer to the related information link.
  10. Restart the IBM Case Manager server.


Results

The Business Space widgets are registered in IBM Case Manager.


What to do next

Configure the IBM Case Manager services in IBM BPM.

Configure Business Space to work with IBM Case Manager


Related reference:
installHumanTaskManagementWidgets command
updateBusinessSpaceWidgets command