Migration

Migration
TIBCO ActiveMatrix BusinessWorks™ Migration
Software Release 6.3.1
January 2016
Two-Second Advantage®
2
Important Information
SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH
EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY
(OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE
EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY
OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE.
USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND
CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED
SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE
CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD
OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE)
OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER
LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THE
SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND
YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE
BOUND BY THE SAME.
This document contains confidential information that is subject to U.S. and international copyright laws
and treaties. No part of this document may be reproduced in any form without the written
authorization of TIBCO Software Inc.
TIBCO, 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 TIBCO
Software Inc. in the United States and/or other countries.
Enterprise Java Beans (EJB), Java Platform Enterprise Edition (Java EE), Java 2 Platform Enterprise
Edition (J2EE), and all Java-based trademarks and logos are trademarks or registered trademarks of
Oracle Corporation in the U.S. and other countries.
All other product and company names and marks mentioned in this document are the property of their
respective owners and are mentioned for identification purposes only.
THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT
ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED
AT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWARE
VERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM.
THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT.
THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL
ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE
CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO
SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S)
AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME.
THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR
INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE,
INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES.
Copyright © 2001-2016 TIBCO Software Inc. All rights reserved.
TIBCO Software Inc. Confidential Information
TIBCO ActiveMatrix BusinessWorks™ Migration
3
Contents
Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
TIBCO Documentation and Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
BusinessWorks 5 and BusinessWorks 6 Type Columns Legend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Standard Constructs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
ActiveMatrix BusinessWorks Core Constructs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Transitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Mapper . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
ActiveMatrix BusinessWorks Palettes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
General Activities Shared Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
General Activities Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
ActiveEnterprise Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Adapter Resources Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
BPEL Extension Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
File Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
FTP Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
HTTP Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
JAVA Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
JDBC Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
JMS Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Mail Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Parse Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Policy Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Process Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Rendezvous Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
REST and JSON Plug-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
RMI Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Service Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
SOAP Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
TCP Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Transaction Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
XML Palette . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Migration Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Migrating 5.x Projects to 6.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Migrating Projects Using TIBCO Business Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Migrating Projects Using Command line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Post-Migration Manual Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
TIBCO ActiveMatrix BusinessWorks™ Migration
4
HTTP Persistent Connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
HTTP Basic Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
JMS Message Selector Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
JAVA Method Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Mail with Simple Attachment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Custom XPath Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Migration Process Outline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Frequently Asked Questions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
TIBCO ActiveMatrix BusinessWorks™ Migration
5
Figures
TIBCO ActiveMatrix BusinessWorks Project Migration Diagram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
ActiveMatrix BusinessWorks 5.x Migrated Project - Before and After . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
TIBCO ActiveMatrix BusinessWorks™ Migration
6
TIBCO Documentation and Support Services
Documentation for this and other TIBCO products is available on the TIBCO Documentation site. This
site is updated more frequently than any documentation that might be included with the product. To
ensure that you are accessing the latest available help topics, please visit:
https://docs.tibco.com
Product-Specific Documentation
Documentation for TIBCO products is not bundled with the software. Instead, it is available on the
TIBCO Documentation site. To directly access documentation for this product, double-click the
following file:
TIBCO_HOME/release_notes/TIB_BW_version_docinfo.html
The following documents for this product can be found on the TIBCO Documentation site:
●
Concepts
●
Installation
●
Getting Started
●
Application Development
●
Administration
●
Bindings and Palettes Reference
●
Samples
●
Error Codes
●
API Reference
●
Migration
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 can
request one.
How to Join TIBCOmmunity
TIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts. It is a
place to share and access the collective experience of the TIBCO community. TIBCOmmunity offers
forums, blogs, and access to a variety of resources. To register, go to the following web address:
https://www.tibcommunity.com
TIBCO ActiveMatrix BusinessWorks™ Migration
7
Introduction
TIBCO ActiveMatrix BusinessWorks 6.x architecture is designed to have migration path for TIBCO
ActiveMatrix BusinessWorks 5.x projects with a few exceptions. This document explains how to
migrate from TIBCO ActiveMatrix BusinessWorks 5.x to TIBCO ActiveMatrix BusinessWorks 6.x, and
lists differences between the two. There are many new features in TIBCO ActiveMatrix BusinessWorks
6.x that advance integration, but are not covered in this document.
Migration Queries
Resolution
ActiveMatrix BusinessWorks 5.x constructs
migrating to equivalent ActiveMatrix
BusinessWorks 6.x constructs
The value Supported is mentioned in the
"Migration Support" for this category.
ActiveMatrix BusinessWorks 5.x constructs
are not migrating to ActiveMatrix
BusinessWorks 6.x because corresponding
ActiveMatrix BusinessWorks 6.x construct is
available with corresponding migration
support, but contains corner case limitations
The value Supported with Limitations is
mentioned in the "Migration Support" for this
category.
The corresponding ActiveMatrix
BusinessWorks 6.x construct are not
available, but are under consideration for
future releases
Supported does not mean defect free.
1. This means feature parity gap for ActiveMatrix
BusinessWorks 6.x compared with ActiveMatrix
BusinessWorks 5.x
2. The value BW6 Construct Under Consideration
is mentioned in the "Migration Support" for this
category
The corresponding ActiveMatrix
BusinessWorks 6.x construct is available, but
ActiveMatrix BusinessWorks 5.x to
ActiveMatrix BusinessWorks 6.x migration
extension is not available and is under
consideration for future releases
1. This means a user can create such construct
using ActiveMatrix BusinessWorks 6.x Design
Studio, but automated migration from
ActiveMatrix BusinessWorks 5.x is not yet
supported.
2. After migration, re-factor and re-create the
construct using ActiveMatrix BusinessWorks 6.x
Design Studio.
3. The value BW6 Migration Not Supported is
mentioned in the "Migration Support" for this
category.
TIBCO ActiveMatrix BusinessWorks™ Migration
8
Migration Queries
Do fundamental design improvements in
ActiveMatrix BusinessWorks 6.x renders
automated migration
Resolution
1. You can achieve better results in ActiveMatrix
BusinessWorks 6.x compared to ActiveMatrix
BusinessWorks 5.x, but only when the construct
is created in ActiveMatrix BusinessWorks 6.x
Design Studio.
2. After migration, re-factor and re-create the
construct using ActiveMatrix BusinessWorks 6.x
Design Studio.
3. The value Refactor and Recreate is mentioned in
the "Migration Support" for this category.
TIBCO ActiveMatrix BusinessWorks™ Migration
9
BusinessWorks 5 and BusinessWorks 6 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. For
example, .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 state
that you can lifecycle.
Shared Resource
Re-usable configuration that does not have a transport state
that you can lifecycle.
Process Starter Activity
1. 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 messages
or internal events.
Regular Activity
1. One of the three activity types supported by ActiveMatrix
BusinessWorks 5.x and ActiveMatrix BusinessWorks 6.x.
2. This type of activity processes its input in-memory.
Signal-in Activity
1. One of the three activity types supported by ActiveMatrix
BusinessWorks 5.x and ActiveMatrix BusinessWorks 6.x.
2. This type of activity suspends the job and waits for an
external event. When BusinessWorks runtime receives an
external event, it correlates the event base on a prescribed
key. The BusinessWorks runtime joins the external event to
the waiting job only when the prescribed key matches.
Built-in
1. An intrinsic built-in feature of ActiveMatrix BusinessWorks
process editor.
2. A built-in feature can be from an eclipse or part of the
editor feature (for example, ActiveMatrix BusinessWorks 6
Process Design Editor).
Palette
1. In ActiveMatrix BusinessWorks 5, a palette is a TIBCO
Designer concept for the grouping of resources or activities.
2. For the purpose of this documentation, a palette is for
describing a group of activities that are offered as part of
core ActiveMatrix BusinessWorks.
TIBCO ActiveMatrix BusinessWorks™ Migration
10
Values used in Type columns
Plug-in
Description
1. In ActiveMatrix BusinessWorks 5, a BusinessWorks Plug-in
is an add-on extension that contains both design-time and
runtime extensions of ActiveMatrix BusinessWorks
activities.
2. In ActiveMatrix BusinessWorks 5, a BusinessWorks Plug-in
is offered as an add-on product to ActiveMatrix
BusinessWorks.
3. For the purpose of this documentation, a plug-in is for
describing a ActiveMatrix BusinessWorks add-on product.
Binding
1. In ActiveMatrix BusinessWorks 6, binding type is offered as
a first class concept as part of activities.
2. SOAP binding and REST binding are offered as a part of
ActiveMatrix BusinessWorks 6 core features.
TIBCO ActiveMatrix BusinessWorks™ Migration
11
Standard Constructs
The supported standard ActiveMatrix BusinessWorks constructs are listed here.
BW 5.x
BW 5.x
Type
BW 6.x
BW 6.x
Type
Migration
Support
DTD
.dtd
XSD
.xsd
Supported
Comments
●
ActiveMatrix BusinessWorks
6.x currently does not
support DTD natively.
●
ActiveMatrix BusinessWorks
6.x Migration tool converts
DTD 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.
TIBCO ActiveMatrix BusinessWorks™ Migration
12
ActiveMatrix BusinessWorks Core Constructs
The following table displays the supported Core ActiveMatrix BusinessWorks constructs.
BW 5.x
Designtime
Library
BW 5.x
Type
BW 6.x
BW 6.x
Type
Migration
Support
Application
Module
Application
Module
Supported
Comments
In this version of
ActiveMatrix
BusinessWorks 6 Migration
Framework, BusinessWorks
5 Design-time Libraries are
migrated inline, as part of
regular resources in
Application Module.
If ActiveMatrix
BusinessWorks 6 developer
wants to reuse the contents
of the DT Library, the
migrated resource can be
manually re-factored into
Shared Module.
TIBCO ActiveMatrix BusinessWorks™ Migration
13
BW 5.x
Start
BW 5.x
Type
Process
Starter
Activity
BW 6.x
Service
Binding
with WSDL
Interface/
Operation +
Receive
BW 6.x
Type
Migration
Support
Service
Binding +
Process
Starter
Activity
Supported
Comments
In ActiveMatrix
BusinessWorks 5, Start and
End activities of the process
play the following roles:
●
Describing the input and
output schema of a
process which
implements a single
method.
●
Starting and ending a
process flow logically.
An ActiveMatrix
BusinessWorks 5 process as
such, has the limitation of
being able to implement
only one operation.
In ActiveMatrix
BusinessWorks 6, a process
is now able to support
implementation of multiple
interfaces and each interface
can support multiple
operations. This leads to
more flexible
implementation of process
logic.
An ActiveMatrix
BusinessWorks 5 process is
migrated to an
ActiveMatrix
BusinessWorks 6 process
with a single service
interface in one single
operation.
The Start activity is
migrated as a Receive
activity where its input and
output schema is described
in the operation input and
output, respectively. Any
exceptions thrown in
ActiveMatrix
BusinessWorks 5 process
are described as the
operation's faults.
The End activity is migrated
as a Reply activity.
TIBCO ActiveMatrix BusinessWorks™ Migration
14
BW 5.x
BW 5.x
Type
BW 6.x
BW 6.x
Type
Migration
Support
Comments
End
Regular
Activity
Service
Binding
with WSDL
Interface/
Operation +
Reply
Service
Binding +
Regular
Activity
Supported
This is same as Start
activity.
Global
Variable
.substvar
Process
Property
.substvar
Supported
Since ActiveMatrix
BusinessWorks 6 Runtime
now supports multiple
applications, it is
recommended not to use
Global Variable to describe
application configurable
properties.
Module
Property
Application
Property
Shared
Resource
Instead, there are following
three levels of properties:
●
Process Properties
●
Module Properties
●
Application Properties
These three levels of
properties are hierarchical:
Application Properties are
in the outer most scope,
followed by Module
Properties, followed by
Process Properties.
You can define and source
value from its parent scope.
For example:
1. Process Property values
can be defined by Literal
Values or source its
value from its parent
scope Module Property.
2. By the same token,
Module Property value
can be defined by Literal
Values or source from
its parent scope
Application Property.
TIBCO ActiveMatrix BusinessWorks™ Migration
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
ActiveMatrix
BusinessWorks 6
construct under
consideration
Group : Iterate
Built-In
Group : Iterate
Built-In
Supported
Group : Repeat
Until True
Built-In
Group : Repeat
Built-In
Supported
Group : Repeat
On Error Until
True
Built-In
Group : Repeat
On Error
Built-In
Supported
Group :
Transaction
Built-In
Group : Local
Transaction
Built-In
Supported
Group : Critical
Section
Built-In
Group : Critical
Section
Built-In
Supported
Group : Pick
First
Built-In
Group : Pick
First
Built-In
ActiveMatrix
BusinessWorks 6
construct under
consideration
Group : While
True
Built-In
Group : While
True
Built-In
Supported
TIBCO ActiveMatrix BusinessWorks™ Migration
16
Transitions
BW 5.x
Type
BW 6.x
BW 6.x
Type
Migration
Support
Process
Definition
.process
Process
.bwp
Supported
Project
Designer
Project
Application
Module
Application
Module
Supported
Transition
:
Built-In
Transition :
Condition
Type :
Success
Built-In
Supported
Built-In
Transition :
Condition
Type :
Success with
condition
Built-In
Supported
Built-In
Transition :
Condition
Type :
Success with
no matching
condition
Built-In
Supported
Built-In
Transition :
Condition
Type : Error
Built-In
Supported
BW 5.x
Condition
Type :
Comments
ActiveMatrix
BusinessWorks
5 .process files are
migrated as .bwp files.
Success
Transition
:
Condition
Type :
Success
with
condition
Transition
:
Condition
Type :
Success
with no
matching
condition
Transition
:
Condition
Type :
Error
TIBCO ActiveMatrix BusinessWorks™ Migration
17
Mapper
BW 5.x
XPATH
XSLT
BW 5.x
Type
BW 6.x
XPATH
in
Designer
Mapper
XPATH
XSLT in
Designer
Mapper
XSLT
BW 6.x
Type
Migration
Support
XPATH in
Eclipse
Mapper
Supported
Comments
XPATH support in
ActiveMatrix BusinessWorks
5.x is limited to XPATH 1.0.
ActiveMatrix BusinessWorks
6.x supports XPATH 2.0. For
example, all literal values
used in XPATH 2.0 must have
a corresponding constructor
function around the literal
value.
XSLT in
Eclipse
Mapper
Supported
XSLT support in ActiveMatrix
BusinessWorks 5.x is limited
to XSLT 1.0.
ActiveMatrix BusinessWorks
6.x supports XSLT 2.0.
TIBCO ActiveMatrix BusinessWorks™ Migration
18
ActiveMatrix BusinessWorks Palettes
General Palette
BW 5.x
Alias
Library
BW 5.x
Type
Shared
Configurati
on
BW 6.x
Application
Module
with Java
Nature or
Eclipse
Java PlugIn Project
BW 6.x
Type
Migration
Support
Eclipse
Plug-in
Project
Supported
Comments
In ActiveMatrix
BusinessWorks 5.x, the
Alias Library construct is
used for describing or
configuring the external
JARs used by an
ActiveMatrix
BusinessWorks 5.x
application Java activities.
The Migration Tool adds
the user JAR files to the
ActiveMatrix
BusinessWorks
application module.
During migration you can
input the JAR files by
selecting the Add External
JARs check box and
configuring the file path to
the JARs.
1. Migration framework
goes over the alias
libraries and adds the
JARs present at the
alias library path to the
lib folder. If the JARs
are not present,
manually select the
JARs.
2. For the Append or
Prepend path, the JARs
need to be consolidated
and then the top level
folder should be
provided as the input
to the Migration tool.
This brings all the JARs
to the lib folder.
TIBCO ActiveMatrix BusinessWorks™ Migration
19
BW 5.x
BW 5.x
Type
BW 6.x
Type
Migration
Support
Enterprise
Archive
Resource
Shared
Configurati
on
ActiveMatr
ix
BusinessW
orks 6
Application
Eclipse
Plug-in
Project
Supported
Folder
Generic
Resource
Folder
Eclipse
Folder
Supported
Generic
Image
Resource
Generic
Resource
Identity
Shared
Configurati
on
Identity
Shared
Configurat
ion
Supported
Library
Builder
.projlib
Shared
Module
Eclipse
Plug-in
Project
Supported
Task List
.taskList
Task List
.taskLis
BW 6
Construct
Under
Consideratio
n
BW 6.x
.txt
The ActiveMatrix
BusinessWorks 5.x project
is migrated as Application
Module and a single
ActiveMatrix
BusinessWorks 6.x
Application project is
created.
Generic
Resource
t
Text
Document
Comments
Text
Document
Supported
.txt
General Activities Shared Resources
ActiveMatrix BusinessWorks 5.x: General Activities Shared Resources
Type: Palette
ActiveMatrix BusinessWorks 6.x: Shared Resources Wizards
Type: Shared Resources
BW 5.x
Custom
Activity
BW 5.x
Type
Shared
Configurati
on
BW 6.x
Custom
Activity
BW 6.x
Type
Migration
Support
Shared
Configurati
on
BW 6
Construct
Under
Considerat
ion
Comments
TIBCO ActiveMatrix BusinessWorks™ Migration
20
BW 5.x
BW 5.x
Type
BW 6.x
BW 6.x
Type
Migration
Support
JNDI
Configurati
on
Shared
Configurati
on
JNDI
Configurati
on
Shared
Configurati
on
Supported
Job Shared
Variable
Shared
Configurati
on
Module :
Job Shared
Variable
Shared
Configurati
on
Supported
Lock Object
Shared
Configurati
on
Module :
Job Shared
Variable
Shared
Configurati
on
Supported
Comments
In ActiveMatrix
BusinessWorks 5.x, Lock
Object is used together
with Group with Critical
Section. This construct is
also supported for cross
engines critical section.
In ActiveMatrix
BusinessWorks 6.x, Group
with Critical Section is
configured with Module
Shared Variable. In
ActiveMatrix
BusinessWorks 6.x Design
Studio, module shared
variables are configured
through Module
Descriptors > Shared
Variables editor. This
construct is also
supported for AppSpace
with multiple AppNodes
in ActiveMatrix
BusinessWorks 6.x, if the
AppSpace is configured
with Engine Group active/
active configuration.
Migration Tool migrates
the ActiveMatrix
BusinessWorks 5.x Lock
Object as a Module
Shared Variable and
Group with Critical
Section.
Notify
Configurati
on
Shared
Configurati
on
Process :
WSDL/
Interface/
Operation
Shared
Configurati
on
Supported
See Notify activity for
details.
TIBCO ActiveMatrix BusinessWorks™ Migration
21
BW 5.x
BW 5.x
Type
Shared
Variable
Shared
Resource
BW 6.x
Module :
Module
Shared
Variable
Type:
Shared
Resource
BW 6.x
Type
Migration
Support
Shared
Resource
Yes
Comments
ActiveMatrix
BusinessWorks 5.x shared
variable with multiengine option is now a
Module Shared Variable
with Persistent option.
General Activities Palette
ActiveMatrix BusinessWorks 5.x: General Activities Palette
Type: Palette
ActiveMatrix BusinessWorks 6.x: General Activities Palette
Type: Palette
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Assign
Regular
Activity
Basic : Assign
Regular
Activity
Supported
Call Process
Regular
Activity
Basic : Invoke
Process +
Reference
Binding
Regular
Activity +
Binding Type
Supported
Catch
Regular
Activity
Scope with
Catch Block
Built-in
Supported
Checkpoint
Regular
Activity
Checkpoint
Regular
Activity
Supported
Confirm
Regular
Activity
Confirm
Regular
Activity
Supported
Engine
Command
Regular
Activity
Engine
Command
Regular
Activity
BW 6
Construct
Under
Considerati
on
External
Command
Regular
Activity
External
Command
Regular
Activity
Supported
Generate
Error
Regular
Activity
Basic : Throw
Regular
Activity
Supported
Comments
TIBCO ActiveMatrix BusinessWorks™ Migration
22
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Get Shared
Variable
Regular
Activity
Get Shared
Variable
Regular
Activity
Supported
Inspector
Regular
Activity
Inspector
Regular
Activity
Supported
Label
Diagram
Notation
Note
Diagram
Notation
Supported
Mapper
Regular
Activity
Mapper
Regular
Activity
Supported
Comments
TIBCO ActiveMatrix BusinessWorks™ Migration
23
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Notify
Regular
Activity
Invoke
Process
Regular
Activity
Migration
Support
ActiveMatri
x
BusinessWo
rks 6
Migration
Not
Supported
Comments
In ActiveMatrix
BusinessWorks
5.x, Notify,
Receive
Notification,
and Wait
activities are
used for interprocess
communication.
In ActiveMatrix
BusinessWorks
6.x, a process
now supports
interface with
multiple
operations.
These operations
can be used for
inter-process
communication.
ActiveMatrix
BusinessWorks
6.x Migration
Tool currently
does not migrate
Notification
Configuration
shared resource,
Notify, Receive
Notification,
and Wait
constructs to
ActiveMatrix
BusinessWorks
6.x. After
migrating the
ActiveMatrix
BusinessWorks
5.x project, you
can manually
add operations
to processes that
need to receive
notification or
wait for
notification. The
Notify activity is
then replaced by
the Invoke
Process.
TIBCO ActiveMatrix BusinessWorks™ Migration
24
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Migration
Support
Comments
When the Notify
or Receive
Notification and
Wait activities
are used for
multiple
processes
waiting to
receive
notification, you
can use a JMS
transport with
topic to achieve
the same
publish/
subscribe
pattern.
Null
Regular
Activity
On Error
Process
Starter
Activity
BW 6
Construct
Under
Considerati
on
On Event
Timeout
Process
Starter
Activity
BW 6
Construct
Under
Considerati
on
On
Notification
Timeout
Process
Starter
Activity
BW 6
Construct
Under
Considerati
on
On Shutdown
Process
Starter
Activity
Type:
Basic : Empty
Activator
Process
Regular
Activity
Process
Supported
Supported
Process with a
special
ActiveMatrix
BusinessWorks
6.x defined
service that
supports an
operation for
onShutdown
functionality.
This process can
be configured
per application.
TIBCO ActiveMatrix BusinessWorks™ Migration
25
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Migration
Support
On Startup
Process
Starter
Activity
Activator
Process
Process
Supported
Process with a
special
ActiveMatrix
BusinessWorks
6.x defined
service that
supports an
operation for
onStartup an be
configured per
application.
Receive
Notification
Process
Starter
Activity
Basic : Receive
Process
Starter
Activity
Supported
See Notify
activity for
details.
Rethrow
Regular
Activity
Basic :
Rethrow
Regular
Activity
Supported
Set Shared
Variable
Regular
Activity
Set Shared
Variable
Regular
Activity
Supported
Sleep
Regular
Activity
Sleep
Regular
Activity
Supported
Timer
Regular
Activity
Timer
Regular
Activity
Supported
Wait
Signal-In
Activity
Receive
Process
Starter
Supported
Write To Log
Regular
Activity
Log
Regular
Activity
Supported
Comments
See Notify
activity for
details.
ActiveEnterprise Palette
ActiveMatrix BusinessWorks 5.x: ActiveEnterprise Palette
Type: Palette
ActiveMatrix BusinessWorks 6.x: ActiveEnterprise Plug-in
Type: Plug-in
In ActiveMatrix BusinessWorks, ActiveEnterprise palette is not bundled out-of-the-box. You must
install the Adapter Framework Pack as an add-on Plug-in.
TIBCO ActiveMatrix BusinessWorks™ Migration
26
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x type
Adapter
RequestResponse Server
Process Starter
Activity
Adapter RequestResponse Server
Process Starter
Activity
Supported
Adapter
Subscriber
Process Starter
Activity
Adapter
Subscriber
Process Starter
Activity
Supported
Invoke an
Adapter Request
response Service
Request/Reply
Activity
Invoke an
Adapter Request
response Service
Request/Reply
Activity
Supported
Publish to
Adapter
Regular Activity
Publish to
Adapter
Regular Activity
Supported
Respond to
Adapter Request
Regular Activity
Respond to
Adapter Request
Regular Activity
Supported
Send Exception
to Adapter
Request
Regular Activity
Send Exception to
Adapter Request
Regular Activity
Supported
Wait for Adapter
Message
Signal-In Activity
Wait for Adapter
Message
Signal-In Activity
Supported
Wait for Adapter
Request
Signal-In Activity
Wait for Adapter
Request
Signal-In Activity
Supported
Adapter Resources Palette
ActiveMatrix BusinessWorks 5.x: Adapter Resources Palette
Type: Palette
ActiveMatrix BusinessWorks 6.x: Adapter Resources Plug-in
Type: Plug-in
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Generic
Adapter
Configuratio
n
Shared
Configuratio
n
Generic
Adapter
Configuration
Shared
Configuration
Supported
Message
Filter
Adapter
Specific
Resource
Message Filter
Adapter
Specific
Resource
Supported
TIBCO ActiveMatrix BusinessWorks™ Migration
27
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Adapter
Archive
Adapter
Specific
Resource
Adapter
Archive
Adapter
Specific
Resource
Supported
Advisory
Adapter
Specific
Resource
Advisory
Adapter
Specific
Resource
Supported
Client
Adapter
Specific
Resource
Client
Adapter
Specific
Resource
Supported
Generic Log
Sink
Adapter
Specific
Resource
Generic Log
Sink
Adapter
Specific
Resource
Supported
Generic
Transaction
Control Pool
Adapter
Specific
Resource
Generic
Transaction
Control Pool
Adapter
Specific
Resource
Supported
Generic
Session
Adapter
Specific
Resource
Generic
Session
Adapter
Specific
Resource
Supported
Load URL
Adapter
Specific
Resource
Load URL
Adapter
Specific
Resource
Supported
Log Sink
Role
Adapter
Specific
Resource
Log Sink Role
Adapter
Specific
Resource
Supported
Publication
Service
Adapter
Specific
Resource
Publication
Service
Adapter
Specific
Resource
Supported
Publisher
Adapter
Specific
Resource
Publisher
Adapter
Specific
Resource
Supported
RequestResponse
Invocation
Service
Adapter
Specific
Resource
RequestResponse
Invocation
Service
Adapter
Specific
Resource
Supported
RequestResponse
Service
Adapter
Specific
Resource
RequestResponse
Service
Adapter
Specific
Resource
Supported
TIBCO ActiveMatrix BusinessWorks™ Migration
28
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Server
Adapter
Specific
Resource
Server
Adapter
Specific
Resource
Supported
Subscriber
Adapter
Specific
Resource
Subscriber
Adapter
Specific
Resource
Supported
Subscription
Service
Adapter
Specific
Resource
Subscription
Service
Adapter
Specific
Resource
Supported
Timer
Adapter
Specific
Resource
Timer
Adapter
Specific
Resource
Supported
BPEL Extension Palette
BW 5.x
BW 5.x
Type
BW 6.x
Orchestration
Process
.orchestratio
n
Built-In :
Process
BW 6.x
Type
Migration
Support
.bwp
Supported
Comments
The .orchestration
resource is available
from BPEL Palette.
ActiveMatrix
BusinessWorks
Process is natively
based on BPEL.
Assign
Regular
Activity
Basic: Assign
Regular
Activity
Supported
Catch
Regular
Activity
Scope with
Catch Block
Built-In
Supported
Checkpoint
Regular
Activity
General
Activities:
Checkpoint
Regular
Activity
Supported
Exit
Regular
Activity
Basic: Exit
Regular
Activity
Supported
Invoke
Regular
Activity
Basic: Invoke
Regular
Activity
Supported
TIBCO ActiveMatrix BusinessWorks™ Migration
29
BW 5.x
BW 5.x
Type
BW 6.x
Type
Migration
Support
Invoke
Process
Regular
Activity
General
Activities :
Invoke
Process +
Reference
Binding
Regular
Activity
Supported
Null
Regular
Activity
Basic: Empty
Regular
Activity
Supported
On Alarm
Process
Starter
Activity
Built-In:
Alarm
Handler
Built-In
BW6
Construct
Under
Considerati
on
On Event
Process
Starter
Activity
Built-In:
Event
Handler
Built-In
Supported
Receive
Starter
Process
Starter
Activity
Basic:
Receive
(Create
Instance =
true)
Process
Starter
Activity
Supported
BW 6.x
Comments
Type:
Process
Starter
Activity
Receive
Signal-In
Activity
Basic:
Receive
(Create
Instance =
false)
Signal-In
Activity
Supported
Reply with
Fault
Regular
Activity
Basic : Reply
with Fault
configured
Regular
Activity
Supported
Reply
Regular
Activity
Basic: Reply
Regular
Activity
Supported
Rethrow
Regular
Activity
Basic:
Rethrow
Regular
Activity
Supported
Sleep
Regular
Activity
General
Activities:
Sleep
Regular
Activity
Supported
TIBCO ActiveMatrix BusinessWorks™ Migration
30
BW 5.x
BW 5.x
Type
BW 6.x
BW 6.x
Type
Migration
Support
Throw
Regular
Activity
Basic: Throw
Regular
Activity
Supported
Write To Log
Regular
Activity
General
Activities:
Log
Regular
Activity
Supported
Comments
File Palette
ActiveMatrix BusinessWorks 5.x: File Palette
Type: Palette
ActiveMatrix BusinessWorks 6.x: File Palette
Type: Palette
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Copy File
Regular
Activity
Copy File
Regular
Activity
Supported
Create File
Regular
Activity
Create File
Regular
Activity
Supported
File Poller
Process
Starter
Activity
File Poller
Process Starter
Activity
Supported
List Files
Regular
Activity
List Files
Regular
Activity
Supported
Read File
Regular
Activity
Read File
Regular
Activity
Supported
Remove File
Regular
Activity
Remove File
Regular
Activity
Supported
Rename File
Regular
Activity
Rename File
Regular
Activity
Supported
Wait for File
Change
Signal-In
Activity
Wait for File
Change
Signal-In
Activity
Supported
Write File
Regular
Activity
Write File
Regular
Activity
Supported
Comments
TIBCO ActiveMatrix BusinessWorks™ Migration
31
FTP Palette
ActiveMatrix BusinessWorks 5.x: FTP
Type: Palette
ActiveMatrix BusinessWorks 6.x: FTP Palette
Type: Palette
BW 5.x
BW 5.x
Type
FTP
Connection
Migration
Support
BW 6.x
BW 6.x Type
Shared
Resource
FTP Connection
Type: Shared
Resource
Shared
Resource
Supported
FTP Change
Default
Directory
Regular
Activity
FTP Change
Default
Directory
Regular
Activity
Supported
FTP Delete
File
Regular
Activity
FTP Delete File
Type: Regular
Activity
Regular
Activity
Supported
FTP Dir
Regular
Activity
FTP Dir
Regular
Activity
Supported
FTP Get
Default
Directory
Regular
Activity
FTP Get Default
Directory
Regular
Activity
Supported
FTP Get
Regular
Activity
FTP Get
Regular
Activity
Supported
FTP Make
Remote
Directory
Regular
Activity
FTP Make
Remote
Directory
Regular
Activity
Supported
FTP Put
Regular
Activity
FTP Put
Regular
Activity
Supported
FTP Quote
Regular
Activity
FTP Quote
Regular
Activity
Supported
FTP Remove
Remote
Directory
Regular
Activity
FTP Remove
Remote
Directory
Regular
Activity
Supported
FTP Rename
File
Regular
Activity
FTP Rename
File
Regular
Activity
Supported
FTP Sys
Type
Regular
Activity
FTP Sys Type
Regular
Activity
Supported
Comments
TIBCO ActiveMatrix BusinessWorks™ Migration
32
HTTP Palette
ActiveMatrix BusinessWorks 5.x: HTTP
Type: Palette
ActiveMatrix BusinessWorks 6.x: HTTP Palette
Type: Palette
BW 5.x
BW 5.x
Type
BW 6.x
BW 6.x
Migration
Support
HTTP
Connection
Shared
Resource
HTTP
Connector
Shared
Resource
Supported
Comments
HTTP Connection
shared resource is
migrated to
ActiveMatrix
BusinessWorks 6.x as an
HTTP Connector
shared resource. This is
for the HTTP Service
side.
ActiveMatrix
BusinessWorks uses
Jetty Server and does
not support Tomcat and
HttpComponent
implementation from
ActiveMatrix
BusinessWorks 5.x.
Proxy
Configurati
on
Shared
Resource
Proxy
Configuratio
n
Shared
Resource
Supported
HTTP
Receiver
Process
Starter
HTTP
Receiver
Process
Starter
Supported
TIBCO ActiveMatrix BusinessWorks™ Migration
33
BW 5.x
BW 5.x
Type
BW 6.x
BW 6.x
Send HTTP
Request
Regular
Activity
Send HTTP
Request
Regular
Activity
Migration
Support
Supported
Comments
ActiveMatrix
BusinessWorks 6.x has
also introduced a new
shared resource for this
client side invoke,
HTTP Client shared
resource. You can use
this shared resource to
configure and tune a
number of optimization
parameters such as
Maximum Total
Connection and
Maximum Total
Connection Per Host.
This new HTTP Client
shared resource also
allows the users to
configure a Thread Pool
shared resource ( new in
ActiveMatrix
BusinessWorks 6.x).
Using the Thread Pool
shared resource you can
configure Minimum
Pool Size, Maximum
Pool Size and a number
of other tuning
parameters.
Send HTTP
Response
Regular
Activity
Send HTTP
Response
Regular
Activity
Supported
Wait For
HTTP
Request
Signal-In
Activity
Wait For
HTTP
Request
Signal-In
Activity
Supported
JAVA Palette
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 BusinessWorks
application module gets converted to a Java project. You see additional src and lib folders in the
project. The src folder contains the Java source files. The lib folder contains the Java libraries (JAR
Files). The project also gets added with the Java Nature.
TIBCO ActiveMatrix BusinessWorks™ Migration
34
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x
Comments
Java
Custom
Function
Shared
Configuratio
n
Custom
XPATH
Function
Shared
Configurati
on
Supported
Java Global
Instance
Shared
Resource
Java Global
Instance
Shared
Resource
Supported
Java Schema
Shared
Configuratio
n
XSD
Schema
.xsd
Supported
In ActiveMatrix
BusinessWorks 6.x
the Java To XML and
XML To Java
activities do not use
Java Schema. After
migration the
corresponding
Schema equivalent to
the Java Schema is
generated and
associated with the
activity.
Java Code
Regular
Activity
Java Invoke
Regular
Activity
Supported
The source code for
the Java Code
activity which was
in-lined in the
ActiveMatrix
BusinessWorks 5.x
now gets created
externally in the src
folder of the
AppModule and then
it is referred by the
Java Invoke activity
with MultiOutput
check box selected.
TIBCO ActiveMatrix BusinessWorks™ Migration
35
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x
Java Event
Source
Process
Starter
Activity
Java
Process
Starter
Process
Starter
Activity
Supported
Comments
The Source code for
Java Event Source
activity which was
in-lined in the
ActiveMatrix
BusinessWorks 5.x
now gets created
externally in the src
folder of the
AppModule and then
Java Process Starter
activity refers to it.
The Java class
implementing the
Java Event Source
now extends
com.tibco.bw.pale
tte.shared.java.J
avaProcessStarter
class instead of
com.tibco.plugin.
java.JavaProcessS
tarter.
Java Event Source in
ActiveMatrix
BusinessWorks 5.x
referring to an
external class needs
to change this.
Java
Method
Regular
Activity
Java Invoke
Regular
Activity
Supported
Java To
XML
Regular
Activity
Java To
XML
Regular
Activity
Supported
XML To
Java
Regular
Activity
XML To
Java
Regular
Activity
Supported
JDBC Palette
ActiveMatrix BusinessWorks 5.x: JDBC
Type: Palette
ActiveMatrix BusinessWorks 6.x: JDBC Palette
Type: Palette
TIBCO ActiveMatrix BusinessWorks™ Migration
36
BW 5.x
BW 5.x
Type
BW 6.x
BW 6.x Type
Migration
Support
JDBC
Connection
Shared
Resource
JDBC
Connection
Shared
Resource
Supported
JDBC Call
Procedure
Regular
Activity
JDBC Call
Procedure
Regular
Activity
Supported
JDBC Get
Connection
Regular
Activity
JDBC Get
Connection
Regular
Activity
BW6
Construct
Under
Consideratio
n
JDBC Query
Regular
Activity
JDBC Query
Regular
Activity
Supported
JDBC Update
Regular
Activity
JDBC
Update
Regular
Activity
Supported
SQL Direct
Regular
Activity
SQL Direct
Regular
Activity
Supported
Comments
JMS Palette
ActiveMatrix BusinessWorks 5.x: JMS Palette
Type: Palette
ActiveMatrix BusinessWorks 6.x: JMS Palette
Type: Palette
BW 5.x
BW 5.x
Type
BW 6.x
BW 6.x
Type
Migration
Support
JMS
Application
Properties
Shared
Configurati
on
XSD Schema
.xsd
Supported
JMS
Connection
Shared
Resource
JMS
Connection
Shared
Resource
Supported
Get JMS
Queue
Message
Regular
Activity
Get JMS
Queue
Message
Regular
Activity
Supported
JMS Queue
Receiver
Process
Starter
Activity
JMS Receive
Message
Process
Starter
Activity
Supported
Comments
JMS Application
Properties is migrated
as XML Schema (XSD
File) in ActiveMatrix
BusinessWorks 6.x.
TIBCO ActiveMatrix BusinessWorks™ Migration
37
BW 5.x
BW 5.x
Type
BW 6.x
BW 6.x
Type
Migration
Support
JMS Queue
Requester
Regular
Activity
JMS Request
Reply
Regular
Activity
Supported
JMS Queue
Sender
Regular
Activity
JMS Send
Message
Regular
Activity
Supported
JMS Topic
Publisher
Regular
Activity
JMS Send
Message
Regular
Activity
Supported
Regular
Activity
Supported
Type:
Regular
Activity
JMS Topic
Requestor
Comments
Type:
Regular
Activity
Regular
Activity
Type:
Regular
Activity
JMS Request
Reply
Type:
Regular
Activity
JMS Topic
Subscriber
Process
Starter
Activity
JMS Receive
Message
Process
Starter
Activity
Supported
Reply to
JMS
Message
Regular
Activity
Reply to JMS
Message
Regular
Activity
Supported
Type:
Regular
Activity
Type:
Regular
Activity
Wait for
JMS Queue
Message
Signal-In
Activity
Wait for JMS
Message
Signal-In
Activity
Supported
Wait for
JMS Topic
Message
Signal-In
Activity
Wait for JMS
Message
Signal-In
Activity
Supported
Mail Palette
ActiveMatrix BusinessWorks 5.x: Mail Palette
Type: Palette
ActiveMatrix BusinessWorks 6.x: Mail Palette
Type: Palette
TIBCO ActiveMatrix BusinessWorks™ Migration
38
BW 5.x
BW 5.x
Type
BW 6.x
BW 6.x
Type
Migration
Support
Receive
Mail
Process
Starter
Activity
Receive Mail
Process
Starter
Activity
Supported
Send Mail
Regular
Activity
Send Mail
Regular
Activity
Supported
Comments
ActiveMatrix
BusinessWorks 6.x
introduces a new SMTP
shared resource.
ActiveMatrix
BusinessWorks 5.x Send
Mail activity
configuration migrates
to both Send Mail
activity and SMTP
shared resource.
Parse Palette
ActiveMatrix BusinessWorks 5.x: Parse Palette
Type: Palette
ActiveMatrix BusinessWorks 6.x: Parse Palette
Type: Palette
BW 6.x
Type
Migration
Support
Data Format
Shared
Configuratio
n
Supported
Regular
Activity
Parse Data
Regular
Activity
Supported
Regular
Activity
Render Data
Regular
Activity
Supported
BW 5.x
BW 5.x Type
BW 6.x
Data Format
Shared
Configuration
Parse Data
Render Data
Comments
Policy Palette
ActiveMatrix BusinessWorks 5.x: Policy Palette
Type: Palette
TIBCO ActiveMatrix BusinessWorks™ Migration
39
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Security
Policy
Association
Shared
Configuration
Security
Policy
Association
Shared
Configuratio
n
BW 6
Construct
Under
Consideration
Security
Policy
Shared
Configuration
Security
Policy
Shared
Configuratio
n
BW Construct
Under
Consideration
Comments
Process Palette
ActiveMatrix BusinessWorks 5.x: Process Palette
Type: Palette
ActiveMatrix BusinessWorks 6.x: Built-In
Type: Built-In
BW 5.x
Process
Definition
BW 5.x
Type
BW 6.x
BW 6.x
Type
Migration
Support
.process
Process
.bwp
Supported
Comments
TIBCO ActiveMatrix BusinessWorks™ Migration
40
BW 5.x
Process
Archive
BW 5.x
Type
Shared
Configur
ation
BW 6.x
Applicati
on Project
BW 6.x
Type
Migration
Support
.applicat
Refactor
and
Recreate
ion
Comments
In ActiveMatrix
BusinessWorks 5.x, Process
Archive is configured within
the Enterprise Archive
Resource. This specifies which
processes in the ActiveMatrix
BusinessWorks 5.x project are
to be packaged to form an EAR
file for deployment.
In ActiveMatrix
BusinessWorks 6.x, the
Enterprise Archive Resource
and Process Archive
configuration are no longer
supported and their
functionality are replaced by
Application and Application
Module, respectively. Any
project artifacts that can be reused by multiple Applications
and multiple Application
Modules are to be created in
Shared Modules.
In the current version of
Migration Tool, an
ActiveMatrix BusinessWorks
5.x project is migrated as an
application module with a
corresponding application
project. If the content of the
ActiveMatrix BusinessWorks
5.x project is meant for creating
multiple applications, then do
the following:
1. Convert the Application
Module to Shared Module.
2. Create an Application
Module and a
corresponding application
project.
a.
In the Application
Module > Module
Descriptors >
Components editor,
define the component
to refer to process
implementation in the
Shared Module.
TIBCO ActiveMatrix BusinessWorks™ Migration
41
BW 5.x
BW 5.x
Type
BW 6.x
BW 6.x
Type
Migration
Support
Comments
b.
Repeat 2.a step for each
process that is needed
to be a part of this
Application Module.
Note: In ActiveMatrix
BusinessWorks 6.x, a
Process (such as
Process A) in a Shared
Module is not activated
unless a Component is
defined and is
configured with
Process A .
3. Repeat Step 2 for the
number of applications
required.
Rendezvous Palette
ActiveMatrix BusinessWorks 5.x: Rendezvous Palette
Type: Palette
ActiveMatrix BusinessWorks 6.x: Rendezvous Palette
Type: Palette
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Rendezvous
Transport
Shared
Resource
Rendezvous
Transport
Shared
Resource
Supported
Publish
Rendezvous
Message
Regular
Activity
Rendezvous
Publisher
Regular
Activity
Supported
Rendezvous
Subscriber
Process
Starter
Activity
Rendezvous
Subscriber
Process
Starter
Activity
Supported
Reply To
Rendezvous
Request
Regular
Activity
Rendezvous
Reply To
Request
Regular
Activity
Supported
Send
Rendezvous
Request
Regular
Activity
Rendezvous
Request
Reply
Regular
Activity
Supported
Comments
TIBCO ActiveMatrix BusinessWorks™ Migration
42
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Wait for
Rendezvous
Message
Signal-In
Activity
Wait for
Rendezvous
Message
Signal-In
Activity
Migration
Support
Comments
Supported
REST and JSON Plug-in
ActiveMatrix BusinessWorks 5.x: REST/JSON Plug-in
Type: Plug-in
ActiveMatrix BusinessWorks 6.x: REST and JSON Palette
Type: Palette
Migration: Supported
BW 5.x
BW 5.x
Type
BW 6.x
BW 6.x Type
Invoke REST
API
Regular
Activity
Invoke REST
API
Regular
Activity
Parse JSON
Regular
Activity
Parse JSON
Regular
Activity
Migration
Support
Supported
with
Limitations
Supported
with
Limitations
Comments
ActiveMatrix
BusinessWorks
6 does not
support the
following:
●
WADL
protocols
●
Responses
returned in
binary
format
●
Rich output
●
Authenticati
on OAuth1.0
and
OAuth2.0
ActiveMatrix
BusinessWorks
6 does not
support the
schema type
Java Classes.
TIBCO ActiveMatrix BusinessWorks™ Migration
43
BW 5.x
Render JSON
BW 5.x
Type
Regular
Activity
BW 6.x
BW 6.x Type
Render JSON
Regular
Activity
Migration
Support
Supported
with
Limitations
Comments
Remove Root
check box is not
supported in
ActiveMatrix
BusinessWorks
6. Root elements
in
BusinessWorks
6 are skipped by
default. You will
need to modify
the input JSON
if it contains
root element.
The schema
type Java
Classes is not
supported in
ActiveMatrix
BusinessWorks
6.
TIBCO ActiveMatrix BusinessWorks™ Migration
44
BW 5.x
REST
Dispatch and
Reply
BW 5.x
Type
BW 6.x
BW 6.x Type
Regular
Activity
REST Service
Binding
Service
Binding
Migration
Support
Supported
with
Limitations
Comments
This
ActiveMatrix
BusinessWorks
5 Dispatch and
Reply REST
activity is
migrated to
REST Service
Binding of
ActiveMatrix
BusinessWorks
6.
REST Service of
ActiveMatrix
BusinessWorks
6 uses XSD as
the resource for
building REST
Service. The
XSD must be
external to the
WSDL. That is,
direct reference
to inline schema
in WSDL is not
supported for
REST binding.
If the Dispatch
and Reply
activity is
configured to
route requests to
ActiveMatrix
BusinessWorks
5 processes with
inline schema
for its input,
output and
fault, then the
ActiveMatrix
BusinessWorks
6 Migration Tool
currently does
not externalize
the inline
schema before
configuring the
REST binding.
You can
manually
externalize the
TIBCO ActiveMatrix BusinessWorks™ Migration
45
BW 5.x
BW 5.x
Type
BW 6.x
BW 6.x Type
Migration
Support
Comments
inline schema
and re-create the
REST binding.
ActiveMatrix
BusinessWorks
6 also does not
support the
following:
●
Enable
WADL
Reference
●
Enable
OAuth
●
Parameter
stylesTemplate
and Header
For additional restrictions refer to Restrictions on XML Schema in TIBCO ActivemMatrix BusinessWorks
Bindings and Palettes Reference.
RMI Palette
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Comments
RMI Lookup
Regular
Activity
RMI Lookup
Regular
Activity
BW6 Construct
Under
Consideration
None
RMI Server
Process
Starter
RMI Server
Process
Starter
BW6 Construct
Under
Consideration
None
Service Palette
ActiveMatrix BusinessWorks 5.x: Service Palette
Type: Palette
ActiveMatrix BusinessWorks 6.x: Built-In
Type: Built-In
Migration: Supported
TIBCO ActiveMatrix BusinessWorks™ Migration
46
BW 5.x
Type
BW 6.x
BW 6.x Type
Migration
Support
Context
Resource
.contextRe
XSD File
.xsd
Supported
Partner Link
Configuratio
n
.sharedpar
Process :
Reference
Built-In
Supported
Service
.serviceag
Process :
Service
Built-In
Supported
ent
Get Context
Regular
Activity
Basic : Get
Context
Regular
Activity
BW 6
Migration Not
Supported
Invoke
Partner
Regular
Activity
Basic :
Invoke
Service
Regular
Activity
Supported
Receive
Partner
Notification
Process
Starter
Activity
Basic :
Receive
Process
Starter
Activity
Supported
BW 5.x
source
tner
Comments
ActiveMatrix
BusinessWorks 6
uses regular XSD
for defining
Context Shared
Resource, which is
equivalent to
ActiveMatrix
BusinessWorks
5 .contextResour
ce.
The Service
Resource is
migrated as a
process with
service and a
SOAP service
binding is added
for the same. The
binding is added
under Module
Descriptors >
Components >
Binding.
SOAP Request
Reply activity is
migrated as a
process with
reference and
SOAP reference
binding is added
for the same. The
binding is added
under Module
Descriptors >
Components >
Binding.
TIBCO ActiveMatrix BusinessWorks™ Migration
47
BW 5.x
Set Context
BW 5.x
Type
BW 6.x
BW 6.x Type
Regular
Activity
Basic : Set
Context
Regular
Activity
Context
Support
Migration
Support
Comments
BW 6
Migration Not
Supported
Refactor and
Recreate
SOAP
Headers
(Bound ,
Unbound,
Undescribed)
SOAP
Attachments
(SwA and
MTOM)
SOAP
Security
SOAP Palette
ActiveMatrix BusinessWorks 5.x: SOAP Palette
Type: Palette
ActiveMatrix BusinessWorks 6.x: Basic Palette + SOAP Binding
Type: Binding
Migration: Supported
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
MIME Parser
Regular
Activity
Parse : MIME
Parser
Regular
Activity
BW6 Construct
Under
Consideration
Retrieve
Resources
Regular
Activity
Generate
WSDL
Service
Regular
Activity +
SOAP Binding
BW6 Construct
Under
Consideration
Comments
The WSDL in
BW6 has to be
generated in
the
BusinessWork
s Design
Studio on the
Component
Binding.
TIBCO ActiveMatrix BusinessWorks™ Migration
48
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Comments
SOAP Event
Source
Process
Starter
Activity
Basic :
Receive +
SOAP Service
Binding
Process Starter
Activity +
SOAP Binding
Supported
The SOAP
Event Source
is migrated as
a Process with
Service and a
SOAP Service
Binding is
added for the
same. The
Binding is
added under
Module
Descriptors/
Components/
Binding.
SOAP
Request
Reply
Regular
Activity
Basic : Invoke
Service +
SOAP
Reference
Binding
Regular
Activity +
SOAP Binding
Supported
The SOAP
Request Reply
is migrated as
a Process with
Reference and
a SOAP
Reference
Binding is
added for the
same. The
Binding is
added under
Module
Descriptors/
Components/
Binding.
SOAP Send
Fault
Regular
Activity
Basic : Reply
with Fault +
SOAP
Reference
Binding
Regular
Activity +
SOAP Binding
Supported
SOAP Send
Reply
Regular
Activity
Basic
Activities:
Reply + SOAP
Reference
Binding
Regular
Activity +
SOAP Binding
Supported
SOAP Send
Reply
TIBCO ActiveMatrix BusinessWorks™ Migration
49
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
Context
Support
Migration
Support
Comments
Refactor and
Recreate
SOAP
Headers
(Bound ,
Unbound,
Undescribed)
SOAP
Attachments
(SwA and
MTOM)
SOAP
Security
TCP Palette
ActiveMatrix BusinessWorks 5.x: TCP Palette
Type: Palette
ActiveMatrix BusinessWorks 6.x: TCP Palette
Type: Palette
Migration: Supported
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
TCP
Connection
Shared
Resource
TCP
Connection
Shared
Resource
Supported
Read TCP
Data
Regular
Activity
Read TCP
Data
Regular
Activity
Supported
TCP Close
Connection
Regular
Activity
TCP Close
Connection
Regular
Activity
Supported
TCP Open
Connection
Regular
Activity
TCP Open
Connection
Regular
Activity
Supported
TCP Receiver
Process
Starter
Activity
TCP Receiver
Process
Starter
Activity
Supported
Wait for TCP
Request
Signal-In
Activity
Wait for TCP
Request
Signal-In
Activity
Supported
Write TCP
Data
Regular
Activity
Write TCP
Data
Regular
Activity
Supported
Comments
TIBCO ActiveMatrix BusinessWorks™ Migration
50
Transaction Palette
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
JTA User
Transaction
Configuratio
n
Shared
Resource
JTA User
Transaction
Configuratio
n
Shared
Resource
BW6
Construct
Under
Consideration
XA
Transaction
Manager
Configuratio
n
Shared
Resource
XA
Transaction
Manager
Configuratio
n
Shared
Resource
BW6
Construct
Under
Consideration
Transaction
State
Regular
Activity
Transaction
State
Regular
Activity
BW6
Construct
Under
Consideration
Comments
XML Palette
ActiveMatrix BusinessWorks 5.x: XML Palette
Type: Palette
ActiveMatrix BusinessWorks 6.x: XML Palette
Type: Palette
Migration: Supported
Migration
Support
BW 5.x
BW 5.x Type
BW 6.x
BW 6.x Type
XSLT File
Shared
Configuratio
n
XSLT File
Shared
Configuratio
n
Supported
Parse XML
Regular
Activity
Parse XML
Regular
Activity
Supported
Render XML
Regular
Activity
Render XML
Regular
Activity
Supported
Transform
XML
Regular
Activity
Transform
XML
Regular
Activity
Supported
Comments
TIBCO ActiveMatrix BusinessWorks™ Migration
51
Migration Scenario
The migration scenarios show the core construct migration of TIBCO ActiveMatrix BusinessWorks 5.x
projects. After migration, these projects are converted to their equivalent in TIBCO ActiveMatrix
BusinessWorks 6.x. The TIBCO ActiveMatrix BusinessWorks 6.x Call Process, Signal-in, Start, and End
activities are notably different from the activities in TIBCO ActiveMatrix BusinessWorks 5.x.
Call Process Activity Migration
The following table provides information about the Call Process activity migration from ActiveMatrix
BusinessWorks 5.x to ActiveMatrix BusinessWorks 6.x.
TIBCO ActiveMatrix BusinessWorks 5.x
TIBCO ActiveMatrix BusinessWorks 6.x
Call Process is literal. It calls a process with
process pipeline data mapped into it and
generates an output that is in essence the
output of the called process.
Call Process mechanism is based on the standard
Invoke activity. It abstracts out the actual Call
Process configuration to the reference that the
Invoke activity is calling.
After Migration: Call Process activity converts to an
Invoke activity which calls a reference that holds
the Call Process activity configuration.
Signal-in Activity Migration
The following table provides information about the Signal-in activity migration from ActiveMatrix
BusinessWorks 5.x to ActiveMatrix BusinessWorks 6.x.
TIBCO ActiveMatrix BusinessWorks™ Migration
52
TIBCO ActiveMatrix BusinessWorks 5.x
TIBCO ActiveMatrix BusinessWorks 6.x
Signal-In activities join an existing job by
comparing the key generated by mapping
process pipeline data to the key field of the
signal-in activity. The value is matched with
the value generated for the candidate event
key field of the signal-in activity by mapping
the signal-in output data.
Conversations, a new mechanism, is introduced to
join an existing process instance, which is based on a
correlation mechanism. It applies to all the activities
receiving a message after the process instance is
created.
A process instance can initialize a conversation
using an activity by initializing a conversation key
with the values mapped from the process pipeline
data. If the join activity generates a conversation key
value by evaluating the expression against the
message data, which matches the value of the
initialized conversation key, a message can join the
conversation.
●
Input key mapping migrates as Conversation
Initiate
●
Candidate Event Key migrates as Conversation
Join.
After Migration: Signal-in activity is migrated to an
ActiveMatrix BusinessWorks 6.x equivalent Signalin activity with a dummy conversation with Initiate
and Join as "true". This mechanism initiates the
conversation based on the process data mapped to a
key and matches it with a value that is generated by
mapping the activity output data.
Start and End Activity Migration
The following table provides information about the Start and End activities migration from
ActiveMatrix BusinessWorks 5.x to ActiveMatrix BusinessWorks 6.x.
TIBCO ActiveMatrix BusinessWorks™ Migration
53
TIBCO ActiveMatrix BusinessWorks 5.x
TIBCO ActiveMatrix BusinessWorks 6.x
The Start activity is a receiver that starts a
process on receiving a message that may be
empty. The End activity sends a reply.
The Start activity is changed to a Receive activity
and the End activity is changed to Reply activity.
The Start activity is the first activity in a
process definition (process starters replace
the Start activity when used in a process
definition).
The End activity is the last activity in a
process definition.
After Migration:
●
The Start activity converts to a Receive activity.
The input is wrapped inside a WSDL message
that listens on a generated port type that acts as
the interface for the process.
●
The End activity converts to a Reply activity.
The output is wrapped inside a WSDL message
that listens on a generated port type that acts as
the interface for the process.
If the ActiveMatrix BusinessWorks 5.x
process has an Event Source activity
instead of a Start activity, then the End
activity gets migrated to an Empty
activity.
Activator
In TIBCO ActiveMatrix BusinessWorks 6.x, each application module has one Activator process that has
two service operations, On StartUp and On ShutDown. Any TIBCO Designer process linked with the
On Start and On ShutDown activity in TIBCO ActiveMatrix BusinessWorks 5.x after migration is
simultaneously changed to a StartUp Operation activity and On ShutDown Operation activity. The
activator calls the start() and stop() methods to start or stop the process.
Service and References
Service and References are defined at a process level.
TIBCO ActiveMatrix BusinessWorks™ Migration
54
TIBCO ActiveMatrix BusinessWorks 5.x
TIBCO ActiveMatrix BusinessWorks 6.x
SOAP services are used for exchanging
information in the implementation of web
services relying on XML message format sent
over HTTP and JMS.
Includes REST compliant services along with HTTP
and JMS, where the purpose of the service is to
manipulate XML representations of web resources
using a uniform set of stateless operations. When
using a stateless operation, the state is managed by
the job itself instead of by the engine.
Migrating 5.x Projects to 6.x
You can migrate ActiveMatrix BusinessWorks 5.x projects to ActiveMatrix BusinessWorks 6.x using the
following options:
●
Project > Migrate BW Projects option in TIBCO Business Studio
●
The command-line option
Migrating Projects Using TIBCO Business Studio
TIBCO ActiveMatrix BusinessWorks 6.x provides an easy way to migrate TIBCO ActiveMatrix
BusinessWorks 5.x projects by using the Migrate BW Projects menu option in TIBCO Business Studio™.
You can also use the Eclipse import mechanism to migrate the projects.
Procedure
1. In TIBCO Business Studio, go to Project > Migrate BW Projects....
2. In the BusinessWorks Migration Tool wizard, specify the relevant information in the following
fields.
a) Click Browse in the BusinessWorks 5 Project Folder field and provide the location of the
ActiveMatrix BusinessWorks 5.x project that you want to migrate. The tool scans the
ActiveMatrix BusinessWorks 5.x projects in the specified folder location and displays the list of
projects.
b) In the Migrated Project Folder field, click Browse and provide the location where you want to
migrate the project.
TIBCO ActiveMatrix BusinessWorks™ Migration
55
c) Select the Add External JARs check box if the ActiveMatrix BusinessWorks 5.x project is using
external JAR files in context with Java activities.
It is recommended you place the external JAR files in a single location. These JAR files can then
be in-lined in the migrated ActiveMatrix BusinessWorks 6.x project.
d) Click Browse in the Jar Location field and provide the location of the JAR files on disk.
3. In the BusinessWorks 5 Projects area, select the projects you want to migrate, and click Migrate.
The migrated projects are visible in the Migration Output area.
4. Click Close after the migration is complete.
You can alternatively migrate the projects using the File > Import menu option. Select
Migrate BW Projects > Next in the Import dialog.
TIBCO ActiveMatrix BusinessWorks™ Migration
56
Project with Subprocess after Migration
Subprocess in ActiveMatrix BusinessWorks 6.x uses a standardized concept of receiving and
replying messages through a service.
Before Migration
After Migration
The Subprocess moves to a green chevron.
Migrating Projects Using Command line
Another option for a speedy migration is migrating the projects using the command line.
Usage: bwmigrator
[-options] BW5Project...
TIBCO ActiveMatrix BusinessWorks™ Migration
57
where options include the following:
-projectDir
Location where ActiveMatrix BusinessWorks 6.x projects are to be generated.
BW5Project...
Location\locations of ActiveMatrix BusinessWorks 5.x projects.
Examples
●
bwmigrator -projectDir <BW6_PROJECTS_HOME>\projects <TIBCO_HOME>\5.9\examples
\activities\file\File
●
(Migrates single ActiveMatrix BusinessWorks 5.x project.)
bwmigrator -projectDir <BW6_PROJECTS_HOME>\projects <TIBCO_HOME>\5.9\examples
\activities\file\File <TIBCO_HOME>\5.9\examples\activities\ftp\ftp
FTP ActiveMatrix BusinessWorks 5.x projects.)
●
bwmigrator -projectDir <BW6_PROJECTS_HOME>\projects <TIBCO_HOME>\5.9\examples
\activities
●
(Migrates File and
(Migrates all ActiveMatrix BusinessWorks 5.x projects in activities directory.)
bwmigrator -projectDir <BW6_PROJECTS_HOME>\projects <TIBCO_HOME>\5.9\examples
\file <TIBCO_HOME>\5.9\examples\ftp
in File and FTP directories.)
(Migrates all ActiveMatrix BusinessWorks 5.x Projects
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>
Post-Migration Manual Tasks
If you encounter problem markers that are related to activity input mapping, resolve these constraints
by 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.
TIBCO ActiveMatrix BusinessWorks™ Migration
58
This option is applicable to the following projects:
●
JAVA Method Project
●
Mail With Simple Attachment
●
simple_attachment
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 and
reopen the project.
HTTP Persistent Connection
This topic describes migrating this project from TIBCO ActiveMatrix BusinessWorks 5.x to TIBCO
ActiveMatrix BusinessWorks 6.x.
Prerequisites
Migrate the TIBCO ActiveMatrix BusinessWorks 5.x project.
Procedure
1. In the HTTP Client shared resource, Client.ClientProcess-Send-HTTP-RequestHttpClientResource, provide the specified details in the following fields.
Field
Value
Maximum Total Connections
3
Maximum Total Connections Per Host
2
Connection Timeout (ms)
20000
2. Provide the same HTTP Client shared resource Client.ClientProcess-Send-HTTP-RequestHttpClientResource to the following activities in the process, ClientProcess.bwp.
a) Send-HTTP-Request-1
b) Send-HTTP-Request-1-1
c) Send-HTTP-Request-1-2
d) Send-HTTP-Request-1-3
HTTP Basic Sample
This topic describes migrating this project from TIBCO ActiveMatrix BusinessWorks 5.x to TIBCO
ActiveMatrix BusinessWorks 6.x.
Prerequisites
Migrate the TIBCO ActiveMatrix BusinessWorks 5.x project.
Procedure
1. Click the Incoming-HTTP-request (HTTP Receiver) activity and click the General tab.
2. In the Parameter table, change the Parameter Cardinality from Required to Optional.
TIBCO ActiveMatrix BusinessWorks™ Migration
59
3. Click the Send-Request-to-Wiki-News (Send HTTP Request) activity and specify the following
three values on Input tab.
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 value
for Content-Type on the Input tab as shown in the following image.
TIBCO ActiveMatrix BusinessWorks™ Migration
60
JMS Message Selector Project
This topic describes migrating this project from TIBCO ActiveMatrix BusinessWorks 5.x to TIBCO
ActiveMatrix BusinessWorks 6.x.
Prerequisites
Migrate the TIBCO ActiveMatrix BusinessWorks 5.x project.
Procedure
1. Open QueueMessageSelector.bwp, click on the JMS-Queue-Sender activity and click the
Advanced tab.
2. Click Application Properties Type, open the Select Schema Type Definition wizard and select
JMSApplicationProperties.
3. Delete the Body element from the Input tab in the JMS Queue Sender activity two body elements
are generated after migration.
TIBCO ActiveMatrix BusinessWorks™ Migration
61
4. Provide a value in the Body element.
5. Do Check and Repair to remove all the problem markers.
6. Run the process.
JAVA Method Project
This topic describes migrating this project from TIBCO ActiveMatrix BusinessWorks 5.x to TIBCO
ActiveMatrix BusinessWorks 6.x.
Prerequisites
Migrate the TIBCO ActiveMatrix BusinessWorks 5.x project.
Procedure
1. Go to PublishBalance.bwp and perform Check and Repair for the InvalidAcctExp and
PublishException activities.
2. In the Mapper Check and Repair wizard, check for jmexample.InvalidAccountException.
3. Run the sample.
TIBCO ActiveMatrix BusinessWorks™ Migration
62
Mail with Simple Attachment
This topic describes migrating this project from TIBCO ActiveMatrix BusinessWorks 5.x to TIBCO
ActiveMatrix BusinessWorks 6.x.
Prerequisites
Migrate the TIBCO ActiveMatrix BusinessWorks 5.x project.
Procedure
1. After migrating the project, select the Sender.bwp process, click on Send-Mail activity and do
Check and Repair.
2. Select the Receiver.bwp process and go to Write-binary-attachment-content activity's Input tab
and do Check and Repair.
Custom XPath Migration
Some manual tasks are needed to be performed after custom XPath migration. These tasks impact
Designtime and Runtime.
Design Time
The migrated custom XPath functions need to be provisioned into TIBCO Business Studio. You can do
this in the following two ways:
Procedure
1. Export the custom XPath function plug-ins into the Host repository. To do this, right-click on the
XPath 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 Business Studio. Restart and refresh your workspace. This results in the
validation errors related to XPath functions not visible.
TIBCO ActiveMatrix BusinessWorks™ Migration
63
Run Time
Make sure to include the XPath function plug-ins in your application.
Go to the Includes folder and add the XPath function plug-ins.
TIBCO ActiveMatrix BusinessWorks™ Migration
64
Migration Process Outline
The migration mechanism takes ActiveMatrix BusinessWorks 5.x projects and converts them to 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
TIBCO ActiveMatrix BusinessWorks Project Migration
ActiveMatrix BusinessWorks 5.x Project
in TIBCO Designer
ActiveMatrix BusinessWorks 6.x Project in
TIBCO Business Studio
Process
ActiveMatrix BusinessWorks 6.x Process
Schema
Schema
WSDL
WSDL
Shared Resource
ActiveMatrix BusinessWorks 6.x Shared Resource
TIBCO 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
TIBCO Designer are displayed in ActiveMatrix BusinessWorks 6.x project in TIBCO Business Studio.
TIBCO ActiveMatrix BusinessWorks™ Migration
65
ActiveMatrix BusinessWorks 5.x Migrated Project - Before and After
TIBCO ActiveMatrix BusinessWorks™ Migration
66
Frequently Asked Questions
What to do...
When migrated process shows mapping
errors?
Resolution
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 existing
errors. Click Fix Type Casting Errors.
3. If the error still persists, check the expression
and do the necessary corrections.
When processes have unresolved WSDL
references?
1. Close and reopen the project.
2. If this does not fix the references, then check the
WSDL Interface value on the General tab of the
Process Service.
When Java Invoke activities show Input
after migration?
Configuration Error
1. Go to the General tab of the Java Invoke activity
and check whether the Class Name is available
in the workspace. If available, re-select the Java
class.
2. If the class is not available, check whether the
JAR file packaging the Java class is available.
Otherwise, copy the JAR file to the "lib" folder
and reselect the Java class.
When activities in the Catch block show
Mapping errors?
The Catch Block activities does not have the
visibility to the output of the activities from the
main process.
Re-map the activity input accordingly. This is
similar to the Java try or catch constructs.
When the Iterate Group "Iteration Element"
fails to resolve?
When Variable not defined error for
Iterate Group Index variable is used outside
the Iterate scope?
1. In ActiveMatrix BusinessWorks 6.x the Iterate
Group Index Variable does not have the
visibility outside the Iterate scope.
2. Define a Process Variable of Type integer and
map it to the Iterate Group Index variable. Now
you can use this variable in the Process scope.
TIBCO ActiveMatrix BusinessWorks™ Migration
67
What to do...
When ActiveMatrix BusinessWorks 5.x
activity migrates as Empty or Rescue activity
in ActiveMatrix BusinessWorks 6.x?
Resolution
1. The ActiveMatrix BusinessWorks 5.x activity
migrates as Rescue activity, if the migration
framework fails to migrate.
2. Check the ActiveMatrix BusinessWorks 5.x
project and add the corresponding activity in the
ActiveMatrix BusinessWorks 6.x project and
redo the mappings.
TIBCO ActiveMatrix BusinessWorks™ Migration
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement