TIB Bwpluginpdf 6.2.2 Users Guide

TIBCO ActiveMatrix BusinessWorks™
Plug-in for PDF
User’s Guide
Software Release 6.2.2
October 2019
2
Important Information
SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH
EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR
PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE
EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY
OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.
USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND
CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED
SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE
CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD
OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE)
OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER
LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THE
SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND
YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE
BOUND BY THE SAME.
ANY SOFTWARE ITEM IDENTIFIED AS THIRD PARTY LIBRARY IS AVAILABLE UNDER
SEPARATE SOFTWARE LICENSE TERMS AND IS NOT PART OF A TIBCO PRODUCT. AS SUCH,
THESE SOFTWARE ITEMS ARE NOT COVERED BY THE TERMS OF YOUR AGREEMENT WITH
TIBCO, INCLUDING ANY TERMS CONCERNING SUPPORT, MAINTENANCE, WARRANTIES,
AND INDEMNITIES. DOWNLOAD AND USE OF THESE ITEMS IS SOLELY AT YOUR OWN
DISCRETION AND SUBJECT TO THE LICENSE TERMS APPLICABLE TO THEM. BY PROCEEDING
TO DOWNLOAD, INSTALL OR USE ANY OF THESE ITEMS, YOU ACKNOWLEDGE THE
FOREGOING DISTINCTIONS BETWEEN THESE ITEMS AND TIBCO PRODUCTS.
This document is subject to U.S. and international copyright laws and treaties. No part of this
document may be reproduced in any form without the written authorization of TIBCO Software Inc.
TIBCO, the TIBCO logo, the TIBCO O logo, ActiveMatrix BusinessWorks, Business Studio, TIBCO
Business Studio, and TIBCO ActiveMatrix BusinessWorks Plug-in for PDF are either registered
trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries.
Java and all Java based trademarks and logos are trademarks or registered trademarks of Oracle and/or
its affiliates.
All other product and company names and marks mentioned in this document are the property of their
respective owners and are mentioned for identification purposes only.
This software may be available on multiple operating systems. However, not all operating system
platforms for a specific software version are released at the same time. Please see the readme.txt file for
the availability of this software version on a specific operating system platform.
THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.
THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL
ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE
CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO
SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S)
AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME.
THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR
INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE,
INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.
This and other products of TIBCO Software Inc. may be covered by registered patents. Please refer to
TIBCO's Virtual Patent Marking document (https://www.tibco.com/patents) for details.
TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

3
Copyright © 2014-2019. TIBCO Software Inc. All Rights Reserved.

4
Contents
TIBCO Documentation and Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Creating a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Configuring a Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Testing a Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Deploying an Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
TIBCO Business Studio Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
PDF Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
PDFReader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
PDFWriter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Adding Watermarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Working with the Sample Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Importing the Sample Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Configuring Module Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Running the Sample Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Configurations of Sample Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
EncryptedReader.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Exception_IncorrectPDFPassword.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Exception_OutputMismatch.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
PDFEncryption.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
PDFMultibyte.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
PDFWriter.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Watermark.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
OutPutDirEmpty.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
OutPutDirInvalid.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Managing Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Log Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Setting Up Log Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Exporting Logs to a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

5
TIBCO Documentation and Support Services
How to Access TIBCO Documentation
Documentation for TIBCO products is available on the TIBCO Product Documentation website, mainly
in HTML and PDF formats.
The TIBCO Product Documentation website is updated frequently and is more current than any other
documentation included with the product. To access the latest documentation, visit https://
docs.tibco.com.
Product-Specific Documentation
Documentation for TIBCO ActiveMatrix BusinessWorks Plug-in for PDF is available on the TIBCO
ActiveMatrix BusinessWorks™ Plug-in for PDF Product Documentation page.
The following documents for this product can be found on the TIBCO Documentation site:
● TIBCO ActiveMatrix BusinessWorks Plug-in for PDF Installation

● TIBCO ActiveMatrix BusinessWorks Plug-in for PDF User’s Guide
● TIBCO ActiveMatrix BusinessWorks Plug-in for PDF Release Notes
How to Contact TIBCO Support
You can contact TIBCO Support in the following ways:
● For an overview of TIBCO Support, visit http://www.tibco.com/services/support.

● For accessing the Support Knowledge Base and getting personalized content about products you are
interested in, visit the TIBCO Support portal at https://support.tibco.com.
● For creating a Support case, you must have a valid maintenance or support contract with TIBCO.
You also need a user name and password to log in to https://support.tibco.com. If you do not have a
user name, you can request one by clicking Register on the website.
How to Join TIBCO Community
TIBCO Community is the official channel for TIBCO customers, partners, and employee subject matter
experts to share and access their collective experience. TIBCO Community offers access to Q&A forums,
product wikis, and best practices. It also offers access to extensions, adapters, solution accelerators, and
tools that extend and enable customers to gain full value from TIBCO products. In addition, users can
submit and vote on feature requests from within the TIBCO Ideas Portal. For a free registration, go to
https://community.tibco.com.

