T24 User guide to JAVA API

Information in this document is subject to change without notice.

No part of this document may be reproduced or transmitted in any form or by any means, for any purpose,
without the express written permission of TEMENOS HEADQUARTERS SA.

COPYRIGHT 2007 - 2008 TEMENOS HEADQUARTERS SA. All rights reserved.

T24 User guide to JAVA API

Table of Contents

Document History ...................................................................................................................................3

INTRODUCTION TO L3 JAVA API ......................................................................................................4
Pre-requisites .......................................................................................................................................4
Workflow diagram ...............................................................................................................................5
Field and EB.API record relation .......................................................................................................7
Steps to create JAVA Project in Design Studio .................................................................................8
Create a new Application ..................................................................................................................15
How to debug? ....................................................................................................................................20
T24 User guide to JAVA API

Document History

Author Version Date Approved By

Ajay Karthi E 1.0 14-02-2020 Deepan

Chakravarthy

Ayushi 1.1 14-02-2020 Deepan

Chakravarthy
T24 User guide to JAVA API

INTRODUCTION TO L3 JAVA API

Temenos T24 Transact is designed to allow the extensive addition of new capabilities by
banks during implementation. The ability to extend T24 Transact, allows a bank to write
large amounts of custom code, called L3. L3 Java enables customers and partners to
write safe L3 customer implementation code in java.

Every T24 Transact implementation requires some degree of customisation to satisfy

customer requirements. L3 Java supports the following usage scenarios for a customer
development:
 Updating User Defined Tables.
 Validating any transaction IDs entered.
 Auto populating fields.
 Cross-validating records and fields.
 Altering and/or defaulting other field values in the record based on a field
value.
 Updating local reference fields.
 Raising errors / overrides.
 Defining services.
 Defining COB jobs.
 Combining data from different applications.

Pre-requisites

1. R19 and higher versions.

2. JD Module installed.
3. TAFJ environment, and not supported in TAFC environment.
4. TAFJClient.jar- Classes for JAVA developers are introduces under this jar.
T24 User guide to JAVA API

Workflow diagram

This is the general method to be followed while developing a L3 Java code.

1. View the help text for the field to which L3 java routines have to be attached.
Ex: For the field INPUT.ROUTINE in the VERSION application, the HelpText is
as follows

In the HelpText, it will be clearly mentioned about EB.API record details and the
hook method that gets invoked.

2. From the EB.API record, we can get the necessary details such as the hook
component and the hook method that gets invoked.
T24 User guide to JAVA API

3. From the Hook component, we can able to view the “Super Class” that has to be
extended and the various methods that are available for that particular hook
component and the details regarding the method functions, arguments and the
return type details that will be available in the Javadoc.
T24 User guide to JAVA API

4. After getting enough info from the Javadoc, we will proceed with the java coding
in the design studio.

Field and EB.API record relation

L3
EB_related_methods.xlsx
T24 User guide to JAVA API

Steps to create JAVA Project in Design Studio

1. Create a Java Project in EDS using the Java Project Wizard.

In EDS, select FILE>NEW>PROJECT.
Select JAVA Project and click on Next.
Give name to the project and select finish.

2. Configure the java build path for our new project.

Right click on your new project and select Properties -> Java Build Path then select the
Libraries Tab.
T24 User guide to JAVA API

 Then add the jars for your project by clicking on Add External JARs, including
the TAFJClient.jar in TAFJ\lib; and
 Add all the libraries present in the t24lib by

Add Library ->User Libraries -> New -> Add External JARs and add the
JARS available in the following path –
“\R19\Infra\AppServer\JBoss\Default\modules\com\slot01\temenos\t24\main”
Then press Apply and Ok.
3. Create a JAVA class by clicking on File>New>Class.
The java class wizard will appear, enter the package, class name and super class
say com.temenos.t24.api.hook.accounting.AccountingEntry and then press finish.
 T24 User guide to JAVA API

Naming Convention:
• Package Name - all lower case
• Class Name - Class Names should be in Camel Case
• Superclass - The top-most class, the class from which all other classes are derived

An outline of the given class will be created with empty method definitions.
Implement the required method.

4. Right click on your project and select Export -> JAR file -> Next. Fill out the dialog
box with the name and location of the jar file and click Finish.

0
 T24 User guide to JAVA API

5. Create an EB.API record for implemented JAVA method, add this EB.API record to
the required field, and check the functionality.

Example: After creating the Java project with Super Class as RecordLifecycle and the
class as L3t1,

1
 T24 User guide to JAVA API

 The above code is made to check the field SECTOR value is ‘1001’ in the
CUSTOMER record.

 For importing CUSTOMER related application record, it is necessary to import

the below:

import com.temenos.t24.api.records.customer.CustomerRecord;
 As discussed earlier, we have to export the L3 api class as jar file

2
 T24 User guide to JAVA API

 In the module.xml file

 Add the jar created to the module.xml

 Create an EB.API record with SOURCE.TYPE as ‘Method’ and the Java method,
class and package as mentioned in the project.

3
 T24 User guide to JAVA API

 Add the routine to the VERSION record

 Test the code by creating the record in the corresponding version

4
 T24 User guide to JAVA API

For a SECTOR value of 1000 error is thrown as per our api design

Create a new Application

1. Create the table using EB.TABLE.DEFINITION. This would create required
PGM.FILE, FILE.CONTROL, STANDARD.SELECTION and data files for your
application.

5
 T24 User guide to JAVA API

2. To generate the API for the created application, kindly make sure that the below
is available:
 Server project to establish connection with T24
 Models project to import application form T24.

Click on New>File>Project

3. Select Design Studio>Design Studio Template Project from the appearing Wizard.

6
 T24 User guide to JAVA API

4. Choose data tools template from the drop down list. Provide Project name,
TAFJ_HOME, insertDir and libDir Paths and click finish.

5. Import the local Application by name in <projectname>-models-project, in

application folder.

7
 T24 User guide to JAVA API

6. You can see the class in EB.Foundation after the application is successfully
imported.

7. To generate the API for this new Table, toggle to TAFJ project, Right click the
project, select Design Studio>Generate T24 API. Give the location and name of
the jar.

8
 T24 User guide to JAVA API

8. Update module.xml and restart jboss.

9. Add the jar to JAVA build Path

10. Once the jar is created and imported in JAVA buildPath, classes for the same can
be created in a similar way as for the other applications.

9
 T24 User guide to JAVA API

How to debug?

0
 T24 User guide to JAVA API

Open the StartUpJboss script for editing purpose.

For the variable JAVA_OPTS add the following line to debug the L3 API’s.
-Xms8G -Xmx18G -Dfile.encoding=UTF-8 -Xdebug -Xnoagent -
Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n

1
 T24 User guide to JAVA API

In the Design Studio, setup the Debug configuration for the Remote Java Application
and set the following HOST can be the localhost or you can specify the ip address and the
port should be the same as the “socket-address” as specified in the StartUpJboss script.

On starting the Jboss, we can see that the port 8787 is started listening and also check
whether the axis2.war is deployed.

2
 T24 User guide to JAVA API

For a Local Application created using the EB.TABLE.DEFENITION, and using the table
in the L3 java code and debugging them, a json file representing the table will be popped
up when we hover around the object that holds the table record.

Is the record of the local application.

‘c1’ is the object and hovering the mouse around the object will display the json file
representation of the record.