IBM BPM, V8.0.1, All platforms > Administer applications and processes in the runtime environment > Manage processes and their components > Administer BPEL processes and human tasks > Business Process Choreographer Explorer and Business Process Archive Explorer

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 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.

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. 

    http:// application_server_host: port_number/ context_root

    In addition, you can extend the URL to go directly to a list or details page for a process, task, or escalation. 

    http:// 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 9080.

    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. If security is enabled, you must 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 

http://hostname:9080/bpc?piid=_PI:90030109.7232ed16.d33c67f6.beb30076

Process State View page of a process instance

http://hostname:9080/bpc?piid=_PI:9003012b.f36b82cc.ee016df6.dde001ae&view=graphic

Process Structure View page of the parent process of an activity instance

http://hostname:9080/bpc?aiid=_AI:9004012b.f36bc92b.ee016df6.dde0021f&view=graphic

Process Structure View page of a process template

http://hostname:9080/bpc?ptid=_PT:9001012b.fea5bcf.b076df6.abd502b4&view=graphic

List two specific process instances

http://hostname:9080/bpc?piids=_PI:9003012c.3b615b8e.948c67f6.87ff010e,                                _PI:9003012c.3b617d5e.948c67f6.87ff016a

List all process templates

http://hostname:9080/bpc?ptids=

Get started with Business Process Choreographer Explorer and Business Process Archive Explorer


Related tasks:
Troubleshooting Business Process Choreographer Explorer