6
Product Overview
TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF provides the services of reading data from
editable fields of PDF files and writing data into editable fields of PDF files. In addition to encrypting,
disabling printing, and adding watermarks to PDF files, this plug-in also reduces your workload by
processing a batch of PDF files at one time.
The following figure shows how the plug-in works with the TIBCO products.
The following list describes each item and the relationship between them in the previous figure.
● Portable Document Format (PDF) is a file format used to present documents in a manner
independent of application software, hardware, and operating systems.
● TIBCO ActiveMatrix BusinessWorks Plug-in for PDF is plugged into TIBCO ActiveMatrix
BusinessWorks™ and is connected to PDF files.
● TIBCO ActiveMatrix BusinessWorks is an easy-to-use integration product suite for enterprise
applications.
● TIBCO Business Studio™ is the graphical user interface (GUI) used by TIBCO ActiveMatrix
BusinessWorks and the plug-in to design business processes, and the process engine used to execute
them.
®
● TIBCO Enterprise Administrator provides a centralized administrative interface to manage and
monitor the plug-in applications deployed in an enterprise.

7
Getting Started
This tutorial is designed for the beginners who want to use TIBCO ActiveMatrix BusinessWorks Plug-in
for PDF in TIBCO Business Studio.
All the operations are performed in TIBCO Business Studio. For information about TIBCO Business
Studio, see TIBCO Business Studio Overview.
A basic procedure of using TIBCO ActiveMatrix BusinessWorks Plug-in for PDF includes:
1. Creating a Project
2. Configuring a Process
3. Testing a Process
4. Deploying an Application
Creating a Project
The first task of using the plug-in is creating a project. After creating a project, you can add resources
and processes.
An Eclipse project is an application module configured for TIBCO ActiveMatrix BusinessWorks. An
application module is the smallest unit of resources that is named, versioned, and packaged as part of
an application.
Procedure
1. Start TIBCO Business Studio using one of the following ways:
● Microsoft Windows: click Start > All Programs > TIBCO > TIBCO_HOME > TIBCO Business
Studio version_number > Studio for Designers.
● Mac OS and Linux: run the TIBCO Business Studio executable file located in the TIBCO_HOME/
studio/version_number/eclipse directory.
2. From the menu, click File > New > BusinessWorks Resources to open the BusinessWorks Resource
wizard.
3. In the "Select a wizard" dialog, click BusinessWorks Application Module and click Next to open
the New BusinessWorks Application Module wizard.
4. In the Project dialog, configure the project that you want to create:
a) In the Project name field, enter a project name.
b) By default, the created project is located in the workspace currently in use. If you do not want to
use the default location for the project, clear the Use default location check box and click Browse
to select a new location.
c) Use the default version of the application module, or enter a new version in the Version field.
d) Keep the Create empty process and Create Application check boxes selected to automatically
create an empty process and an application when creating the project.
e) Select the Use Java configuration check box if you want to create a Java module.
A Java module provides the Java tooling capabilities.
f) Click Finish to create the project.
Result
The project with the specified settings is displayed in the Project Explorer view.

8
Configuring a Process
After creating a project, an empty process is created. You can add activities to the empty process to
complete a task. For example, write a PDF file.
Prerequisites
Ensure that you have created an empty process when Creating a Project.
Procedure
1. In the Project Explorer view, click the created project and open the empty process from the Process
folder.
2. Select activities from the palette library and drop them in the Process editor.
For example, select and drop the Timer activity from the General Activities palette, and the
PDFWriter activity from the PDF palette.
3. Click an activity in the Process editor and drag the icon to create a transition between the
activities.
4. Configure the added activities, as described in PDF Palette.

9
5. Click File > Save to save the process.
Testing a Process
After configuring a process, you can test the process to check whether the process completes your task.
Prerequisites
Ensure that you have configured a process, as described in Configuring a Process.
Procedure
1. On the toolbar, click Debug > Debug Configurations.

2. Click BusinessWorks Application > BWApplication in the left panel.
By default, all the applications in the current workspace are selected on the Applications tab.
Ensure that only the application you want to debug is selected on the Applications tab in the right
panel.
3. Optional: If you want to run a process containing the PDFWriter activity on the Mac OS platform,
click the Arguments tab, add the following property to the "VM arguments" panel and click Apply:
-Djava.awt.headless=true

10
4. Click Debug to test the process in the selected application.

TIBCO Business Studio changes to the Debug perspective. The debug information is displayed in
the Console view.
5. On the Debug tab, expand the debugged process and click an activity.
6. In the upper-right corner, click the Job Data tab, and then click the Output tab to check the activity
output.

11
Deploying an Application
After testing, if the configured process works as expected, you can deploy the application that contains
the configured process into a runtime environment, and then use the bwadmin utility to manage the
deployed application.
Prerequisites
Before deploying an application, you must generate an application archive, which is an enterprise
archive (EAR) file that is created in TIBCO Business Studio.
Deploying an application involves the following tasks:
1. Uploading an EAR file

2. Deploying an application
3. Starting an application
For more details on how to deploy an application, see TIBCO ActiveMatrix BusinessWorks Administration
guide.
Editing the Application Node
Before deploying the application that contains the PDFWriter activity on the Mac OS platform, you
must edit the application node in the TRA file:
1. Open the bwappnode-nodename.tra file, which is located in the TIBCO_HOME\bw\version_number

\domains\domain_name\appnodes\space_name\node_name\bin directory.
2. In the bwappnode-nodename.tra file, change #java.extended.properties=-Xmx1024m -

Xms128m-XX:PermSize=27m -XX:MaxPermSize=128m -XX:-HeapDumpOnOutOfMemoryError
into
java.extended.properties=-Xmx1024m -Xms128m -XX:PermSize=27m -XX:MaxPermSize=128m
-XX:-HeapDumpOnOutOfMemoryError -Djava.awt.headless=true.
3. Save the file and restart the current application node.
TIBCO Business Studio Overview

TIBCO Business Studio is an Eclipse-based integration development environment that is used to
design, develop, and test ActiveMatrix BusinessWorks applications.
TIBCO Business Studio provides a workbench in which you can create, manage, and navigate resources
in your workspace. A workspace is the central location on your machine where all data files are stored.

12
The workbench consists of the following elements:
1. Menu: contains menu items such as File, Edit, Diagram, Navigate, Search, Project, Run, Window,
and Help.
2. Toolbar: contains buttons for frequently used commands such as New , Save , Enable/
Disable Business Studio Capabilities , Create a new BusinessWorks Application Module ,
Create a new BusinessWorks Shared Module , Debug , Run , and so on.

3. Perspective: contains an initial set and layout of views that are required to perform a certain task.
TIBCO Business Studio launches the Modeling perspective by default. You can change the
perspective from the menu Window > Open Perspective > Perspective_Name.
4. View: displays resources. For example, the Project Explorer view displays the ActiveMatrix
BusinessWorks applications, modules, and other resources in your workspace, and the Properties
view displays the properties for the selected resource. You can open a view from the menu Window
> Show View > View_Name.
5. Editor: provides a canvas to configure, edit, or browse a resource. Double-click a resource in a view
to open the appropriate editor for the selected resource. For example, double-click an ActiveMatrix
BusinessWorks process (Process.bwp) in the Project Explorer view to open the process in the editor.
6. Palette: contains a set of widgets and a palette library. A palette groups activities that perform similar
tasks and provide quick access to activities when configuring a process.

13
PDF Palette
The PDF palette is added to TIBCO Business Studio after installing TIBCO ActiveMatrix BusinessWorks
Plug-in for PDF.
The PDF palette contains the following activities to read data from editable fields of PDF files and write
data into editable fields of PDF files:
● PDFReader
● PDFWriter
PDFReader
You can use the PDFReader activity to read data from editable fields of PDF files. This activity uses a
PDF file that is specified on the General tab to create an output schema. The input PDF file on the Input
tab is parsed and read by matching its own schema with the created schema displayed on the Output
tab.
General
The following table describes the fields on the General tab of the PDFReader activity.
Module
Field Property? Description
Name No (Required) The name of the activity displayed in the process.

The default value is PDFReader.
Input File No (Required) The input PDF template file that is used to
generate a template schema on the Output tab. Type a PDF
template file path with its name in your local system in this
field or click the Choose a resource icon to navigate to the

PDF template file.
When the input PDF template file is not read

because it cannot be decrypted, an error message is
displayed in the Input File Password field. Only if
the PDF template file cannot be read because it is
encrypted with an empty string, the error message
is displayed next to the Input File field.
Input File Yes (Optional) Type a correct password for the input PDF
Password template file if it is encrypted.
If the input PDF template file is not encrypted, leave

this field blank.
Use Process No (Optional) A check box that is used to allow acceptance of

Data binary data on the Input tab.
Description
On the Description tab, you can add a short description for the PDFReader activity.

14
Input
The input of the PDFReader activity depends on the configuration specified on the General tab. The
following table describes the input elements on the Input tab of the PDFReader activity.
Data
Input Item Type Description
inputPDFFilePath String Type the path and name of the input PDF file to be read in
double or single quotation marks, for example, "D:\PDF
\test.pdf".
The PDF file specified on the General tab and the

PDF file specified on the Input tab must have the
same structure. Otherwise, an error message is
displayed at run time. You can check the error
message in Console view or in the log file.
inputPDFFilePassword String Type a password for the PDF file to be read.
If the PDF file is encrypted, type the correct

password. If the PDF file is not encrypted, leave
this field blank.
processData Binary Get binary data on the Input tab when Use Process Data is
selected on the General tab.
Output
The Output tab contains the tibPdfRoot item.

The tibPdfRoot item is created according to the PDF template file, and the schema varies depending on
the PDF template file.
Fault
The following table describes the error schema elements on the Fault tab of the PDFReader activity.
Error Schema Element Data Type Description
msg String This error message is displayed when the PDF plug-
in captures an exception for the PDFReader activity.
msgCode String This error code is displayed when the PDF plug-in
captures an exception for the PDFReader activity.
PDFWriter
You can use the PDFWriter activity to write data into editable fields of input PDF files, and then
produce filled PDF files as the outputs. The data source of the input PDF files can come from any other
BusinessWorks activities.
General
The following table describes the fields on the General tab of the PDFWriter activity.

15
Module
Name No (Required) The name of the activity displayed in the process.

