Configuring Launch Pages to Handle Context-Switching

You must configure the Openspace or Workspace launch page(s) to handle the different format of the URL that results from context-switching.

The load balancer may use context-switching (for example, to allow dynamic routing of endpoints) in the URL that it uses to access Openspace or Workspace.

For example:

loadbalancer:port/context/openspace

If multiple contexts are used, for example:

loadbalancer:port/context1/context2/openspace

Openspace and Workspace cannot by default resolve the URL properly to load the TIBCO Forms runtime and display a form.

To correct this, you must edit the appropriate Openspace or Workspace HTML launch page(s) to account for the different format of the URL.

Procedure

  1. Identify each Openspace or Workspace HTML launch page that you need to edit, depending on the client types that you use. The following table lists the different launch pages - there are two copies of each launch page, one in each of the following folders:
    • CONFIG_HOME\tibcohost\Admin-enterpriseName-serverName\host\plugins\
    • TIBCO_HOME\components\shared\1.0.0\plugins\

    You should edit both copies.

    File Description
    com.tibco.openspace.login_version\resources\openspace.html Openspace launch page
    com.tibco.openspace.login_version\resources\mobile\mobile.html Openspace - Mobile launch page
    com.tibco.openspace.login_version\resources\openform\openform.html Openspace launch page for pushed work items
    com.tibco.n2.rtc.ws_version\resources\workspace.html Workspace launch page
    com.tibco.n2.rtc.ws_version\resources\openworkitem.html Workspace launch page for pushed work items
  2. In each file:
    1. Find the following entry: 
      <script
   type="text/javascript" language="javascript"
   src="../bpmresources/formsclient/formsclient.nocache.js">
</script>
    2. Prefix the src path with an additional "../" for each additional nesting level used in the context path of the load balancer URL.
    3. Save the file.

Example

If the URL used to access Openspace from the load balancer is:

loadbalancer:port/context1/context2/openspace

change the entry in the launch page to: 

<script
   type="text/javascript" language="javascript"
   src="../../bpmresources/formsclient/formsclient.nocache.js">
</script>
Note: Openspace or Workspace can, by default, resolve a request and display a form if the URL used to access Openspace or Workspace from the load balancer has the format:

loadbalancer:port/BPMclient

or

loadbalancer:port/context/BPMclient

For example, if the URL used to access Openspace from the load balancer is:

loadbalancer:port/openspace

or

loadbalancer:port/openspace.html

or

loadbalancer:port/context1/openspace.html

no additional configuration of launch pages is required.