TIBCO ActiveMatrix BusinessWorks Plug-in for Microsoft ...

TIBCO ActiveMatrix BusinessWorks™

Plug-in for Microsoft ExcelUser's GuideSoftware Release 6.0June 2015

Two-Second Advantage®

Important Information

SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCHEMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY(OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THEEMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANYOTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.

USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS ANDCONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTEDSOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THECLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOADOR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE)OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USERLICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THESOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, ANDYOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BEBOUND BY THE SAME.

This document contains confidential information that is subject to U.S. and international copyright lawsand treaties. No part of this document may be reproduced in any form without the writtenauthorization of TIBCO Software Inc.

TIBCO, Two-Second Advantage, TIBCO ActiveMatrix BusinessWorks, TIBCO EnterpriseAdministrator, and TIBCO Business Studio are either registered trademarks or trademarks of TIBCOSoftware Inc. in the United States and/or other countries.

Enterprise Java Beans (EJB), Java Platform Enterprise Edition (Java EE), Java 2 Platform EnterpriseEdition (J2EE), and all Java-based trademarks and logos are trademarks or registered trademarks ofOracle Corporation in the U.S. and other countries.

All other product and company names and marks mentioned in this document are the property of theirrespective owners and are mentioned for identification purposes only.

THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOTALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASEDAT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWAREVERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM.

THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.

THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICALERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESECHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCOSOFTWARE 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 ORINDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE,INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.

Copyright © 2015 TIBCO Software Inc. ALL RIGHTS RESERVED.

TIBCO Software Inc. Confidential Information

2

TIBCO ActiveMatrix BusinessWorks™ Plug-in for Microsoft Excel User's Guide

Contents

TIBCO Documentation and Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

TIBCO Business Studio Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

Creating a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Configuring a Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Testing a Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Deploying an Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Excel Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

ExcelData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

Create_Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Delete_Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Create_Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Delete_Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23

Read_Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Update_Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Create_Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Delete_Sheets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Create_Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Delete_Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27

Read_Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Update_Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Fault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

ExcelMetaData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28

Get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Get . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30

Fault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30

Excel Custom XPath Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31

3


Using the Excel Custom XPath Function . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Working with the Sample Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Importing the Sample Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Configuring Module Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35

Running the Sample Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Configuration of Sample Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

CSVConvertToExcel.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

BatchingWriteExcel.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

CRUDExcelData.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

ReadExcelGroup.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41

ExcelFunction.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41

SetGetExcelMetaData.bwp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42

Managing Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Log Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Setting Up Log Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Exporting Logs to a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

4


TIBCO Documentation and Support Services

Documentation for this and other TIBCO products is available on the TIBCO Documentation site:

https://docs.tibco.com

Documentation on the TIBCO Documentation site is updated more frequently than any documentationthat might be included with the product. To ensure that you are accessing the latest available helptopics, please visit us at https://docs.tibco.com.

Product-Specific Documentation

Documentation for TIBCO products is not bundled with the software. Instead, it is available on theTIBCO Documentation site. To directly access documentation for this product, double-click thefollowing file:

TIBCO_HOME/release_notes/TIB_bwpluginexcel_version_docinfo.html

where TIBCO_HOME is the top-level directory in which TIBCO products are installed. On Windows,the default TIBCO_HOME is C:\Program Files\tibco. On UNIX systems, the default TIBCO_HOMEis /opt/tibco.

The following documents for this product can be found in the TIBCO Documentation Site:

● TIBCO ActiveMatrix BusinessWorks Plug-in for Microsoft Excel Installation● TIBCO ActiveMatrix BusinessWorks Plug-in for Microsoft Excel User’s Guide● TIBCO ActiveMatrix BusinessWorks Plug-in for Microsoft Excel Release Notes

How to Contact TIBCO Support

For comments or problems with this manual or the software it addresses, contact TIBCO Support:

● For an overview of TIBCO Support, and information about getting started with TIBCO Support,visit this site:

http://www.tibco.com/services/support

● If you already have a valid maintenance or support contract, visit this site:

https://support.tibco.com

Entry to this site requires a user name and password. If you do not have a user name, you canrequest one.

How to Join TIBCOmmunity

TIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts. It is aplace to share and access the collective experience of the TIBCO community. TIBCOmmunity offersforums, blogs, and access to a variety of resources. To register, go to:

https://www.tibcommunity.com

5




http://www.tibco.com/services/support

https://support.tibco.com

https://www.tibcommunity.com

Product Overview

TIBCO ActiveMatrix BusinessWorks™ Plug-in for Microsoft Excel provides the services of creating anddeleting rows and sheets, reading and updating cell values, formatting cells with specified rules orconditions, and also drawing charts in Excel files. In addition, with this plug-in you can set metadatafor Excel files and get metadata from Excel files.

The following lists describe each item and their relationships in the above figure.

● Excel files consist of worksheets on which you can use TIBCO ActiveMatrix BusinessWorks Plug-infor Microsoft Excel to perform some actions.

● TIBCO ActiveMatrix BusinessWorks Plug-in for Microsoft Excel is plugged into TIBCOActiveMatrix BusinessWorks™ and is connected to Excel files.

● TIBCO ActiveMatrix BusinessWorks is an easy-to-use integration product suite for enterpriseapplications.

● TIBCO Business Studio™ is the graphical user interface (GUI) used by TIBCO ActiveMatrixBusinessWorks and the plug-in to design business processes, and the process engine used to executethem.

● TIBCO Enterprise Administrator™ provides a centralized administrative interface to manage andmonitor the plug-in applications deployed in an enterprise.

6


Getting Started

This tutorial is designed for the beginners who want to use TIBCO ActiveMatrix BusinessWorks Plug-in for Microsoft Excel in TIBCO Business Studio.

All the operations are performed in TIBCO Business Studio. See TIBCO Business Studio Overview toget familiar with TIBCO Business Studio.

A basic procedure of using TIBCO ActiveMatrix BusinessWorks Plug-in for Microsoft Excel includes:

1. Creating a Project2. Configuring a Process3. Testing a Process4. Deploying an ApplicationBefore using the plug-in, convert your .xls files to .xlsx files.

TIBCO Business Studio OverviewTIBCO Business Studio is an Eclipse-based integration development environment that is used todesign, develop, and test ActiveMatrix BusinessWorks applications.

TIBCO Business Studio provides a workbench in which you can create, manage, and navigate resourcesin your workspace. A workspace is the central location on your machine where all data files are stored.

The workbench consists of:

● Menu: contains menu items such as File, Edit, Diagram, Navigate, Search, Project, Run, Window,and Help.

● 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.

7


● 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 theperspective from the menu Window > Open Perspective > Perspective_Name.

● View: displays resources. For example, the Project Explorer view displays the ActiveMatrixBusinessWorks applications, modules, and other resources in your workspace, and the Propertiesview displays the properties for the selected resource. You can open a view from the menu Window> Show View > View_Name.

● Editor: provides a canvas to configure, edit, or browse a resource. Double-click a resource in a viewto open the appropriate editor for the selected resource. For example, double-click an ActiveMatrixBusinessWorks process (MortgageAppConsumer.bwp) in the Project Explorer view to open theprocess in the editor.

● Palette: contains a set of widgets and a palette library. A palette groups activities that performsimilar tasks and provide quick access to activities when you configure a process.

