BusinessWare

Introduction
BusinessWare Version 4.2.1
March 2004
Copyright 1997-2004
Vitria Technology, Inc.
945 Stewart Drive
Sunnyvale, CA 94085-3913
Phone: (408) 212-2700
Fax: (408) 212-2720
All rights reserved. Printed in the USA.

Vitria, BusinessWare, Vitria Collaborative Application, VCA, VCML,

Trading Partner Manager, and XEDI are trademarks or registered
trademarks of Vitria Technology, Inc. All other brand or product names
are trademarks or registered trademarks of their respective companies or
organizations.

This document, as well as the software documented in it, is furnished

under license and may only be used or copied in accordance with the
terms of such license. This product includes technology protected by
U.S. Patent No. 6,338,055 B1.
The information in this document is subject to change without notice.
 TABLE OF CONTENTS

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Related Reading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
BusinessWare Documentation Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .viii
Contacting Vitria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Headquarters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

Chapter BusinessWare Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 1

The BusinessWare Platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
Business Process Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
Business Analysis and Monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . .2
Enterprise Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
Service Orientation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Business Vocabulary Management. . . . . . . . . . . . . . . . . . . . . . . . . . .3
BusinessWare in Your Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Solving Integration Challenges within an Enterprise . . . . . . . . . . . . . .4
Solving Integration Challenges Across Enterprises . . . . . . . . . . . . . .5
BusinessWare Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
The BusinessWare Environments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
Design Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
Execution Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Administration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Manual Workflow Web Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Index-1

BusinessWare Introduction iii

iv BusinessWare Introduction
 PREFACE

Welcome to the BusinessWare Introduction.

This guide introduces BusinessWare by giving an overview of what the product
is, how it can be used, and how it works.

This preface contains the following information:

! Audience
! Related Reading
! BusinessWare Documentation Set
! Conventions
! Contacting Vitria

AUDIENCE
This guide is intended for anyone who needs to know about or use BusinessWare:
executives, business analysts, architects, programmers, system administrators,
and end users.

The BusinessWare Introduction provides a basic understanding of BusinessWare

and is a prerequisite to all other BusinessWare documentation.

RELATED READING
Refer to the following documents for information related to the topics in this
manual:
! BusinessWare Modeling Guide
! BusinessWare Administration Guide
! BusinessWare Task List Guide
! Business Cockpit Guide

BusinessWare Introduction v
PREFACE

BUSINESSWARE DOCUMENTATION SET

The BusinessWare documentation set includes the following manuals:

Table 1 BusinessWare Documentation

Document Description
Read these documents first
BusinessWare Introduction Introduces the BusinessWare product suite and
architecture and describes the key concepts underlying
BusinessWare.
Read this manual first.
BusinessWare Release Provides current information on features, fixes, and
Notes known problems for BusinessWare.
Read this document before installing BusinessWare.
BusinessWare Migration Describes how to migrate a BusinessWare 3.1.x
Guide solution or a BusinessWare 4.1.x solution to
BusinessWare 4.2 and provides a conceptual
comparison between those versions of BusinessWare
and BusinessWare 4.2.
Read this manual if you wish to migrate a previous
version of BusinessWare to BusinessWare 4.2.
BusinessWare Installation Explains how to install BusinessWare and supporting
Guide for Windows third-party products and how to perform initial
configuration on your operating system.
Read this manual before installing BusinessWare.
BusinessWare Installation Explains how to install BusinessWare and supporting
Guide for Unix third-party products and how to perform initial
configuration on your operating system.
Read this manual before installing BusinessWare.
BusinessWare documents
BusinessWare Explains how to administer and manage
Administration Guide BusinessWare.
BusinessWare Describes how to perform basic administration tasks
Administration Help using the BusinessWare Web Administration tool.
Application Administration Describes how to administer the registry service for
Help trading partners; users, groups, and roles for your
BusinessWare solutions; and the logging service.
Access this online help system through the Application
Administration UI.

vi BusinessWare Introduction
 PREFACE

Table 1 BusinessWare Documentation (Continued)

