Enabling your applications

This article explains how to copy or update SWING PDF Converter's design elements in a custom Notes application.

The design elements may be copied/updated automatically (using the Update action in your SWING PDF Converter database) or by replacing the design elements manually.

Once you've copied the required design elements into your application, you can invoke the PDF rendering functions using our Lotus Script API.

Automated design replacement

1. Download SWING PDF Converter (using the download link provided by SWING Software) and extract the PDFConverter.nsf file from the ZIP package to an appropriate location.

2. Open the PDFConverter.nsf file and activate the product using your product license key.

3. Click For Developers in the Administration menu and click Update:

4. In the pop-up which appears, locate and select the custom application which is being upgraded and click OK.

After that, the existing PDF Converter's design elements in the custom application will be replaced wit the new ones:

Select database

5. Finally, sign your database with Server ID (or other unrestricted ID).

NOTE: If your application runs on a server, then after copying the required design elements you will also need to start a conversion job once on the server (in order to extract required .jar files) and restart your server. The server-side conversion job can be executed by creating a scheduled agent on Domino server that runs the SWING PDF Converter API or by running the agent manually from Lotus Notes with the "agent.RunOnServer" LotusScript command.

Manual design replacement

1. Open your custom application in Domino Designer.

2. If you have previously installed PDF Converter in this application, delete all the design elements that are showing the "SWING Software", "SWING Software - HIDDEN", "SWING PDF Converter - HIDDEN" or "SWING PDF Converter" comments (see below image). Otherwise skip this step.

3. Open the SWING PDF Converter database in Domino Designer.

4. Copy all the design elements that are showing the "SWING Software", "SWING Software - HIDDEN", "SWING PDF Converter - HIDDEN" or "SWING PDF Converter" comments and paste them into your custom application.

5. Finally, sign your database with Server ID (or other unrestricted ID).

WARNING: Some SWING PDF Converter elements are provided in hidden design. It is not recommended to open them in Domino Designer (by double clicking them in order to show their code) since this action can corrupt the hidden code.

Note: If your application runs on a server, then after copying the required design elements you will also need to start a conversion job once on the server (in order to extract required .jar files) and restart your server. The server-side conversion job can be executed by creating a scheduled agent on Domino server that runs the SWING PDF Converter API or by running the agent manually from Lotus Notes with the "agent.RunOnServer" LotusScript command.