The default value is PDFWriter.
Input File No (Required) The input PDF template file that is used to generate
the input schema of the TIBCOROOT field on the Input tab.
Type the directory and the input PDF file name directly in the
field, or click the Choose a resource icon to navigate to the

PDF file.
When the input PDF template file is not read because

it cannot be decrypted, an error message is displayed
in the Input File Password field. Only if the PDF
template file cannot be read because it is encrypted
with an empty string, the error message is displayed
next to the Input File field.
Input File Yes (Optional) Type a correct password for the input PDF template
Password file if it is encrypted.
If the input PDF template file is not encrypted, leave

this field blank.
Output File Yes (Optional) The output PDF file directory in this activity. The
Directory generated PDF output file is installed in this directory if the
application runs successfully. Type the directory in this field, or
click the Choose a resource icon to navigate to the directory.
If you only type the output file directory, the

generated PDF file is appended with a universally
unique identifier (UUID). For example, if the input
PDF file is named test.pdf, and you only specify
this field, the generated PDF file is named as
test524623ad-dcda-4c5d-8eac-74dda7fe5452.pdf.
Output File Yes (Optional) Type a prefix for your output PDF file in this field.
Name Prefix When you use the prefix, UUID is appended to the prefix, and
the string is used in the output file name.
Is Output File No (Optional) Select this check box if you want to encrypt the
Encrypted output PDF file.
Use Process Data No (Optional) Select this check box to get the processed data on the
Output tab.
Description
On the Description tab, you can add a short description for the PDFWriter activity.

16
Advanced
The following table describes the fields on the Advanced tab of the PDFWriter activity.
Module
Restrict Printing No Select the Restrict Printing check box to disable printing of a
generated PDF file in any application that can read or edit PDF
files.
TTF File for No The path of the Arial Unicode MS.ttf file, which is used to
Watermark install multiple languages that might be used in a generated
PDF file. The Arial Unicode MS.ttf file is provided with the
sample project, which is located in the TIBCO_HOME\bw
\palettes\pdf\version\samples\Samplefiles
\MultibyteTTF directory.
Input
The input schema of the activity depends on the input PDF file specified on the General tab. The
following table describes the input elements on the Input tab of the PDFWriter activity.
Input Item Data Type Description
userPassword String This option is displayed only when the Is Output File
Encrypted check box is selected. Type the password used
to encrypt the output PDF file.
outputPDFFilePath String Type the path and name of the output PDF file in double or
single quotation marks for example, "D:\PDF\test.pdf".
Any data entered as value for the output PDF

file name with path in this field takes precedence
over any value for the Output File Directory
field and the Output File Name Prefix field. The
outputPDFFilePath is not displayed when Use
Process Data is selected on the General tab.
watermark N/A Two options are available for adding a watermark:

textContent and binaryContent.
● textContent
Used to add text watermarks.
● binaryContent
Used to add image watermarks.
For details on how to add watermarks, see Adding
Watermarks.
TIBCOROOT N/A All fields of a PDF file are listed. You can optionally specify
field values for a PDF file to be generated.

17
Output
The following table describes the output element on the Output tab of the PDFWriter activity.
Ouput Item Data Type Description
outputPDFFilePath String Displays the path and name of the generated output PDF
file.
processedData Binary It is displayed on the Output tab when Use Process Data is
selected on the General tab.
Fault
The following table describes the error schema elements on the Fault tab of the PDFWriter activity.
Error Schema Element Data Type Description
msg String This error message is displayed when the PDF plug-in
captures an exception for the PDFWriter activity.
msgCode String This error code is displayed when the PDF plug-in
captures an exception for the PDFWriter activity.
Adding Watermarks
You can add watermarks on PDF files.
Prerequisites
Ensure that the path of the Arial Unicode MS.ttf file is selected in the TTF File for Watermark field
of the Advanced tab.
Procedure
1. In the Data Source view, expand processContext and map ProcessInstanceId to textContent|
binaryContent under the watermark item. The Drop dialog is displayed.
2. In the Drop dialog, select textContent or binaryContent from the list. Click Finish.
3. Add content for the watermark:
● If you select textContent, type the text for the watermark in the textContent field. For example:
Confidential.
● If you select binaryContent, add a Read File activity in the process, transform the image as
binary, and then map the binaryContent in the Data Source view to the binaryContent field in
the watermark item.

18
Working with the Sample Project

Working through the sample project helps you understand how TIBCO ActiveMatrix BusinessWorks
Plug-in for PDF operates.
TIBCO ActiveMatrix BusinessWorks Plug-in for PDF is packaged with a sample project within the
installer. After installing the plug-in, you can find the sample project that is located in the
TIBCO_HOME\bw\palettes\pdf\version\samples directory.
Importing the Sample Project

Before running the project, you must import the project to TIBCO Business Studio.
Procedure
1. Start TIBCO Business Studio using one of the following ways:
● Microsoft Windows: click Start > All Programs > TIBCO > TIBCO_HOME > TIBCO Business
Studio version_number > Studio for Designers.
● Mac OS and Linux: run the TIBCO Business Studio executable file located in the TIBCO_HOME/
studio/version_number/eclipse directory.
2. From the menu, click File > Import.

