Deploy developed business process for test
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:
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:
- Select the menu item "Content loaders -> Business Processes" in the
administration interface.
- Press "Insert" to create a new business process
- 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.
- Create default presentation - leave this option checked.
- Press "Insert".
Follow these steps to attach a business process to a menu element as a menu
item:
- In the Administration interface left menu select "Site structure -> Site
structure"
- Select the menu that should contain the new business process menu item.
- Press "Add". This starts a wizard that will lead you through the process.
- Select "Create new site element" and "Frameset", press "Next".
- Select the presentation of the business process to be used by pressing
"Select".
Use the search facility to find the presentation.
- 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
- Assign the roles for the site element, and press "Finish".
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:
- The Site Setting "Automatic event creation" must be checked.
- The Site Setting "Library for created events must correspond to the
library/folder containing the program object for the EventHandler.
- 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.
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.