EMDOCU R19 TAFJ

Document Output
Installation Guide

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.

© 2018 Temenos Headquarters SA - all rights reserved.

EMDOCU R19 TAFJ Installation Guide

Table of Contents
Document History ......................................................................................................................................... 2
Introduction ................................................................................................................................................... 3
Contents of the package ............................................................................................................................... 3
Installation steps ........................................................................................................................................... 3
Document Output libraries ........................................................................................................................ 3
EMDOCU libraries ..................................................................................................................................... 4
Document Output folders .......................................................................................................................... 4
EMDOCU package .................................................................................................................................... 5
EMDOCU web application ........................................................................................................................ 7
Configuration................................................................................................................................................. 9

Document History

Author Version Date

Lukasz Czechowicz 1.0 23rd April 2020

2
EMDOCU R19 TAFJ Installation Guide

Introduction
This document explains the steps required to install the EMDOCU (Document Output) functionality on R19
TAFJ environment.

Contents of the package

The EMDOCU package contains the following items:
 DocumentOutput_Libraries.zip – jasperreports libraries, sample fonts and helper class for calling
jasperreports from T24
 EMDOCU_Libraries.zip – Java libraries with the EMDOCU functionality
 TMNS001-EMDOCU.zip – Build Control package with the EMDOCU functionality
 DocumentOutput_Folders.zip – default Document Output folder configuration with sample
documents / images
 EMDOCU_Web.zip – web application for document repository viewer
 do.module.config.zip – sample jboss configuration file for “do” module

Installation steps
Document Output libraries
Create “DocumentOutput” folder in the “t24lib” folder in the installation environment and copy the content
of DocumentOutput_Libraries.zip package into the directory.

Add the .jar libraries from this pack to the web server’s configuration file. In jboss, it is recommended to
create a “do” module with the configuration file “module.xml” included in do.module.config.zip package.
Note that the “t24lib” is a symbolic link to the t24lib folder of the installation environment.

The above “do” module should have dependency on the “tafj” module and “log4j.logmanager”.

3
EMDOCU R19 TAFJ Installation Guide

EMDOCU libraries
Copy the EMDOCU_...jar files from the EMDOCU_Libraries.zip package to the “t24lib” folder in the
environment.

Add the above libraries to the web servers’s “t24” module configuration file.

And define dependency on the “do” module created for DocumentOutput libraries.

Similarly dependency on the “do” module should be added for the “tafj” module.
When the modules are configured, the web server should be restarted for installation of the EMDOCU
Build Control package.

Document Output folders

Create a new folder for Document Output support files in a spare area / drive, it should be available to the
web server, e.g. it could be inside the “UD” folder of the environment. Copy the content of the
DocumentOutput_Folders.zip package into this new directory. In the example below, the folder is named
“DocumentOutputEnv1” and the structure inside should be like this.

4
EMDOCU R19 TAFJ Installation Guide

EMDOCU package
Copy TMNS001-EMDOCU folder in to the release folder of the Build Control packager in the
environment.
Run BUILD.CONTROL application and release all the data records included.

Make sure all the records are authorised – the object list to be authorised in each component is included
in the TMNS001-EMDOCU.zip.
Note: when authorising DO.DATA.SOURCE,MAIN record “AaCustomer”, the “Language” fields mapping
may need to be updated as below:

5
EMDOCU R19 TAFJ Installation Guide

Note: when authorising DO.DATA.SOURCE,MAIN record “Images”, the path to the image files should be
updated accordingly to the location of the Document Output folders setup in the previous step.

Note: for authorising of DO.TEMPLATE / DO.DOCUMENT records, the DO.PARAMETER record must be
already setup. This is specific to the installation environment, please refer to the Document Output user
guide for more details. Sample DO.PARAMETER,MAIN record SYSTEM is shown below.

Note: if the following BATCH records do not release correctly, please recreate them as well as the
corresponding TSA.SERVICE records, according to the installation environment setup (may need to be
company-specific with mnemonic):

6
EMDOCU R19 TAFJ Installation Guide

EMDOCU web application

The PDF repository viewer can be installed in a TAFJ environment in two ways:
 As a standalone DocRepoWebApp.war application in the application server (jboss)
 As a BrowserWeb.war plugin (recommended)

The two options are described below.

DocRepoWebApp Application
This web application should be manually deployed in jboss.

7
EMDOCU R19 TAFJ Installation Guide

Some configuration changes are required to point the repository viewer to where the PDF documents
generated from T24 are stored – this is manual task – edit web.xml file in the
DocRepoWebApp.war/WEB_INF folder and update the below parameters to the same paths that are
defined on the main Document Output parameter file in T24 (DO.PARAMETER).

BrowserWeb Plugin
This method requires the DocRepo.jar library to be copied into the BrowserWeb.war/WEB-INF/lib folder,
and the following changes should be done in the BrowserWeb.war/WEB-INF/web.xml file (at the end of
<context-param> section) – the paths should be set to the document output locations from the main
Document Output parameter file in T24.

8
EMDOCU R19 TAFJ Installation Guide

Then after the <servlets> tag, the following should be added:

When Browser plugin method is used, also the Repository Viewer URL (setup on Document Output Main
Parameter file) should be: http://<browser_host>/BrowserWeb/DownloadServlet, example below:
http://localhost:8180/BrowserWeb/DownloadServlet

Configuration
Access to Document Output menu is available from ?DO.MAIN:

Please refer the Document Output user guide for configuring the module further.