3. In the Import window, expand the General folder and select the Existing Studio Projects into
Workspace item. Click Next.
4. Click Browse next to the Select archive file field to select the examples.zip file . Click Finish.
The examples.zip file is located in the TIBCO_HOME\bw\palettes\pdf\version\samples
directory.
Result
The sample project is imported to TIBCO Business Studio.

19
If you want to upgrade TIBCO ActiveMatrix BusinessWorks Plug-in for PDF from version 6.1 or earlier
to version 6.2, you must reimport the sample project.
What to do next
After importing the sample project, you must manually update the path in the Input File field of the
General tab for each PDF activity. Otherwise, the sample project is displayed with errors in TIBCO
Business Studio.
Configuring Module Properties

After importing the PDFExample sample project, configure module properties before running the
processes. Module properties are used to select directories when you configure the processes.
Procedure
1. In the Project Explorer view, expand the Module Descriptors resource, and double-click Module
Properties. The Module Properties panel is displayed.
2. In the Module Properties panel, expand the PDFExample folder, and configure the module
property values accordingly in the default column.
3. On the toolbar, click the Save icon to save your changes.

20
● After configuring module properties, you must manually select a PDF file in the Input
File field on the General tab by clicking the Choose a resource icon to navigate to
the location of the PDF file.
● You must modify the directory in the Reader.xml file in the following directory:
TIBCO_HOME\bw\palettes\pdf\version_number\samples\Samplefiles
\PdfReader.
Running the Sample Project

The sample project shows how to use the plug-in to read data from editable fields of PDF files and
write data into editable fields of PDF files, as well as how to deal with PDF plug-in exceptions.
Prerequisites
Ensure that you have imported the sample project to TIBCO Business Studio, as described in Importing
the Sample Project, and configured module properties, as described in Configuring Module Properties.
Procedure
1. In the Project Explorer view, expand the Module Descriptors resource, and double-click
Components. The Components panel is displayed.
2. In the Components panel, click the Create Process Component icon, and the Select a
BusinessWorks Process window is displayed.
If you want to delete a process in the Components panel, you can click the process and
then click the remove selected component icon to delete it.
3. In the Select a BusinessWorks Process window, select the process that you want to run. Click OK.
4. On the toolbar, click the Save icon to save your changes.

5. From the menu, click Run > Run Configurations, and the Run Configurations window opens.
6. In the Run Configurations window, expand BusinessWorks Application, and click BWApplication.
7. Ensure that only the sample application is selected on the Applications tab.
8. Click Run to run the selected process.
9. Click the Terminate icon to stop the process.
Configurations of Sample Processes

The sample project contains several processes. Each process has a different function.
After Importing the Sample Project, expand the Processes resource, and the eight processes are
displayed.

21
EncryptedReader.bwp
This process demonstrates how to use the plug-in to read a batch of encrypted PDF files by using the
While activity that is listed under Basic Activities in the palette library.
The process is designed with the following activities:
The following table lists the activities in the process.
Activity Description
Timer Starts the process.
ReadFile Reads XML files.
ParseXML Parses XML files.

22
PDFReader Reads a PDF template file and creates a template schema. Based on the PDF
template file and schema, the PDFReader activity parses and reads the input
PDF file on the Input tab.
While Creates sets of activities that participate in a transaction.
Before you run the EncryptedReader.bwp process, you must update the inputPDFFilePath paths in
the Reader.xml file with your actual paths. The Reader.xml file is located in the TIBCO_HOME\bw
\palettes\pdf\version\samples\Samplefiles\PdfReader directory.
Exception_IncorrectPDFPassword.bwp
This process demonstrates how the plug-in throws exceptions when the password for an encrypted
PDF file is incorrect.
PDFReader Reads a PDF template file and creates a template schema. Based on
the PDF template file and schema, the PDFReader activity parses and
reads the input PDF files on the Input tab.
Log Writes exceptions to a log file.
Throw Generates an error and causes an immediate transition to selected

error transition in the process.
Exception_OutputMismatch.bwp
This process demonstrates how the plug-in throws exceptions when the input file on the Input tab does
not match the input PDF file on the General tab.

23
the PDF template file and schema, the PDFReader activity parses
and reads the input PDF files on the Input tab.
Throw Generates an error and causes an immediate transition to selected

error transition in the process.
PDFEncryption.bwp
This process demonstrates how to write an encrypted PDF file by using the PDFWriter activity.
PDFWriter Writes data into the input PDF file.

24
PDFMultibyte.bwp
This process demonstrates how to enable the plug-in with the multibyte feature by loading the Arial
Unicode MS.ttf file. With the multibyte support, you can input multilanguage values to the input
schema and generate a PDF file with multilanguage text watermarks and fields.
PDFWriter Writes multibyte data into the input PDF file.
the PDF template file and schema, the PDFReader activity parses and
reads the input PDF files on the Input tab.
PDFWriter.bwp
This process demonstrates how to write different contents into a PDF file at the same time.
FilePoller Starts the process automatically when the input files are changed. It
supports batch processing files.
ParseXml Parses the input file and passes the result to the PDFWriter activity.

