SOCLASS MODULAR

20 - Reference Table

Subject Advanced Tutorial

Version ADK 233
Issue date 06/07/2005
Beneficiaries Developers
File Tutorial 20 - Reference Table.doc
Status Final
Checked by Asycuda World - Lyon competence center
Copyrights United Nations Conference on Trade and Development
 Developer Guide
Version ADK 233
20 - Reference Table

Table of contents
1. OBJECTIVE......................................................................................................... 4
2. MODULE CREATION ....................................................................................... 5
2.1. GLOBAL ARCHITECTURE GENERATION, USING SOMWIZARD............................. 5
3. REFERENCE TABLE IMPLEMENTATION ................................................. 6
3.1. SHARED FILES DESCRIPTION ............................................................................ 6
3.1.1. Constants declaration in C_radical file .................................................... 6
3.1.2. Document’s logic representation in D_radical file................................... 7
3.1.3. Abstract document representation in AD_radical file............................... 7
3.2. SERVER FILES DESCRIPTION ........................................................................... 10
3.2.1. S_radical.java file.................................................................................... 10
3.3. CLIENT FILES DESCRIPTION ........................................................................... 11
3.3.1. Visual document ...................................................................................... 11
3.4. CLASS MODULE INFO .................................................................................... 12
4. PROPERTIES FILES........................................................................................ 13
4.1. DATABASE DECLARATION ............................................................................. 13
4.2. BUSINESS UNIT .............................................................................................. 16
4.3. BINDER.......................................................................................................... 16
4.4. DOCUMENT LIBRARY ..................................................................................... 17
4.5. MODULE PROPERTIES FILES ........................................................................... 17
4.5.1. un.asytutorialAdv.properties ................................................................... 17
4.5.2. Un.asytutorialAdv.tutorial20.properties ................................................. 17

United Nations Conference on Trade and Development Page 1 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

Figures
FIGURE1 - THIS IS AN EXAMPLE OF FIGURE........................................................................... 3
FIGURE2 - JOB REFERENCE TABLE ........................................................................................ 5
FIGURE3 - ACTION MENU ..................................................................................................... 8
FIGURE4 - FIND ITEM MENU ................................................................................................. 9
FIGURE5 - FIND DIALOGUE BOX ........................................................................................... 9

Source code
SOURCE 1 - THIS IS AN EXAMPLE OF SOURCE CODE ................................................................ 3
SOURCE 2 - CONSTANTS DECLARATION IN THE C_TUTORIAL20 INTERFACES ........................ 7
SOURCE 3 - DOCUMENT’S LOGIC REPRESENTATION IN THE D_TUTORIAL20 CLASS ................ 7
SOURCE 4 - ABSTRACT DOCUMENT REPRESENTATION IN THE AD_TUTORIAL20 CLASS (1) ... 8
SOURCE 5 - ABSTRACT DOCUMENT REPRESENTATION IN THE AD_TUTORIAL20 CLASS (2) ... 9
SOURCE 6 - ABSTRACT DOCUMENT REPRESENTATION IN THE AD_TUTORIAL20 CLASS (3) . 10
SOURCE 7 - S_TUTORIAL20 CLASS FILE ............................................................................... 10
SOURCE 8 - VISUAL DOCUMENT DECLARATION IN THE VD_TUTORIAL20 CLASS ................. 11
SOURCE 9 - ASYTUTORIALADVDOCUMENTINFO.JAVA CLASS FILE ...................................... 12
SOURCE 10 - INSTALL_SRC.XML DATABASE DECLARATION ................................................... 14
SOURCE 11 - ASYTUTORIALADV_CREATE.XML FILE .............................................................. 14
SOURCE 12 - ASYTUTORIALADV_INSERT.XML FILE ................................................................ 15
SOURCE 13 - PROP.XML MODIFICATIONS ................................................................................ 15
SOURCE 14 - BUSINESS UNIT DECLARATION IN THE INSTALL_SRC.XML FILE .......................... 16
SOURCE 15 - BINDER DECLARATION IN THE INSTALL_SRC.XML FILE ...................................... 16
SOURCE 16 - SHORTCUT DECLARATION IN THE INSTALL_SRC.XML FILE ................................. 17
SOURCE 17 - UN.ASYTUTORIALADV.PROPERTIES ................................................................... 17
SOURCE 18 - UN.ASYTUTORIALADV.TUTORIAL20.PROPERTIES .............................................. 17

