Configuring the baseUrl

The baseUrl needs to be configured if you are going to run the View Distributor application locally on your development machine. The baseUrl is the URL that points to the Action Processor to which the application will connect at runtime.

Note that when running on an ActiveMatrix BPM node, the application and the Action Processor must be running on the same machine. Therefore, the baseUrl attribute for the ActionProcessors record in the config.xml file is set to an empty string by default:

<record jsxid="ActionProcessors" type="workspace">
    <ActionProcessor
       weighting="100"
       baseUrl="">
    </ActionProcessor>
</record>

This causes the URL of the Action Processor to be determined at runtime based on the URL entered in the browser to start the application. So if you are going to deploy the View Distributor application to a runtime node and run it by pointing a browser to the application’s URL, leave the value of the baseUrl attribute an empty string.

In a development/testing environment, however, you will likely be running the application on a local machine. Therefore, you will need to specify the URL to the Action Processor in the baseUrl attribute. To specify the baseUrl:

Procedure

  1. Open the following file:

    StudioHome\wcc\version\JSXAPPS\wccViewDistributor\config.xml

    where:

    • StudioHome is the directory in which TIBCO Business Studio was installed.
    • version is the version number of WCC that was installed with TIBCO Business Studio.
  2. Locate the ActionProcessors record in the config.xml file.
  3. Set the baseUrl attribute to the URL of the Action Processor. The string in the baseUrl attribute must be in the form:

    http://Host:Port/bpm/actionprocessor/actionprocessor.servlet

    where:

    • Host is the name or IP address of the machine hosting the Action Processor.
    • Port is the port number used by the ActiveMatrix WebApp Implementation Type to communicate with web applications.
      For example:
      <record jsxid="ActionProcessors" type="Workspace">
         <ActionProcessor
            weighting="100"
            baseUrl="http://Austin:8080/bpm/actionprocessor/actionprocessor.servlet">
      </ActionProcessor>

      Note that the weighting attribute is not used at this time. Also note that you cannot run locally if the transport protocol for the Action Processor is https; it must be http to run locally.

  4. Save and close the config.xml file.