25
Watermark.bwp
This process demonstrates how to add watermarks to the PDF file.
FilePoller Starts the process automatically when input files are changed. It
supports batch processing files.
ParseXml Parses the input file and passes the validated file to the PDFWriter
activity.
ReadFile Reads the image file and passes the data content to the PDFWriter
activity.
OutPutDirEmpty.bwp
This process demonstrates how the plug-in performs when the output directory for the PDF file is
empty.

26
Throw Generates an error and causes an immediate transition to selected error

transition in the process.
OutPutDirInvalid.bwp
This process demonstrates how the plug-in performs when the output directory for the PDF file is
invalid.
Log Writes exceptions into a log file.
Throw Generates an error and causes an immediate transition to selected error

transition in the process.

27
Managing Logs
When an error occurs, you can check logs to trace and troubleshoot the plug-in exceptions.
By default, error logs are displayed in the Console view when you run a process in debug mode. You
can change the log level of the plug-in to trace different messages and export logs to a file. Different log
levels correspond to different messages, as described in Log Levels.
Log Levels
Different log levels include different information.
The plug-in supports the following log levels.
Log Level Description
Debug Indicates a developer-defined tracing message.
Info Indicates normal plug-in operations. No action is required. A tracing message

tagged with Info indicates that a significant processing step is reached, and
logged for tracking or auditing purposes. Only info messages preceding a
tracking identifier are considered as significant steps.
Warn Indicates that an abnormal condition occurred. Processing continues, but for
best practice, you can contact the administrator to investigate it.
Error Indicates that an unrecoverable error occurred. Depending on the severity of

the error, the plug-in might continue with the next operation or might stop.
Setting Up Log Levels

You can configure a different log level for the plug-in and plug-in activities to trace different messages.
By default, the plug-in uses the log level configured for TIBCO ActiveMatrix BusinessWorks. The
default log level of TIBCO ActiveMatrix BusinessWorks is Error.
Procedure
1. Navigate to the TIBCO_HOME\bw\version_number\config\design\logback directory and open

the logback.xml file.
2. Add the following node in the BusinessWorks Palette and Activity loggers area to specify a log
level for the plug-in:
<logger name="com.tibco.bw.palette.pdf.runtime">
<level value="DEBUG"/>
</logger>
The value of the level element can be Debug, Info, Warn, or Error.
If you set the log level to Debug, the input and output for the plug-in activities are also
displayed in the Console view. For more details regarding each log level, see Log Levels.
3. Optional: Add the following node in the BusinessWorks Palette and Activity loggers area to
specify a log level for an activity:
<logger name="com.tibco.bw.palette.pdf.runtime.ActivityNameActivity">
</logger>

28
For example, add the following node to set the log level of the PDFWriter activity to Debug:
<logger name="com.tibco.bw.palette.pdf.runtime.PDFWriterActivity">
</logger>
The activities that are not configured with specific log levels use the log level configured
for the plug-in.
4. Save the file.
Exporting Logs to a File

You can update the logback.xml file to export plug-in logs to a file.
Procedure
1. Navigate to the TIBCO_HOME\bw\version_number\config\design\logback directory and open

the logback.xml file.
After deploying an application in TIBCO Enterprise Administrator, navigate to the

TIBCO_HOME\bw\version_number\domains\domain_name\appnodes\space_name
\node_name directory to find the logback.xml file.
2. Add the following node to specify the file where the log is exported:
<appender name="FILE" class="ch.qos.logback.core.FileAppender">
<file>c:/bw6-pdf.log</file>
<encoder>
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36}-%msg%n</pattern>
</encoder>
</appender>
The value of the file element is the absolute path of the file that stores the exported log.
3. Add the following node to the root node at the bottom of the logback.xml file:
<root level="DEBUG">
<appender-ref ref="STDOUT"/>
<appender-ref ref="FILE"/>
</root>
4. Save the file.

29
Error Codes
The following table lists error codes, detailed explanation of error codes, and where applicable, ways to
solve different errors.
Error Code and Error

Message Role Category Description Resolution
TIBCO-BW-PALETTE- Debug BW-Plug- The This is a debug

PDF-220004 in inputPDFFilePassword message and
file on the Input tab. resolution is not
The
applicable.
inputPDFFilePassword
file in Input tab
is : {0}
TIBCO-BW-PALETTE- Debug BW-Plug- The password for input This is a debug

PDF-220005 in file to be read is message and
supplied from module resolution is not
The password for
properties or process applicable.
input file to be read
properties.
is supplied from a
Module Properties or
Process Properties
TIBCO-BW-PALETTE- Debug BW-Plug- Creating output schema This is a debug

PDF-220006 in for reader. message and
resolution is not
Creating output
applicable.
Schema for reader
TIBCO-BW-PALETTE- Debug BW-Plug- Output was This is a debug

PDF-220007 in successfully created for message and
the given input for this resolution is not
Output was
run. applicable.
successfully created
for the given input
for this run
TIBCO-BW-PALETTE- Debug BW-Plug- Start processing PDF This is a debug

PDF-220008 in Reader data. message and
resolution is not
Start processing PDF
applicable.
Reader data
TIBCO-BW-PALETTE- Debug BW-Plug- Text watermark which This is a debug

PDF-210004 in will be applied. message and
resolution is not
Text watermark which
applicable.
will be applied is :
{0}

