ActiveBPEL Designer Online Help V4.1
Online Help Conventions
XML Syntax
Installation and System Requirements
Documentation Conventions
Welcome to ActiveBPEL Designer
About ActiveBPEL Designer
Working in the Eclipse Environment
Introducing Business Process Execution Language
A Little BPEL History
BPEL Resources
What’s New in WS-BPEL 2.0
Opening and Using BPEL4WS 1.1 Processes
Migrating Processes from BPEL4WS 1.1 to WS-BPEL 2.0
WS-BPEL 2.0 Limited Support in ActiveBPEL Designer 2.X
Links to WS-BPEL 2.0 and BPEL4WS 1.1 Specifications
What is a BPEL Process?
BPEL Process Definition Elements
ActiveBPEL Extensions to WS-BPEL 2.0
ActiveBPEL Feature Tour
ActiveBPEL Designer Installation Options
Printing ActiveBPEL Designer User's Guide
ActiveBPEL Tutorial
Introduction to ActiveBPEL Tutorial
Tutorial Part 1: Starting a New Process
Tutorial Part 2: Planning and Designing a Process
Tutorial Part 3: Adding Web References
Tutorial Part 4: Using the Operation Wizard to Create Web Interaction Activities
Tutorial Part 5: Adding Process Activities and Properties
Tutorial Part 6: Adding Fault Handling
Tutorial Part 7: Adding Compensation and Correlation
Tutorial Part 8: Simulating the Process
Tutorial Part 9: Deploying the Process
Tutorial Part 10: Running the Process on the Server
Tutorial Part 11: Debugging Your Process Remotely
Using ActiveBPEL for the First Time
Launching ActiveBPEL Designer
Using the Workspace to Store Projects
Creating Projects and Folders
Starting a New Process
Importing an Existing BPEL Process into ActiveBPEL
Using the ActiveBPEL Samples
Getting Started in ActiveBPEL Designer
About ActiveBPEL Designer and the Eclipse Workbench
Navigating Through ActiveBPEL Designer
Windows, Perspectives, Views, and Editors
ActiveBPEL Perspectives
ActiveBPEL Designer Perspective
BPEL File Navigator
Web References
Outline View
Properties View
Process Variables
Error Log
Problems View
Tasks View
Thumbnail View
Bookmarks View
Status Bar
ActiveBPEL Debug Perspective
Using the ActiveBPEL Process Editor
Process Editor Process Activities Tab
Process Editor Fault Handlers Tab
Process Editor Event Handlers Tab
Process Editor Compensation and Termination Handler Tabs
Process Editor Source Tab
Using Process Editor Tool Palettes
Displaying Swimlanes
Setting Visual Properties and Using Your Own Library of Images
Adding Tasks and Bookmarks to the Process
Adding Comments to a Process
Adding Documentation to a Process
Tips for Designing on the Process Editor Canvas
Expanding and Collapsing Container Activities
Process Editor Keyboard Shortcuts
ActiveBPEL Function Keys
Customizing the ActiveBPEL Perspective
ActiveBPEL Preferences
Layout Preferences
Swimlane Appearance Preferences
Tasks and Problems Preferences
Identity Chooser Preference
Additional Preferences
Accessing ActiveBPEL Online Help
Preserving BPEL Layout With VBPEL Files
Web References
What is a Web Reference?
Viewing, Adding, and Removing Web References
Viewing Key Elements of a WSDL Tree
Web References Toolbar Options
Adding a Web Reference
Removing a Web Reference
Viewing, Editing, and Resolving Web References
Refreshing Web References
Filtering the Web References View by Reference Set
Viewing WSDL Namespaces, Messages, Partner Link Types, and Schema
Using WSDL Operations in BPEL Activities
Creating a WSDL File with Extensions for BPEL
Using Sample Data for WSDL Messages
Adding a Sample Data Value for a Simple Type Message Part
Generating a Sample Data File
Adding a Sample Data File in Web References
Selecting a Default Sample Data File
Viewing the XML Structure of a Sample Data File
Removing a Sample Data File
Finding Where a WSDL Component is Used
Using Web References Search
Planning Your BPEL Process
Using Top-Down or Bottom-Up Process Design
Using WSDL References for Efficient Design
Creating WSDL Extensions for BPEL
Starting a Process by Dropping an Operation onto the Process Editor
Importing WSDL, Schema, and Other Resources
Automatically Importing WSDL and Schema Locations
Manually Importing WSDL, Schema, and Other Resources
Refreshing Imports
Deleting an Import
Namespace Prefix and Declaration
Declaring Extensions
Using the ActiveBPEL Create XPath Extension
Using the ActiveBPEL Disable Selection Failure Fault Extension
Declaring
Extension Elements and Attributes
Understanding BPEL Process Structure and Properties
Process Element and Properties
Partner Links
Variables
Activities
Fault Handlers
Compensation Handlers
BPEL XML Source and Implicitly Added Activities
Understanding BPEL Process Lifecycle
Creating an Executable vs. an Abstract Process
Creating an Abstract Process
Tips for Working with Abstract Processes
Creating a BPEL Process as a Service for Another BPEL Process
Message Exchange Declaration
Partner Link Types and Partner Links
What are Partner Link Types and Partner Links?
Partner Link Type
Partner Link
Using Scoped Partner Links
Partner Links and Endpoint References
Showing and Hiding Swimlanes
Showing and Hiding Lanes for Partner Link Definitions
Exporting a Partner Link to an Abstract Process
Creating an Activity
Overview of Activities
Defining an Activity and Its Properties
Selecting Values for Activity Properties
Selecting Activity Labels
Standard Properties for Activities
Receive
Invoke
From Part to Variable
From Variable to Part
Reply
Validate
Assign
Tips for Copy Operations
Copy Operation Query and Expression Examples
Copy Operation Literal
Contents Examples
Copy Operation Dynamic Endpoint Reference Example
Element to Element Copy Operation with Keep Source Element Name Attribute
Copy Operation with Ignore Missing From Data Attribute
Throw
Rethrow
Exit
Wait
Empty
Compensate Scope
Compensate
Break
Continue
Suspend
Opaque
Creating a Custom Activity
Creating an Activity by Starting with a Web Reference
Creating an Activity Using the Operation Wizard
Using the Expression Builder
BPEL Functions
ActiveBPEL Custom Functions
String Functions
Number Functions
Boolean Functions
Node Set Functions
Example Expressions for Message, Element, and Complex Schema Type Variables
Expected Expressions for Conditions, Counters, and Other Values
Using the Query Builder
Creating a Join Condition for an Incoming Link
Deadline and Duration Expressions
Structuring Activities
Different Ways of Structuring Activities
Defining a Container and its Branches and Properties
Defining Container Branches
Defining Container and Branch Properties
Sequence
Flow
While
Repeat Until
Pick
If
Scope
Setting Isolated to “Yes” in a Scope
Using a Termination Handler for a Scope
Lifecycle of a Scope
For Each
Selecting Activities for Containment
Using Variables
Overview of Variables
Adding a Variable
WSDL Message Types
XML Schema Type
XML Schema Element
Adding Variable Properties and Property Aliases
Initializing a Variable
Viewing Variables
Quick View of Variables Used in Activities
Using the Process Variables View Options
Opening a Variable to View its Definition
Viewing Variable Properties
Understanding Icons, Symbols, and Descriptions of Variable Parts
Deleting a Variable
Using Sample Data in Process Variables View
Editing a Single Sample Data Value for a Simple Type Message Part
Loading a Sample Data File in Process Variables View
Saving and Viewing Sample Data in Process Variables View
Using the XML Data Wizard
Finding Variables Where Used
Using Variables in a Copy Operation
Creating a Copy Operation Using a Context Menu
Creating a Copy Operation Using Drag and Drop
Selecting a Copy Operation to Edit
Using Variables Based on WSDL Fault Messages
Mapping WSDL Message Parts in Web Service Interaction Activities
Validating Variables
Working with Variable Attachments
Attachments
What is an Attachment?
Adding an Attachment
Adding an Attachment for Simulation
Remote Debugging with Variable Attachments
Custom Functions for Attachments
Attachment Custom Function Examples
Using Links
What is a Link?
Adding a Link Between Activities
Adding a Link with no Transition
Adding a Link with a Transition Condition
Link Examples
Execution Rules for Links
Designing With Links vs. Structured Activities
Links and the Join Condition
Link Properties
Compensation
What is Compensation?
Compensation Handlers and Compensate Activities
Default-Order Compensation Example
Specified Compensation Example
Adding a Compensation Handler to a Scope
Compensating an Invoke Activity
Correlation
What is Correlation?
What is a Correlation Set?
WSDL Syntax and Example for Property Names and Aliases
Global and Local Correlation Sets
Creating Message Properties and Property Aliases
Creating a Property Definition
Creating a Property Alias
Adding a Correlation Set
Deleting a Correlation Set
Adding Correlations to an Activity
Initiating and Setting Patterns for Correlation
Adding Correlation to a Receive, OnMessage, OnEvent, or Reply
Adding Correlation to an Invoke Activity
Adding Missing Correlation
Rules for Declaring and Using Correlation Sets
Correlation Sets and Engine-Managed Correlation
Event Handling
What is Event Handling?
Adding Event Handlers
Adding an onEvent Event Handler
Adding an onAlarm Event Handler
Processing Rules for Events
Fault Handling
What is BPEL Fault Handling?
Defining Catch and CatchAll Fault Handlers
Fault Handling for Service Invocations
Adding a Fault Handler
Adding a Fault Handler for the Process
Adding a Fault Handler for a Scope
Adding an Inline Fault Handler for an Invoke Activity
Selecting a Fault Name
Adding a Fault Variable Definition
Fault Handling Processing Rules
Rules for Catching Faults in a Catch Activity
Tips on Fault Handling
Simulating and Debugging
What is the ActiveBPEL Debug Perspective?
Opening the ActiveBPEL Debug Perspective
Switching Between ActiveBPEL Perspectives
ActiveBPEL Debug Perspective Views and Menus
Using the ActiveBPEL Debug View
Using Breakpoints in BPEL Process Simulation
Using the ActiveBPEL Debug Console
Simulating Execution of a BPEL Process
Prerequisites for Simulation
Starting and Ending Simulation of a BPEL Process
Running to a Breakpoint in a BPEL Process
Stepping to the Next Activity in a BPEL Simulation
Viewing the Execution State of an Activity or Link
Modifying a BPEL Process During Simulation
Terminating and Removing BPEL Process Simulations
Clearing the Process Execution State
Supplying and Inspecting Sample Variable Data During Simulation
Setting up Sample Data Values for Input, Output, and Fault Messages
Inspecting Process Variables during Simulation
Selecting Simulation Paths and Properties
Simulating Event Handlers
Simulating Fault Handlers
Inspecting Standard Faults During Simulation
Simulation Preferences
Disable bpel:selectionFailure Fault Example
Auto Create Target Path for Copy/To Example
Disable bpel:selectionFailure Fault and Auto Create Target Path for Copy/To Example
Setting Debug Preferences
Debugging Remote Processes Running on the Server
Configuring a Remote Process Connection
Selecting Processes for Remote Debugging
Setting Breakpoints on a Process for Remote Debugging
Using the Debug View, Process Editor, and Variable View for Remote Debugging
Remote Debugging Preferences
Selecting a Launch Configuration from the Toolbar
Checking for an Out of Sync Process
Server Interactions During a Remote Debugging Session
Setting Options for Console Output
Correcting, Retrying, or Completing Activities
Updating Variable Data in the Process Variables View
Updating Correlation Property Data
Updating Partner Link Address Information
Deploying Your Processes
What is Deployment?
Preparing for Deployment
Preparing BPEL Files for Deployment
Selecting an ActiveBPEL Server Platform for Deployed Processes
Endpoint Reference Addressing Considerations
Endpoint References and WS-Addressing Considerations
Endpoint References Requiring Credentials for Access
Specifying a Replacable URN/URL for an Endpoint Reference
Endpoint References and WS-Policy
Overview of Process Deployment Steps
Creating a Process Deployment Descriptor File
Deployment Platforms
Partner Role Invoke Handlers
Partner Role Endpoint Types
My Role Binding, Service Name, and Allowed Roles Options
Selecting a Service for a Deployment Descriptor Partner Link
Adding Policy Assertions
Authentication
Encryption
Signature
Timestamp
Retry
XPath Header Map
Engine-Managed Correlation
WS-Reliable Messaging
User-Defined Policy Assertion
Adding Indexed Properties
Editing a Process Deployment Descriptor File
Creating a Partner Definition File
Creating a Business Process Archive File
Using a BPRD Script to Regenerate and Deploy a BPR File
Deploying Your Process to the ActiveBPEL Engine
Deploying Your Process to ActiveBPEL Enterprise
Starting the Server and Running a Process
How a BPEL Process is Instantiated
What is Process Versioning?
Creating and Using Custom Functions
Custom Functions Technical Requirements and Sample Files
Java-Based Custom Functions
Custom Functions in ActiveBPEL Enterprise for .NET
Adding Custom Functions to Expression and Query Builders
Specifying Custom Function Simulation Setup
Adding Custom Functions to the ActiveBPEL Engine
Process Exception Management
What is Process Exception Management?
Suspending a Process on Uncaught Faults
Making all Processes Eligible for Suspension on Uncaught Faults
Making Individual Processes Eligible for Suspension on Uncaught Faults
Suspending a Process Programatically with a Suspend Activity
Remote Debugging a Faulting Activity
BPEL Standard Faults
Special Purpose BPEL Processes
Alert Service
Retry-Policy Service
Identity Service
Email Service
Monitoring Alert Service
Glossary
Index
Technical Support
Tips and tricks
What's New
Printed Version
Samples
All Samples
ActiveBPEL Release Notes - All Products V4.1
Designer
Apache Tomcat Enterprise
BEA WebLogic
IBM Websphere
JBOSS
Microsoft .NET
ActiveBPEL for People
ActiveBPEL Designer's CentraSite Publication Online Help V4.1
ActiveBPEL® Designer CentraSite Publication Help
What is CentraSite?
What Are the Prerequisites to Publishing BPEL into CentraSite?
Starting the BPR Export Wizard to Access CentraSite Publication
CentraSite Publication
Executing a CentraSite Script
Printed Version
ActiveBPEL Enterprise Administration Console Online Help V4.1
ActiveBPEL® Enterprise Administration Console Overview
Prerequisites for Running the Administration Console
Options for Different Application Servers
Understanding the Properties of an Invoked Service
Home
Engine
Engine Properties
URN Mappings
Function Contexts
Server Configuration (Tomcat)
Alerts
Monitoring Properties
Cluster Configuration (WebSphere/WebLogic)
License
Monitoring
Storage
Version Detail
Extended Services
Email Service
Identity Service
Creating a Trusted Keystore File
Task Manager (ActiveBPEL for People Inbox)
Deployment
Deploy BPR
Deployment Logs
Deployed Processes
Deployed Process Detail
Deployed Process Version Detail
Deployed Services
Indexed Properties
Partner Definitions
Resource Catalog
Process Status
Active Processes
Using Selection Filters for Active Processes
Alarm Queue
Receive Queue
Process ID and Process Details
Using the Process Details Page
Using the Process Details Graphic View
Using the Process Details Outline View
Inspecting Where and Why an Activity Faulted
Working with Variable Attachments
Process Versions
Process Version Life Cycles
Process Version Persistence Type
Exception Management Type
Process Instance Retention Days
ActiveBPEL Enterprise Clusters (Application Server Specific)
Process Exception Management
BPEL Standard Faults
ActiveBPEL Custom Faults
Printed Version
ActiveBPEL Enterprise Installation, Configuration, and Deployment Guide V4.1
Apache Tomcat
Overview
Introduction
Prerequisites
Installation
Configuration
Deployment
Installation Checklist
Glossary
ActiveBPEL for People Inbox Configuration
ActiveBPEL for People Inbox Deployment
BEA WebLogic
Overview
Introduction
Prerequisites
Installation
Configuration
Deployment
Installation Checklist
Glossary
ActiveBPEL for People Inbox Configuration
ActiveBPEL for People Inbox Deployment
IBM Websphere
Overview
Introduction
Prerequisites
Installation
Configuration
Deployment
Installation Checklist
Glossary
ActiveBPEL for People Inbox Configuration
ActiveBPEL for People Inbox Deployment
JBOSS
Overview
Introduction
Prerequisites
Installation
Configuration
Deployment
Installation Checklist
Glossary
ActiveBPEL for People Inbox Configuration
ActiveBPEL for People Inbox Deployment
Microsoft .NET
Overview
Introduction
Prerequisites
Installation
Configuration
Deployment
Installation Checklist
Glossary
ActiveBPEL Enterprise Server User Guide V4.1
Preface
Welcome to ActiveBPEL Enterprise
What are the Server Components of ActiveBPEL?
Installing, Configuring, and Starting Up the Server
Configuring ActiveBPEL Enterprise for WS-Security
Configuring Java-Based Servers for WS-Security
Configuring .Net-Based Servers for WS-Security
What is a BPEL Process?
How Do I Create, Deploy, and Run a BPEL Process?
Using ActiveBPEL Designer
Using the ActiveBPEL Enterprise Administration Console
Deployment Basics
What is Business Process Deployment?
What is a Business Process Archive?
What is a Process Deployment Descriptor?
Endpoint References and WS-Addressing
Endpoint References and WS-Policy
Authentication
Encryption
Signature
Timestamp
Retry
XPath Header Map
Engine-Managed Correlation
WS-Reliable Messaging
User-Defined Policy Assertion
Partner Role Details
Partner Role Invoke Handlers
URN/URL Mappings for an Endpoint Reference
My Role Details
Engine Settings for Individual Processes
Process Version Details
Process Group
Indexed Properties
What is a Partner Definition File?
Deploying a Business Process Archive
Executing and Modifying a BPRD Script
Understanding the Resource Catalog
Creating a Standard or External Service Endpoint for My Role Partner Links
Standard vs. External Publishing of Service Endpoints for My Role Partner Links
What is an External Service Endpoint?
Creating a J2EE for Web Services Endpoint
Adding the ActiveBPEL Engine EJB Interface to the Java Class File
Adding the My Role Partner Link Context to the Java Class File
Adding a Security Context to the Java Class File
Example J2EE Web Service Endpoint
Packaging a J2EE for Web Services Endpoint
Deploying a J2EE Web Services Endpoint
Custom Invoke Handlers
Standard vs. Custom Invocation of Service Endpoints
What is a Custom Invoke Handler?
Referencing the Custom Invoke Handler Interface in a Java-Based Implementation
Referencing the Custom Invoke Handler Interface in a .NET Assembly
Adding the Custom Invoke Handler Attribute to the Process Deployment Descriptor
Packaging the Custom Invoke Handler as an EJB
Deploying Custom Invoke Handler Files
Special Purpose BPEL Processes
Alert Service
Retry-Policy Service
Identity Service
Email Service
Printed Version
ActiveBPEL for People Inbox Online Help V4.1
About My ActiveBPEL for People Inbox
What is an ActiveBPEL for People Task?
About Users and Administrators
Navigating in the Inbox
Refreshing Your Task List
Claiming, Starting, Revoking, and Setting Priority for a Task
Working with a Work Item, Attachments and Comments
Modifying a Task
Completing or Failing a Task
Assigning a Task to Another User
What Happens When a Task is Overdue
About ActiveBPEL® Server and the Inbox
Starting and Signing Into the Inbox
Session Time Out
Printed Version
ActiveBPEL for People Online Help V4.1
Welcome to ActiveBPEL for People
Getting Started with ActiveBPEL for People
What is ActiveBPEL for People?
Introducing Human Workflow into a BPEL Process
Routing Tasks to People at Run Time
About Task LifeCycle
Creating the Artifacts Needed for the People Activity
Using the People Activity
What is a People Activity?
Conceptual Overview of the People Activity
Adding a People Activity
Adding Potential Owners
Identity Chooser
Generating Literal Contents for Potential Owners and Administrators
Using an Expression to Define Potential Owners and Administrators
Adding Administrators
Adding an Interface
Setting up Task Data Mappings
Specifying Input Data Mappings
Specifying Output Data Mappings
Sending and Receiving Attachments
Adding Task Deadlines and Actions
Notification Action
Revoke Owner Action
Reprioritize Task Action
Adding Task Expiration Details
Adding Task Presentation Properties
Adding a Name and Target Namespace
Composing an Expression for a Task Subject and Other Task Details
Catching a Fault Thrown by the People Activity
Simulating, Debugging, and Deploying the People Activity
Simulating a Process with a People Activity
Deploying a BPEL Process Containing a People Activity
Running Your Process from the ActiveBPEL Enterprise Server
Customizing the ActiveBPEL for People Task Inbox and Other Clients
What is the ActiveBPEL for People Inbox?
Viewing the Default Rendering of Task Inbox Details Page
Providing Rendering for the Inbox or Another Client Application
List of Renderings
Customizing Interface MetaData
Adding a Rendering
Creating a JSP Rendering
Creating an XSL Rendering
Using the ActiveBPEL Default XSL Rendering Files
Filling in the Presentation and Command URI
Creating a Custom Rendering
Contributing a Custom Task Rendering Hint Editor
Creating Custom Escalation Actions
Printed Version
ActiveBPEL Open Source Engine Help V4.1
ActiveBPEL® Engine Administration Console Help
Administration Home Page
Engine
Deployment Status
Process Status
Process ID and Process Details
Using the Process Details Page
Using the Process Details Graphic View
Using the Process Details Outline View
Inspecting Where and Why an Activity Faulted
Working with Variable Attachments
Persistence Storage Setup
ActiveBPEL Custom Faults
Printed Version
ActiveBPEL for People Customizations V4.1
ActiveBPEL for People Customizations