TIBCO ActiveMatrix BusinessWorks Migration

TIBCO ActiveMatrix BusinessWorks™

Migration Software Release 6.5.0 August 2018

Document Updated: October 2018, November 2018.

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 (ORPROVIDE 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.

ANY SOFTWARE ITEM IDENTIFIED AS THIRD PARTY LIBRARY IS AVAILABLE UNDERSEPARATE 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 WITHTIBCO, INCLUDING ANY TERMS CONCERNING SUPPORT, MAINTENANCE, WARRANTIES,AND INDEMNITIES. DOWNLOAD AND USE OF THESE ITEMS IS SOLELY AT YOUR OWNDISCRETION AND SUBJECT TO THE LICENSE TERMS APPLICABLE TO THEM. BY PROCEEDINGTO DOWNLOAD, INSTALL OR USE ANY OF THESE ITEMS, YOU ACKNOWLEDGE THEFOREGOING DISTINCTIONS BETWEEN THESE ITEMS AND TIBCO PRODUCTS.

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, TIBCO ActiveMatrix BusinessWorks, TIBCO Rendezvous, TIBCO Enterprise Message Service,TIBCO Business Studio, TIBCO Enterprise Administrator, TIBCO ActiveSpaces, TIBCO Runtime Agent,TIBCO Designer, and Two-Second Advantage 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, EITHER EXPRESSOR 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.

2

TIBCO ActiveMatrix BusinessWorks™ Migration

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 © 2001-2018. TIBCO Software Inc. All Rights Reserved.

3


Contents

Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

TIBCO Documentation and Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

ActiveMatrix BusinessWorks 5.x and TIBCO ActiveMatrix BusinessWorks™ 6.x Type Columns Legend . .11

Standard Constructs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

TIBCO ActiveMatrix BusinessWorks™ Core Constructs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Transitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Timer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

Mapper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

TIBCO ActiveMatrix BusinessWorks™ Palettes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

General Activities Shared Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

General Activities Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

ActiveEnterprise Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Adapter Resources Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

BPEL Extension Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

File Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

FTP Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

HTTP Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36

JAVA Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

JDBC Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40

JMS Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Mail Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Parse Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43

Policy Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43

Process Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Rendezvous Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

REST and JSON Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

RMI Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Service Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

SOAP Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

TCP Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55

Transaction Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

XML Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Migration Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

4


Migrating TIBCO ActiveMatrix BusinessWorks™ 5.x projects to ActiveMatrix BusinessWorks™ 6.x . . . . . . . . . . . . . . . . . . . . . .59

Migrating Projects Using TIBCO Business Studio™ for BusinessWorks™ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Migrating Projects Using Command line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Command line Configuration File Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64

Post-Migration Manual Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

HTTP Basic Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Custom XPath Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Migrating Design Time Libraries ( DTL) as Shared Modules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68

Using the Quick Fix Option to Resolve XSLT out of Sync Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71

Migration Process Outline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

5


Figures

ActiveMatrix BusinessWorks Project Migration Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

ActiveMatrix BusinessWorks 5.x Migrated Project - Before and After . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

6


TIBCO Documentation and Support Services

How to Access TIBCO Documentation

Documentation for TIBCO products is available on the TIBCO Product Documentation website, mainlyin HTML and PDF formats.

The TIBCO Product Documentation website is updated frequently and is more current than any otherdocumentation included with the product. To access the latest documentation, visit 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_BW_version_docinfo.html

Access the following TIBCO ActiveMatrix BusinessWorks™ guides on the TIBCO Documentation site:

● Concepts

● Installation

● Getting Started

● Application Development

● Administration

● Bindings and Palettes Reference

● Business Works Samples

● Error Codes

● Migration

● Performance Benchmarking and Tuning

● API Reference

● REST Reference Guide

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 areinterested 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 auser 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 matterexperts 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, andtools that extend and enable customers to gain full value from TIBCO products. In addition, users can

7


https://docs.tibco.com

https://docs.tibco.com

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

https://support.tibco.com

https://support.tibco.com

submit and vote on feature requests from within the TIBCO Ideas Portal. For a free registration, go to https://community.tibco.com.

8


https://ideas.tibco.com/

https://community.tibco.com

Introduction

TIBCO ActiveMatrix BusinessWorks™ 6.x architecture provides a migration path for ActiveMatrixBusinessWorks™ 5.x projects with a few exceptions. This document explains how to migrate fromActiveMatrix BusinessWorks 5.x to ActiveMatrix BusinessWorks 6.x, and lists differences between thetwo. There are many new features in ActiveMatrix BusinessWorks 6.x that advance integration, but arenot covered in this document.

Migration Queries Resolution

ActiveMatrix BusinessWorks 5.x constructsmigrating to equivalent ActiveMatrixBusinessWorks 6.x constructs.

The value Supported is mentioned in the"Migration Support" for this category.

Supported does not mean defect free.

ActiveMatrix BusinessWorks 5.x constructsare not migrating to ActiveMatrixBusinessWorks 6.x, because correspondingActiveMatrix BusinessWorks 6.x construct isavailable with corresponding migrationsupport, with corner case limitations.

The value Supported with limitations is mentionedin the "Migration Support" for this category.

The corresponding ActiveMatrixBusinessWorks 6.x constructs are notcurrently available.

1. This implies a feature parity gap forActiveMatrix BusinessWorks 6.x compared withActiveMatrix BusinessWorks 5.x.

2. The value Currently not supported is mentionedin the "Migration Support" for this category.

Contact Product Management for detailson features that are currently notsupported.

The corresponding ActiveMatrixBusinessWorks 6.x construct is available, butActiveMatrix BusinessWorks 5.x toActiveMatrix BusinessWorks 6.x migrationextension is currently not available.

1. This means a user can create such a constructusing TIBCO Business Studio™ forBusinessWorks™, but automated migration fromActiveMatrix BusinessWorks 5.x is not yetsupported.

2. After migration, re-factor and re-create theconstruct using TIBCO Business Studio forBusinessWorks.

3. The value BW6 migration not supported ismentioned in the "Migration Support" for thiscategory.

9


Migration Queries Resolution

Fundamental design improvements inActiveMatrix BusinessWorks 6.x rendersautomated migration.

1. You can achieve better results in ActiveMatrixBusinessWorks 6.x compared to ActiveMatrixBusinessWorks 5.x, but only when the constructis created in TIBCO Business Studio forBusinessWorks.

2. After migration, re-factor and re-create theconstruct using TIBCO Business Studio forBusinessWorks.

3. The value Refactor and recreate is mentioned inthe "Migration Support" for this category.

10


ActiveMatrix BusinessWorks 5.x and TIBCO ActiveMatrixBusinessWorks™ 6.x Type Columns Legend

The following values are used in the "Type" columns.

Values used in Type columns Description

.<resource extension> The file extension used to describe its type. Forexample, .xml, .xsd, and .wsdl resources.

Adapter Specific Resource Special resources used only for configuration of Adapters.

Shared Configuration Resource configuration that has associated a transport statethat you can lifecycle.

Shared Resource Re-usable configuration that does not have a transport statethat you can lifecycle.

Process Starter Activity1. One of the three activity types supported by ActiveMatrix

BusinessWorks™ 5.x and ActiveMatrix BusinessWorks 6.x.

2. This type of activity starts a new job from external messagesor internal events.

Regular Activity1. One of the three activity types supported by ActiveMatrix


2. This type of activity processes its input in-memory.

Signal-in Activity1. One of the three activity types supported by ActiveMatrix


2. This type of activity suspends the job and waits for anexternal event. When BusinessWorks runtime receives anexternal event, it correlates the event base on a prescribedkey. The ActiveMatrix BusinessWorks runtime joins theexternal event to the waiting job only when the prescribedkey matches.

Built-in1. An intrinsic built-in feature of ActiveMatrix BusinessWorks

process editor.

2. A built-in feature can be from an eclipse or part of theeditor feature (for example, ActiveMatrix BusinessWorks6.x Process Design Editor).

11


Values used in Type columns Description

Palette1. In ActiveMatrix BusinessWorks™ 5.x, a palette is a TIBCO

Designer™ concept for the grouping of resources oractivities.

2. For the purpose of this documentation, a palette is fordescribing a group of activities that are offered as part ofcore ActiveMatrix BusinessWorks.

Plug-in1. In ActiveMatrix BusinessWorks™ 5.x, a ActiveMatrix

BusinessWorks Plug-in is an add-on extension that containsboth design-time and runtime extensions of ActiveMatrixBusinessWorks activities.

2. In ActiveMatrix BusinessWorks™ 5.x, a ActiveMatrixBusinessWorks Plug-in is offered as an add-on product toActiveMatrix BusinessWorks.

3. For the purpose of this documentation, a plug-in is fordescribing a ActiveMatrix BusinessWorks add-on product.

Binding1. In ActiveMatrix BusinessWorks 6.x, binding type is offered

as a first class concept as part of activities.

2. SOAP binding and REST binding are offered as a part ofActiveMatrix BusinessWorks 6.x core features.

12


Standard Constructs

The supported standard TIBCO ActiveMatrix BusinessWorks™ constructs are listed here.

BW 5.xBW 5.xType BW 6.x

BW 6.xType

MigrationSupport Comments

DTD .dtd XSD .xsd Supported● ActiveMatrix

BusinessWorks™ 6.xcurrently does not supportDTD natively.

● ActiveMatrix BusinessWorks6.x Migration tool convertsDTD resource to XSD.

Instance .xml Instance .xml Supported Migrates as is.

Schema .xsd Schema .xsd Supported Migrates as is.

XSLT .xslt XSLT .xslt Supported Migrates as is.

WSDL .wsdl WSDL .wsdl Supported Migrates as is.

13


TIBCO ActiveMatrix BusinessWorks™ Core Constructs

The following table displays the supported Core ActiveMatrix BusinessWorks™ constructs.


BW 6.xType


Design-timeLibrary

ApplicationModule

ApplicationModule

Supported

Start Start Start Supported Applies to a Sub Process. Ifthe Sub Process refers to aninline schema it will beexternalized.

ProcessStarter

ProcessStarterActivity orService

ProcessStarterActivity orService

Supported If the ActiveMatrixBusinessWorks 5.x activityis a SOAP Event Source or aService Binding then theService will be created. Forall other Process Starter itwill create the ProcessStarter only.

End End End Supported Applies to a Sub Process. Ifthe Sub Process refers to aninline schema it will beexternalized.

14



BW 6.xType


GlobalVariable

.substvar ProcessProperty

ModuleProperty

ApplicationProperty

.substvar Supported As ActiveMatrixBusinessWorks 6.x Runtimesupports multipleapplications, it isrecommended that GlobalVariable is not used todescribe applicationconfigurable properties.

Instead, there are followingthree levels of properties:

● Process Properties

● Module Properties

● Application Properties

These three levels ofproperties are hierarchical:Application Properties arein the outer most scope,followed by ModuleProperties, followed byProcess Properties.

You can define and sourcevalue from its parent scope.For example:

1. Process Property valuescan be defined by LiteralValues or source itsvalue from its parentscope Module Property.

2. By the same token,Module Property valuecan be defined by LiteralValues or source fromits parent scopeApplication Property.

15


Groups

BW 5.x BW 5.x Type BW 6.x BW 6.x Type Migration Support

Group Built-In Scope Built-In Supported

Group : If Built-In Group : If Built-In Currently notsupported

Group : Iterate Built-In Group : Iterate Built-In Supported

Group : RepeatUntil True

Built-In Group : Repeat Built-In Supported

Group : RepeatOn Error UntilTrue

Built-In Group : RepeatOn Error

Built-In Supported

Group :Transaction

Built-In Group : LocalTransaction

Built-In Supported

Group : CriticalSection

Built-In Group : CriticalSection

Built-In Supported

Group : PickFirst

Built-In Group : PickFirst

Built-In Currently notsupported

Group : WhileTrue

Built-In Group : While Built-In Supported

16


Transitions


BW 6.xType


ProcessDefinition

.process Process .bwp Supported TIBCO ActiveMatrixBusinessWorks™5.x .process filesare migrated as .bwpfiles.

Project DesignerProject

ApplicationModule

ApplicationModule

Supported

Transition :

ConditionType :

Success

Built-In Transition :ConditionType :Success

Built-In Supported

Transition :

ConditionType :

Success withcondition

Built-In Transition :ConditionType :Successwithcondition

Built-In Supported

Transition :

ConditionType :

Success withno matchingcondition

Built-In Transition :ConditionType :Successwith nomatchingcondition

Built-In Supported

Transition :

ConditionType :

Error

Built-In Transition :ConditionType : Error

Built-In Supported

17


Timer

Timer is a process starter activity that starts the process at a specific time. You can also specify theprocesses to be started periodically.

General

The General tab has the following fields.

Field

Literal Value/ModuleProperty/ProcessProperty Description

Name None The name to be displayed as the label for the activity in theprocess.

Start Time Yes The day and time to start the process. To run the processperiodically, the start time indicates the first time to run theprocess.

The local machine’s time zone is used to determine the processstart. If the project is running on machines in different time zones,the time zone of the machine where the project was saved, isused. Use a process property in this field to provide start timesrelative to the time zone where the project is deployed. If youprovide a process property for this field, the format of thespecified time must be: yyyy MMM dd HH:mm:ss z

Run Once None Indicates this process should be run only once on the day andtime indicated by the Start Time field.

If you do not select this check box, the Time Interval and IntervalUnit fields are displayed that you can use to specify the frequencyof the process.

TimeInterval

Yes The integer indicating the number of units specified in theInterval Unit field. For example, if a value of 1 is specified andthe Interval Unit field is specified as Hour, a new process isstarted every hour beginning at the time specified in the StartTime field.

● If a value of 2 is specified and the Interval Unit field isspecified as Month, a process is started every other month,beginning at the time specified in the Start Time field.

● If the value specified is less than one second (1000milliseconds), the timer ignores the specified interval and istriggered once every second.

Using Literal Value, Module Property, and ProcessProperty in this field, specifies the time interval inmilliseconds and the Interval Unit field is notdisplayed.

18


Field

Literal Value/ModuleProperty/ProcessProperty Description

Interval Unit None The unit of time to use with the Time Interval field to determinehow often to start a new process. The units can be: Millisecond,Second, Minute, Hour, Day, Week, Month, and Year.

End After None Specify the number of occurrences or the end time here. Selectfrom the following available options:

● Never: Click the Never radio button if you want tocontinuously execute the process instance. For example, if theTime Interval value specified is 5 and the Interval Unitspecified is Second, the process instance executes every 5seconds.

● Occurrences: Clicking the Occurrences radio button displaysthe Occurrences field. Specify the number of occurrences ofthe process instance execution. This field can be configuredwith Literal Value, Module Property, and Process Property.

● End Time: Clicking the End Time radio button displays theEnd Time field. Specify the end time and date when you wantthe process to end. This field can be configured with LiteralValue, Module Property, and Process Property.

Description

Provide a short description of the activity.

Advanced

The Advanced tab has the following fields.

Field Description

Sequencing Key This field contains an XPath expression that specifies which processes shouldrun in sequence. Process instances with sequencing keys evaluating to the samevalue, are executed sequentially in the sequence the process instance wascreated.

Custom Job Id This field contains an XPath expression that specifies a custom job ID for everyjob in the process instance.

Conversations

You can initiate the conversation here. Click the Add New Conversation button to initiate multipleconversations.For more information about conversations, see the TIBCO ActiveMatrix BusinessWorks™ ApplicationDevelopment guide.

19


Output

The following is the output of the activity.

Output Item Description

TimerOutputSchema The time the process instance started.

The time is represented by several items in the output schema indicating:

● Now

● Hour

● Minute

● Second

● Week

● Month

● Year

● Date

● Time

● DayOfMonth

Each of these items uses the appropriate datatype.

Threading Policy Details

The following are the details about the Timer activity threading policy.

Activity TypeMulti-Threaded?

Default ThreadCount Thread Count Configuration

ProcessStarter No 1 Not applicable.

The Timer process starter does not generatemultiple events concurrently. You cannot alterthe default thread count for this activity.

20


Mapper

BW 5.xBW 5.xType BW 6.x BW 6.x Type


XPATH XPATH inDesignerMapper

XPATH XPATH inEclipseMapper

Supported XPATH support in TIBCOActiveMatrixBusinessWorks™ 5.x is limitedto XPATH 1.0.

ActiveMatrixBusinessWorks™ 6.x supportsXPATH 1.0. For example, allliteral values used in XPATH1.0 must have acorresponding constructorfunction around the literalvalue.

XSLT XSLT inDesignerMapper

XSLT XSLT inEclipseMapper

Supported XSLT support in ActiveMatrixBusinessWorks 5.x is limitedto XSLT 1.0.

ActiveMatrix BusinessWorks6.x also supports XSLT 1.0.

When a repeating element ismapped to a string using afilter, and the xsl:value-ofinstruction parameter hasno separator attribute, and thevalue of the select expressionis a sequence of more thanone item, then under XSLT 2.0all the items in the outputsequence are space separated,whereas for XSLT 1.0, allitems after the first elementare discarded.

21


TIBCO ActiveMatrix BusinessWorks™ Palettes

General Palette

BW 5.x BW 5.x Type BW 6.x BW 6.x TypeMigrationSupport Comments

AliasLibrary

SharedConfiguration

ApplicationModule with JavaNature or EclipseJava Plug-InProject

Eclipse Plug-in Project

NotSupported

EnterpriseArchiveResource

SharedConfiguration

ActiveMatrixBusinessWorks™6.x Application

Eclipse Plug-in Project

NotSupported

OnlyActiveMatrixBusinessWorks5.x sourceprojectmigration issupported.

Folder GenericResource

Folder Eclipse Folder Supported

GenericImageResource

GenericResource

GenericResource

Identity SharedConfiguration

Identity SharedConfiguration

Supported

22



LibraryBuilder

.projlib Shared Module Eclipse Plug-in Project

Supported ActiveMatrixBusinessWorks6.x MigrationFramework,ActiveMatrixBusinessWorks5.x Design-timeLibraries aremigrated inline,as part of regularresources inApplicationModule.

If ActiveMatrixBusinessWorks6.x developerwants to reusethe contents ofthe DT Library,the migratedresource can bemanually re-factored intoShared Module.

Task List .taskList Task List .taskList Currentlynotsupported

TextDocument

.txt Text Document .txt Supported

General Activities Shared Resources

TIBCO ActiveMatrix BusinessWorks™ 5.x: General Activities Shared Resources

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: Shared Resources Wizards

Type: Shared Resources


CustomActivity

SharedConfiguration

CustomActivity

SharedConfiguration

Currentlynotsupported

JNDIConfiguration

SharedConfiguration

JNDIConfiguration

SharedConfiguration

Supported

23



Job SharedVariable

SharedConfiguration

Module : JobSharedVariable

SharedConfiguration

Supported

24



Lock Object SharedConfiguration

Module : JobSharedVariable

SharedConfiguration

Supported InActiveMatrixBusinessWorks5.x, LockObject is usedwith theCriticalSection group.This constructis alsosupported forcross enginescritical section.

InActiveMatrixBusinessWorks6.x, the CriticalSection groupis configuredwith ModuleSharedVariable.

In TIBCOBusinessStudio™ forBusinessWorks™ 6.x, modulesharedvariables areconfiguredthroughModuleDescriptors >SharedVariableseditor. Thisconstruct isalso supportedfor AppSpaceswith multipleAppNodes inActiveMatrixBusinessWorks6.x, if theAppSpace isconfiguredwith EngineGroup active/activeconfiguration.

25



Migration Toolmigrates theActiveMatrixBusinessWorks5.x Lock Objectas a ModuleSharedVariable andthe CriticalSection group.

NotifyConfiguration

SharedConfiguration

Process :WSDL/Interface/Operation

SharedConfiguration

Supported

SharedVariable

SharedResource

Module :ModuleSharedVariable Type:SharedResource

SharedResource

Supported ActiveMatrixBusinessWorks5.x sharedvariable withmulti-engineoption is now aModule SharedVariable withPersistentoption.

General Activities Palette

ActiveMatrix BusinessWorks™ 5.x: General Activities Palette

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: General Activities Palette

Type: Palette


Assign RegularActivity

Basic : Assign RegularActivity

Supported

Call Process RegularActivity

Call ProcessActivity

RegularActivity +Binding Type

Supported

Catch RegularActivity

Scope withCatch Block

Built-in Supported

26



Checkpoint RegularActivity


Supported

Confirm RegularActivity

Confirm RegularActivity

Supported

EngineCommand

RegularActivity

EngineCommand

RegularActivity

Supported

ExternalCommand

RegularActivity

ExternalCommand

RegularActivity

Supported

GenerateError

RegularActivity

Basic : Throw RegularActivity

Supported

Get SharedVariable

RegularActivity

Get SharedVariable

RegularActivity

Supported

Inspector RegularActivity

Inspector RegularActivity

Supported

Label DiagramNotation

Note DiagramNotation

Supported

Mapper RegularActivity

Mapper RegularActivity

Supported

27



Notify RegularActivity

Invoke Process RegularActivity

Supported InActiveMatrixBusinessWorks™ 5.x, Notify,and Waitactivities areused for inter-processcommunication.

InActiveMatrixBusinessWorks6.x, a processnow supportsinterface withmultipleoperations.Theseoperations canbe used forinter-processcommunication.

When theNotify andWait activitiesare used formultipleprocesseswaiting toreceivenotification,you can use aJMS transportwith topic toachieve thesame publish/subscribepattern.

Null RegularActivity

Basic : Empty RegularActivity

Supported

On Error

Type:

ProcessStarterActivity

Currently notsupported

On EventTimeout



28



OnNotificationTimeout


Supported

OnShutdown


ActivatorProcess

Process Supported Process with aspecialActiveMatrixBusinessWorks6.x definedservice thatsupports anoperation foronShutdownfunctionality.This processcan beconfigured perapplication.

Close, re-open,and clean themigratedproject toresolveunresolvedschemareferences.

On Startup ProcessStarterActivity

ActivatorProcess

Process Supported Process with aspecialActiveMatrixBusinessWorks6.x definedservice thatsupports anoperation foronStartup anbe configuredperapplication.

Close, re-open,and clean themigratedproject toresolveunresolvedschemareferences.

ReceiveNotification


Basic : Receive ProcessStarterActivity

Supported

29



Rethrow RegularActivity

Basic :Rethrow

RegularActivity

Supported

Set SharedVariable

RegularActivity

Set SharedVariable

RegularActivity

Supported

Sleep RegularActivity


Supported

Timer RegularActivity

Timer RegularActivity

Supported

Wait Signal-InActivity

Receive ProcessStarter

Supported

Write To Log RegularActivity

Log RegularActivity

Supported

ActiveEnterprise Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: ActiveEnterprise Palette

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: ActiveEnterprise Plug-in

Type: Plug-in

In ActiveMatrix BusinessWorks, the ActiveEnterprise palette is not bundled out-of-the-box. You mustinstall the Adapter Framework Pack as an add-on Plug-in.

BW 5.x BW 5.x Type BW 6.x BW 6.x TypeMigrationSupport

AdapterRequest-Response Server

Process StarterActivity

Adapter Request-Response Server


Supported

AdapterSubscriber


AdapterSubscriber


Supported

Invoke anAdapter Requestresponse Service

Request/ReplyActivity

Invoke anAdapter Requestresponse Service

Request/ReplyActivity

Supported

Publish toAdapter

Regular Activity Publish toAdapter

Regular Activity Supported

Respond toAdapter Request

Regular Activity Respond toAdapter Request


30


BW 5.x BW 5.x Type BW 6.x BW 6.x TypeMigrationSupport

Send Exceptionto AdapterRequest

Regular Activity Send Exception toAdapter Request


Wait for AdapterMessage

Signal-In Activity Wait for AdapterMessage

Signal-In Activity Supported

Wait for AdapterRequest

Signal-In Activity Wait for AdapterRequest

Signal-In Activity Supported

Adapter Resources Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: Adapter Resources Palette

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: Adapter Resources Plug-in

Type: Plug-in


GenericAdapterConfiguration

SharedConfiguration

GenericAdapterConfiguration

SharedConfiguration

Supported

Message Filter AdapterSpecificResource

MessageFilter

AdapterSpecificResource

Supported

AdapterArchive


AdapterArchive


Supported

Advisory AdapterSpecificResource

Advisory AdapterSpecificResource

Supported

Client AdapterSpecificResource

Client AdapterSpecificResource

Supported

Generic LogSink


Generic LogSink


Supported

GenericTransactionControl Pool


GenericTransactionControl Pool


Supported

31



GenericSession


GenericSession


Supported

Load URL AdapterSpecificResource

Load URL AdapterSpecificResource

Supported

Log Sink Role AdapterSpecificResource

Log Sink Role AdapterSpecificResource

Supported

PublicationService


PublicationService


Supported

Publisher AdapterSpecificResource

Publisher AdapterSpecificResource

Supported

Request-ResponseInvocationService


Request-ResponseInvocationService


Supported

Request-ResponseService


Request-ResponseService


Supported

Server AdapterSpecificResource

Server AdapterSpecificResource

Supported

Subscriber AdapterSpecificResource

Subscriber AdapterSpecificResource

Supported

SubscriptionService


SubscriptionService


Supported

Timer AdapterSpecificResource

Timer AdapterSpecificResource

Supported

32


BPEL Extension Palette

BW 5.x BW 5.x Type BW 6.xBW 6.xType


OrchestrationProcess

.orchestration Built-In :Process

.bwp Supported The .orchestrationresource is availablein the BPEL Palette.

TIBCO ActiveMatrixBusinessWorks™Process is nativelybased on BPEL.

Assign RegularActivity

Basic:Assign

RegularActivity

Supported

Catch RegularActivity

Scope withCatch Block

Built-In Supported


GeneralActivities:Checkpoint

RegularActivity

Supported

Exit RegularActivity

Basic: Exit RegularActivity

Supported

Invoke RegularActivity

Basic:Invoke

RegularActivity

Supported

InvokeProcess

RegularActivity

GeneralActivities :InvokeProcess +ReferenceBinding

RegularActivity

Supported

Null RegularActivity

Basic:Empty

RegularActivity

Supported

On Alarm ProcessStarterActivity

Built-In:AlarmHandler

Built-In Currentlynotsupported

On Event ProcessStarterActivity

Built-In:EventHandler

Built-In Supported

33




ReceiveStarter


Basic:Receive(CreateInstance =true)

Type:ProcessStarterActivity


Supported

Receive Signal-InActivity

Basic:Receive(CreateInstance =false)

Signal-InActivity

Supported

Reply withFault

RegularActivity

Basic : Replywith Faultconfigured

RegularActivity

Supported

Reply RegularActivity

Basic: Reply RegularActivity

Supported

Rethrow RegularActivity

Basic:Rethrow

RegularActivity

Supported


GeneralActivities:Sleep

RegularActivity

Supported

Throw RegularActivity

Basic:Throw

RegularActivity

Supported

Write To Log RegularActivity

GeneralActivities:Log

RegularActivity

Supported

File Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: File Palette

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: File Palette

Type: Palette

34



Copy File RegularActivity

Copy File RegularActivity

Supported

Create File RegularActivity

Create File RegularActivity

Supported

File Poller ProcessStarterActivity

File Poller Process StarterActivity

Supported

List Files RegularActivity

List Files RegularActivity

Supported

Read File RegularActivity

Read File RegularActivity

Supported

Remove File RegularActivity

Remove File RegularActivity

Supported

Rename File RegularActivity

Rename File RegularActivity

Supported

Wait for FileChange

Signal-InActivity

Wait for FileChange

Signal-InActivity

Supported

Write File RegularActivity

Write File RegularActivity

Supported

FTP Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: FTP

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: FTP Palette

Type: Palette



FTPConnection

SharedResource

FTP ConnectionType: SharedResource

SharedResource

Supported

FTP ChangeDefaultDirectory

RegularActivity

FTP ChangeDefaultDirectory

RegularActivity

Supported

35




FTP DeleteFile

RegularActivity

FTP Delete FileType: RegularActivity

RegularActivity

Supported

FTP Dir RegularActivity

FTP Dir RegularActivity

Supported

FTP GetDefaultDirectory

RegularActivity

FTP Get DefaultDirectory

RegularActivity

Supported

FTP Get RegularActivity

FTP Get RegularActivity

Supported

FTP MakeRemoteDirectory

RegularActivity

FTP MakeRemoteDirectory

RegularActivity

Supported

FTP Put RegularActivity

FTP Put RegularActivity

Supported

FTP Quote RegularActivity

FTP Quote RegularActivity

Supported

FTP RemoveRemoteDirectory

RegularActivity

FTP RemoveRemoteDirectory

RegularActivity

Supported

FTP RenameFile

RegularActivity

FTP RenameFile

RegularActivity

Supported

FTP SysType

RegularActivity

FTP Sys Type RegularActivity

Supported

HTTP Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: HTTP

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: HTTP Palette

Type: Palette

36



BW 6.xType


HTTPConnection

SharedResource

HTTPConnector

SharedResource

Supported HTTP Connectionshared resource ismigrated toActiveMatrixBusinessWorks 6.x asan HTTP Connectorshared resource. Thisis for the HTTPService.

ActiveMatrixBusinessWorks usesJetty Server and doesnot support Tomcatand HttpComponentimplementation fromActiveMatrixBusinessWorks 5.x.

ProxyConfiguration

SharedResource

ProxyConfiguration

SharedResource

Supported

HTTPReceiver

ProcessStarter

HTTPReceiver

ProcessStarter

Supported

37



BW 6.xType


Send HTTPRequest

RegularActivity

Send HTTPRequest

RegularActivity

Supported ActiveMatrixBusinessWorks 6.x hasalso introduced a newshared resource forthis client side invoke,HTTP Client sharedresource. You can usethis shared resource toconfigure and tune anumber ofoptimizationparameters such asMaximum TotalConnection andMaximum TotalConnection Per Host.

This new HTTP Clientshared resource alsoallows the users toconfigure a ThreadPool shared resource( new in ActiveMatrixBusinessWorks 6.x).Using the Thread Poolshared resource youcan configureMinimum Pool Size,Maximum Pool Sizeand a number of othertuning parameters.

Send HTTPResponse

RegularActivity

Send HTTPResponse

RegularActivity

Supported

Wait ForHTTPRequest

Signal-InActivity

Wait ForHTTP Request

Signal-InActivity

Supported

JAVA Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: JAVA

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: JAVA Palette

Type: Palette

If the ActiveMatrix BusinessWorks 5.x project has an activity from the Java palette, the ActiveMatrixBusinessWorks application module gets converted to a Java project. The additional src and lib foldersare seen in the project. The src folder contains the Java source files. The lib folder contains the Javalibraries (JAR Files). Java Nature is also added to the project.

38



JavaCustomFunction

SharedConfiguration

CustomXPATHFunction

SharedConfiguration

Supported

Java GlobalInstance

SharedResource

Java GlobalInstance

SharedResource

Supported

JavaSchema

SharedConfiguration

XSDSchema

.xsd Supported In ActiveMatrixBusinessWorks 6.xthe Java To XMLand XML To Javaactivities do not useJava Schema. Aftermigration thecorrespondingSchema equivalentto the Java Schemais generated andassociated with theactivity.

Java Code RegularActivity

JavaInvoke

RegularActivity

Supported The source code forthe Java Codeactivity which wasin-lined in theActiveMatrixBusinessWorks 5.xnow gets createdexternally in the srcfolder of theAppModule andthen it is referred bythe Java Invokeactivity withMultiOutput checkbox selected.

39



Java EventSource


JavaProcessStarter


Supported The Source code forJava Event Sourceactivity which wasin-lined in theActiveMatrixBusinessWorks 5.xnow gets createdexternally in the srcfolder of theAppModule andthen Java ProcessStarter activityrefers to it.

The Java classimplementing theJava Event Sourcenow extendscom.tibco.bw.pale

tte.shared.java.J

avaProcessStarter

class instead ofcom.tibco.plugin.

java.JavaProcessS

tarter.

Java Event Sourcein ActiveMatrixBusinessWorks 5.xreferring to anexternal class needsto change this.

JavaMethod

RegularActivity

JavaInvoke

RegularActivity

Supported

Java ToXML

RegularActivity

Java ToXML

RegularActivity

Supported

XML ToJava

RegularActivity

XML ToJava

RegularActivity

Supported

JDBC Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: JDBC

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: JDBC Palette

Type: Palette

40




JDBCConnection

SharedResource

JDBCConnection

SharedResource

Supported

JDBC CallProcedure

RegularActivity

JDBC CallProcedure

RegularActivity

Supported

JDBC GetConnection

RegularActivity

JDBC GetConnection

RegularActivity

Currentlynotsupported

JDBC Query RegularActivity

JDBC Query RegularActivity

Supported

JDBC Update RegularActivity

JDBCUpdate

RegularActivity

Supported

SQL Direct RegularActivity

SQL Direct RegularActivity

Supported

JMS Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: JMS Palette

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: JMS Palette

Type: Palette



JMSApplicationProperties

SharedConfiguration

XSD Schema .xsd Supported JMS ApplicationProperties is migratedas XML Schema (XSDFile) in ActiveMatrixBusinessWorks 6.x.

JMSConnection

SharedResource

JMSConnection

SharedResource

Supported

Get JMSQueueMessage

RegularActivity

Get JMSQueueMessage

RegularActivity

Supported

JMS QueueReceiver


JMS ReceiveMessage


Supported

JMS QueueRequester

RegularActivity

JMS RequestReply

RegularActivity

Supported

41




JMS QueueSender

RegularActivity

JMS SendMessage

RegularActivity

Supported

JMS TopicPublisher

Type:RegularActivity

RegularActivity

JMS SendMessage


RegularActivity

Supported

JMS TopicRequestor


RegularActivity

JMS RequestReply


RegularActivity

Supported

JMS TopicSubscriber


JMS ReceiveMessage


Supported

Reply toJMSMessage


RegularActivity

Reply toJMSMessage


RegularActivity

Supported

Wait forJMS QueueMessage

Signal-InActivity

Wait for JMSMessage

Signal-InActivity

Supported

Wait forJMS TopicMessage

Signal-InActivity

Wait for JMSMessage

Signal-InActivity

Supported

Mail Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: Mail Palette

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: Mail Palette

Type: Palette


BW 6.xType


ReceiveMail


Receive Mail ProcessStarterActivity

Supported

42



BW 6.xType


Send Mail RegularActivity

Send Mail RegularActivity

Supported ActiveMatrixBusinessWorks 6.xintroduces a new SMTPshared resource.ActiveMatrixBusinessWorks 5.x SendMail activityconfiguration migratesto both Send Mailactivity and SMTPshared resource.

Parse Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: Parse Palette

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: Parse Palette

Type: Palette


Data Format SharedConfiguration

Data Format SharedConfiguration

Supported

Parse Data RegularActivity

Parse Data RegularActivity

Supported

Render Data RegularActivity

Render Data RegularActivity

Supported

Policy Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: Policy Palette

Type: Palette


SecurityPolicyAssociation

SharedConfiguration

SecurityPolicyAssociation

SharedConfiguration


SecurityPolicy

SharedConfiguration

SecurityPolicy

SharedConfiguration


43


Process Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: Process Palette

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: Built-In

Type: Built-In


ProcessDefinition

.process Process .bwp Supported

44



ProcessArchive

SharedConfiguration

ApplicationProject

.application Refactorandrecreate

In ActiveMatrixBusinessWorks™ 5.x,Process Archive isconfigured within theEnterprise ArchiveResource. Thisspecifies whichprocesses in theActiveMatrixBusinessWorks™ 5.xproject are to bepackaged to form anEAR file fordeployment.

In ActiveMatrixBusinessWorks 6.x, theEnterprise ArchiveResource and ProcessArchive configurationare no longersupported and theirfunctionality arereplaced byApplication andApplication Module,respectively. Anyproject artifacts thatcan be re-used bymultiple Applicationsand multipleApplication Modulesare to be created inShared Modules.

In the current versionof Migration Tool, anActiveMatrixBusinessWorks™ 5.xproject is migrated asan application modulewith a correspondingapplication project. Ifthe content of theActiveMatrixBusinessWorks™ 5.xproject is meant forcreating multipleapplications, then dothe following:

1. Convert theApplication

45



Module to SharedModule.

2. Create anApplicationModule and acorrespondingapplication project.

a. In theApplicationModule >ModuleDescriptors >Componentseditor, definethe componentto refer toprocessimplementation in the SharedModule.

b. Repeat 2.a stepfor eachprocess that isrequired to be apart of thisApplicationModule. Note:In ActiveMatrixBusinessWorks6.x, a Process(say, Process A)in a SharedModule is notactivatedunless aComponent isdefined and isconfiguredwith ProcessA .

3. Repeat Step 2 forthe number ofapplicationsrequired.

Rendezvous Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: Rendezvous Palette

46


Type: Palette

ActiveMatrix BusinessWorks™ 6.x: Rendezvous Palette

Type: Palette


RendezvousTransport

SharedResource

RendezvousTransport

SharedResource

Supported

PublishRendezvousMessage

RegularActivity

RendezvousPublisher

RegularActivity

Supported

RendezvousSubscriber


RendezvousSubscriber


Supported

Reply ToRendezvousRequest

RegularActivity

RendezvousReply ToRequest

RegularActivity

Supported

SendRendezvousRequest

RegularActivity

RendezvousRequestReply

RegularActivity

Supported

Wait forRendezvousMessage

Signal-InActivity

Wait forRendezvousMessage

Signal-InActivity

Supported

REST and JSON Plug-inTIBCO ActiveMatrix BusinessWorks™ 5.x: REST/JSON Plug-in

Type: Plug-in

ActiveMatrix BusinessWorks™ 6.x: REST and JSON Palette

Type: Palette

Migration: Supported

47




Invoke RESTAPI

RegularActivity

Invoke RESTAPI

RegularActivity

Supportedwithlimitations

ActiveMatrixBusinessWorks6.x does notsupport thefollowing:

● WADLprotocols

● Responsesreturned inbinaryformat

● Rich output

● Authentication OAuth1.0andOAuth2.0

The Circuit Breaker pattern is not supported by the Invoke REST API activity. If you wantto use Circuit Breaker pattern, you need to configure the REST Reference Binding. Formore information, see Using the Wizard to Create a REST Reference in the TIBCOActiveMatrix BusinessWorks™ REST Reference guide.

Parse JSON RegularActivity

Parse JSON RegularActivity


ActiveMatrixBusinessWorks6.x does notsupport theschema typeJava Classes.

48




Render JSON RegularActivity

Render JSON RegularActivity


The RemoveRoot check boxis not supportedin ActiveMatrixBusinessWorks6.x. Rootelements inActiveMatrixBusinessWorks6.x are skippedby default. Youwill need tomodify theinput JSON if itcontains rootelement.

The schematype JavaClasses is notsupported inActiveMatrixBusinessWorks6.x.

49




RESTDispatch andReply

RegularActivity

REST ServiceBinding

ServiceBinding


This ThisActiveMatrixBusinessWorks™5.x Dispatchand ReplyREST activity ismigrated toREST ServiceBinding ofActiveMatrixBusinessWorks6.x.

REST Service ofActiveMatrixBusinessWorks6.x uses XSD asthe resource forbuilding RESTService. TheXSD must beexternal to theWSDL. That is,direct referenceto inline schemain WSDL is notsupported forREST binding.

If the Dispatchand Replyactivity isconfigured toroute requests toActiveMatrixBusinessWorks™5.x processeswith inlineschema for itsinput, outputand fault, thentheActiveMatrixBusinessWorks6.x MigrationTool currentlydoes notexternalize theinline schemabeforeconfiguring theREST binding.You can

50




manuallyexternalize theinline schemaand re-create theREST binding.

ActiveMatrixBusinessWorks6.x also does notsupport thefollowing:

● EnableWADLReference

● EnableOAuth

● Parameterstyles-Templateand Header

For more information about additional restrictions, see Restrictions on XML Schema in TIBCOActiveMatrix BusinessWorks™ Bindings and Palettes Reference.

RMI Palette


RMI Lookup RegularActivity

RMI Lookup RegularActivity


None

RMI Server ProcessStarter

RMI Server ProcessStarter


None

Service Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: Service Palette

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: Built-In

Type: Built-In


51




ContextResource

.contextResour

ce

Built-In Supported Migrated as JobShared Variable

Partner LinkConfiguration

.sharedpartner Process :Reference

Built-In Supported

Service .serviceagent Process :Service

Built-In Supported

Get Context Regular Activity Basic : GetContext

RegularActivity

Supported Post migration,two sets of GetContext and SetContextactivities aredisplayed in aservice process.The sets retrievethe contextinformation andpass theinformation tothesubprocesses,and vice versa.

InvokePartner

Regular Activity Basic :InvokeService

RegularActivity

Supported SOAP RequestReply activity ismigrated as aprocess withreference andSOAP referencebinding isadded for thesame. Thebinding isadded underModuleDescriptors >Components >Binding.

ReceivePartnerNotification


Basic :Receive


Supported

52




Set Context Regular Activity Basic : SetContext

RegularActivity

Supported Post migration,two sets of GetContext and SetContextactivities aredisplayed in aservice process.The sets retrievethe contextinformation andpass theinformation tothesubprocesses,and vice versa.

SOAP Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: SOAP Palette

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: Basic Palette + SOAP Binding

Type: Binding



MIME Parser RegularActivity

Parse : MIMEParser

RegularActivity


RetrieveResources

RegularActivity

GenerateWSDLService

RegularActivity +SOAP Binding


The WSDL inActiveMatrixBusinessWorks 6.x has to begenerated inthe TIBCOBusinessStudio™ forBusinessWorks™ 6.x on theComponentBinding.

53



SOAP EventSource


Basic :Receive +SOAP ServiceBinding

Process StarterActivity +SOAP Binding

Supportedwithlimitations.

The SOAPEvent Sourceis migrated asa Process withService and aSOAP ServiceBinding isadded for thesame. TheBinding isadded underModuleDescriptors/Components/Binding.

HeaderMigrationis notsupported.

SOAPRequestReply

RegularActivity

Basic : InvokeService +SOAPReferenceBinding


Supportedwithlimitations.

The SOAPRequest Replyis migrated asa Process withReference anda SOAPReferenceBinding isadded for thesame. TheBinding isadded underModuleDescriptors/Components/Binding.

HeaderMigrationis notsupported.

SOAP SendFault

RegularActivity

Basic : Replywith Fault +SOAPReferenceBinding


Supported

54



SOAP SendReply

RegularActivity

BasicActivities:Reply + SOAPReferenceBinding


Supported

TCP Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: TCP Palette

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: TCP Palette

Type: Palette



TCPConnection

SharedResource

TCPConnection

SharedResource

Supported

Read TCPData

RegularActivity

Read TCPData

RegularActivity

Supported

TCP CloseConnection

RegularActivity

TCP CloseConnection

RegularActivity

Supported

TCP OpenConnection

RegularActivity

TCP OpenConnection

RegularActivity

Supported

TCP Receiver ProcessStarterActivity

TCP Receiver ProcessStarterActivity

Supported

Wait for TCPRequest

Signal-InActivity

Wait for TCPRequest

Signal-InActivity

Supported

Write TCPData

RegularActivity

Write TCPData

RegularActivity

Supported

55


Transaction Palette


JTA UserTransactionConfiguration

SharedResource

JTA UserTransactionConfiguration

SharedResource


XATransactionManagerConfiguration

SharedResource

XATransactionManagerConfiguration

SharedResource


TransactionState

RegularActivity

TransactionState

RegularActivity


XML Palette

TIBCO ActiveMatrix BusinessWorks™ 5.x: XML Palette

Type: Palette

ActiveMatrix BusinessWorks™ 6.x: XML Palette

Type: Palette



XSLT File SharedConfiguration

XSLT File SharedConfiguration

Supported

Parse XML RegularActivity

Parse XML RegularActivity

Supported

Render XML RegularActivity

RenderXML

RegularActivity

Supported

TransformXML

RegularActivity

TransformXML

RegularActivity

Supported

56


Migration Scenario

The migration scenarios show the core construct migration of ActiveMatrix BusinessWorks™ 5.xprojects. After migration, these projects are converted to their equivalent in ActiveMatrixBusinessWorks™ 6.x. The ActiveMatrix BusinessWorks 6.x Call Process, Signal-in, Start, and Endactivities are notably different from the activities in ActiveMatrix BusinessWorks™ 5.x.

Call Process Activity Migration

The following table provides information about the Call Process activity migration from ActiveMatrixBusinessWorks™ 5.x to ActiveMatrix BusinessWorks 6.x.

ActiveMatrix BusinessWorks™ 5.x ActiveMatrix BusinessWorks 6.x

Call Process is literal. It calls a process withprocess pipeline data mapped into it andgenerates an output that is in essence theoutput of the called process.

Call Process mechanism is based on the standardInvoke activity. It abstracts out the actual CallProcess configuration to the reference that theInvoke activity is calling.

After Migration: Call Process activity is migrated asa Direct Call Process.

Signal-in Activity Migration

The following table provides information about the Signal-in activity migration from ActiveMatrixBusinessWorks 5.x to ActiveMatrix BusinessWorks 6.x.

ActiveMatrix BusinessWorks 5.x ActiveMatrix BusinessWorks 6.x

Signal-In activities join an existing job bycomparing the key generated by mappingprocess pipeline data to the key field of thesignal-in activity. The value is matched withthe value generated for the candidate eventkey field of the signal-in activity by mappingthe signal-in output data.

Conversations is introduced to join an existingprocess instance, which is based on a correlationmechanism. It applies to all the activities receiving amessage after the process instance is created.

A process instance can initialize a conversationusing an activity by initializing a conversation keywith the values mapped from the process pipelinedata. If the join activity generates a conversation keyvalue by evaluating the expression against themessage data, which matches the value of theinitialized conversation key, a message can join theconversation.

● Input key mapping migrates as ConversationInitiate

● Candidate Event Key migrates as ConversationJoin.

After Migration: Signal-in activity is migrated to anActiveMatrix BusinessWorks 6.x equivalent Signal-in activity with a dummy conversation with Initiateand Join as "true". This mechanism initiates theconversation based on the process data mapped to akey and matches it with a value that is generated bymapping the activity output data.

57


Start and End Activity Migration

The following table provides information about the Start and End activities migration fromActiveMatrix BusinessWorks™ 5.x to ActiveMatrix BusinessWorks 6.x.


The Start activity is a receiver that starts aprocess on receiving a message that may beempty. The End activity sends a reply.

The Start activity is the first activity in aprocess definition (process starters replacethe Start activity when used in a processdefinition).

The End activity is the last activity in aprocess definition.

The Start activity and End activity are nowsupported.

Activator

In ActiveMatrix BusinessWorks 6.x, each application module has one Activator process that has twoservice operations, On StartUp and On ShutDown. Any TIBCO Designer process linked with the OnStart and On ShutDown activity in ActiveMatrix BusinessWorks™ 5.x after migration is simultaneouslychanged to a StartUp Operation activity and On ShutDown Operation activity. The activator calls thestart() and stop() methods to start or stop the process.

Service and References

Service and References are defined at a process level.

58



SOAP services are used for exchanginginformation in the implementation of webservices relying on XML message format sentover HTTP and JMS.

Includes REST compliant services along with HTTPand JMS, where the purpose of the service is tomanipulate XML representations of web resourcesusing a uniform set of stateless operations. Whenusing a stateless operation, the state is managed bythe job itself instead of by the engine.

Migrating TIBCO ActiveMatrix BusinessWorks™ 5.x projects to ActiveMatrixBusinessWorks™ 6.x

You can migrate ActiveMatrix BusinessWorks 5.x projects to ActiveMatrix BusinessWorks 6.x using thefollowing options:

● Project > Migrate BW Projects option in TIBCO Business Studio™ for BusinessWorks™

● The command-line option

Migrating Projects Using TIBCO Business Studio™ for BusinessWorks™

TIBCO ActiveMatrix BusinessWorks™ 6.x provides an easy way to migrate ActiveMatrixBusinessWorks™ 5.x projects by using the Migrate BW Projects menu option in TIBCO Business Studiofor BusinessWorks.

Prerequisites

● Perform validation and ensure that ActiveMatrix BusinessWorks5.x project does not have errors.

● Optionally, schemas without namespaces should be refactored before migration.

● Remove or update any retrieve WSDL processes.

● It is recommended to add missing namespaces for the schemas.

● Ensure that there are no spaces or special characters in the folder names.

● Global variables with integer values but datatype as String must be updated to data type as Integer.Examples include timeouts, message size, and so on.

Procedure

1. In TIBCO Business Studio for BusinessWorks, choose Project > Migrate BW Projects....

59


2. In the Project Migration Wizard, click Migrate Single BusinessWorks 5x Project to migrate a singleActiveMatrix BusinessWorks 5.x project, or click Migrate Multiple BusinessWorks 5.x Projects tomigrate multiple ActiveMatrix BusinessWorks 5.x projects.When migrating single ActiveMatrix BusinessWorks 5.x projects, you can also migrate selectiveprocesses or subprocesses. Select the Select Processes for Migration check box, and provide therequired information as explained in Step 6, below. After the required information is provided, theSelect Processes button is displayed.

The Select Processes for Migration check box is disabled when you select the MigrateMultiple BusinessWorks 5.x Projects option. This check box can be used only to migratesingle projects.

The list of processes in the selected ActiveMatrix BusinessWorks 5.x project are displayed in theProject Migration Wizard. The processes can be viewed in the Flat Hierarchy or the Tree Hierarchystructures.

3. Click Select Linked Processes to select all the subprocesses under the main process. Deselect thecheck box for the process you do not want to migrate.To view the processes that are selected for migration, click Show Linked Process Hierarchy. Thestatic and dynamic processes to be migrated are displayed.

4. While migrating selective processes, to select or unselect the already migrated existing processes,select the Re-Select Process check box provided on the Select Processes page of the MigrationWizard.

5. Click Migrate Project.

6. Specify the relevant information in the following fields.a) Click Browse in the Select Project(s) to be migrated field and provide the location of the

