TIBCO ActiveMatrix® BPM 4.0 Release Notes

79 Pages·2015·0.69 MB·English

TIBCO ActiveMatrix® BPM Release Notes
Software Release 4.0.0
November 2015
Document Updated: December 2015
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, Two-Second Advantage, TIBCO ActiveMatrix BPM, TIBCO Administrator, TIBCO Business
Studio, TIBCO Enterprise Message Service, TIBCO General Interface, TIBCO Hawk, TIBCO iProcess,
TIBCO JasperReports, TIBCO Spotfire, TIBCO Spotfire Server, and TIBCO Spotfire Web Player 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 © 2005-2015 TIBCO Software Inc. ALL RIGHTS RESERVED.
TIBCO Software Inc. Confidential Information
TIBCO ActiveMatrix® BPM Release Notes
3
Contents
TIBCO Documentation and Support Services.........................................................5
Important Installation and Upgrade Notes............................................................7
New Features......................................................................................9
Core Components .....................................................................................................9
Application Management..........................................................................................9
Client Application Framework .................................................................................... 10
Work Manager...................................................................................................10
Clients ...............................................................................................................11
TIBCO Forms....................................................................................................11
Openspace ......................................................................................................12
Workspace ...................................................................................................... 12
Changes in Functionality .......................................................................... 14
Deprecated and Removed Features .................................................................15
Migration and Compatibility ........................................................................22
Upgrading Pre-TIBCO ActiveMatrix BPM 2.2 to TIBCO ActiveMatrix BPM 4.0..........................................22
Upgrading TIBCO ActiveMatrix BPM 2.2 and Later to TIBCO ActiveMatrix BPM 4.0....................................22
TIBCO ActiveMatrix BPM Version 3.0.................................................................................22
TIBCO ActiveMatrix BPM Version 1.3.................................................................................23
Initializers and Migration..............................................................................................23
Configuring the Business Data Services (BDS) Database ............................................................. 23
Upgrade Script Issue with Openspace GlobalHubPolicy Data ..........................................................24
Upgrading the Oracle JDBC Driver....................................................................................25
Openspace Upgrade Script and Data Views...........................................................................25
Workspace Migration.................................................................................................26
Closed Issues .....................................................................................29
Core Components ....................................................................................................29
Work Manager ...................................................................................................29
Process Manager ................................................................................................33
Clients ...............................................................................................................36
TIBCO Forms ....................................................................................................36
Openspace......................................................................................................37
Workspace ...................................................................................................... 41
Known Issues.....................................................................................44
Platform..............................................................................................................44
Administrator.................................................................................................... 44
Installer..........................................................................................................55
Runtime .........................................................................................................56
TIBCO Hawk ActiveMatrix Plug-in................................................................................64
TIBCO ActiveMatrix® BPM Release Notes
4
Core Components ....................................................................................................66
Work Manager ...................................................................................................66
Process Manager ................................................................................................72
Clients ...............................................................................................................75
TIBCO Forms....................................................................................................75
Openspace ......................................................................................................77
Workspace ...................................................................................................... 79
TIBCO ActiveMatrix® BPM Release Notes
5
TIBCO Documentation and Support Services
Documentation for this and other TIBCO products is available on the TIBCO Documentation site:
https://docs.tibco.com
Documentation on the TIBCO Documentation site is updated more frequently than any 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_amx-bpm_version_docinfo.html
where TIBCO_HOME is the top-level directory in which TIBCO products are installed. On Windows,
the default TIBCO_HOME is C:\tibco. On UNIX systems, the default TIBCO_HOME is /opt/tibco.
The following documents for this product can be found on the TIBCO Documentation site:
● TIBCO ActiveMatrix BPM SOA Concepts
● TIBCO ActiveMatrix BPM Concepts
● TIBCO ActiveMatrix BPM Developer's Guide
● TIBCO ActiveMatrix BPM Web Client Developer's Guide
● TIBCO ActiveMatrix BPM Tutorials
● TIBCO ActiveMatrix BPM Business Data Services Developer Guide
● TIBCO ActiveMatrix BPM Case Data User Guide
● TIBCO ActiveMatrix BPM Event Collector Schema Reference
● TIBCO ActiveMatrix BPM - Integration with Content Management Systems
● TIBCO ActiveMatrix BPM SOA Composite Development
● TIBCO ActiveMatrix BPM Java Component Development
● TIBCO ActiveMatrix BPM Mediation Component Development
● TIBCO ActiveMatrix BPM Mediation API Reference
● TIBCO ActiveMatrix BPM WebApp Component Development
● TIBCO ActiveMatrix BPM Administration
● TIBCO ActiveMatrix BPM Performance Tuning Guide
● TIBCO ActiveMatrix BPM SOA Administration
● TIBCO ActiveMatrix BPM SOA Administration Tutorials
● TIBCO ActiveMatrix BPM SOA Development Tutorials
● TIBCO ActiveMatrix BPM Application Management Guide
● TIBCO ActiveMatrix BPM Client Application Developer's Guide
● TIBCO Openspace User's Guide
● TIBCO Openspace Customization Guide
● TIBCO ActiveMatrix BPM Organization Browser User's Guide (Openspace)
TIBCO ActiveMatrix® BPM Release Notes
6
● TIBCO ActiveMatrix BPM Organization Browser User's Guide (Workspace)
● TIBCO ActiveMatrix BPM Spotfire Visualizations
● TIBCO Workspace User's Guide
● TIBCO Workspace Configuration and Customization
● TIBCO Workspace Components Developer Guide
● TIBCO ActiveMatrix BPM Troubleshooting Guide
● TIBCO ActiveMatrix BPM Deployment
● TIBCO ActiveMatrix BPM Hawk Plug-in User's Guide
● TIBCO ActiveMatrix BPM Installation: Developer Server
● TIBCO ActiveMatrix BPM Installation and Configuration
● TIBCO ActiveMatrix BPM Log Viewer
● TIBCO ActiveMatrix BPM Single Sign-On
● Using TIBCO JasperReports for ActiveMatrix BPM
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® BPM Release Notes
7
Important Installation and Upgrade Notes
To upgrade to TIBCO ActiveMatrix BPM 4.0, TIBCO ActiveMatrix Platform 3.3.0 Hotfix 11 is
mandatory.
For more information on upgrade, see Upgrading Pre-TIBCO ActiveMatrix BPM 2.2 to ActiveMatrix
BPM 4.0 and Upgrading TIBCO ActiveMatrix BPM 2.2 and later to TIBCO ActiveMatrix BPM 4.0
TIBCO ActiveMatrix® Binding Type for REST 3.3.0 HF01 is a minimum requirement if using REST
service invocation tasks from BPM processes. This is required on runtime and design-time.
The following table lists a number of known issues in TIBCO ActiveMatrix Platform 3.3.0 that affect
TIBCO ActiveMatrix BPM version 4.0. Contact TIBCO Support for up to date information on these
issues and their resolution.
Key Summary/Workaround
AMRP-5232 Summary: A form fails to load and an java.io.IOException: write beyond
end of stream Error" error is reported. This error only occurs on systems
where TIBCO ActiveMatrix Platform 3.3.0 Hotfix 10 has been applied, and is
caused by an HTTP compression issue.
Workaround: To avoid this problem, disable the use of HTTP compression by
the BPM runtime. To do this, add the following property:
java.property.com.tibco.amf.hpa.tibcohost.jetty.disableCompressio
n=true
to the CONFIG_HOME\tibcohost\Admin-enterpriseName-adminServerName
\data_version\nodes\BPMnodeName\bin\BPMNode.tra file.
Support for this property was introduced in TIBCO ActiveMatrix
Platform 3.3.0 Hotfix 012.
AMX-15224 Summary: If you upgrade from TIBCO ActiveMatrix BPM version 2.1.0 to
version 4.0, the upgrade fails on the first attempt on the upgrade-admin step.
Workaround: Re-run the upgrade. The upgrade process completes successfully.
The following issues are resolved by TIBCO ActiveMatrix Platform 3.3.0 Hotfix 012, which you can
obtain from TIBCO Support.
Key Summary
AMX-15212, Summary: On a system where TIBCO ActiveMatrix Platform 3.3.0 Hotfix 10 has
SDA-451 been applied, you cannot deploy a Decisions Service project from TIBCO
Business Studio.
Workaround: Export the Decisions Service project as a DAA and deploy it from
ActiveMatrix Administrator.
This issue is resolved by TIBCO ActiveMatrix Platform 3.3.0 Hotfix
012.
TIBCO ActiveMatrix® BPM Release Notes
8
Key Summary
AMX-15258 Summary: A process application containing a service task that calls a BPM
service (that is, invokes any public BPM API operation) may not work as
expected after upgrade to TIBCO ActiveMatrix BPM version 4.0. In some
circumstances, the application may not work at all.
Workaround: None.
This issue is resolved by TIBCO ActiveMatrix Platform 3.3.0 Hotfix
012.
AMX-15265 Summary: On a system where TIBCO ActiveMatrix Platform 3.3.0 Hotfix 10 has
been applied, upgrading TIBCO ActiveMatrix BPM to version 4.0 fails when
you try to upgrade the ActiveMatrix BPM database. The following error is
displayed:
Error moving LDAP connections to the application: The max
connection pool size is invalid. It can only allow a number OR a
substitution variable.
(This error occurs because the upgrade sends a string value for the maxPoolSize
parameter for the sslServer resource template, but this value is now an integer
as a result of a change in TIBCO ActiveMatrix Platform 3.3.0 Hotfix 10.)
Workaround: Before upgrading, use ActiveMatrix Administrator to change the
Max Pool Size parameter for the sslServer resource template (type SSL Server
Provider) from Default to 20.
This issue is resolved by TIBCO ActiveMatrix Platform 3.3.0 Hotfix
012.
AMRP-5306 Summary: On TIBCO ActiveMatrix BPM version 4.0, .zip files or .pdf files that
are uploaded to the CMIS repository may be corrupted. Content is lost and the
files cannot be opened if they are downloaded.
Workaround: None.
This issue is resolved by TIBCO ActiveMatrix Platform 3.3.0 Hotfix
012.
TIBCO ActiveMatrix® BPM Release Notes
9
New Features
This release introduces new features for the following components:
● Core Components
● Clients
Core Components
This section describes the new features for Core Components.
Application Management
A new Application Management user interface is available that is used to manage your ActiveMatrix
BPM client applications.
With Application Management you can upload application files, edit the files, then test and verify your
changes without having to deploy the complete application to an ActiveMatrix BPM server.
Using Application Management you can customize your applications, and make layout, markup and
style sheet (CSS) changes.
Once you have verified your application, simply publish your application to make it available
immediately to your users. Once your application is published, it automatically provides support for
devices, such as, Smart Phone, Tablet and PC. Once an application is published, you can dynamically
modify it using Application Management.
A localization service enables you to provide one or more languages to applications that are developed
using application management. You can quickly and easily add new locales by dragging and dropping
a language pack to your application. You can dynamically customize and modify locale information for
your application.
Application roles are used to define the access control for applications. Users can access an application
itself or a feature/component within that application, based on the application roles you assign them -
for example: user, administrator, supervisor.
My Work Application
My Work Application is available as part of Application Management. My Work Application presents
an integrated, fully functional client application. It is called "workapp" in the Application Management
user interface. This application provides an example user interface to the business components and
business component services (which are part of the Client Application Framework). You can use My
Work Application out-of-the box, or clone and customize it, depending on your own requirements. You
can also customize logos and other visual elements. For example, you can keep the service logic of the
work list, but completely change the appearance of the layout. This allows you to rapidly develop user
interfaces for your business without the need to handle API interactions. See the "myWorkApp
Demonstration" video available on the ActiveMatrix BPM product page on the TIBCO Documentation
site.
Component Showcase
The Component Showcase application is available as part of Application Management. The Component
Showcase application demonstrates the use of individual business components and component services
(which are part of the Client Application Framework). It is called "component_showcase" in the
Application Management user interface. Component Showcase uses the same business components and
component services as My Work Application. However, whereas My Work Application presents an
integrated, fully functional client application, Component Showcase breaks that functionality down
into a number of stand alone examples, which you can use to more easily understand how they work,
TIBCO ActiveMatrix® BPM Release Notes
10
or as the basis for your own development. See "Component Showcase Application" in the TIBCO
ActiveMatrix BPM Client Application Framework Developer Guide for more information.
Client Application Framework
The Client Application Framework is used to create and manage lightweight BPM applications using
industry-standard technologies, such as Bootstrap CSS, AngularJS, and JavaScript.
The Client Application Framework consists of, and uses, the following elements:
● Business Components - Business components are used to render BPM-related controls in an
application. These can be used as building blocks to create a client application.
Business components are BPM-specific components, implemented as AngularJS directives, that can
be embedded in an application as HTML elements.
● Component Services - Component services are used to perform BPM-related functions that would
require several calls to the lower-level objectAPI. They can be used to extend or change existing
business components, or to build new custom components.
Component services are fully functional AngularJS services that can be consumed by AngularJS
clients. They make it much easier to perform certain BPM functions that require the use of multiple
calls when done directly from the objectAPI - for example, opening a work item or displaying a
form from a pageflow can be done with a single call using component services.
● ObjectAPI - The ObjectAPI provides services that contain functions for all available ActiveMatrix
BPM functionality. Object API is a client side API written in Javascript to consume BPM services
easily from a web client. Typically, you will use business components and component services to
build an application, as those require less effort. However, not all ActiveMatrix BPM functionality is
available by using business components and component services. If that additional functionality is
needed, the ObjectAPI can be used to access it.
Work Manager
Reduced Use of XA Transactions
Use of XA transactions in TIBCO ActiveMatrix BPM has been reduced, producing significant
performance improvements. As part of this change:
● The node types used by BPM have changed. The following table shows the pre-version 4.0 node
types and their version 4.0 equivalents.
Pre-version 4.0 Node Type Version 4.0 Node Type
BPM BPM
Web Components Client
Process Manager Server
Work Manager Server
If you are upgrading from a pre-4.0 version BPM system that includes BPM nodes of node type Web
Components, Process Manager or Work Manager, these node types will automatically be
converted as part of the upgrade process to version 4.0 node types. (Web Components nodes are
converted to Client node type. Process Manager and Work Manager nodes are converted to Server
node type.) The upgrade process could potentially take a significant amount of time because of the
work involved in this conversion.
TIBCO ActiveMatrix® BPM Release Notes