Creating a ProjectThe first task using the plug-in is creating a project. After creating a project, you can add resources andprocesses.

An Eclipse project is an application module configured for TIBCO ActiveMatrix BusinessWorks. Anapplication module is the smallest unit of resources that is named, versioned, and packaged as part ofan application.

Procedure

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

● Microsoft Windows: click Start > All Programs > TIBCO > TIBCO_HOME > TIBCO BusinessStudio 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 ResourceWizard.

3. In the "Select a wizard" dialog, click BusinessWorks Application Module and click Next to openthe 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 Browseto 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 ProcessAfter creating a project, an empty process is created. You can add activities to the empty process tocomplete a task, such as creating sheets.

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 theProcesses folder.

2. Select activities from the Palette view and drop them in the Process editor.For example, select and drop the Timer activity from the General Activities palette, and theExcelData activity from the Excel palette.

9


3. Click an activity in the Process editor and drag the icon to create a transition between theadded activities.

4. Configure the added Excel activities, as described in Excel Palette.

5. Click File > Save to save the process.

Testing a ProcessAfter configuring a process, you can test the process to check if the process completes your task.

Prerequisites

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

Procedure

1. Open the process you have configured in TIBCO Business Studio.

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

3. Click BusinessWorks Application > BWApplication in the left panel.By default, all the applications in the current workspace are selected in the Applications tab. Ensurethat only the application you want to debug is selected in the Applications tab in the right panel.

4. Click Debug to test the process in the selected application.TIBCO Business Studio changes to the Debug perspective. The debug information is displayed inthe Console view.

5. In the Debug tab, expand the debugged process and click an activity, such as the ExcelData activity.

6. In the upper-right panel, click Job Data view, and then click the Output tab to check the activityoutput.

10


Deploying an ApplicationAfter testing, if the configured process works as expected, you can deploy the application that containsthe configured process into a runtime environment, and then use the bwadmin utility to manage thedeployed application.

Before deploying an application, you must generate an application archive, which is an enterprisearchive (EAR) file that is created in TIBCO Business Studio.

Deploying an application involves the following tasks:

1. Uploading an application archive

2. Deploying an application archive

3. Starting an application

See TIBCO ActiveMatrix BusinessWorks Administration for more details on how to deploy an application.

● Before running the application that contains the ExcelData activity and is deployed in the Mac OSplatform, you have to complete the following steps: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

intojava.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.

● Before running the application that contains the XPath functions, complete the following steps: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

intojava.extended.properties=-Xmx1024m -Xms128m -XX:PermSize=27m -

XX:MaxPermSize=128m -XX:-HeapDumpOnOutOfMemoryError -

Djavax.xml.parsers.SAXParserFactory=com.sun.org.apache.xerces.internal.jaxp.SA

XParserFactoryImpl.

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

11


Excel Palette

A palette groups the activities that connect the same external applications together. The Excel palette isadded to TIBCO Business Studio after installing TIBCO ActiveMatrix BusinessWorks Plug-in forMicrosoft Excel.

The Excel palette contains the following activities which can be used to create and delete rows andsheets, read and update cell values, format cells with specified rules and conditions, and also drawcharts in Excel files. Besides, with these activities you can get metadata from Excel files and setmetadata for Excel files.

● ExcelData● ExcelMetaData

ExcelDataYou can use the ExcelData activity to create and delete rows and sheets, and also read and update cellvalues in Excel files. Besides, you can use the ExcelData activity to set attributes for cells, format cellswith specified rules or conditions, and draw charts in Excel files.

GeneralIn the General tab, you can select different actions to complete different tasks.

The following table describes the items in the General tab of the ExcelData activity.

Item Description

Name The name of the activity displayed in the process. The defaultvalue is ExcelData.

Actions The actions you can choose from:

● Create_Sheets● Delete_Sheets● Create_Rows● Delete_Rows● Read_Rows● Update_Rows

Modes Two modes you can choose from:

● Basic

You can use Basic mode to complete basic functions of theExcelData activity.

● Advanced

You can use Advanced mode to complete basic and advancedfunctions of the ExcelData activity.

Available only when the Create_Rows, Read_Rows, orUpdate_Rows action is selected.

12


Item Description

Create New File Select this check box if you want to create a new Excel file.Available only when the Create_Sheets, or Create_Rows action isselected.

Choose Output Directory Choose the output directory for the newly created Excel file by

clicking the Choose a resource icon. Available only when theCreate New File check box is selected.

Output File Name Prefix Enter a prefix name for the output Excel file. Available only whenthe Create New File check box is selected.

DescriptionIn the Description tab, you can add a short description for the ExcelData activity.

InputThe input varies depending on the actions you select in the General tab.

Check the input for the activity for the following actions:


Create_Sheets

When Create_Sheets is selected in the General tab, the input for the activity is as follows.

Input Item Data Type Description

FilePath string Enter the absolute path for the Excel file with quotation marks,where the newly created sheets are added.

SheetName string Enter a name for the sheet with quotation marks. This elementsupports duplication.

● You can create multiple SheetNames by hoveringyour cursor over the SheetName and right-clickingto select Duplicate from the pop-up menu.

● Ensure that the name for each sheet is different.Otherwise, only one sheet is created.

● Ensure that the maximum length for the sheet nameis no more than 31 characters, which is limited byMicrosoft Excel itself.

13


Delete_Sheets

When Delete_Sheets is selected in the General tab, the input for the activity is as follows.


FilePath string Enter the absolute path for the Excel file withquotation marks, where one or multiple sheets aredeleted.

Sheet None This node supports duplication.

If you want to delete multiple sheets froman Excel file, you can duplicate the Sheetnode by hovering your cursor over theSheet node and right-clicking to selectDuplicate from the pop-up menu.

SheetName|SheetPointer None Select SheetName or SheetPointer to delete a sheetfrom the Excel file.

Before selecting SheetName orSheetPointer, complete the followingsteps:1. Drag SheetName|SheetPointer under

the Sheet node in the XPath Expressionview to the Data Source view. The Dropwindow opens.

2. In the Drop window, select SheetNameor SheetPointer from the list. ClickFinish.

SheetName string Enter the name of the sheet to be deleted withquotation marks.

Ensure that the maximum length for thesheet name is no more than 31 characters,which is limited by Microsoft Excel itself.

SheetPointer positiveinteger

Enter the index number of the sheet to be deleted.

Create_Rows

When Create_Rows is selected in the General tab, the input for the activity is as follows.

Input ItemDataType Mode Description

FilePath string Basic andAdvanced

Enter the absolute path for the Excel file withquotation marks, where the newly created rowsare added.

14



SheetName string Basic andAdvanced

Enter the name of the sheet with quotation marks,where the newly created rows are added.

Ensure that the maximum length for thesheet name is no more than 31characters, which is limited byMicrosoft Excel itself.

StartingRowPointer positiveinteger

Advanced Enter the starting row index number, where onerow or multiple rows start to be created.

Row None Basic andAdvanced

This node supports duplication.

If you want to create multiple rows inan Excel file, you can duplicate the Rownode by hovering your cursor over theRow node and right-clicking to selectDuplicate from the pop-up menu.

Cells None Basic andAdvanced

Set attributes for one or multiple cells under thisnode. This node supports duplication.

If you want to set attributes for multiplecells, you can hover your cursor overthe Cells node and right-click to selectDuplicate from the pop-up menu toduplicate the Cells node.