ActiveMatrix BusinessWorks 5.x project that you want to migrate. Note: History of the last fivemigrated project paths can be retrieved by selecting CTRL+ Spacebar.

b) The Select Migrated Project Location field displays the location of the current open workspacewhere the project will be migrated. Click Browse if you want to provide a different workspace.

c) Click the Select Third Party JAR's folder field to browse for third party jars required for yourproject.

d) The Single XPath Function Group Project check box is selected by default, to create all customXPaths as a single plugin project and under a single custom XPath. After migration, the customXPath function group plugin project is included in the application project. The classes folder cannow be found in the customXPathFunction.jar file, and is no longer available in the pluginproject. This jar file is also added to the project class path.

60


e) In the Select ProjectLibs (DTLs) used by Project field, click Browse to select the project librariesto be used for the project.

f) In the Select Java Libraries used by Project field, click Browse and provide the location of theJAR files on disk if the ActiveMatrix BusinessWorks 5.x project is using external JAR files incontext with Java activities.It is recommended you place the external JAR files in a single location. These JAR files can thenbe in-lined in the migrated ActiveMatrix BusinessWorks 6.x project.

g) Click the Export button to generate the dot (.) properties file which can be used for performingcommand-line migration. For more information about the (.) properties file, see Command lineConfiguration File Template.