United Nations Conference on Trade and Development Page 2 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

How to read this document

This symbol indicates advice and recommendations. Information on best
practices and recommended procedures related to the current topic is
contained here.

Keyword Definition

This symbol indicates a warning. Information on common pitfalls or dangers

associated with the current topic is contained here.

This symbol indicates an example to further illustrate the current topic.

Source 1 -
This is an example
of source code Source code.

Phase 1 Phase 2 Phase 3

Figure1 - This is an example of figure

United Nations Conference on Trade and Development Page 3 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

1. Objective

In this document you will learn

How to create a reference table in an independent module

Required element

Knowledge on how to create a new module

The objective of this document is to show how to create a reference table in an independent
module.
It describes the different steps to create a module that contain one or more reference tables.
Referential tables can be visualised in Asycuda client with the shape of a chart, and different
operations can be performed on this data by default: Edit, View.
They can also be used by other modules, in this document we will describe only the reference
tables using by their own, but they can also be used by others module as it is shown in
Tutorial 21 – Binding Reference Table.

The basic sample that is going to be described in this document is a table reference with two
fields for a job list:
• Job code reference
• Job code description

United Nations Conference on Trade and Development Page 4 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

Figure2 - Job reference table

2. Module creation

2.1. Global architecture generation, using somwizard

The first step in the creation of a reference table in an independent module is to create a
new module. This module has to be creating with the SOMwizard tool of the SOClass
environment:

This tool can be found in “\adk\bin\” directory.

United Nations Conference on Trade and Development Page 5 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

All the needed files for a module will be installed in the directory of your choice. The
structure of a reference table module is the same of the classic structure.
Refer to Tutorial 1 for more details on module creation.
Referential table e-document depends on so.tes module. Don’t forget to select it in the
dependencies check screen during somwizard execution.
So.tes is the table editor module.

3. Reference Table implementation

Each reference table has to be considered as a module e-document, so you will have one
document by reference table.

Type of file File name Location

Constants file C_radical.java shared directory
Document’s logic representation D_radical.java shared directory
Abstract document representation AD_radical.java shared directory
Server binder S_radical.java server directory
Visual Document VD_radical.java client directory

3.1. Shared files description

Shared parts are in the folder:
un\asytutorialAdv\shared\src\un\asytutorialAdv\tutorial20

3.1.1. Constants declaration in C_radical file

The starting point is to define all the constants in the C_radical class.
To define a reference table, one constant corresponds to each column of the reference
table you want to create.
In this tutorial there are two constants defined:
 COL1 Job code
 COL2 Job description

A constant for language translation is also defined; it is used with language

properties file situated in the server/som/lng directory.

United Nations Conference on Trade and Development Page 6 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