Value string Basic andAdvanced

Enter a value for the cell with quotation marks.

IsFormulaCell boolean Basic andAdvanced

Enter true() into this field if the cell containsExcel formula. Otherwise, enter false() into thisfield or leave this field blank.

TagName string Basic andAdvanced

Enter a tag name for the cell with quotation marks.This tag name can be used for further operations,such as drawing charts or setting conditionalformatting rules.

CellComments None Advanced Set attributes for cell comments under this node.

Value string Advanced Enter a value for the cell comment with quotationmarks.

FontStyle None Advanced Set font style for cell comments under this node.

15



FontName string Advanced Enter a font name for the cell comment withquotation marks.

The font name entered in this field mustbe supported by the Excel file.

StandardColor|RGBValues

None Advanced Select StandardColor or RGBValues for cellcomments.

Before selecting StandardColor orRGBValues, complete the followingsteps:1. Drag SheetName|SheetPointer

under the Sheet node in the XPathExpression view to the Data Sourceview. The Drop window opens.

2. In the Drop window, selectStandardColor or RGBValues fromthe list. Click Finish.

StandardColor string Advanced Enter the name of the color with quotation marks,such as "GREEN". Select a standard color from thefollowing list:

● BLACK● BLUE● GRAY● GREEN● ORANGE● PINK● RED● WHITE● YELLOW

The name of the color entered in thisfield must be supported by the Excelfile.

RGBValues None Advanced Enter RGB values under this node. In the Red,Green and Blue elements, enter a valuerespectively, which must be an integer within therange of 0 - 255.

FontSize positiveinteger

Advanced Enter a value for the font size of the cell comment.

16



Bold boolean Advanced Enter true() into this field if the cell commentmust be in bold. Otherwise, enter false() intothis field or leave this field blank.

Italic boolean Advanced Enter true() into this field if the cell commentmust be in italic. Otherwise, enter false() intothis field or leave this field blank.

StrikeThrough boolean Advanced Enter true() into this field if the cell commentmust be struck through. Otherwise, enter false()into this field or leave this field blank.

Underline string Advanced Enter an underline type with quotation marks,such as "U_SINGLE". Select an underline type fromthe following list:

● U_DOUBLE● U_DOUBLEACCOUNTING● U_NONE● U_SINGLE● U_SINGLEACCOUNTING

The underline type entered in this fieldmust be supported by the Excel file.

CellStyle None Advanced Set attributes for cell style under this node. Referto attributes setting in the fields under theCellComments node.

Alignment string Advanced Enter an alignment type with quotation marks,such as "ALIGN_LEFT". Select an alignment typefrom the following list:

● ALIGN_CENTER● ALIGN_CENTER_SELECTION● ALIGN_FILL● ALIGN_GENERAL● ALIGN_JUSTIFY● ALIGN_LEFT● ALIGN_RIGHT

The alignment type entered in this fieldmust be supported by the Excel file.

BackgroundColor None Advanced Set background color for cells under this node.

17



FillPattern string Advanced Enter a fill pattern type with quotation marks,such as "FINE_DOTS". Select a fill pattern typefrom the following list:

● BIG_SPOTS● BRICKS● DIAMONDS● FINE_DOTS● NO_FILL● SOLID_FOREGROUND● SPARSE_DOTS● SQUARES● THICK_BACKWARD_DIAG● THICK_FORWARD_DIAG● THICK_HORZ_BANDS● THICK_VERT_BANDS● THIN_BACKWARD_DIAG● THIN_FORWARD_DIAG● THIN_HORZ_BANDS● THIN_VERT_BANDS

The fill pattern type entered in this fieldmust be supported by the Excel file.

WrapText boolean Advanced Enter true() into this field if the cell value mustbe text wrapped. Otherwise, enter false() intothis field or leave this field blank.

Chart None Advanced This node supports duplication.

If you want to create multiple charts inan Excel file, you can duplicate theChart node by hovering your cursorover the Chart node and right-clickingto select Duplicate from the pop-upmenu.

ChartLocation None Advanced Specify the location for the chart under this node.

FirstCellColumn positiveinteger

Advanced Enter a numeral that indicates the column locationfor the first cell which the chart is drawn upon.

FirstCellRow positiveinteger

Advanced Enter a numeral that indicates the row location forthe first cell which the chart is drawn upon.

18



SecondCellColumn positiveinteger

Advanced Enter a numeral that indicates the column locationfor the second cell which the chart is drawn upon.

SecondCellRow positiveinteger

Advanced Enter a numeral that indicates the row location forthe second cell which the chart is drawn upon.

ChartDataSource -CellRangeAddress

None Advanced Specify the start and end cell addresses of therequired data for drawing the chart under thisnode.

● The horizontal axis is plotted by thecell values in the first column of therequired data area.

● The cell values in the first row of therequired data area serve as thelegend names, which are displayedin the legend area of the chart.

● If each cell in the selected data areais filled with a value, the first cellvalue is not taken when drawing achart.

StartTag string Advanced Enter the start tag name of the required datasource for drawing the chart, or enter the start celladdress of the required data source for drawingthe chart with quotation marks, such as "A1".

EndTag string Advanced Enter the end tag name of the required data sourcefor drawing the chart, or enter the end cell addressof the required data source for drawing the chartwith quotation marks, such as "D5".

Conditional -FormattingRules

None Advanced Set conditional formatting rules for cells underthis node. This node supports duplication.

If you want to set conditionalformatting rules for cells in multipleareas in an Excel file, you can duplicatethe ConditionalFormattingRulesnode by hovering your cursor over theConditionalFormattingRules nodeand right-clicking to select Duplicatefrom the pop-up menu.

Condition None Advanced Set conditions for cells which are applied withconditional formatting rules under this node.

19



Comparator string Advanced Enter a comparator value with quotation marks,such as "LT" which means less than. Select acomparator type from the following list:

● BETWEEN● EQUAL● GE● GT● LE● LT● NO_COMPARISON● NOT_BETWEEN● NOT_EQUAL

The comparator value entered in thisfield decides the values in the Operand1and Operand2 elements.

Operand1 string Advanced Enter a proper operand value in this field.

Operand2 string Advanced Enter a proper operand value in this field.

FontFormat None Advanced Set font format for the cells within the specifiedcell range under this node.

Italic boolean Advanced Enter true() into this field if the cell commentmust be in italic. Otherwise, enter false() intothis field.

Bold boolean Advanced Enter true() into this field if the cell commentmust be in bold. Otherwise, enter false() intothis field.

20



StandardColor string Advanced Enter the name of the color with quotation marks,such as "GREEN". Select a standard color from thefollowing list:



Underline string Advanced Enter an underline type with quotation marks,such as "U_SINGLE". Select an underline type fromthe following list:

● U_DOUBLE● U_NONE● U_SINGLE

The underline type entered in this fieldmust be supported by the Excel file.

PatternFormat None Advanced Set pattern format for the cells within the specifiedcell range under this node.

21



BackgroundColor string Advanced Enter the name of the color with quotation marks,such as "GREEN". Select a background color fromthe following list:



FillPattern string Advanced Enter a fill pattern type with quotation marks,such as "FINE_DOTS".