h) Click the Import button to browse the (.) properties file which will populate the referred 5.xproject path for migration.


8. Click Finish after the migration is complete.

61


Project with Subprocess after Migration

Subprocesses in ActiveMatrix BusinessWorks 6.x use a standardized concept of receiving andreplying messages through a service.

Before Migration

After Migration

The Call Process is migrated as a Direct Call Process.

62


Migrating Projects Using Command lineAnother option for a speedy migration is migrating the projects using the command line.

Usage: bwmigrator [-options] BW5Project...

where options include the following:

Option Description

-projectDir Location where TIBCO ActiveMatrixBusinessWorks™ 6.x projects are to be generated.

BW5Project... Location\locations of ActiveMatrixBusinessWorks™ 5.x projects.

-propFile The bw6migration.properties file. The syntax forpassing the bw6migration properties file isbwmigrator.exe [-data <User_Workspace>]

-projectDir <BusinessWorks 6.x Target

directory> <BusinessWorks 5.x Project

location> -propFile

<bw6migration.properties location>.

The template can be found at, <TIBCO_HOME>\bw\6.4\config

\bw6migration_template.properties.

Examples

● bwmigrator -projectDir <BW6_PROJECTS_HOME>\projects <TIBCO_HOME>\5.9\examples

\activities\file\File (Migrates single ActiveMatrix BusinessWorks 5.x project.)