30

TIBCO-BW-PALETTE- Debug BW-Plug- Image buffer This is a debug

PDF-210006 in watermark will be message and
applied. resolution is not
Image buffer
applicable.
watermark will be
applied
TIBCO-BW-PALETTE- Debug BW-Plug- The writer output the This is a debug

PDF-210007 in pdf file encryption. message and
resolution is not
The writer output pdf
applicable.
file encryption
TIBCO-BW-PALETTE- Debug BW-Plug- Saving the output PDF This is a debug

PDF-210008 in file. message and
resolution is not
Plugin work is done.
applicable.
Saving the output PDF
file
TIBCO-BW-PALETTE- Debug BW-Plug- Close the output PDF This is a debug

resolution is not
Close the output PDF
applicable.
file
TIBCO-BW-PALETTE- Debug BW-Plug- User has entered a This is a debug

PDF-210010 in value for output file message and
name prefix on the resolution is not
User has entered a
General tab. applicable.
value for output file
name prefix in
General tab
TIBCO-BW-PALETTE- Debug BW-Plug- User has chosen to This is a debug

PDF-210011 in enter the output file message and
name through the resolution is not
User has chosen to
Input tab. applicable.
enter the output file
name through the
Input tab for this
run
TIBCO-BW-PALETTE- Debug BW-Plug- Start processing the This is a debug

PDF-210012 in PDF Writer data. message and
resolution is not
Start processing PDF
applicable.
Writer data
TIBCO-BW-PALETTE- Debug BW-Plug- Output was This is a debug

PDF-210013 in successfully created for message and
the given input. resolution is not
Output was
applicable.
successfully created
for the given input
for this run

31

TIBCO-BW-PALETTE- Debug BW-Plug- Selected PDF file has an This is a debug

PDF-210014 in empty input schema. message and
Activity will generate a resolution is not
Selected PDF file has
new PDF file with the applicable.
an empty input
original PDF content.
schema. Activity will
generate a new PDF
file with the
original PDF content
TIBCO-BW-PALETTE- Info BW-Plug- Inputs the PDF File This is an info

PDF-320002 in entered on the General message and
tab. resolution is not
Input PDF File
applicable.
entered in General
tab is : {0}
TIBCO-BW-PALETTE- Info BW-Plug- Input file name with the This is an info
PDF-320003 in path. message and
resolution is not
Input File Name with
applicable.
path for this run is
{0}
TIBCO-BW-PALETTE- Info BW-Plug- Input file to be read is This is an info

PDF-320004 in password protected. message and
resolution is not
Input file to be read
applicable.
for this run is
password protected
TIBCO-BW-PALETTE- Info BW-Plug- Input PDF file entered This is an info

PDF-310002 in on the General tab. message and
resolution is not
Input PDF File
applicable.
entered in General
tab is : {0}
TIBCO-BW-PALETTE- Info BW-Plug- The output PDF file This is an info

PDF-310003 in directory as entered on message and
the General tab. resolution is not
The output PDF file
applicable.
directory as entered
in the General tab
is : {0}
TIBCO-BW-PALETTE- Info BW-Plug- The output PDF file This is an info

PDF-310004 in prefix as entered on the message and
General tab. resolution is not
The output PDF file
applicable.
prefix as entered in
the General tab is :
{0}

32

TIBCO-BW-PALETTE- Info BW-Plug- The output file to be This is an info

PDF-310005 in generated with the message and
path. resolution is not
Output file to be
applicable.
generated with path
is {0}
TIBCO-BW-PALETTE- Info BW-Plug- Restrict printing on the This is an info

PDF-310006 in output PDF file. message and
resolution is not
Should printing be
applicable.
restricted on the
output PDF file? {0}
TIBCO-BW-PALETTE- Info BW-Plug- Encrypt the output PDF This is an info

resolution is not
Should encrypting the
applicable.
output PDF file? {0}
TIBCO-BW-PALETTE- Info BW-Plug- Begin to create the root This is an info

PDF-310008 in element of PDF Writer message and
resolution is not
Begin to create the
applicable.
root element of PDF
Writer
TIBCO-BW-PALETTE- Info BW-Plug- Begins to create the This is an info

PDF-310009 in output node schema message and
resolution is not
Begin to create
applicable.
Output node schema
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the No action.

PDF-510003 in generated PDF file
cannot be closed.
Output PDF located at
{0} could not be
closed
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the Specify a valid

PDF-510006 in directory for the directory for the
generated PDF file is generated PDF file.
{0} is not a valid
invalid.
directory in this
file system
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the Specify a valid

PDF-510007 in specified extension for extension for the
the generated PDF file generated PDF file.
The entered output
is invalid.
file name {0}
extension is not a
valid pdf extension

33

TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the Enter an absolute

PDF-510008 in directory for the URL for the
generated PDF file is outputPDFFilePath
The directory for
not specified. field on the Input
output file has not
tab.
been specified
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when creating No action.

PDF-510009 in the output PDF file.
Error while creating
output file
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the PDF Ensure that PDF
PDF-510010 in file does not have crop pages have crop
boxes. boxes if the
PDF page's crop box
watermark is
found missing while
applied.
applying watermark.
If watermark needs to
be applied, page has
to be well formed
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when running No action.