Document Description
BusinessWare Performance Describes how to monitor and tune BusinessWare for
Tuning Guide higher performance.
BusinessWare High Describes how to install and configure BusinessWare
Availability Guide for a high availability cluster and how to integrate
BusinessWare with cluster software.
BusinessWare Modeling Describes the BusinessWare application integration
Guide platform that manages the integration lifecycle with an
integrated development environment for designing,
developing, deploying, testing, monitoring, and
analyzing business solutions.
BME Help Describes how to model, debug, and deploy projects in
the BME.
Access this online help system through the
BusinessWare Modeling Environment.
BusinessWare Documents BusinessWares Java and C++ public
Programming Reference APIs.
Business Cockpit Guide Describes how to access and manage process views
using the Cockpit Web interface.
Business Cockpit Help Context-sensitive help that describes how to access
and manage process views using the Cockpit Web
interface.
Business Collaboration Describes how to build a Business Collaboration
Guide solution using BusinessWare. Includes details on the
Registry Service, messaging, and trading protocols
and transports.
BusinessWare Transformer Describes how to use the BusinessWare Transformer
Guide to transform input events of one type to an output event
of a different type.
BusinessWare Task List Describes how to create the BusinessWare Workflow
Guide Web interface and how to use the BusinessWare Task
List as a performer, supervisor, or manager.
BusinessWare Glossary Defines key terms associated with BusinessWare.

BusinessWare Introduction vii

PREFACE

Table 1 BusinessWare Documentation (Continued)

Document
Email Connector Guide
File Connector Guide
FTP Connector Guide
HTTP Connector Guide
Description
Describes how to configure and use the Email
Connector installed with this release of BusinessWare.
Describes how to configure and use the File Connector
installed with this release of BusinessWare.
Describes how to configure and use the FTP
Connector installed with this release of BusinessWare.
Describes how to configure and use the HTTP
Connector installed with this release of BusinessWare.

CONVENTIONS
This manual uses the following conventions:
! Monospace
Specifies file names, object names, and programming code.
Example: C:\VTlicenses
! Italics
" Identifies a variable.
Example: installdir/bin/unix_platform, where
installdir indicates the directory where BusinessWare is installed and
unix_platform indicates the Unix platform, such as Solaris, HP-UX,
or AIX.
" Indicates a value that you must enter within examples and command
syntax.
Example: java com.vitria.rta.AnalyzerUtil -n servername
" Introduces new terminology, highlights book titles, and provides
emphasis.
Example: An operation is a defined action that is meant to be applied to a
given class of software objects.
! Bold
Highlights items and indicates specific items in a graphical user interface
(GUI).
Example: From the list, select the Properties item.
! Path names

viii BusinessWare Introduction

 PREFACE

" This document uses the variable installdir to indicate the directory where
BusinessWare is installed. On Windows, the default installation directory
is C:\Program Files\Vitria\BW42. On Unix, the default
installation directory is /usr/local/bw42.
" While BusinessWare is supported on multiple operating systems, path
names are displayed only in the Windows backslash format.
Example for Windows systems:
samples\communicator\javaflow\anypub.java
" If you are operating in a Unix environment, change to the forward slash
format.
Example for Unix systems:
samples/communicator/javaflow/anypub.java
" Internet URLs follow the standard forward slash convention.
Example:
http://www.vitria.com

CONTACTING VITRIA
If you have any questions regarding Vitria or any of the Vitria products, please
contact Vitria using the resources listed in this section.

HEADQUARTERS
Vitria Technology, Inc.
945 Stewart Drive
Sunnyvale, CA 94085
1-408-212-2700
http://www.vitria.com

TECHNICAL SUPPORT
Vitria Technical Support provides comprehensive support for all Vitria products
through our Technical Support Web site:
http://help.vitria.com (login and password required)

If you need a login for help.vitria.com, please send your request to:
contractadmin@vitria.com

BusinessWare Introduction ix
PREFACE

Each customer who has purchased a support contract has one or more designated
individuals who are authorized to contact Vitria Technical Support. If you have
questions about using the BusinessWare products, please have a designated
person at your site open a case with Vitria Technical Support.

DOCUMENTATION
If you have any comments on the documentation, please contact the Technical
Publications group directly:
documentation@vitria.com

We would like to hear from you.

x BusinessWare Introduction
 BUSINESSWARE INTRODUCTION

This guide provides an overview of what BusinessWare is, how you can use it, and
how it works.
Topics include:
! The BusinessWare Platform
! BusinessWare in Your Organization
! BusinessWare Users
! The BusinessWare Environments

THE BUSINESSWARE PLATFORM

BusinessWare is a unified, standards-based integration platform that includes
comprehensive, advanced functionality for business process management,
business analysis and monitoring, business vocabulary management, enabling
service-oriented architectures and enterprise connectivity.