● BIG_SPOTS● BRICKS● DIAMONDS● FINE_DOTS● SOLID_FOREGROUND● SPARSE_DOTS● SQUARES● THICK_BACKWARD_DIAG● THICK_FORWARD_DIAG● THICK_HORZ_BANDS● THICK_VERT_BANDS● THIN_BACKWARD_DIAG● THIN_FORWARD_DIAG● THIN_HORZ_BANDS● THIN_VERT_BANDS

The fill pattern type entered in this fieldmust be supported by the Excel file.

22



CellRange None Advanced Set the cell range that the conditional formattingrules applies to. This node supports duplication.

If you want to set conditionalformatting rules in multiple areas in anExcel sheet, you can duplicate theCellRange node by hovering yourcursor over the CellRange node andright-clicking to select Duplicate fromthe pop-up menu.

StartTag string Advanced Enter the start tag name for the specified cellrange, or enter the start cell address for thespecified cell range with quotation marks, such as"A1".

EndTag string Advanced Enter the end tag name for the specified cell range,or enter the end cell address for the specified cellrange with quotation marks, such as "D5".

Delete_Rows

When Delete_Rows is selected in the General tab, the input for the activity is as follows.


FilePath string Enter the absolute path for the Excel file withquotation marks, where the specified rows in a sheetare deleted.

SheetName|SheetPointer None Select SheetName or SheetPointer to delete rows inthe Excel file.

Before selecting SheetName orSheetPointer, complete the followingsteps:1. Drag SheetName|SheetPointer under

the Sheet node in the XPath Expressionview to the Data Source view. The Dropwindow opens.

2. In the Drop window, select SheetNameor SheetPointer from the list. ClickFinish.

SheetName string Enter the name of the sheet with quotation marks,where the rows are deleted.

Ensure that the maximum length for thesheet name is no more than 31 characters,which is limited by Microsoft Excel itself.

23




Enter the index number of the sheet, where the rowsare deleted.

StartingRowPointerToDelete positiveinteger

Specify the starting row pointer, where the rows startto be deleted.

The value entered in this field must begreater than zero.

EndingRowPointerToDelete integer Specify the ending row pointer, where the rows stopto be deleted.

If the value in this field is -1, rows aredeleted from the specified starting row tothe last row in the sheet.

Read_Rows

When Read_Rows is selected in the General tab, the input for the activity is as follows.

Input Item Data Type Mode Description


Enter the absolute path for the Excel filewith quotation marks, where the cellvalues in specified rows are read.

SheetName|SheetPointer

None Basic andAdvanced

Select SheetName or SheetPointer toread the cell values in specified rows inthe Excel file.

Before selecting SheetName orSheetPointer, complete thefollowing steps:1. Drag SheetName|

SheetPointer under theSheet node in the XPathExpression view to the DataSource view. The Dropwindow opens.

2. In the Drop window, selectSheetName orSheetPointer from the list.Click Finish.

24




Enter the name of the sheet withquotation marks, where the rows areread.

Ensure that the maximumlength for the sheet name is nomore than 31 characters, whichis limited by Microsoft Excelitself.


Basic andAdvanced

Enter the index number of the sheet,where the rows are read.

StartingRowPointer positiveinteger

Advanced Specify the starting row pointer, wherethe rows start to be read.

RowChunkSizeToRead positiveinteger

Advanced Specify the amount of rows to be read.

Update_Rows

When Update_Rows is selected in the General tab, the input for the activity is as follows.



Enter the absolute path for the Excel file withquotation marks, where the values in one ormultiple cells are updated.


Enter the name of the sheet with quotationmarks.

Ensure that the maximum length forthe sheet name is no more than 31characters, which is limited byMicrosoft Excel itself.

Row None Basic andAdvanced

This node supports duplication.

If you want to update the cell valuesin multiple rows in an Excel file,you can duplicate the Row node byhovering your cursor over the Rownode and right-clicking to selectDuplicate from the pop-up menu.

RowToUpdate positiveinteger

Basic andAdvanced

Specify the row number, where the cell valuein the row is updated.

25



Cells None Basic andAdvanced

Set attributes for a cell under this node. Thisnode supports duplication.

If you want to set attributes formultiple cells, you can hover yourcursor over the Cells node andright-click to select Duplicate fromthe pop-up menu to duplicate theCells node.

ColumnToUpdate positiveinteger

Basic andAdvanced

Specify the column number, where the cellvalue in the column is updated.

Value string Basic andAdvanced

Enter a value for the cell to be updated withquotation marks.

IsFormulaCell boolean Basic andAdvanced

Enter true() into this field if the cell containsExcel formula. Otherwise, enter false() intothis field or leave this field blank.

TagName string Basic andAdvanced

Enter a tag name for the cell with quotationmarks.

CellComments None Advanced Set attributes for cell comments under thisnode. See the table in Create_Rows Action fordetails.

CellStyle None Advanced Set attributes for cell style under this node. Seethe table in Create_Rows Action for details.

OutputThe output varies depending on the actions you select in the General tab.

Check the output for the activity for the following actions:


Create_Sheets

When Create_Sheets is selected in the General tab, the output for the activity is as follows.

The following elements are displayed in the Output tab:

● FilePath

● TotalSheetsCreated

● SheetName

26


Delete_Sheets

When Delete_Sheets is selected in the General tab, the output for the activity is as follows.


● FilePath

● TotalSheetsDeleted

● SheetName

Create_Rows

When Create_Rows is selected in the General tab, the output for the activity is as follows.


● FilePath

● TotalRowsCreated

Delete_Rows

When Delete_Rows is selected in the General tab, the output for the activity is as follows.


● FilePath

● TotalRowsDeleted

Read_Rows

When Read_Rows is selected in the General tab, the output for the activity is as follows.


● FilePath

● SheetName

● Value

● IsFormulaCell

● CellComments

● CellStyle

● TotalCellsReadInRow

● NextRowPointer

● TotalRowsInSheet

● NextSheetPointer

● TotalSheetsInFile

Update_Rows

When Update_Rows is selected in the General tab, the output for the activity is as follows.


● FilePath

27


● TotalRowsUpdated

FaultThe following table describes the exception in the Fault tab of the ExcelData activity.

Exception Info Description

ExcelActivityException msg Displays the error message.

msgCode Displays the error code.

ExcelMetaDataYou can use the ExcelMetaData activity to set metadata into Excel files or get metadata from Excel files.This activity contains two actions which you can select to complete different tasks.

GeneralIn the General tab, you can select the Get or Set action to complete a task.

The following table describes the items in the General tab of the ExcelMetaData activity.

Item Description

Name The name of the activity displayed in the process. The default name isExcelMetaData.

Actions Two actions you can select from:

● Set

You can use the Set action to set metadata for Excel files.● Get

You can use the Get action to get metadata from Excel files.

DescriptionIn the Description tab, you can add a short description for the ExcelMetaData activity.

InputThe input varies depending on the actions you select in the General tab.

Check the input for the activity for the following actions:

● Get● Set

28


Get

When Get is selected in the General tab, the input for the activity is as follows.


FilePath string Enter the absolute path for the Excel file with quotationmarks, where the metadata of the Excel file is extracted.

Set

When Get is selected in the General tab, the input for the activity is as follows.


FilePath string Enter the absolute path for the Excel file with quotationmarks, where the metadata of the Excel file is set.

WorkbookDetails None A list of attribute fields for the Excel file is provided whereyou can set values.

categories string Set the category for the Excel file with quotation marks.

