Invoking a JADE Report Writer Application from a User Application

The JADE Report Writer Configuration and Designer applications should be integrated into the user system. The JADE Report Writer Designer application print, extract data, and preview options are not enabled unless the report designer is run from the user system.

For initial evaluation of the JADE Report Writer, you can do this from JadeScript methods, as shown in the following examples.

startConfiguration();
vars
    rwManager : JadeReportWriterManager;
begin
    create rwManager transient;
    rwManager.startReportWriterConfiguration("a user name", null);
epilog
    delete rwManager;
end;

startDesigner();
vars
    rwManager : JadeReportWriterManager;
begin
    create rwManager transient;
    rwManager.startReportWriterDesigner("a user name", null);
epilog
    delete rwManager;
end;

For full integration into the user system, use the same JadeReportWriterManager methods but with the first method parameter being the name of the currently signed-on user and the second method parameter being the subclass of JadeReportWriterSecurity in the user schema.

The JadeReportWriterManager class provides two methods, startReportWriterConfiguration and startReportWriterDesigner, to start the JADE Report Writer Configuration application and the JADE Report Writer Designer application, respectively.

The JADE Report Writer keeps a reference to the security object reference set when the setSecurityObject method of the JadeReportWriterManager class is called. The security object is used whenever the JADE Report Writer needs to check security access to something. This reference is held in the internal equivalent of the user app object, so needs to be valid for the life of the application.

Instead of deleting it after calling the report writer startReportWriterConfiguration or startReportWriterDesigner methods, it would be best to create it once and hold a reference in the user app object or equivalent, and reuse this instance so it stays valid. It can be deleted at the end of the application.

For details, see "Dynamically Configuring JADE Reports at Run Time" under "Run Time Considerations", in Chapter 6. For full details, see the JADE Encyclopaedia of Classes.

For details about configuring or designing reports, see Chapter 3 or Chapter 4, respectively.