Navigating in the BPEL Designer

This section explores the navigation capabilities of the BPEL Designer.

The BPEL Editor Views

The Navigator Window

The Properties Window

Scrolling

Zooming In and Out

Printing BPEL Diagrams and Source Files

The BPEL Editor Views

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 the Mapper view press Ctrl-Shift-F9 or click the Mapper tab on the editor toolbar. For more information refer to 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 the Logging view press Alt-L or click the Logging tab on the editor toolbar. For more information seeLogging and Alerting section.

Cloning Document Views

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.

To Clone the Document View:

1. Open the BPEL file

2. Right click the tab with the file name and choose Clone document. Another tab with the same document will be created.

3. Drag and drop one of the tabs to the location you choose: left, right or to the bottom of the screen. An orange frame will show you where the window you are dragging will be placed.

The Navigator 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.

XML View

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.

Logical View

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 pop-up 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 pop-up 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 pop-up 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 pop-up 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.

To add a resource file (.wsdl or .xsd) as an import:

1. In the BPEL Logical View of the Navigator window, right-click the Imports node and choose one of the following, depending on the format of the imported file: Add WSDL Import or Add Schema Import.

2. In the Create New Import dialog box, select the file in your project structure to add it as import.

   ---

   Note –

   You first need to 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 strikethrough style.

   ---

3. View the values in the read-only Namespace and Type fields and click OK.

   The resource file you have just added appears under the Imports node in the Navigator window.

To add a property to a WSDL file:

From the Navigator window you can add properties and property aliases to the WSDL files referenced in the BPEL document.

1. In the BPEL Logical View of the Navigator window, right-click a WSDL file under the Imports node and choose Add Property from the pop-up menu.

2. In the Create New Correlation Property dialog box, specify the property name.

3. Select the property type and click OK.

To add a property alias to a WSDL file:

1. In the BPEL Logical View of the Navigator window, right-click a WSDL file under the Imports node and select Add Property Alias from the pop-up menu.

2. In the Create New Property Alias dialog box, click Browse next to the Property field to specify the property.

3. In the Property Chooser dialog box, select the property for which you are creating the alias and click OK. The Property Type field in the Create New Property Alias dialog box is populated with the type.

4. In the Map Property To tree, expand the WSDL file node and select the message or message part.

5. To add a query, enter the query string in the Query text field.

   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.

6. Click OK.

See Also

For more information on defining properties and property aliases with the WSDL Editor, refer to the Developer Guide to the WSDL Editor.

The Properties Window

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. There are only two permanent fields of the Properties window available for every element:

• Name. Shows the name of the element.

• Documentation. Contains comments associated with the element. For more information see Documentation section.

To open the Properties window, choose Window > Properties or press Ctrl-Shift-7.

Scrolling

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

• Pressing the Tab key to move through elements

Zooming In and Out

Zooming in and out of the diagram. The zoom feature allows 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.

Note that 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.

Printing BPEL Diagrams and Source Files

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.

To preview and print a BPEL diagram or source file:

1. Open a BPEL file in the Design view.

2. Choose File from the main menu and select one of the following commands:

   • Print Preview. Preview the print layout or configure print settings.

   • Print to HTML. Print the .bpel file as an HTML file.

To customize print options:

1. In the IDE, select an object you want to print.

2. In the Print Preview window, click Print Options. The Print Options dialog box opens.

3. Change the print settings to suit your preferences:

   • 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 checkboxes, 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.

4. Click OK.

To customize page settings:

1. In the IDE, select an object you want to print.

2. Choose File > Print Preview.

3. In the Print Preview window, click Page Setup. The Page Setup dialog box opens.

4. You can also invoke the Page Setup dialog box by choosing File > Page Setup.

5. On the Page Setup page specify the following parameters:

   • Paper size

   • Source of the paper

   • Paper orientation

   • Margin sizes

6. Click Printer button and specify the printer.

7. Click Ok.