status string Set the status for the Excel file with quotation marks.

author string Set the author for the Excel file with quotation marks.

comments string Set the comment for the Excel file with quotation marks.

revision integer Set the revision number for the Excel file.

subject string Set the subject for the Excel file with quotation marks.

title string Set the title for the Excel file with quotation marks.

tags string Set the tag for the Excel file with quotation marks.

company string Set the company for the Excel file with quotation marks.

manager string Set the manager for the Excel file with quotation marks.

OutputThe output varies depending on the actions you select in the General tab.

Check the output for the activity for the following actions:

● Get● Set

Get

When Get is selected in the General tab, the output for the activity is as follows.


29


● sheetName

● noOfRows

● noOfColumns

● categories

● status

● created

● author

● comments

● lastModified

● lastModifiedBy

● revision

● subject

● title

● tags

● company

● manager

● template

Set

When Set is selected in the General tab, the output for the activity is as follows.

The Result element is displayed in the Output tab.

FaultThe following table describes the exception in the Fault tab of the ExcelMetaData activity.

Exception Info Description

ExcelActivityException msg Displays the error message.

msgCode Displays the error code.

30


Excel Custom XPath Function

The Excel Custom XPath function is designed to help users complete most functions of the ExcelDataand the ExcelMetaData activities in a simplified way.

The following table describes the items in the Excel Custom XPath function.

Item Description

d_cloneSheetBySheetName Clones a sheet based on the sheet name.

d_cloneSheetBySheetPointer Clones a sheet based on the sheet pointer.

d_createSheets Creates sheets for an Excel file.

d_deleteRowsBySheetName Deletes rows based on the sheet name.

d_deleteRowsBySheetPointer Deletes rows based on the sheet pointer.

d_deleteSheetBySheetName Deletes a sheet based on the sheet name.

d_deleteSheetBySheetPointer Deletes a sheet based on the sheet pointer.

d_deleteSingleRowBySheetName Deletes a single row based on the sheet name.

d_deleteSingleRowBySheetPointer Deletes a single row based on the sheet pointer.

d_searchCellCommentBySheetName Searches a cell comment in an Excel sheet based on thesheet name.

d_searchCellCommentBySheetPointer Searches a cell comment in an Excel sheet based on thesheet pointer.

d_searchCellValueBySheetName Searches a cell value in an Excel sheet by the sheet name.

d_searchCellValueBySheetPointer Searches a cell value in an Excel sheet by the sheetpointer.

md_getAuthor Gets the author of an Excel file.

md_getCategories Gets the category of an Excel file.

md_getComments Gets the comments of an Excel file.

md_getCompany Gets the company of an Excel file.

md_getCreatedDate Gets the created date of an Excel file.

md_getLastModifiedBy Gets information about who last modified the Excel file.

md_getLastModifiedDate Gets the last modified date of an Excel file.

md_getManager Gets the manager of an Excel file.

31


Item Description

md_getRevision Gets the revision number of an Excel file.

md_getStatus Gets the status of an Excel file.

md_getSubject Gets the subject of an Excel file.

md_getTags Gets the tags of an Excel file.

md_getTemplate Gets the template of an Excel file.

md_getTitle Gets the title of an Excel file.

md_setAuthor Sets the author for an Excel file.

md_setCategories Sets the category for an Excel file.

md_setComments Sets comments for an Excel file.

md_setCompany Sets the company for an Excel file.

md_setManager Sets the manager for an Excel file.

md_setRevision Sets the revision number for an Excel file.

md_setStatus Sets the status for an Excel file.

md_setSubject Sets the subject for an Excel file.

md_setTags Sets tags for an Excel file.

md_setTitle Sets the title for an Excel file.

Items with initial d in the Excel Functions folder indicate corresponding functions in the ExcelDataactivity. Items with initial md in the Excel Functions folder indicate corresponding functions in theExcelMetaData activity.

Using the Excel Custom XPath FunctionYou can use the Excel Custom XPath function instead of the ExcelData and the ExcelMetaData activitiesto complete the same tasks, without having to create a separate process each time.

The Excel Custom XPath function can work with any activities in the Palette view. For example, if youwant to delete a sheet by the sheet name of the Excel file, just select the Timer activity and anotheractivity and drag them to the Process editor. Then you can debug the process by completing thefollowing steps:

Procedure

1. Open a process if you have created one, or create a new project if you have not.See Creating a Project or Configuring a Process for details.

2. Select the Timer activity and another activity, such as the Log activity, from Palette Library anddrag them to the Process editor.

32


3. Click the Log activity in the Process editor, and then click Functions view in the Input tab.A list of folders is displayed.

4. Expand the Excel Functions folder, left-click the d_deleteSheetBySheetName item and drag it to themessage element in the XPath Expression view.

5. Configure the parameters in the message element.

6. Debug the configured process.See Testing a Process for details.

If you want to complete other functions of the ExcelData and the ExcelMetaData activities,repeat Step 4, Step 5, and Step 6.

33


Working with the Sample Project

Working through the sample project helps you understand how TIBCO ActiveMatrix BusinessWorksPlug-in for Microsoft Excel operates.

TIBCO ActiveMatrix BusinessWorks Plug-in for Microsoft Excel is packaged with a sample projectwithin the installer. After installing the plug-in, you can find the sample project which is located in theTIBCO_HOME\bw\palettes\excel\version\samples directory.

Importing the Sample ProjectBefore 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 BusinessStudio 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 intoWorkspace item. Click Next.

4. Click Browse next to the Select archive file field to select the example.zip file. Click Finish.The example.zip file is located in the TIBCO_HOME\bw\palettes\excel\version\samplesdirectory.

Result

The sample project is imported to TIBCO Business Studio.

34


Configuring Module PropertiesAfter importing the example.zip file, 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 Module Descriptors resource, and then double-click ModuleProperties.

2. In the Module Properties panel, expand the ExcelExample folder, and configure the moduleproperty values accordingly in the default column.In Windows system, by default, do not change the directories. Otherwise, change the directoriesinto your own.

35


3. On the toolbar, click the Save icon to save your changes.

In the Module Properties panel, change the TIBCO_HOME into your own.

Running the Sample ProjectThe sample project shows how to use the plug-in to convert CSV files to Excel files, read values from orwrite values into Excel files in batches, set metadata for or get metadata from Excel files, and how touse Excel functions.

Prerequisites

Ensure that you have imported the sample project to TIBCO Business Studio, as described in Importingthe 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 then double-clickComponents.

2. By default, all the processes are listed in the Components editor. Select the process that you do not

want to run and click the remove selected component icon.

3. On the toolbar, click the Save icon to save your changes.

4. From the menu, click Run > Run Configurations to run the selected process.

5. In the Run Configuration dialog, expand BusinessWorks Application, and then clickBWApplication.

6. In the right panel, click the Applications tab, and select the check box next toExcelExample.application.

7. Click Run to run the selected process.

8. Click the Terminate icon to stop the process.

36


Configuration of Sample ProcessesThe sample project contains six processes. Each process has a different function.

After Importing the Sample Project, expand the Processes resource. All the six processes are displayed.

CSVConvertToExcel.bwpThis process demonstrates how to use the plug-in to convert a CSV file into an Excel file.

The process is designed with the following activities:

37


The following table describes the activities in the process.

Activity Description

Timer Starts the process.