\activities\file\File <TIBCO_HOME>\5.9\examples\activities\ftp\ftp (Migrates File andFTP ActiveMatrix BusinessWorks 5.x projects.)


\activities (Migrates all ActiveMatrix BusinessWorks 5.x projects in activities directory.)


\file <TIBCO_HOME>\5.9\examples\ftp (Migrates all ActiveMatrix BusinessWorks 5.x Projectsin File and FTP directories.)

Procedure

● In the command prompt, type the following command:bwmigrator.exe -projectDir c:/temp <BW 5.x Project Path>

For Java migration type the following command: bwmigrator.exe -projectDir c:/temp -classpath <Jar Location Path> <BW 5.x Project Path>

63


Command line Configuration File Template

The TIBCO ActiveMatrix BusinessWorks™ 6.x migration configuration file, .properties file is atemplate file that contains configurable properties to migrate design time libraries, custom XPathfunctions, selected processes and projects using the command line.

To migrate projects using the command line migration option open the .properties file and paste thecommand from the .properties file on the command prompt and execute the command which has thefollowing format as stated below:

Example: bwmigrator.exe [-data <User_Workspace>] -projectDir <BusinessWorks 6.xTarget directory> <BusinessWorks 5.x Project location> -propFile <.properties

location>

Optionally, you can also modify the path for User_Workspace. If the User_Workspace path has beenmodified, ensure that the same path is provided for BW6 Target directory.