BUSINESS PROCESS MANAGEMENT

BusinessWare enables you to build solutions that drive detailed business process
integration logic from high-level, human-oriented business processes.
Capabilities for automating easily maintained multi-step business processes
include:
! State management for tracking, storing, and acting intelligently on the
complete status of each step or a long-lived, multi-step transaction
! Unified process automation and workflow for invoking and using human
intelligence and decision-making more efficiently
! Automated, intelligent management of data and process exceptions and errors
! Transaction rollbacks and compensating transactions
! Time-based exception management
! Nested and concurrent model support
! Design-time repository of reusable subprocesses

BusinessWare Introduction 1
 Business process models in BusinessWare can be invoked synchronously through
a variety of standards-based protocols, such as HTTP, Java RMI, and Web
Services, and asynchronously through a wide variety of standards-based
messaging platforms, including JMS, MQ, and RDBMS.

BUSINESS ANALYSIS AND MONITORING

The business analysis and monitoring capabilities of the BusinessWare platform
give business and IT users visibility over strategic processes, with real-time and
historical process data analysis. With BusinessWare analysis and monitoring
you can:
! Capture the big picture, then drill down on a single data object (such as an
order or claim) to understand the complete status of an item across all systems
involved in the process
! Zoom in on cross-process metrics using real-time analysis to determine which
processes are creating bottlenecks or which customer is most profitable
! Monitor service-level agreements

ENTERPRISE CONNECTIVITY
BusinessWare allows a company to plug in each application, messaging system,
or database just once for it to interoperate with any other connected system.
BusinessWare handles connections and messaging in a transport-independent
manner, providing a flexible data-bus capability.
When making connections between IT assets, you can avoid an inflexible,
hardwired spaghetti of connections that can proliferate beyond the point of
manageability and control. With BusinessWare connectivity and messaging
capabilities, you can:
! Connect to popular packaged applications, messaging systems, and databases
with pre-built, off-the-shelf connectors from Vitria
! Quickly build a connector for homegrown or less common applications
! Choose an appropriate transport techology, including pre-built performance-
optimized channels and queues

To learn more about BusinessWare connectivity and messaging capabilities, see

the documentation that ships with your Vitria connector and the BusinessWare
Connector SDK Programming Guide.

2 BusinessWare Introduction
 SERVICE ORIENTATION
The BusinessWare platform provides native capabilities for exposing existing
legacy and packaged applications as services. Further, BusinessWare can
orchestrate enterprise services through long-lived and short-lived business
processes. Finally, new business processes that provide a higher-level, business-
oriented mediation on service execution, visibility, and performance may be
developed and deployed as services as well . These services may be exposed
through a variety of standards-based synchronous protocols, such as HTTP, RMI,
and Web Services or can be asynchronously invoked through a variety of
standards-based messaging platforms.

Service architectures do not preclude workflow and document-passing solutions,

both of which also have built-in support: the Registry service stores partner
contexts for understanding document metadata and the Document Repository
provides a rich multi-version document storage solution which can ease transport
burdens for highly-integrated workflows and workgroups.
To learn more about how BusinessWare enables service-oriented architectures,
see the BusinessWare Modeling Guide.

BUSINESS VOCABULARY MANAGEMENT

Most companies have hundreds or even thousands of different instances of
applications and electronic document types, resulting in a diverse mix of
business vocabularies. These vocabularies represent the same information with
different formats, structures, contexts, and meanings and may be defined by:
! Industries for business-to-business documents interchange (such as EDI,
SWIFT, and HIPAA)
! Packaged software vendors (such as Siebel, SAP, or PeopleSoft)
! Customer-specific legacy systems

BusinessWare tools validate and transform data between vocabularies, making

integration solutions, faster, less expensive, and easier to change.

For a current list of Vitria business vocabulary management solutions, see

http://www.vitria.com.

BusinessWare Introduction 3
BUSINESSWARE IN YOUR ORGANIZATION
BusinessWare fits into any organization that needs to integrate data from legacy
systems or automate and manage cross-application and cross-functional business
processes. All operations can take place within an enterprise or externally for
customer interactions and business collaborations.

SOLVING INTEGRATION CHALLENGES WITHIN AN ENTERPRISE

The typical cross-organizational scenario shown in Figure 1involves a company
with client information coming in from sales divisions that each use a different
enterprise application. Using BusinessWare, client information can be integrated
for mass mailings and other purposes, and new client information entered into any
database can be integrated into the other databases.
Figure 1