JavaInvokeConvertCSVToString Converts a CSV file to string.

ParseStringToXML Parses string to XML data format.

CreateExcelFromCSV Creates an Excel file based on the data parsed in the CSVfile.

CVSConvertToExcelLog Records exceptions for the plug-in when you run theprocess.

CVSConvertToExcelThrow Throws an error when the error is recorded by theCVSConvertToExcelLog activity.

BatchingWriteExcel.bwpThis process demonstrates how to use the plug-in to write values into multiple Excel files.


38




FilePoller Triggers the process.

Parse XML Parses the specified string as XML format using the specifiedschema.

ExcelData Writes the parsed XML data into Excel files.

BatchingWriteExcelLog Records exceptions for the plug-in when you run the process.

BatchingWriteExcelThrow Throws an error when the error is recorded by theBatchingWriteExcelLog activity.

CRUDExcelData.bwpThis process demonstrates how to use the plug-in to complete all functions of the ExcelData activity.


39





CreateSheets Creates sheets for the Excel file.

CreateRows_Basic Creates rows for the Excel file to complete the basic functions of theplug-in in creating rows.

CreateRows_Advance Creates rows for the Excel file, including conditional formatting anddrawing charts, to complete the advanced functions of the plug-in increating rows.

ReadRows_Basic Reads cell values in rows from the Excel file to complete the basicfunctions of the plug-in in reading rows.

ReadRows_Advance Reads cell values in rows from the Excel file to complete the advancedfunctions of the plug-in in reading rows.

UpdateRows_Basic Updates cell values in rows from the Excel file to complete the basicfunctions of the plug-in in updating rows.

UpdateRows_Advance Updates cell values in rows from the Excel file to complete theadvanced functions of the plug-in in updating rows.

DeleteRows Deletes rows from the Excel file.

DeleteSheets Deletes sheets from the Excel file.

Log_ExcelData Records exceptions for the plug-in when you run the process.

40



Throw_ExcelData Throws an error when the error is recorded by the Log_ExcelDataactivity.

ReadExcelGroup.bwpThis process demonstrates how to use the plug-in to read values from a batch of Excel files.





Read File Reads the specified XML file as string format.

Parse XML Parses the specified string as XML format using thespecified schema.

ExcelData Reads values from a batch of Excel files.

ReadExcelGroupLog Records exceptions for the plug-in when you run theprocess.

ReadExcelGroupThrow Throws an error when the error is recorded by theReadExcelGroupLog activity.

ExcelFunction.bwpThis process demonstrates how to use the functions of the plug-in.


41





Function_CloneSheet Clones a sheet for the Excel file.

Function_DeleteSheet Deletes a sheet from the Excel file.

Function_GetTitle Gets the title from the Excel file and then writes the titleinto a txt file.

Function_PutTitle Sets the title for the Excel file.

ReadFile Reads values from the txt file and gets the originaltitle.

RevertTitle Reverts the title for the Excel file.

SetGetExcelMetaData.bwpThis process demonstrates how to use the plug-in to get metadata from or set metadata for an Excel file.


42





Read File Reads the specified XML file as string format.

Parse XML Parses the specified string as XML format using thespecified schema.

ExcelMetaDataSet Sets metadata for the Excel file.

ExcelMetaDataGet Gets metadata from the Excel file.

SetGetExcelMetaDataLog Records exceptions for the plug-in when you run theprocess.

SetGetExcelMetaDataThrow Throws an error when the error is recorded by theSetGetExcelMetaDataLog activity.

43


Managing Logs

When an error occurs, you can check logs to trace and troubleshoot the plug-in exception.

By default, error logs are displayed in the Console view when you run a process in the 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 LevelsDifferent 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 messagetagged with Info indicates that a significant processing step is reached, andlogged for tracking or auditing purposes. Only info messages preceding atracking identifier are considered as significant steps.

Error Indicates that an unrecoverable error occurred. Depending on the severity ofthe error, the plug-in might continue with the next operation or might stop.

Setting Up Log LevelsYou can configure different log levels 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. Thedefault log level of TIBCO ActiveMatrix BusinessWorks is Error.

Procedure

1. Navigate to the TIBCO_HOME\bw\version_number\config\design\logback directory and openthe logback.xml file.

2. Add the following node in the BusinessWorks Palette and Activity loggers area to specify a loglevel for the plug-in:<logger name="com.tibco.bw.palette.excel.runtime"> <level value="DEBUG"/></logger>

The value of the level element can be Debug, Info, or Error.

If you set the log level to Debug, the input and output for the plug-in activities are alsodisplayed in the Console view. See Log Levels for more details regarding each log level.

3. Optional: add the following node in the BusinessWorks Palette and Activity loggers area to controla log level for the activity:

● For example, to control the debug log level for the ExcelData activity, set the followingparameters:<logger name="com.tibco.bw.palette.excel.runtime.ExcelDataSynchronousActivity"> <level value="DEBUG"/></logger>

44


● For example, to control the debug log level for the ExcelMetadata activity, set the followingparameters:<logger name="com.tibco.bw.palette.excel.runtime.WorkbookMetaDataSynchronousActivity"> <level value="DEBUG"/></logger>

The activities that are not configured with specific log levels use the log level configuredfor the plug-in.

4. Save the file.

Exporting Logs to a FileYou can update the logback.xml file to export plug-in logs to a file.

Procedure

1. In Windows system, navigate to the TIBCO_HOME\bw\version_number\config\design\logbackdirectory and open the logback.xml file.

After deploying an application in TIBCO Enterprise Administrator, navigate to theTIBCO_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-excel.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.

45


Error Codes

The exceptions that are thrown by the plug-in are listed with their corresponding descriptions andsolutions.

Error Code and ErrorMessage Role Category Description Solutions

TIBCO-BW-PALETTE-EXCEL-210001

\nStart of the

Activity {0} +

\nInput received:\n

{1} \n

debug BW-Plug-in Occurs when the plug-in activities start to runin a process.

None.


\nActivity {0}

Output data:\n {1}

\n Exit of Activity

{2}

debug BW-Plug-in Occurs when the plug-in activities finishperforming a logic in aprocess.

None.


\nExcel File {0}

opened for

operation [{1}] in

activity [{2}]

debug BW-Plug-in Occurs when the plug-in activities open anExcel file by using oneof their actions.

None.


\nChanges to excel

file {0} is saved

and the file is

closed for

operation [{1}] in

activity [{2}]

debug BW-Plug-in Occurs when the plug-in activities have madesome changes to anExcel file and thechanges have beensaved in the Excel file.

None.


\nInput file not

found:{0} for

operation {1} in

activity {2}

debug BW-Plug-in Occurs when thespecified Excel file isnot found.

None.

46




\nNew excel file

created at location

{0} for operation

{1} in activity {2}

debug BW-Plug-in Occurs when the plug-in activity is used tocreate a new Excel filein a specified directory.

None.


\nFormula for cell

located at column

{0} of row {1} in

sheet {2} will be

set as {3}

debug BW-Plug-in Occurs when you fill aformula in a cell in anExcel sheet.

None.


\nA row already

exists at the

starting row number

{0} of sheet {1}.

Shifting down the

existing row to

create a new row at

row number {2}

debug BW-Plug-in Occurs when youcreate a new row in aspecified row number,where a row has beenexisted, and the existedrow moves down.

None.


\nNo sheets present

in file and user

