Deploy developed business process for test

Overview

This description describes the steps necessary for deploying a developed business process for test purposes.

This guide shows how to make the the business process available by pressing a menu item.

For a more complete description of how you can add the business process to a site, read the two administrator guides:

Deploy objects

The simplest way of deploying the objects is to let the library/folder you compile you objects to be part of the library list/path defined for the application service jobs.

For iSeries, this is defined in the job description EXPRESS. For Windows, this is defined in the settings.cmd file under the folder "Application Service"

If the templates has been defined using the PageModeler (RPG Developer and 2E Developer) the templates are already deployed. Otherwise you will have to move the templates to one of the folders defined in the administration interface.

For iSeries, you must restart the jobs servicing the application (use the start/stop) command if any program objects has been changed.

Define business process in the administration interface

Follow these steps in order to define a new Business Process:

  1. Select the menu item "Content loaders -> Business Processes" in the administration interface.
  2. Press "Insert" to create a new business process
  3. On the insert page enter the following information:
    • Name - a recognizable name for the business process.
    • Program name - the name of the ProcessEntryPoint function (name of the program object)
    • Description - a short description of the process (if nothing else is preferable - copy the Name)
    • Comment - optional comment about the business process.
  4. Create default presentation - leave this option checked.
  5. Press "Insert".

Make business process available as a menu item

Follow these steps to attach a business process to a menu element as a menu item:

  1. In the Administration interface left menu select "Site structure -> Site structure"
  2. Select the menu that should contain the new business process menu item.
  3. Press "Add". This starts a wizard that will lead you through the process.
  4. Select "Create new site element" and "Frameset", press "Next".
  5. Select the presentation of the business process to be used by pressing "Select".
    Use the search facility to find the presentation.
  6. Supply information about the site element, and press "Next".
    • Menu item text - this is the text that will be shown for the menu item in the menu. (It will also be shown in the site structure tree).
    • Alignment - indicating whether you want to show the menu item in the first (left) or second (right) section of the menu.
    • Sequence - this specifies the order that the menu items will be shown in. Be aware that by defining two or more menu items with the same combination of alignment and sequence will result in only one of them being shown in the menu. Which menu item to show is decided from the roles assigned to the menu items in combination with the roles assigned to the current session.
    • Display in frame - this specifies the frame you want to split using the frameset when the menu item is activated.
    • Comments - optional field for your comments
  7. Assign the roles for the site element, and press "Finish".

Ensure that events can be registered

Whenever a new event (typically buttons or links on pages) is called the first time, the Websydian Express runtime makes a registration of the event as a valid event.

To ensure that only the correct events are registered - a number of preconditions must be in place:

  1. The Site Setting "Automatic event creation" must be checked.
  2. The Site Setting "Library for created events must correspond to the library/folder containing the program object for the EventHandler.
  3. The IP address of the PC running the browser must belong to the IP intranet mask defined in the Site Setting "IP intranet mask".

The Site Settings can be found in the Sites -> Site Settings in the administration interface.

If any of these preconditions are not satisfied, an general error will be shown to the user, and a diagnostic error message will be written to the message log.

Searching for errors

If an error occurs when trying to run the application, there are a couple of places to look for diagnostic information:

Message log

The message log is found in the administration interface. Utilities -> Message Log.

The message log contains error messages and diagnostic information from the Websydian Express runtime.

iSeries joblog

When using the iSeries, the joblog for the EXPRESSAS jobs submitted by the START command can contain all of the usual information concerning missing objects etc.

Windows log file

In Windows installations, the EXPRESS.log file found in the installed folder "Application Service" can contain error and diagnostic message.