You can control the data document server from a Caché application, by using the supplied control classes.

To run reports and to generate documents, you need the following components:

  1. A Tomcat Server (This is the standards based runtime framework, that ReportWeaver/JPublisher uses to run its engine.) The tomcat server can be downloaded from: http://tomcat.apache.org/. It is recommended to use version 5.5. Please see the Tomcat Server installation instructions for details.
  2. The data document server. The data document server is a deployment file for the Tomcat Server. It is called ddserver.war (or blueprint.war) and should reside in your installation directory for the template studio.
  3. The Caché Web Service Interface. This is a set of classes, that can be loaded into your Caché application and that communicate with the data document server.

This chapter describes how the Web Service Interface is loaded and used.

Loading the classes

Please start the Cache system management portal and select classes from the menu.

loading qint classes

  1. Select your namespace.
  2. Press Import

select import file

  1. Please go to the installation directory of your template studio. (This should reside in \Program Files\QintSoft)
  2. There you must select the file joriacachewebservice.xml

import classes

  1. After pressing open, the classes are shown.
  2. This is the list of classe that will be imported. They all start with joria. (The internal name of ReportWeaver/JPublisher)
  3. Press import to start the import.

  1. If the import finished successfully, you can start using the classes. If not please contact Qint's free support at support@qint.de.

Using the classes

  1. The main interface class is Joria.Joria.
  2. It has extensive documentation, that is accessible from the system management portal.
  3. The documentation is also included here.

Samples

  1. In the Caché Studio you can take a look at the sample class JoriaSamples.Sample. It contains the boilerplate code to start a report either generically
  2. or from a specific object.

Please copy the code into your application, and modify it as required.