The properties to be configured to migrate design time libraries, custom XPath functions, and selectedprocesses are explained in the tables below.

Selective Migration

Property Description

selectProcess The default value false will migrate all theprocesses.Set the property to true to migrate only thespecified processes.

selectLinkedProcess The default value false will migrate the specifiedmain process. Forexample, .process=<process1>,<process2>...Set the property to true to migrate all thedependent processes, of the specified mainprocess. For example,.process=<folder1/process1>,</process2>,. Specifying the mainprocess path will migrate all the processes that aredependent on the main process.

.process Provide comma separated processes with relativeprocess paths with respect to the ActiveMatrixBusinessWorks 5.x project root folder as explainedin the following example. .process=Service/ZipInfo-

service1.serviceagent,TestService/

getCityInfoTest.process,Service/

getCityInfoService.process,TestService/

getCityDistanceTestJMS.process,Service/

getCityDistanceService.process,TestServic

e/getCityInfoTestJMS.process,TestService/

getCityDistanceTest.process,

64


Design Time Library Migration (DTL)


sharedModule The default value of this property is false, andwill migrate the DTL as an application module.Set the property to true to create anActiveMatrix BusinessWorks 6.x shared module.

Mapping DTLs to Shared Modules


dtlDir Provide the project lib folder location here.

