Websydian v6.1 online documentationOnline documentation - WebsydianExpress v3.0

Setup WebsydianExpress for Java Development Environment

Add Websydian library models to group model and extract

In your group model, add the library WSYAPI. You will be prompted for a number of libraries used by the WSYAPI model. These libraries are either CA Plex libraries or Websydian libraries. For the CA Plex libraries select the libraries delivered with CA Plex version 6.0. For the Websydian libraries use the libraries delivered with the Websydian installation, see the table below.

Library model Location Licensed
Web Developer
WSYAPI <Websydian Install Folder>\development\Plex6.0\patterns\WSYAPI No
WSYBASE <Websydian Install Folder>\development\Plex6.0\patterns\WSYBASE Yes
WSYVAL <Websydian Install Folder>\development\Plex6.0\patterns\WSYVAL No
WYSINTEG <Websydian Install Folder>\development\Plex6.0\patterns\WSYINTEG No
WYSSESS <Websydian Install Folder>\development\Plex6.0\patterns\WSYSESS No
WSYUSER <Websydian Install Folder>\development\Plex6.0\patterns\WSYUSER No
WSYUTIL <Websydian Install Folder>\development\Plex6.0\patterns\WSYUTIL No
SDSTRING <Websydian Install Folder>\development\Plex6.0\patterns\SDSTRING No
WSYHTTP <Websydian Install Folder>\development\Plex6.0\patterns\WSYHTTP No

If planning on developing web services for WebsydianExpress you will also need to add the library WSYAPIWS.

Library model Location Licensed
WSYAPIWS <Websydian Install Folder>\development\Plex6.0\patterns\WSYAPIWS No
WSYDOM <Websydian Install Folder>\development\Plex6.0\patterns\WSYDOM Yes
WSYXML <Websydian Install Folder>\development\Plex6.0\patterns\WSYXML No
WSYSOAP <Websydian Install Folder>\development\Plex6.0\patterns\WSYSOAP No

When done adding the Websydian libraries to your group model make sure that you extract the new libraries into your local model.

Setup model configuration

Open the "Model Configuration" dialog and set the Variant, Version and Level of the Websydian supplied libraries according to the following table:

Library model Variant Version Level
WSYAPI JAVA JDBC Server v3.0.4 v3.0.4
WSYBASE DWA - Java v6.1.4 v6.1.4
WSYVAL Base v6.1.4 v6.1.4
WYSINTEG Base v6.1.4 v6.1.4
WYSSESS Base v6.1.4 v6.1.4
WSYUSER Base v6.1.4 v6.1.4
WSYUTIL Base v6.1.4 v6.1.4
WSYHTTP Java v6.1.4 v6.1.4
SDSTRING Java v6.1.4 v6.1.4
If you also attached the WSYAPIWS library model for developing web services for WebsydianExpress, please check the Variant, Version and Level of the following libraries:
Library model Variant Version Level
WSYAPIWS Base v3.0.4 v3.0.4
WSYDOM Java v6.1.4 v6.1.4
WSYSOAP Base v6.1.4 v6.1.4
WSYXML Base v6.1.4 v6.1.4

Configure Generate and Build Options

System Properties (32-bit C++ build)

Setup the pre-built C++ library files in the CA Plex local model. Follow these steps:

  1. Open the "System Definitions" dialog located under the "Generate and Build Options".
  2. Select the "System name" with "System type" WINNT and press the "Properties" button
  3. In the "32-bit C++ Build" section activate "Use pre-built libraries" if not all ready activated.
  4. Add each of the library files listed in the following table to the "Libraries" field. Make sure to add the full path of each library file and delimiting each library file by a semicolon (;)
    Library file Location
    websyd.lib Located in the folder <Websydian Install Folder>\development\Plex6.0\lib
    wsexpress.lib Located in the folder <Websydian Install Folder>\development\Plex6.0\lib
  5. Add the Websydian header folder "<Websydian Install Folder>\development\Plex5.5\include" to the field "Header Directories"
    Header files Location
    Websydian header files Located in the folder <Websydian Install Folder>\development\Plex6.0\include
C++ library files are referenced by file name whereas header files are referenced by the name of the folder where they are located.

Libraries by Example

An example of a libraries string. Shown with line breaks for convenience. Copy and paste to notepad, replace location of Websydian and CA Plex installation and line breaks then copy and paste to CA Plex "System Properties".

c:\Websydian\development\Plex6.0\lib\websyd.lib;
c:\Websydian\development\Plex6.0\lib\wsexpress.lib

Header Directories by Example

An example of a directory string. Copy and paste to CA Plex "System Properties" and replace location of Websydian.

c:\Websydian\development\Plex6.0\include

System Properties (Java Build)

Setup the User classes jar files in the CA Plex local model. Follow these steps:

  1. Open the "System Definitions" dialog located under the "Generate and Build Options".
  2. Select the "System name" with "System type" WINNT and press the "Properties" button
  3. In the "Java Build" section add each of the jar files listed in the following table to the "User classes" field. Make sure to add the full path of each jar file and delimiting each file by a semicolon (;)
    Jar file Location
    WsydDwa21.jar Located in the folder <Websydian Install Folder>\development\Plex6.0\jars
    WsydUtil.jar Located in the folder <Websydian Install Folder>\development\Plex6.0\jars
    WsydXML.jar Located in the folder <Websydian Install Folder>\development\Plex6.0\jars
    OBPTJAVA.JAR Provided with CA Plex in the folder <Plex Install Folder>\CLASS600\PatternLibs

User classes by example

An example of a User classes string. Shown with line breaks for convenience. Copy and paste to notepad, replace location of Websydian and CA Plex installation and line breaks then copy and paste to CA Plex "System Properties".

c:\Websydian\development\Plex6.0\jars\WsydDwa21.jar;
c:\Websydian\development\Plex6.0\jars\WsydUtil.jar;
c:\Websydian\development\Plex6.0\jars\WsydXML.jar;
c:\Plex6.0\CLASS600\PatternLibs\OBPTJAVA.JAR

Copy required release objects to your local model

In order for the DocumentTemplateGenerator to execute correctly you are required to copy a number of files to your local model release directory.

Settings for Websydian DocumentTemplateGenerators

Settings for where the DocumentTemplateGenerators are saving the html templates are located in the file websydian.ini in your release directory.

Using notepad you are able to change the location of the generated html files. By default a directory named html scoped to the release directory is used.

; Specify location of the generated html files
[WebSourceHTM]
sourcedir=.\html

; Specify information about URL to be used by your Websydian application
; Will be used in the document templates as action references
[Websydian]
URL_Dispatcher=/(WSACTION)