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 –

   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 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 Using the WSDL Editor.