Source 2 -
package un.asytutorialAdv.tutorial20;
Constants
declaration in the import so.kernel.tableseditor.C_AbstractEditor;
C_Tutorial20
Interfaces public interface C_Tutorial20 extends C_AbstractEditor {

// Definition of the language pattern

static final String LNG_DOC = "RefJob";

// Definition of the column names of the reference table

static final String COL1 = "JOB_COD";
static final String COL2 = "JOB_DSC";

3.1.2. Document’s logic representation in D_radical file

The D_radical file is used to define the document’s logic representation.

Source 3 -
package un.asytutorialAdv.tutorial20;
Document’s logic
representation in import so.kernel.tableseditor.D_AbstractEditor;
the D_Tutorial20
class public class D_Tutorial20 extends D_AbstractEditor implements C_Tutorial20 {

private static final Class description = AD_Tutorial20.class;

In this file the only code that has to be written to define the document representation is
to declare an AD_radical Class object named description.

The name of the AD_radical class object must be : description

3.1.3. Abstract document representation in AD_radical file

In this first part of the file you can find the required code for the AD_radical.java
file.
This code defines specific variables used by the AbstractDescription Class to set
form name, form title, command names. A new option menu is created to manage this
reference table as follow:

United Nations Conference on Trade and Development Page 7 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

Figure3 - Action menu

With this menu you can:

 Sort a column by job code or job description
 Find a job by its code or its description
 Insert a new row in the reference table
 Edit an existing row of the reference table
 Delete an existing row of the reference table
These variables can be translated in the appropriate language using the properties file
situated in the server/som/lng directory.

Source 4 -
Abstract document package un.asytutorialAdv.tutorial20;
representation in
the AD_Tutorial20 import so.i18n.IntlFormat;
class (1) import so.i18n.IntlObj;
import so.kernel.tableseditor.AbstractDescription;
import so.kernel.tableseditor.AbstractEditorItem;
import so.kernel.tableseditor.AbstractEditorItems;

public class AD_Tutorial20 extends AbstractDescription implements C_Tutorial20

{

private static final IntlObj TITLE = lng1("{0}");

private static final IntlObj DESCRIPTION = lng("Action");
private static final IntlObj FORM_NAME = lng(LNG_DOC);
private static final IntlObj NEW_CMD = lng("New {0}", new Object[] {
DESCRIPTION });
private static final IntlObj EDT_CMD = lng("Edit {0}", new Object[] {
DESCRIPTION });
private static final IntlObj DEL_CMD = lng("Delete {0}", new Object[] {
DESCRIPTION });

private static final AbstractEditorItems information =

new AbstractEditorItems(TITLE,
DESCRIPTION,
FORM_NAME,
NEW_CMD,
EDT_CMD,
DEL_CMD);
…

United Nations Conference on Trade and Development Page 8 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

In this second part of the AD_radical.java file, the formats of the reference table
columns are defined:
 UN3 for CODE
 X35 for DESCRIPTION

The names description and the dialogue box for the find item menu to use with the
fields are also defined in this part of the file.

Figure4 - Find item menu

Figure5 - Find dialogue box

Source 5 -
static {
Abstract document AbstractEditorItem item;
representation in
the AD_Tutorial20 String formatId_1 = "UN3";
class (2) item = new AbstractEditorItem(COL1, true, "Ref", "Find Ref",
getConstructorTextColumn(formatId_1),
getParametersTextColumn(formatId_1));
information.add(item);

String formatId_2 = "X35";

item = new AbstractEditorItem(COL2, false, "Description", "Find Description",
getConstructorTextColumn(formatId_2),
getParametersTextColumn(formatId_2));
information.add(item);

United Nations Conference on Trade and Development Page 9 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

information.lock();
}

In this third part of the AD_radical.java file the language function are defined.
They are in association with the language properties files in
un\asytutorialAdv\server\src\un\asytutorialAdv\
tutorial20\server\som\lng

Source 6 - private static IntlFormat lng1(String pattern) {

Abstract document return IntlFormat.createIntlMessageFormat(“TutorialAdv”, pattern);
representation in }
the AD_Tutorial20
class (3) private static IntlObj lng(String pattern, Object args[]) {
return IntlFormat.createIntlMessageObject( “TutorialAdv”, pattern, args);
}

private static IntlObj lng(String property) {

return new IntlObj( “TutorialAdv” , property);
}

3.2. Server files description

Server files are in the folder:

un\asytutorialAdv\server\src\un\asytutorialAdv\tutorial20
\server

3.2.1. S_radical.java file

This file is used to define the type of the data for the different columns of the reference
table.
The object of the AD_radical class must be named: description.

Source 7 -
package un.asytutorialAdv.tutorial20.server;
S_Tutorial20 class
file import java.sql.Types;

import so.kernel.tableseditor.server.S_AbstractEditor;
import un.asytutorialAdv.tutorial20.AD_Tutorial20;
import un.asytutorialAdv.tutorial20.C_Tutorial20;

United Nations Conference on Trade and Development Page 10 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

public class S_Tutorial20 extends S_AbstractEditor implements C_Tutorial20 {

private static final Class description = AD_Tutorial20.class;

protected S_AbstractEditor.TableItem[ ] getServerInformation() {

return new S_AbstractEditor.TableItem[ ] {
new S_AbstractEditor.TableItem(COL1, Types.CHAR),
new S_AbstractEditor.TableItem(COL2, Types.CHAR)
};
}
}

The name of the AD_radical class object must be : description

3.3. Client files description

Server files are in the folder:

un\asytutorialAdv\client\src\un\asytutorialAdv\tutorial20
\client

3.3.1. Visual document

This file is used to define the visual document.
In this example, the background of the document is defined (colour, background
image, Margin, height). The setBackgroundImage() function is optional, if it is
not define, the default background will be used.

Source 8 -
package un.asytutorialAdv.tutorial20.client;
Visual document
declaration in the import java.awt.Color;
VD_Tutorial20
class import so.kernel.tableseditor.client.VD_AbstractEditor;
import so.kernel.tableseditor.client.VP_AbstractEditor;
import so.swing.KPanel;
import un.asytutorialAdv.tutorial20.C_Tutorial20;
import un.asytutorialAdv.tutorial20.D_Tutorial20;

public class VD_Tutorial20 extends VD_AbstractEditor implements C_Tutorial20{

private static final Class docClass = D_Tutorial20.class;

public VD_Tutorial20() {
super();
}

public void setVisualPageDefault(VP_AbstractEditor vp) {

United Nations Conference on Trade and Development Page 11 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

vp.setBackgroundImage(so.swing.IconResourcer.getIcon("img/Background.jpg"),
KPanel.TILE);
vp.setBackgroundFilter(new Color(204, 204, 204, 255), false);
vp.setRowMargin(3);
vp.setRowHeight(15);
}

3.4. Class Module Info

Somwizard tool is used to generate all our module architecture: directories, properties
files, xml files… it generates also two class files: RadicalModule.java and
RacidalDocumentInfo.java located in the folder
un\asytutorialAdk\server\src\un\asytutorialAdv\module.
RadicalDocumentInfo.java contains information used if you want to restore this
module. Init() method returns data from GCF table configuration.
As we don’t use GCF table for reference table e-document then we have to delete or
put into comment tag all code in Init() method then
RadicalDocumentInfo.java looks like as follow:

Source 9 -
AsytutorialAdvDoc package un.asytutorialAdv.module;
umentInfo.java
class file
import so.kernel.server.DocumentModuleInfo;

/**
*
*/
public class AsytutorialAdvDocumentInfo extends DocumentModuleInfo {

/** Creates a new instance of AsytutorialAdvDocumentInfo */

public AsytutorialAdvDocumentInfo() {
super();
}

protected void init() {

/*String url = Server.getString("module.un.asytutorialAdv.gcf.url");

String usr = Server.getString("module.un.asytutorialAdv.gcf.user");
String passwd = Server.getString("module.un.asytutorialAdv.gcf.password");

String iedTable = Server.getString("module.un.asytutorialAdv.gcf.tables.ied");

String historyTable = Server.getString("module.un.asytutorialAdv.gcf.tables.history");
String locksTable = Server.getString("module.un.asytutorialAdv.gcf.tables.locks");
String trackTable = Server.getString("module.un.asytutorialAdv.gcf.tables.track");

setIED(url, usr, passwd, iedTable);

setHistory(url, usr, passwd, historyTable);
setLocks(url, usr, passwd, locksTable);
setTrack(url, usr, passwd, trackTable);*/
}

United Nations Conference on Trade and Development Page 12 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

4. Properties files
We have to prepare all configuration files.

In this chapter you will learn

Prepare properties files for deployment.

Properties files that will be modified

install_src.xml \server\som
prop.xml \server\som
asytutorialAdv_create.xml \server\som\db
asytutorialAdv_insert.xml \server\som\db
un.asytutorialAdv.properties \server\som\config
un.asytutorialAdv.tutorial20.properties \server\som\config

The install_src.xml file is in folder:

un\asytutorialAdv\server\src\un\asytutorialAdv\server\som
Install_src.xml is used to create the som file by using ant som command in server
directory (see Installation Guide for details).
During the module deployment, som file is used by mast tool to install the module on the
ASYCUDA server.
So we need to modify the install_src.xml to prepare our document installation.
We will create database declaration, Business Unit, Binder and Document Library shortcut
within <system> XML tag.

4.1. Database declaration

In install_src.xml file, we find <db> XML tag. Within those tags, there is default
code for GCF table management, created by somwizard tool during the creation of the
module. As we not use GCF table in reference table e-document, we have to delete these
lines.
The next step is to insert lines that manage the automatic creation of our e-document
database during the module installation.
We must add within <db> XML tag the following code:

United Nations Conference on Trade and Development Page 13 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

Source 10 -
Install_src.xml …..
database </copy>
declaration
<!--
Properties for DB.
-->
<db manager="${un.asytutorialAdv.drv_manager}" url="${un.asytutorialAdv.url}"
user="${un.asytutorialAdv.user_name}" password="${un.asytutorialAdv.password}">
<create>
<fileset dir="db">
<include name="asytutorialAdv_create.xml"/>
</fileset>
</create>
<insert>
<fileset dir="db">
<include name="asytutorialAdv_insert.xml"/>
</fileset>
</insert>
<appserver dbsource="jdbc/un.asytutorialAdv" name="un.asytutorialAdv">
<pool minPoolSize="1" maxPoolSize="-1" maxIdleTime="5"/>
</appserver>
</db>

<!--
Import into Kernel DB
-->
<system>
……

Notice that we declare two files used for database automatic installation.
• asytutorialAdv_create.xml for the automatic creation of the tables in the
database.
• asytutorialAdv_insert.xml for the automatic insertion of records in the
tables.
These files are located in:
un\asytutorialAdv\server\src\un\asytutorialAdv\server\som\db

Source 11 -
asytutorialAdv_cre <?xml version="1.0" encoding="UTF-8"?>
ate.xml file <!DOCTYPE create SYSTEM "http://strategyobject.com/dtd/create.dtd">
<create>
<table name="refjob">
<column name="JOB_COD" type="VARCHAR"/>
<column name="JOB_DSC" type="VARCHAR"/>
</table>
</create>

Table name used by our e-document is named refjob.

United Nations Conference on Trade and Development Page 14 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

Source 12 -
asytutorialAdv_inse <?xml version="1.0" encoding="UTF-8"?>
rt.xml file <!DOCTYPE insert SYSTEM "http://strategyobject.com/dtd/insert.dtd">

<insert>
<table name="refjob">
<row>
<column name="JOB_COD">FIN</column>
<column name="JOB_DSC">Accounting/Finance</column>
</row>
<row>
<column name="JOB_COD">ADV</column>
<column name="JOB_DSC">Advertising/Public Relations</column>
</row>
<row>
<column name="JOB_COD">ART</column>
<column name="JOB_DSC">Arts/Entertainment/Publishing</column>
</row>
<row>
<column name="JOB_COD">BAM</column>
<column name="JOB_DSC">Banking/Mortgage</column>
</row>
<row>
<column name="JOB_COD">ADM</column>
<column name="JOB_DSC">Clerical/Administrative</column>
</row>
….
<row>
<column name="JOB_COD">OTH</column>
<column name="JOB_DSC">Other</column>
</row>
</table>
</insert>

Another file is necessary for our database installation: prop.xml

The prop.xml file is where the connection to the new database has to be indicated. As in
install_src.xml, we must delete all GCF database management lines.

Source 13 -
Prop.xml …
modifications <properties>
<group type="connection">
<property name="un.asytutorialAdv.drv_manager" from="driver" />
<property name="un.asytutorialAdv.url" from="url" default="asytutorialAdv.mod" />
<property name="un.asytutorialAdv.user_name" from="user" />
<property name="un.asytutorialAdv.password" from="password" />
<description><![CDATA[Connection to database Module asytutorialAdv is required.
This database is available. You can create new or use the same database.
Then enter connection properties in this form.]]></description>
</group>

</properties>

United Nations Conference on Trade and Development Page 15 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

4.2. Business unit

In this e-document, we will create a business unit called “BUasytutorialAdv”. The business
unit is declared within <system> XML tags

Source 14 -
business unit
declaration in the <BU name="BUasytutorialAdv">Advanced tutorial</BU>
install_src.xml file

The Business Units on a document could be defined manually filling this file or using the
ASYCUDA client application. The defined Business Units will be added automatically in
ASYCUDA environment with the appropriated rights if they are defined in the
install_src.xml file.

4.3. Binder
Binder is usually situated after business unit definition within <system> XML tags.

Binder A server side class that manages the binding of the

document and the database and the Document
Processing Path. It defines the document server binder
business logic that, for security and architectural
reasons, has to be executed on the server. It
encompasses server rules attached to operations, and
table connectors.

Source 15 -
Binder declaration <binder name="B_TUTORIAL20" status="">
in the <field name="server" value="un.asytutorialAdv.tutorial20.server.S_Tutorial20"/>
install_src.xml file <field name="dom" value="un.asytutorialAdv.tutorial20.D_Tutorial20"/>
<field name="client" value="un.asytutorialAdv.tutorial20.client.DC_Tutorial20"/>
<access bu="BUasytutorialAdv">
<full/>
</access>
</binder>

United Nations Conference on Trade and Development Page 16 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

4.4. Document library

Shortcut is usually situated after binder tags definition within <DL> XML tags.

Document The holder of shortcuts to applications bound to the

library system. Users will view those shortcuts according to
their user permissions.

Shortcut has a sense only if a binder is defined.

Source 16 -
Shortcut
declaration in the
install_src.xml file
<DL>
<folder name="Tutorial ADV" icon="">
<access bu="BUasytutorialAdv">
<full/>
</access>
<item name="tutorial 20 – Reference Table" icon="">
<field name="binder" value="B_TUTORIAL20"/>
<field name="skin" value=" un.asytutorialAdv.tutorial20.client.VD_ Tutorial20 "/>
<access bu="BUasytutorialAdv">
<full/>
</access>
</item>
</folder>
</DL>

4.5. Module properties files

These files are situated in:
un\asytutorialAdv\server\src\un\asytutorialAdv\server\som\conf
ig

4.5.1. un.asytutorialAdv.properties
This file is common to all the reference tables of the module.
You will have to add include lines if you use more than one reference table in this
module.

Source 17 -
un.asytutorialAdv.p
roperties @include un.asytutorialAdv.tutorial20.properties

United Nations Conference on Trade and Development Page 17 of 19

 Developer Guide
Version ADK 233
20 - Reference Table

4.5.2. Un.asytutorialAdv.tutorial20.properties
In this file the link to the database table is defined:
 Database URL
 Database User
 Database Login
 Reference name to be used by other modules (refname)
 Table name
 Table fields

Source 18 -
un.asytutorialAdv.t un.asytutorialAdv.tutorial20.server.S_Tutorial20#Table=refjob
utorial20.properties un.asytutorialAdv.tutorial20.server.S_Tutorial20#URL=$[un.asytutorialAdv_URL]
un.asytutorialAdv.tutorial20.server.S_Tutorial20#User=$[un.asytutorialAdv_User]
un.asytutorialAdv.tutorial20.server.S_Tutorial20#Password=$[un.asytutorialAdv_Passwor
d]
un.asytutorialAdv.tutorial20.server.S_Tutorial20#refname=JOB_TAB

########################################
# Define REFJOB reference tables
########################################

# Job reference table

so.kernel.server.ServerReferenceTablesManager#JOB_TAB#URL=$[un.asytutorialAdv_U
RL]
so.kernel.server.ServerReferenceTablesManager#JOB_TAB#User=$[un.asytutorialAdv_U
ser]
so.kernel.server.ServerReferenceTablesManager#JOB_TAB#Password=$[un.asytutorialA
dv_Password]
so.kernel.server.ServerReferenceTablesManager#JOB_TAB#Table=refjob
so.kernel.server.ServerReferenceTablesManager#JOB_TAB#Fields=JOB_COD JOB_DSC

Now you can compile and deploy your module with Ant tools.

United Nations Conference on Trade and Development Page 18 of 19