PDF-510011 in the process which
involves the PDFWriter
Unknown Error : {0};
activity.
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the PDF Enter the PDF file
PDF-510012 in file name is not entered name with a proper
in the extension for the
No output file name
outputPDFFilePath absolute URL in the
has been specified
field on the Input tab. outputPDFFilePath
field on the Input
tab.
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the text Ensure that the text
PDF-510013 in string of the watermark string of the
is invalid. watermark is a
Error while adding
valid string to be
text watermark to
set.
output PDF
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the Ensure that the

PDF-510014 in configuration of the configuration of the
activity is set incorrect. activity is set
Error while reading
correctly.
or saving output PDF
file

34


PDF-510015 in variable value on the variable value on
Input tab is incorrect. the Input tab is
Error while saving
correct.
the output PDF file
after setting values

PDF-510017 in configuration for the configuration for
activity is incorrect. the activity is
Configuration Error:
correct.
One of the
configurations is
incorrect
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the Check the binary

PDF-510018 in watermark image fails content used as
to be read by the Read watermarks.
Error while adding
File activity.
buffer image
watermark to output
PDF
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the value Provide the correct
PDF-520003 in set in the path with a correct
inputPDFFilePath field file name for the
Problem loading
on the Input tab is not inputPDFFilePath
inputPDFFilePath for
found. field on the Input
this run located at:
{0} tab.
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the input Check whether the
PDF-520004 in PDF template file is input PDF template
opened in other places file is opened in
Problem closing input
or used by other other places or used
PDF template file
applications. by other
located at : {0}
applications.
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the Specify the

PDF-520005 in directory of the input directory for the
PDF template file is not input PDF template
Input PDF Path
specified on the file on the General
template is not
General tab. tab.
specified
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the Ensure that you are
PDF-520011 in password for using the correct
decrypting the password to
Error while
encrypted PDF file is decrypt the input
decrypting the
incorrect. PDF file.
encrypted PDF file
password read from
Module Properties or
Process Properties

35

TIBCO-BW-PALETTE- Error BW-Plug- Occurs when reading No action.

PDF-520012 in contents of the input
PDF file.
Error while reading
contents of input PDF
file {0}
TIBCO-BW-PALETTE- Error BW-Plug- Occurs when the input Provide a PDF file
PDF-520013 in PDF file to be read on without being
the Input tab is encrypted with an
The input PDF to read
encrypted with an empty string.
for this run {0} is
empty string.
encrypted with empty
string. Plugin is
unable to decrypt the
file because your
Java version does not
support this
operation

TIB Bwpluginpdf 6.2.2 Users Guide

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

TIB Bwpluginpdf 6.2.2 Users Guide

Uploaded by

Copyright:

Available Formats

TIBCO ActiveMatrix BusinessWorks™

Plug-in for PDF

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

Copyright © 2014-2019. TIBCO Software Inc. All Rights Reserved.

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

Working with the Sample Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

TIBCO Documentation and Support Services

How to Access TIBCO Documentation

● TIBCO ActiveMatrix BusinessWorks Plug-in for PDF Installation

How to Contact TIBCO Support

You can contact TIBCO Support in the following ways:

● For an overview of TIBCO Support, visit http://www.tibco.com/services/support.

How to Join TIBCO Community

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

1. Start TIBCO Business Studio using one of the following ways:

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

5. Click File > Save to save the process.

Ensure that you have configured a process, as described in Configuring a Process.

1. On the toolbar, click Debug > Debug Configurations.

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

4. Click Debug to test the process in the selected application.

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

1. Uploading an EAR file

Editing the Application Node

1. Open the bwappnode-nodename.tra file, which is located in the TIBCO_HOME\bw\version_number

2. In the bwappnode-nodename.tra file, change #java.extended.properties=-Xmx1024m -

3. Save the file and restart the current application node.

TIBCO Business Studio Overview

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

The workbench consists of the following elements:

Disable Business Studio Capabilities , Create a new BusinessWorks Application Module ,

Create a new BusinessWorks Shared Module , Debug , Run , and so on.

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

Name No (Required) The name of the activity displayed in the process.

field or click the Choose a resource icon to navigate to the

When the input PDF template file is not read

If the input PDF template file is not encrypted, leave

Use Process No (Optional) A check box that is used to allow acceptance of

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

The PDF file specified on the General tab and the

inputPDFFilePassword String Type a password for the PDF file to be read.

If the PDF file is encrypted, type the correct

The Output tab contains the tibPdfRoot item.

Error Schema Element Data Type Description

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

Name No (Required) The name of the activity displayed in the process.

field, or click the Choose a resource icon to navigate to the

When the input PDF template file is not read because

If the input PDF template file is not encrypted, leave

click the Choose a resource icon to navigate to the directory.

If you only type the output file directory, the

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

Input Item Data Type Description

Any data entered as value for the output PDF

watermark N/A Two options are available for adding a watermark:

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

Ouput Item Data Type Description

Error Schema Element Data Type Description

TIBCO ActiveMatrix BusinessWorks™ Plug-in for PDF User’s Guide

Working with the Sample Project

Importing the Sample Project