has not given any

sheet names to add.

Creating default

sheet with name {0}

for operation {1}

in activity {2}

debug BW-Plug-in Occurs when youcreate a sheet withoutspecifying its name,and a default name isgiven to the sheet.

None.


\nTotal sheets

created in file {0}

for operation {1}

in activity {2} is

{3}

debug BW-Plug-in Occurs when theCreate_Rows action inthe ExcelData activitycompletes an operation.

None.

47




\nDeleted sheet {0}

from file {1}

debug BW-Plug-in Occurs when theDelete_Sheets action inthe ExcelData activity isselected to delete sheetsfrom an Excel file.

None.


\nTotal number of

sheets deleted from

file {0} is {1}

debug BW-Plug-in Occurs when the resultof the deleted sheetsfrom an Excel file iscollected.

None.


\nA new sheet {0}

has been created in

excel file {1}

debug BW-Plug-in Occurs when thespecified sheet is notpresent in the Excel file,and the specified sheetmust be created beforecreating rows.

None.


\nA new row has

been created at row

number {0} of sheet

{1} in excel file

{2}

debug BW-Plug-in Occurs when a newrow has been created inan Excel file.

None.


\nNo starting row

is specified. Will

create a new row in

the next available

empty row {0} in

the sheet {1} of

excel file {2}

debug BW-Plug-in Occurs when youcreate a new rowwithout specifying therow number, and therow is created from thelast row in the specifiedsheet.

None.


\nRow {0} of sheet

{1} in file {2} has

been deleted

debug BW-Plug-in Occurs when a row hasbeen deleted from anExcel file.

None.


\nTotally {0} rows

deleted from sheet

{1} of file {2}

debug BW-Plug-in Occurs when the resultof the rows deleted bythe ExcelData activityhas been collected.

None.

48




\nTotal cells read

in row {0} of sheet

{1} is {2}

debug BW-Plug-in Occurs when the resultof the cells read by theExcelData activity hasbeen collected.

None.


\nNext row number

to read in sheet

{0} of file {1} is

{2}

debug BW-Plug-in Occurs when thecurrent row has beenread and the next rowis to be read.

None.


\nNext sheet number

to read in file {0}

is {1}

debug BW-Plug-in Occurs when thespecified sheet is read,the information of thenext sheet is providedto the followingactivity.

None.


Retrieved Meta Data

value for {0} is

{1} for file: {2}

operation [{3}] in

activity [{4}]

debug BW-Plug-in Occurs when theExcelMetadata activityis used to get metadatafrom an Excel file.

None.


Activity Name:{0},

Operation Name:

{1};-- Exception

occurred while

open/locked excel

file at {2}, close/

unlock it and

perform the action

error BW-Plug-in Occurs when the plug-in is used to performsome operations on anExcel file that isopened.

Close the openedExcel file.


Activity Name:{0},

Operation Name:

{1};-- Workbook

could not be

retrieved for file

{2}

error BW-Plug-in Occurs when aworkbook object in anExcel file fails to beretrieved, which mightbe caused by the Excelfile being damaged orabnormal.

Enter the correctdirectory for thevalid Excel file inthe FilePathelement in theInput tab.

49




Activity Name:{0},

Operation Name:

{1};-- Input file:

{2}not found

error BW-Plug-in Occurs when the inputExcel file is not presentin the specifieddirectory.

Provide a validExcel file that ispresent in thespecifieddirectory.


Activity Name:{0},

Operation Name:

{1};-- No such

sheet in workbook

file {2} for given

sheet {3} {4}

error BW-Plug-in Occurs when a givensheet is not present inthe Excel file.

Ensure that thegiven sheet in theExcel file ispresent.


Activity Name:{0},

Operation Name:

{1};-- No such

directory {2} is

present in the file

system while

creating new file

error BW-Plug-in Occurs when the inputdirectory is not presentin the file system.

Provide adirectory whichis present in thefile system.


Activity Name:{0},

Operation Name:

{1};-- Invalid file

extension in user

input data {2}

error BW-Plug-in Occurs when theformat of the inputExcel file is incorrect.

Provide a correctformat for theinput Excel file.At present, onlythe .xlsx formatis supported.


Activity Name:{0},

Operation Name:

{1};--

StartingRowPointer

should be greater

than 0

error BW-Plug-in Occurs when the valuein theStartingRowPointer

element in the Inputtab is equal to or lessthan zero.

Ensure that thevalue in theStartingRowPoi

nter element inthe Input tab isgreater than zero.

50




Activity Name:{0},

Operation Name:

{1};-- No such row

{2} is present in

sheet {3} for file

{4}

error BW-Plug-in Occurs when the plug-in is used for carryingout operations, such asreading cell valuesfrom a row which is notpresent in the Excel file.

Ensure that therow whereoperations arecarried out ispresent in theExcel file.


Activity Name:{0},

Operation Name:

{1};-- No such cell

{2} is present in

row {3} in sheet

{4} for file {5}

error BW-Plug-in Occurs when the plug-in is used for carryingout operations, such asreading cell valuesfrom a column which isnot present in the Excelfile.

Ensure that thecolumn whereoperations arecarried out ispresent in theExcel file.


Activity Name:{0},

Operation Name:

{1};-- The tag name

{2} for cell in Row

{3}: Column {4} is

duplicated in sheet

{5} for file {6}

error BW-Plug-in Occurs in the process ofcreating and updatingrows when the sametag name is entered indifferent TagNameelements underdifferent Cell nodes inthe Input tab.

Ensure that thetag name is notused more thanonce.


Activity Name:{0},

Operation Name:

{1};-- Input file

could not be

created:{2}

error BW-Plug-in Occurs when the inputfile path is incorrectand the input filecannot be created.

Ensure that thecorrect file pathis entered.


Activity Name:{0},

Operation Name:

{1} ;-- Starting

Sheet Pointer

cannot be less than

zero or empty

error BW-Plug-in Occurs when the valueentered in theStartingSheetPointe

r element is less than orequal to zero.

Ensure that thevalue entered intheStartingSheetP

ointer elementis greater thanzero.

51




Activity Name:{0},

Operation Name:

{1};-- Error while

plotting X-Axis in

sheet {2} for file

{3}

error BW-Plug-in Occurs in the process ofdrawing a chart whenone or multiple cells ina column of the givenrange required fordrawing the chart arenot present.

Ensure that eachcell in the givenrange requiredfor drawing thechart is filledwith anappropriatevalue.


Activity Name:{0},

Operation Name:

{1};-- Unexpected

error occurred

while plotting

chart in sheet {2}

for file {3}

error BW-Plug-in Occurs when the plug-in fails to draw a plotchart in the Excel filebecause the Excel filemight be damaged orabnormal.

Provide a validExcel file.


Activity Name:{0},

Operation Name:

{1};-- Cell Address

for X Axis cannot

be less than zero

for sheet {2} for

file {3}

error BW-Plug-in Occurs in the process ofdrawing a chart whenthe value of the givencell column is less thanzero.

Ensure that thevalue of the cellcolumn is equalto or greater thanzero.


Activity Name:{0},

Operation Name:

{1};-- Error while

retrieving core

properties of file

{2}

error BW-Plug-in Occurs when the ExcelMetaData activity failsto get CorePropertiesfrom the Excel filebecause the Excel file isdamaged or abnormal.



Activity Name:{0},

