Skip Navigation Links | |
Exit Print View | |
Oracle Java CAPS BPEL Designer and Service Engine User's Guide Java CAPS Documentation |
BPEL Designer and Service Engine User's Guide
To View the Installed or Deployed JBI Components
The Composite Application Project
BPEL Designer and Service Engine Features
Supported WS-BPEL 2.0 Constructs
BPEL Service Engine and Oracle SOA Suite
Understanding the BPEL Module Project
Creating Sample Processes in the BPEL Designer
An Asynchronous Sample Process
Travel Reservation Service Sample
Creating a Sample BPEL Module Project
Navigating in the BPEL Designer
Element Documentation and Report Generation
Creating Documentation for an Element
Collapsing and Expanding Process Blocks in the Diagram
To Collapse and Expand a Process Block
Zooming In and Out of the Diagram
Printing BPEL Diagrams and Source Files
Creating a BPEL Module Project
To Check the Status of the GlassFish V2 Application Server in the NetBeans IDE
To Register the GlassFish V2 Application Server with the NetBeans IDE
To Start the GlassFish V2 Application Server in the NetBeans IDE
Creating a new BPEL Module Project
To Create a BPEL Module Project
Creating the XML Schema and the WSDL Document
Creating a BPEL Process Using the BPEL Designer
Creating a Composite Application Project
To Create a New Composite Application Project
Building and Deploying the Composite Application Project
To Build and Deploy the Composite Application Project
Testing the Composite Application
Test the HelloWorldApplication Composite Application Project
Developing a BPEL Process Using the Diagram
Configuring Element Properties in the Design View
Finding Usages of BPEL Components
To Find Usages of a BPEL Component
The BPEL Designer Palette Elements
Adding BPEL Components to the Process
Using the Partner Link Element
Dynamic Partner Links and Dynamic Addressing
Using the CompensateScope Element
CompensateScope Element Properties
Adding an Else If Branch to the If Element
Adding an Else Branch to the If Element
Using the Repeat Until Element
Repeat Until Element Properties
Adding Branches to the Flow Element
Changing the Order of Elements inside Flow
Adding Child Activities to the Sequence
Changing the Order of Elements inside Sequence
To Open the BPEL Mapper Window
To Create a Mapping Without Using any Functions
To Use a Function in a Mapping
To Delete a Link or Function in a Mapping
Using Type Cast and Pseudo-Components
Type Cast and Pseudo Component Limitations
Using Normalized Message Properties
Using Normalized Message Properties in a BPEL Process
Using Predefined Normalized Message Properties in a BPEL Process
To Use Predefined Normalized Message Properties in a BPEL Process
Adding Additional Normalized Message Properties to a BPEL Process
To Add a Normalized Message Property Shortcut to a BPEL Process
To Edit an NM Property Shortcut
To Delete an NM Property Shortcut
To Add a Normalized Message Property to a BPEL Process
BPEL Code Generation Using NM Properties
General Normalized Message Properties
Binding Component Specific Normalized Message Properties
To Add a Compensation Handler to Scope or Invoke Elements
To Add a Termination Handler to Scope or Process Elements
Understanding Correlation. Using the Correlation Wizard
Elements That Use and Express Correlation
Defining Correlation Using the Correlation Wizard
BPEL Process Logging and Alerting
To Set the Log Level for the BPEL Service Engine
Configuring the BPEL Service Engine Runtime Properties
Accessing the BPEL Service Engine Runtime Properties
BPEL Service Engine Deployment Artifacts
Testing and Debugging BPEL Processes
To Add a Test Case and Bind it to a BPEL Operation
Steps in Debugging BPEL Processes
Starting and Finishing a BPEL Debugging Session
Using Breakpoints to Debug BPEL Processes
Group operations over breakpoints
Monitoring Execution of BPEL Processes
Correlation Sets and Faults information
BPEL Debugger Console Messages
Monitoring the BPEL Service Engine
Installing the BPEL Monitor API and Command Line Monitoring Tool
To Install the Monitoring Tool
Using the BPEL Monitor Command Line Tool
To Use the BPEL Monitor Command Line Tool
Configuring Quality of Service (QOS) Properties, Throttling, and Redelivery
Configuring the Quality of Service Properties
To Access the Config QOS Properties Editor
Configuring Message Throttling
Configuring an Endpoint for Throttling
Using Dynamic Partner Links and Dynamic Addressing
Using a Literal to Construct an Endpoint
Using an Existing Partner Link's Endpoint
Using an Incoming Message to Extract the Endpoint
Using a Database Query to Provide an Endpoint
Sending Service Endpoint References
Configuring Persistence for the BPEL Service Engine
Setting the JVM Classpath to the Database JDBC Drivers
To Set the GlassFish JVM Classpath Settings
Configuring the User and Database for Persistence
Creating an XA Connection Pool and a JDBC Resource
To Create an XA Connection Pool
Creating a Non-XA Connection Pool and JDBC Resource
Enabling Persistence for the BPEL Service Engine
To Enable Persistence for the BPEL Service Engine
Truncating and Dropping Tables
Configuring Failover for the BPEL Service Engine
Using BPEL Schemas Different from the BPEL 2.0 Specification
Relationship of Service Endpoint to Test Cases
GlassFish V2 Application Server HTTP Port
Travel Reservation Service Endpoint Conflict
Disabling Firewalls when Using Servers
Required Correlation Set Usage is Not Detected by the Validation System
This section explores the navigation capabilities of the BPEL Designer.
Zooming In and Out of the Diagram
Printing BPEL Diagrams and Source Files
The new BPEL file opens in the Design view of the BPEL Designer.
To open the BPEL Designer, either create a new BPEL Process or open an existing BPEL Process. The image above shows the NetBeans IDE open to the BluePrint1 Project's BPEL process in the BPEL Designer. If the Pallet and Properties windows are not displayed in your current view, click Windows -> Reset Windows from the NetBeans menu.
The BPEL Designer includes the following components:
BPEL Editor — The center pane displays the BPEL Editor. The Design view of the BPEL Editor enables you to visually model the business process. The BPEL Designer automatically generates BPEL code that corresponds to the visual design.
Pallet — The Pallet, available in the designers upper-right pane of the Design view, provides easy access to the BPEL elements.
Properties Window — The Properties window, available in the lower-right pane of the Design view, provides the property sheet for any selected component or activity.
Navigator Window — The Navigator window, available in the lower-left pane, shows the BPEL Logical View of the BPEL process.
Source View — Click the Source button, and the Source view of the BPEL Editor displays the code for the current process.
BPEL Mapper — To see the BPEL Mapper view, select a BPEL activity in the Design view of the editor, then click the Mapper button. The Mapper view of the BPEL Editor provides a framework that enables you to define and direct BPEL process data.
BPEL Logger — To see the BPEL Logger view, select a BPEL activity in the Design view of the editor, then click the Logger button. The Logger, similar in appearance to the BPEL Mapper view, enables you to select the level of logging for the various process activities.
In the BPEL Editor you can switch between Source View, Design View, Mapper View and Logging View. All the views are always kept in sync.
Design View — The Design view is a business processes designer where you can author a diagram of your business process. In the Design view, you add, edit, and delete diagram elements. The diagram constructed in the Design view is automatically generated into BPEL source code compliant with the WS-BPEL 2.0 specification with the exceptions listed in the BPEL 2.0 Language Constructs section of the BPEL Service Engine User's Guide.
The Design view opens by default when you double-click a BPEL source file from a BPEL Module project in the Projects window. To switch to the corresponding place in the Source view, right-click an element in the Design view and select Go to Source (Alt-O).
Source View — The Source view shows the underlying code for a business process diagram. The Source view is based on the IDE's XML Source view and provides access to conveniences such as code folding, XML syntax highlighting, and code completion.
You can perform source level editing as well as visual designing. The BPEL Designer will perform round-trip two-way engineering to ensure that the Design view and Source view remain synchronized with each other. The IDE will automatically re-parse the BPEL source file and rebuild the diagram every time you perform manual edits of the source file.
To switch to the corresponding place in the Design view, place a cursor at the line in the Source view, right-click and choose Go to Design (Alt-D).
Mapper View — The BPEL Mapper provides a framework for processing and directing BPEL process data. The BPEL Mapper can be used to assign values or to set conditions. To switch to the Mapper view press Ctrl-Shift-F9 or click the Mapper tab on the editor toolbar. For more information refer to the Using the BPEL Mapper section.
Logging View — The Logging view provides you with the capability to set logging or alerting rules for the process. To switch to the Logging view press Alt-L or click the Logging tab on the editor toolbar. For more information see the Logging and Alerting section.
The Clone Document feature is a customization option which enables you to clone documents views. For example, if you want to see both the source and the design view of a BPEL process at the same time (or the Design and Mapper view) follow the instructions below.
Several views of one document are always kept in sync.
Another tab with the same document is created.
The BPEL Designer includes a feature that allows you to create comments (documentation) attached to the elements of a BPEL process. This documentation is then included with the source code of the BPEL process and can later be extracted and included in a report.
Select an element on the diagram or in the Navigator window.
Click the selected element's Documentation icon which appears next to the selected element in the diagram.
A documentation window appears.
Type any information or comments that you feel are useful, into the Documentation window. This documentation is now available to you whenever you open the Documentation window, and is also written to the element's Properties file.
The Report Generation feature of the BPEL Designer enables you to generate a PDF document describing the BPEL Process. By creating a custom report you can create a more verbose report or include information for only those elements that have documentation, in the report.
From the BPEL Diagram toolbar, press the Generate Report button. The report, in PDF format, is added to the project's Process files in the Projects window.
The report includes the following information:
The name of the process
The diagram
Information about partner links
Information about imported documents
A list of all defined variables
Information about the process elements
Documentation created for the process elements
To customize a report so it includes all of the element properties, or to include only elements that have documentation, click the Customize Report button in the BPEL Diagram toolbar.
A Customize Report dialog box appears.
Choose Generate Verbose Report to include all of the element properties in the report.
Choose Include Only Elements with Documentation to only include elements with documentation in the report.
Click OK, and click the Generate Report button. If a report already exists, the new report will overwrite the existing report in the Projects window.
The Navigator window is a companion of the BPEL Designer. If the Navigator window is not visible, you can manually invoke it by selecting Window -> Navigating -> Navigator from the main menu or pressing the Ctrl-7 key combination.
The Navigator window provides two distinct views of the BPEL process: BPEL Logical View and XML View. You can switch between the XML View and BPEL Logical View using the drop-down menu in the upper part of the Navigator window.
The XML View is identical to the Navigator view that is available for all XML documents opened in the IDE. The XML View is a companion to the BPEL Source view. Double-click any Navigator node and the Source view adjusts the current line of code to show the selected element.
The Navigator also provides the BPEL Logical View of BPEL processes. When you select BPEL constructs in the Design view, the BPEL Logical View shows the same element selected. Alternatively, when you select a node in the BPEL Logical View's tree, the corresponding element is selected on the diagram.
Right-clicking the nodes in the BPEL Logical View invokes context menus with actions relevant to the particular node. For example, for the Assign element, the actions are Go to Source, Go to Design, Wrap With, Move Up and Move Down, Toggle Breakpoint, Delete, Show BPEL Mapper, and Properties. The Go to Source and Go to Design actions, available for most of the nodes, have associated keyboard shortcuts: Alt-O for Go to Source and Alt-D for Go to Design.
In general, the nodes in the Navigator window correspond to the elements on the diagram. In addition, there are nodes, such as Variables and Correlation Sets, that are related to functionality not directly accessible from the diagram.
To view the variables used in the business process, expand the Variables node in the BPEL Logical View of the Navigator window. For variables, the following commands are available in the context menu:
Go To Source. Opens the source of the BPEL file and places the cursor at the place where the variable is mentioned for the first time.
Go To Type Source. Opens the source file that contains a definition of the variable type. This can be, for example, a WSDL file.
Find Usages. Shows usages of variables in the BPEL file. This command is also available from the context menu for correlation sets and Partner Link elements.
Of particular relevance is the Imports node, which lists XSD and WSDL files referenced with the help of the Import element in your BPEL file. Using the context menu for the Imports node, you can add reference to an XSD or WSDL file. Note that only files located in the project folder may be referenced.
Note - Before you can import a file, you must first add the files stored in your project directory to the project structure, then you can add them as imports. The files that are already referenced are displayed in the strike-through style.
The resource file you have just added appears under the Imports node in the Navigator window.
From the Navigator window you can add properties and property aliases to the WSDL files referenced in the BPEL document.
If the Synchronous with Tree checkbox is selected, the Query field is updated each time you change the selection in the Map Property To tree.
See Also
For more information on defining properties and property aliases with the WSDL Editor, refer to Using the WSDL Editor.
The Properties window contains the properties information for the currently selected element of the process. You can also use the IDE's Properties window to configure all BPEL element properties. The contents of the Properties window differs depending on the active element of the process. To open the Properties window, choose Window -> Properties or press Ctrl-Shift-7.
When you open a BPEL file from the Projects window, the diagram opens in the Editing Mode of the Design view by default. In this mode, you can edit the diagram and scroll through it. The Editing Mode is enabled when the Navigation mode is selected on the Editor toolbar.
In the Editing Mode, you can scroll through the diagram by using the following methods:
Turning the mouse wheel
Using the horizontal and vertical scroll bars
Using the thumbnail view to select the section of the diagram to display. To access the thumbnail view, click the Thumbnail button located below vertical scroll bar, or press Ctrl+B
Pressing the Tab key to move through elements
The diagram enables you to collapse and expand process blocks to allow you to focus on other processes.
The zoom feature enables you to reduce or enlarge the size of your diagram to get a closer view or to see more of the diagram at a reduced size. You can change the zoom value using the Zoom Value drop-down list on the Editor toolbar.
To scale the diagram to fit the window, click Fit Diagram.
To scale the diagram width to fit the window width, click the Fit Width button.
The minimum scale size is 33% and some large diagrams might not fit entirely the window.
To change the scale do one of the following:
Click Zoom In or Zoom Out button on the toolbar.
Click Fit Diagram button on the toolbar to scale the diagram to fit the window.
Click Fit Width button on the toolbar to scale the diagram width to fit the window.
Turn on the Navigation Mode on the toolbar, then you can zoom in and out using the mouse wheel.
You can print BPEL diagrams and source files and customize printing settings, including border, headers, footers, colors, line numbers, and zooming, to suit your preferences.
Print Preview. Preview the print layout or configure print settings.
Print to HTML. Print the .BPEL file as an HTML file.
Print Border — Adds a border to the printed page. Click the Color icon to change the border color.
Print Header and Print Footer — Specifies the text, alignment, color, and font of the header and footer.
To hide the header or footer, clear the Print Header or Print Footer check boxes, respectively.
To specify the header or footer pattern text, click in the field corresponding to the alignment (Left, Center, or Right) and select one of the buttons below. For example, to add the time of printing at the bottom left corner, select the Print Footer checkbox, click into the Left field, and click the "Time of printing " icon.
Click the Choose Footer Color and Choose Footer Font icons to modify the color and the font for the page header and footer.
Line Numbers — Specifies whether to print line numbers for source files.
Wrap Lines — Wraps the lines to fit them on the page.
Print as in Editor — The printed page will look like you see it in the editor.
Text Font and Color — Specifies the color and font of the text when you are printing, for example, source files.
Background Color — Specifies the background color.
Line spacing — Specifies the value for line spacing.
Zoom — Specifies the scale for the printed text or diagram on the page. You can select to fit width or height or choose a specific zoom scale.
Paper size
Source of the paper
Paper orientation
Margin sizes