For example, C:/Users/workspace1/folder/BW5DTLLib.projlib.

sharedModuleDirs You can provide multiple directory locationsusing comma separated values.

For example, C:/CLIWorkspace,C:/CLIWorkspace/SharedModuleProject1,....

Custom XPath Migration


singleCXFGroupProject By default, the property is set to true, to migrateall the custom XPath functions under a singlecustom XPath function group.Set the property to false to migrate eachcustom XPath function and create custom XPathfunction groups for each individual XPathfunction.

thirdPartyCXFJarDir Provide the location of the third party JAR filesthat are referred by the custom XPath function.

Post-Migration Manual TasksIf you encounter problem markers that are related to activity input mapping, resolve these constraintsby using the Show Check and Repair and the Fix Type-Casting Errors functions.

Show Check and Repair

Procedure

1. To clear the problem markers in the migrated project, click project.bwp.

2. Click the activity in your project and click the Input tab.

3. Click the Show Check and Repair icon .The Mapper Check and Repair window displays.

65


4. Perform Check and Repair, click OK and run the project.

Fix Type-Casting Errors

To fix the construct functions errors, click the Fix Type-Casting Errors icon .

If the Project > Clean option does not work to resolve problem markers, close andreopen the project.

HTTP Basic Sample

This topic describes migrating this project from TIBCO ActiveMatrix BusinessWorks™ 5.x toActiveMatrix BusinessWorks™ 6.x.