Operation Name:

{1};-- Error while

retrieving extended

properties of file

{2}

error BW-Plug-in Occurs when the ExcelMetaData activity failsto getExtendedPropertiesfrom the Excel filebecause the Excel file isdamaged or abnormal.


52




Activity Name:{0},

Operation Name:

{1};-- The value is

not conformity with

the rule in

specified formula

"{2}" in sheet {3}

for file {4}

error BW-Plug-in Occurs when the valuein the cell which usesformula does notconform to formularules.

Ensure that thevalue in the cellconforms toformula rules.


Activity Name:{0},

Operation Name:

{1};-- The font

name "{2}" that is

specified is

invalid in current

system

error BW-Plug-in Occurs when the fontname entered is notsupported by thecurrent system.

Enter a font namethat is supportedby your currentsystem.


Activity Name:{0},

Operation Name:

{1};-- Excel file

name is absent in

user input data

error BW-Plug-in Occurs when the inputExcel file is not presentin the specifieddirectory.

Provide an Excelfile that is presentin the specifieddirectory.


Activity Name:{0},

Operation Name:

{1};-- No Rows

found in sheet {2}

for file {3}

error BW-Plug-in Occurs when the givenparameters for a row inthe Input tab cannot beused for locating thecorresponding row inthe Excel file.

Ensure that theparameters forthe row can beused for locatingthe row in theExcel file.


Activity Name:{0},

Operation Name:

{1};--No sheet

input for file {2}

error BW-Plug-in Occurs in the process ofreading values fromrows in an Excel filewhen the sheet name isempty.

Enter a validsheet name.

53




ERROR occurs when

rename the file {0}

to {1}

error BW-Plug-in Occurs in the process ofcreating or updatingrows when the plug-infails to rename theExcel file which isoccupied by anotherapplication.

Ensure that theExcel file is notoccupied byanotherapplication.


Activity Name: {0},

Operation Name:

{1} ;--Excel File

Name in input

schema is null or

empty

error BW-Plug-in Occurs in the process ofusing the plug-in tocreate rows or sheets,set metadata for or getmetadata from an Excelfile when the file pathin the Input tab is notspecified or empty.

Specify a validfile path in theInput tab.


Activity Name:{0},

Operation Name:

{1};-- Directory to

create output excel

file has not been

specified

error BW-Plug-in Occurs in the process ofcreating sheets whenthe Create New Filecheck box is selected,but the Choose OutputDirectory field is notspecified and theFilePath element inthe Input tab is notentered with a value.

Ensure that theChoose OutputDirectory field isspecified whenthe Create NewFile check box isselected but theFilePath

element in theInput tab is notentered with afile path.


Activity Name:{0},

Operation Name:

{1};-- Sheet by

Name {2} already

exists in file {3},

sheet names must be

unique

error BW-Plug-in Occurs in the process ofcreating sheets whenthe sheet name isalready present in theExcel file.

Enter a sheetname that is notpresent in theExcel file whencreating a sheet.


Activity Name:{0},

Operation Name:

{1};--Invalid

sheetName:{2}is in

user input data

error BW-Plug-in Occurs in the process ofcreating sheets whenthe sheet name enteredin the SheetNameelement is invalid.

Ensure that thesheet nameentered in theSheetName

element is valid.

54




Activity Name:

{0},Operation Name:

{1};-- Unexpected

error while

deleting sheets in

workbook file {2}.

Aborting delete

sheets activity.

error BW-Plug-in Occurs in the process ofdeleting sheets whenthe plug-in fails toretrieve a sheet fromthe Excel file becausethe sheet has beendeleted and replacedby another sheet in theExcel file.

None.


Activity Name:

{0},Operation Name:

{1};--Cannot delete

sheets because

total sheets

entered to delete

[{2}] equals total

number of sheets in

excel file {3}

error BW-Plug-in Occurs in the process ofdeleting all sheetswhen not all the sheetsare deleted from theExcel file.

Ensure that atleast one sheet isleft in an Excelfile whendeleting sheets.


Activity Name:

{0},Operation Name:

{1};-- Cannot

delete any sheet

from excel file {2}

because the file

has only one sheet.

error BW-Plug-in Occurs in the process ofdeleting sheets whenthe Excel file has onlyone sheet left.

Ensure the Excelfile has morethan one sheetwhen deletingsheets.


Activity Name:

{0},Operation Name:

{1};-- Sheet

pointer to delete a

sheet cannot be

zero or lesser.

Value can be

ranging from 1 to

total number of

sheets in excel

file {2}

error BW-Plug-in Occurs in the process ofdeleting sheets basedon sheet pointer whenthe value in theSheetPointer elementis less than or equal tozero.

Ensure that thevalue in theSheetPointer

element is withinthe range of sheetnumber of theExcel file.

55




Activity Name:

{0},Operation Name:

{1};-- Sheet

pointer to delete

cannot be more than

the total sheets in

workbook. Value can

be ranging from 1

to total number of

sheets in excel

file {2}

error BW-Plug-in Occurs in the process ofdeleting sheets basedon sheet pointer whenthe value in theSheetPointer elementis greater than the totalsheet number in theExcel file.

Ensure that thevalue in theSheetPointer

element is withinthe range of sheetnumber of theExcel file.


Activity Name:

{0},Operation Name:

{1};-- Input sheet

name could not be

created:{2}

error BW-Plug-in Occurs in the process ofcreating rows when theplug-in fails to create asheet because the sheetname is illegal or theExcel file is damaged.

Enter a validExcel file with avalid sheet name.


Activity Name:

{0},Operation Name:

{1};--

EndRowPointer

should be greater

than 0

error BW-Plug-in Occurs in the process ofdeleting rows when thevalue in theEndingRowPointerToD

elete element is lessthan zero.

Ensure that thevalue in theEndingRowPoint

erToDelete

element is greaterthan zero.


Activity Name:

{0},Operation Name:

{1};-- Start Row

pointer cannot be

greater than end

Row pointer for

sheet: {2}

error BW-Plug-in Occurs in the process ofdeleting rows when thevalue in theStartingRowPointerT

oDelete element isgreater than the valuein theEndingRowPointerToD

elete element.

Ensure that thevalue in theStartingRowPoi

nterToDelete

element is equalto or less than thevalue in theEndingRowPoint

erToDelete

element.

56




Activity Name:

{0},Operation Name:

{1};-- Entered

sheet pointer {2}

is more than total

sheets in workbook.

Value can be

ranging from 1 to

total number of

sheets in excel

file {3}

error BW-Plug-in Occurs in the process ofreading or deletingrows when the value ofthe sheet pointer isgreater than the totalsheet number in theExcel file.

Ensure that thevalue of the sheetpointer is equalto or less than thetotal sheetnumber in theExcel file.


Activity Name:

{0},Operation Name:

{1};--

RowChunckSizeToRead

should be greater

than 0

error BW-Plug-in Occurs in the process ofreading cell valuesfrom rows when thevalue in theRowChunckSizeToRead

element in the Inputtab is equal to or lessthan zero.

Ensure that thevalue in theRowChunckSizeT

oRead element inthe Input tab isgreater than zero.

57


Date post:	15-Oct-2021
Category:	Documents
Upload:	others
View:	8 times
Download:	0 times

TIBCO ActiveMatrix BusinessWorks Plug-in for Microsoft ...

Documents