Figure 1 Cross-Organizational Integration

4 BusinessWare Introduction
 SOLVING INTEGRATION CHALLENGES ACROSS ENTERPRISES
Another scenario, shown in Figure 2 might be processing orders through a supply
chain scattered across the globe. Each uses a different application and all need to
coordinate operations to place and fill an order. A customer in San Francisco
places an order, a credit risk analyst in New York checks the customers credit,
and then the order is sent to the distributor in London who sends the order while
simultaneously generating a bill that is processed in Buenos Aires.
Figure 2

Figure 2 Cross-Enterprise Integration

BusinessWare Introduction 5
BUSINESSWARE USERS
BusinessWare is used by those responsible for planning and implementing
business processes and integrations and those who supply information to be
processed and integrated.

Each plays a role in making and maintaining a solution that fits the unique needs
of an enterprise:
! Solution architectsdesign BusinessWare solutions to meet business needs.
! Programmersdevelop the code behind the BusinessWare solution design.
! Business process modelersselect, arrange, and configure the
BusinessWare components that best support the solution.
! Administratorsconfigure and manage BusinessWare servers.
! End usersassign and respond to workflow task requests through the
BusinessWare Workflow Web interface.

THE BUSINESSWARE ENVIRONMENTS

The BusinessWare platform can be divided into three general environments:
! Design environmentin the design environment, the solution architect,
business process modelers, and programmers use the BusinessWare modeling
tools to create graphical integration solutions.
! Execution environmentin the execution environment, the integration
solution that was modeled in the design environment is executed by the
BusinessWare integration server.
! Web browser interfacesin the Web browser interfaces, administrators use
Web pages to administer BusinessWare servers and solutions. People who
participate in completing business process steps also use workflow Web pages
to dispatch their workflow tasks.

6 BusinessWare Introduction
 BusinessWare is capable of integrating with a number of third-party applications
and systems. Table 1 provides a partial list.

Table 1 Applications and Systems that Integrate with BusinessWare

Category Integration Vehicle Shipped with Shipped Separately
BusinessWare from BusinessWare
Distributed System Java Remote Method X
Protocols Invocations (RMI)
J2EE Enterprise Java X
Beans
Web Service Definition X
Language over HTTP
CORBA IIOP X
Simple Connectivity Email connector X
File connector X
HTTP/HTTPS connector X
FTP X
RDBMS connector X
JMS connector X
Application Connectivity SAP connector X
Siebel connector X
PeopleSoft connector X
Oracle Application X
connector
Data Definition Languages XML X
XML DTD X
XML Schema X
Business Vocabularies EDI: X12 and EDIFACT X
SWIFT X
HIPAA X

BusinessWare Introduction 7
 To learn more about the availability of components shipped separately from
BusinessWare, contact Vitria product support at http://help.vitria.com or your
Vitria sales representative.

DESIGN ENVIRONMENT
Your integration architecture can be clearly translated to BusinessWares
modeling design environment. This environment, called the BME (Business
Modeling Environment), allows you to develop and work with models that are
visual representations of your solution that can be used through the entire solution
lifecycle. Using the BME, you can look at high-level pictures of your processes
or, drill down for a detailed look at process components. (See Figure 3.)

From the high-level view of business process designers and component

developers, the processes that make up your integration solution can be seen, and
the models you develop can be reused in other solutions so that you can extend
solutions or develop new ones with efficiency and consistency.

8 BusinessWare Introduction
Figure 3

Figure 3 Integration Model with a Drill-Down View

BusinessWare Introduction 9
 As shown in Figure 4, models are designed in the BME Editor window using
palettes of modeling elements, and each element can be arranged, formatted, and
annotated to your specifications.
Figure 4

Palettes BME Editor Window

Proxy

Connector

Process
Component

Integration Port Wire

Component

Figure 4 BusinessWare Modeling Environment

! Componentsare models that perform specific business functions.

! Connectorscommunicate between external applications and
BusinessWare.
! Proxiesrepresent interactions and connectivity via standard protocols, such
as Remote Method Invocation (RMI) and Web services.
! Portsdefine the types of events and operations that will communicated to
components and indicate which direction communication occurs.
! Wiresconnect ports between components.

10 BusinessWare Introduction
 In the design environment, there are two key component types: integration models
