This topic applies only to the IBM Business Automation Workflow Advanced
configuration.

Starting Business Process Choreographer Explorer

Business Process Choreographer Explorer is a web application that can be installed as part of the configuration of the process container.

Before you begin

Before you can start using Business Process Choreographer Explorer from a web browser, you must have installed the process container, human task container, and the Business Process Choreographer Explorer application, and the application must be running.

About this task

To start Business Process Choreographer Explorer, complete the following steps.

Procedure

  1. Direct your web browser to the Business Process Choreographer Explorer URL.
    The value of the URL depends on how the virtual host and context root were configured for your installation. The URL takes the following form.
    https://application_server_host:port_number/context_root
    Important: Any attempts to access the Business Process Choreographer Explorer using the HTTP protocol are redirected to use HTTPS.
    In addition, you can extend the URL to go directly to a list or details page for a process, task, or escalation.
    https://application_server_host:port_number/context_root
           [?oid_type=oid[&view=graphic]|?oids_type=[oids]]
    Where:
    application_server_host
    The network name for the host of the application server that provides the Business Process Choreographer Explorer instance with which you want to work.
    port_number
    The port number used by Business Process Choreographer Explorer. The port number depends on your system configuration. The default port number is 9443.
    context_root
    The root directory for the Business Process Choreographer Explorer application on the application server. The default is bpc.
    oid_type
    Optional. The type of object that you want to display. This parameter can take one of the following values:
    aiid
    Activity instance ID
    piid
    Process instance ID
    ptid
    Process template ID
    tkiid
    Task instance ID
    tktid
    Task template ID
    esiid
    Escalation instance ID
    oid
    Required if oid_type is specified. The value of the object ID. If you did not specify a view or you specified an unsupported value for the view, the details page of the object is displayed.
    view
    Optional. The type of view to be shown.
    graphic
    Optional. This parameter is used to display the Process State View page or the Process Structure View page. It requires that the value of the oid_type parameter is piid, aiid, or ptid.
    • If the value of the oid_type parameter is piid or aiid, the Process State View page is displayed. For activities, this is the Process State View page for the corresponding process.
    • If the value of the oid_type parameter is ptid, the Process Structure View page is displayed.
    oids_type
    Optional. The type of the objects that you want display. Use this parameter if you want to display a list of objects. If you specify the oid_type parameter, this parameter is ignored. This parameter can take one of the following values:
    aiids
    Activity instance IDs
    piids
    Process instance IDs
    ptids
    Process template IDs
    tkiids
    Task instance IDs
    tktids
    Task template IDs
    oids
    Optional. A comma-separated list of the object IDs that you want to display in a list. If you do not specify a list of object IDs, all of the objects of the specified object type that you are authorized to see are displayed.
  2. Enter a user ID and password, then click Login.

Results

If you did not specify any of the optional parameters, the initial Business Process Choreographer Explorer page is displayed. By default, the initial page is the My To-dos page. If you specified one of the optional parameters, the details page, the Process Structure View page, or the Process State View page for the object, or a list of objects is displayed.

Example URLs

The following list shows example URLs for some of the Business Process Choreographer pages.
Process Instance page
https://hostname:9443/bpc?piid=_PI:90030109.7232ed16.d33c67f6.beb30076
Process State View page of a process instance
https://hostname:9443/bpc?piid=_PI:9003012b.f36b82cc.ee016df6.dde001ae&view=graphic
Process Structure View page of the parent process of an activity instance
https://hostname:9443/bpc?aiid=_AI:9004012b.f36bc92b.ee016df6.dde0021f&view=graphic
Process Structure View page of a process template
https://hostname:9443/bpc?ptid=_PT:9001012b.fea5bcf.b076df6.abd502b4&view=graphic
List two specific process instances
https://hostname:9443/bpc?piids=_PI:9003012c.3b615b8e.948c67f6.87ff010e,
                               _PI:9003012c.3b617d5e.948c67f6.87ff016a
List all process templates
https://hostname:9443/bpc?ptids=