Prerequisites

Migrate the ActiveMatrix BusinessWorks 5.x project.

Procedure

1. Click the Incoming-HTTP-request (HTTP Receiver) activity and then click the General tab.

2. In the Parameter table, change the Parameter Cardinality from Required to Optional.

3. Click the Send-Request-to-Wiki-News (Send HTTP Request) activity and specify the followingthree values on Input tab.

66


Input Type Values

RequestURI "/wiki/Main_Page"

Accept-Encoding "text/*, text/html, text/html;level=1"

Content-Type "text/html;charset=UTF-8"

4. Click the Send-Response-from-Wiki-News (Send HTTP Response) activity and specify the valuefor Content-Type on the Input tab as shown in the following image.

Custom XPath MigrationSome manual tasks need to be performed after custom XPath migration. These tasks impactDesigntime.

Design Time

The migrated custom XPath functions need to be provisioned into TIBCO ActiveMatrixBusinessWorks™ . You can do this in the following way:

67


Procedure

1. Export the custom XPath function plug-ins into the Host repository. To do this, right-click on theXPath Function Plug-in, and select Plug-in Development/Deployable Plug-ins and fragments.

2. Select Install into .host Repository and, click Finish.You are prompted to restart TIBCO Business Studio™ for BusinessWorks™ . Restart and refreshyour workspace. This results in the validation errors related to XPath functions not visible.

Custom XPath Migration Using Command line

Set the following properties to migrate custom XPath functions using thebw6migration.properties file.


singleCXFGroupProject By default, the property is set to true, andmigrates all the custom XPath functions under asingle custom XPath function group.Set the property to false to migrate eachcustom XPath function and create custom XPathfunction groups for each individual XPathfunction.

thirdPartyCXFJarDir Provide the location of the third party JAR filesthat are referred by the custom XPath function.

Migrating Design Time Libraries ( DTL) as Shared ModulesTIBCO ActiveMatrix BusinessWorks™ 5.x design time library source projects can be migrated asActiveMatrix BusinessWorks™ 6.x shared modules.

Migrating Design Time Libraries Using TIBCO Business Studio™ for BusinessWorks™

Using the ActiveMatrix BusinessWorks 6.x framework, you can migrate ActiveMatrix BusinessWorks5.x projects where the business process uses design time libraries to define the resources, subprocessesand so on.

You can migrate the design time libraries using the following options:

● Project > Migrate BW Projects option in ActiveMatrix BusinessWorks

● The command-line option

Procedure

1. In the Project Migration Wizard, click Migrate Single BusinessWorks 5.x Project and select theMigrate as Shared Module check box.