and process models.

Integration Models
Integration models represent the overall structure and operation of a solution by
showing the main components and how they interact with each other and external
systems.

Every BusinessWare solution project has one root integration model, which is the
top-level model in the project. Depending on the complexity of the solution, there
may also be nested integration models (as shown in Figure 3) which represent
individual subsystems.

Figure 5 shows an example of a top-level integration model.

Figure 5

Figure 5 Top-Level Integration Model

Process Models
Process models contain the rules for initiating and managing your business
processes. For example, you might set up a process model to automate interactions
with ordering, inventory, billing, and shipping systems. You might also have
process models for human interaction, assigning a credit-risk analyst to approve
orders over a certain amount.
Figure 6 shows the parts of the process model that are discussed below.

BusinessWare Introduction 11
Figure 6

Port Process Model

Event State Transition

Figure 6 Process Model State Chart Diagram

From a modeling perspective, a process model is an statechart diagram based on

the Unified Modeling Language (UML).

As a statechart, the process model specifies:

! Statesone or more represent a distinct activity in a business process, such as
checking inventory
! Transitionscontrol the progression from state to state

12 BusinessWare Introduction
 ! Eventstrigger transitions
! Portscontrol what input is received and how output is distributed; ports are
the models gateways to other BusinessWare components and external
systems

EXECUTION ENVIRONMENT
After you have modeled, built, and deployed your solution (making it available to
the directory and integration servers), you are ready to run it in the execution
environment. As shown in Figure 7, you control the solution runtime from the
Administration Tool or command line tools. You can use these tools to start your
solution, processing events through the directory and integration servers and
depositing integrated data into the database server that manages external
application data.
Figure 7

Figure 7 Execution Environment

ADMINISTRATION TOOL
The Administration Tool, shown in Figure 8, allows administrators to manage or
monitor the BusinessWare execution environment and the solutions built and
deployed to this environment.
The Administration Tool:
! Provides a single point of administration for all BusinessWare installations
! Displays information about the objects in the BusinessWare namespace in the
directory server

BusinessWare Introduction 13
 ! Uses a Web browser or command line tools for administrating the execution
environment anywhere on the network
Using the Administration Tool, you can:
! Ensure that all components of the BusinessWare solution are functioning
properly
! Start and stop projects
! Start and stop servers
! Query the BusinessWare directory structure for components
! Get and set attributes and properties for various components

As shown in Figure 8, the Administration Tool opens with a login page so you can
administer solutions securely.
Figure 8

Figure 8 Administration Tool Login Page

14 BusinessWare Introduction
 From the login page, you work with a Projects page to view and control the
solution runtime.
Figure 9

Figure 9 Administration Tool Projects Page

MANUAL WORKFLOW WEB INTERFACE

BusinessWare provides Web-based interfaces to enable performers and
supervisors to manage their workflow tasks manually. The Web-based interfaces
include Task List pages for performers and supervisors.

Task List
The Task List is a series of Web pages the performer can use to view and manage
tasks. A performer can view assigned tasks, indicate when an assigned task is
complete, and relay any data associated with completing the task back to the
automation system for further processing. Tasks can be sorted by due date,
priority, and a number of other attributes. Figure 10 shows the starting point for
working with the task list.

BusinessWare Introduction 15
Figure 10

Figure 10 Performer Task List Page

Supervisor Pages
The supervisor pages are a series of Web pages in the Task List that supervisors
can use to monitor and manage tasks assigned to themselves and their
subordinates. Supervisors can access the same basic functions as performers, as
well as change the state of tasks on behalf of performers. For example, a
supervisor can reassign a task if the assigned performer is out of the office.
Figure 11 shows the task list for supervisors.

16 BusinessWare Introduction
Figure 11

Figure 11 Supervisor Task Page

BusinessWare Introduction 17
18 BusinessWare Introduction
 INDEX

A M
Administration Tool 1-13 monitoring 1-2

B S
BME 1-8 State management 1-1
business analysis 1-2 storing 1-1
Business Modeling Environment 1-8
T
C tracking 1-1
connectivity 1-2
U
D Unified Modeling Language 1-12
Design environment 1-6 Unified process automation 1-1

E V
exception management 1-1 vocabulary management 1-3
Execution environment 1-6
W
I Web browser interfaces 1-6
Integration models 1-11 workflow 1-1

BusinessWare Introduction Index-1

Index-2 BusinessWare Introduction