2. Provide the Project Location details and the XPATH Function Group Configuration details if acustom XPath is used in the project.

3. Click the Select Third Party JARs folder field to browse for third party jars only if your projectcontains a custom XPath.


68


Result

After migration, you can view the folder structure of the resources, including the resource, schema,wsdl, and so on that are available in the shared module under the Module Descriptors > Provides tab.

After migration, do not perform refactoring operations on any of the resources like the schema,ActiveMatrix BusinessWorks 6.x shared resources, service definitions, and so on. Theproperties, and naming conventions of the resources must be retained as they are. Mappingissues, if any, can be corrected, and resource specific properties of the shared resources can bechanged.Limitations

● Shared module migration does not support ActiveMatrix BusinessWorks 5.x AE schemas.AE Schemas are migrated as part of the application module.

● Custom XPath function project duplication should be managed manually by deleting theduplicate source projects.

● Starter processes in the DTL source projects have to be manually refactored or moved to theActiveMatrix BusinessWorks 6.x application module after all the dependent projects are alsomigrated, as ActiveMatrix BusinessWorks 6.x does not support starter processes in sharedmodules.

● DTL migration does not support the Process Name Dynamic Override feature of the CallProcess activity. To use this feature, add the process name manually.

69


Migrating Application Modules

ActiveMatrix BusinessWorks 5.x projects using design time libraries can be migrated asapplication modules by linking the corresponding shared modules to the DTL libraries.

Select the Link DTL to Shared Module check box.

Select the required DTL project, and click OK.

Mapping the DTL to the <Do Not Migrate> option will not link the DTL to the shared module.

70


Multiple DTL libraries can be linked to one shared module. After migration all the DTLlibraries refer to the same shared module to resolve resource references.

Migrating Design Time Libraries Using Command line

Design time library source projects can be migrated as shared modules using the commandline.

Set the following properties to migrate DTL projects as a shared module using thebw6migration.properties file.


sharedModule Set the property to true to create anActiveMatrix BusinessWorks 6.x shared module.

Set the property to false to migrate the DTL asan application module.

The shared module and the application module must be maintained in the sameworkspace while performing migration using the command line.

Mapping a Design Time Library to a Shared Module

Set the following properties to link a DTL library to the shared module.


dtlDir Provide the project lib folder location here. Forexample, C:/Users/workspace1/folder/BW5DTLLib.projlib.

sharedModuleDirs Provide the shared module location here. Youcan provide multiple directory locations usingcomma separated values. For example, C:/CLIWorkspace,C:/CLIWorkspace/

SharedModuleProject1,....

Using the Quick Fix Option to Resolve XSLT out of Sync ErrorsAfter migrating a project, use the Quick Fix option to resolve XSLT out of Sync errors in the project.

Prerequisites

Set the minimum JVM heap size to either 4GB, 6GB or 8GB, keeping in mind the size of the project. Foradditional instructions, see Specifying JVM Heap Size in the TIBCO ActiveMatrix BusinessWorks™Performance Benchmarking and Tuning guide .

After migrating a project, follow these steps:

Procedure

1. Turn off the Auto Build, which is enabled by default, by selecting Project > Build Automatically.

2. From the Problems tab, click the icon, and select Configure Contents.The Configure Contents window displays.

71


3. Clear the Use item limits check box and select OK.This causes all of the errors in the project to display.

4. From the Problems tab, right-click on an XSLT out of Sync error, and select Quick Fix.

5. Click Select All, and click Finish.

6. Clean the project to fix broken mappings that might have occurred. To do this, select Project >Clean....

Result

The number of XSLT out of Sync errors in the migrated project are either reduced or fully resolved.If there are a few XSLT out of Sync errors still lingering, use the Quick Fix option to resolve theseproblems. Ensure the Auto Build is turned off during this process.

72


Migration Process Outline

The migration mechanism takes TIBCO ActiveMatrix BusinessWorks™ 5.x projects and converts themto their equivalent in ActiveMatrix BusinessWorks™ 6.x.

The process flow in the project is migrated as is for the following:

● The activities and their associated mappings● The transitions and their associated conditions● Groups

ActiveMatrix BusinessWorks Project Migration

ActiveMatrix BusinessWorks 5.x Projectin TIBCO Designer

ActiveMatrix BusinessWorks 6.x Project in TIBCOBusiness Studio™ for BusinessWorks™

Process ActiveMatrix BusinessWorks 6.x Process

Schema Schema

WSDL WSDL

Shared Resource ActiveMatrix BusinessWorks 6.x Shared Resource

While migrating projects, if a project rests in a multiple folder hierarchy structure and contains WSDLs,or schemas, or both WSDLs and schemas, the folder names must be unique. If the folder names are notunique the project can run into design time issues due to incorrect namespaces and imports.

ActiveMatrix BusinessWorks Project Migration Diagram

The process flow in the project after the migration is shown in the following image. Activities,transitions, and their associated mappings visible in the ActiveMatrix BusinessWorks 5.x project in

73


TIBCO Designer are displayed in ActiveMatrix BusinessWorks 6.x project in TIBCO Business Studio forBusinessWorks.

ActiveMatrix BusinessWorks 5.x Migrated Project - Before and After

74


Frequently Asked Questions

What to do... Resolution

When migrated process shows mappingerrors? 1. Go to Menu > Project > Clean and click Clean

All Projects.

2. Go to the Activity Input with the Mapping Error.Click Show Check and Repair and fix existingerrors. Click Fix Type Casting Errors.

3. If the error still persists, check the expressionand do the necessary corrections.

When processes have unresolved WSDLreferences? 1. Close and reopen the project.

2. If this does not fix the references, then check theWSDL Interface value on the General tab of theProcess Service.

When Java Invoke activities show InputConfiguration Error after migration? 1. Go to the General tab of the Java Invoke activity

and check whether the Class Name is availablein the workspace. If available, re-select the Javaclass.

2. If the class is not available, check whether theJAR file packaging the Java class is available.Otherwise, copy the JAR file to the "lib" folderand reselect the Java class.

When activities in the Catch block showMapping errors?

The Catch Block activities does not have thevisibility to the output of the activities from themain process.

Re-map the activity input accordingly. This issimilar to the Java try or catch constructs.

When Variable not defined error forIterate Group Index variable is used outsidethe Iterate scope?

1. In TIBCO ActiveMatrix BusinessWorks™ 6.x theIterate Group Index Variable does not have thevisibility outside the Iterate scope.

2. Define a Process Variable of Type integer andmap it to the Iterate Group Index variable. Youcan now you can use this variable in the Processscope.

75


What to do... Resolution

When ActiveMatrix BusinessWorks™ 5.xactivity migrates as Empty or Rescue activityin ActiveMatrix BusinessWorks 6.x?

1. The ActiveMatrix BusinessWorks 5.x activitymigrates as Rescue activity, if the migrationframework fails to migrate.

2. Check the ActiveMatrix BusinessWorks 5.xproject and add the corresponding activity in theActiveMatrix BusinessWorks 6.x project and redothe mappings.

After migrating a project using thetib:concat-sequence-format() the outputreturns errors.

The function tib:concat-sequence-format() does notaccept string as return value for node set. Post-migration, replace tib:concat-sequence-format() withstring-join() function.

When a group is around the activities andthe xpath condition over the group is notsatisfied after migration, the error, ExpectedNon Repeating got repeating isdisplayed.

1. Verify the xpath condition and resolve issues ofthe group (eg: iterator, for-each...)

2. Re-map the same from the group.

When the Variable not defined error isdisplayed post migration for multiplevariables created in the input of any activityand each variable is created with thecondition on another variable.

1. Remove all the variables and recreate thevariables and add the mappings again. In thiscase the back-end references are also removed.

2. Delete the xpath on the variables one by one andre-correct them. This also resolves the issuesometimes.

When the error Unresolved referenceschema is displayed.

Reconfigure the broken module variables. Redo allthe mappings as they break due to reconfiguration.

When the Catch-All End error is notconfigured.

When a Catch All fault handler is used in aActiveMatrix BusinessWorks 5.x project, onmigration the fault handler is converted as expectedbut an End activity is created in place of a Catch Allactivity. An End activity without any input iscreated. Delete the end activity and to resolve theissue.

Schema references issues post migration References of schemas that are imported in anotherschema are not found. Delete the import and add itagain. The references are updated with the correctnamespace and the namespace issues will beresolved.

76


Date post:	03-Oct-2021
Category:	Documents
Upload:	others
View:	11 times
Download:	0 times

TIBCO ActiveMatrix BusinessWorks Migration

Documents