Developer Guide to the BPEL Designer: Finding Usages of BPEL Components and Validating BPEL

Contributed by Bob May, maintained by Irina Filippova
December 2007

Contents

Developer Guide to the BPEL Designer

Content on this page applies to the NetBeans 6.0 IDE

Finding Usages of BPEL Components

For BPEL files, the Find Usages command determines where the following elements are used in the associated .bpel files:

To find usages of a BPEL component:

  1. In the IDE, open the BPEL file (.bpel) you want to work with.
    By default, the IDE opens the Design view for the BPEL file.
  2. In the Design view, select the element for which you want to see usages.
    You can also select the element in the BPEL Logical View of the Navigator window.
  3. Right-click the element either in the Design view or in the Navigator window and choose Find Usages from the pop-up menu.
    The IDE opens the XML Usages window in the lower part of the IDE. The first time you invoke the Find Usages function, the window has no tabs. For each consequent query, the IDE adds a Find XML Usages tab that shows the usages of the component you selected.
  4. (Optional) To go to the source for an element and double-click that element in the tree. The right part of the XML Usages windows is a visual representation of element usages throughout the project.

Validating BPEL

The BPEL Designer has a built-in BPEL code validation functionality that helps developers create well-formed, valid and standard-compliant code. The code is checked for errors and the user is notified if validation fails.

Validation Criteria

The Validator checks the BPEL process in accordance with the following criteria:

  1. For conformance with the BPEL 2.0 schema.
    See the Troubleshooting section of this guide for more information about using BPEL schemas different from the BPEL 2.0 specification.
  2. For compliance with static analysis rules defined in the WS-BPEL 2.0 specification.
  3. For broken references.
  4. For constructs that are valid per the BPEL 2.0 specification but are not yet supported by the Sun BPEL Service Engine.

Validation Types

The BPEL Designer provides two types of validation:

Real-time validation

This type of validation is invoked automatically and does not require any explicit actions from the user. Only the current file is checked. The validation is performed in accordance with all the criteria mentioned above, except for validation for conformance with the BPEL 2.0 schema.

Explicit validation

This type of validation requires that the user explicitly invoke the validation process. All imported XSD and WSDL files are also checked. The validation is performed in accordance with all the criteria mentioned above.

To invoke explicit validation, do one of the following:

Notifications

The user is notified about validation errors or success in the Outpur window, in the Design view, and in the Navigator.

The Output window

The results of validation appear in the Output window if validation has been invoked explicitly. If validation fails, the Output window contains errors and/or warnings:

Validation Failed

If validation is successful, there are no warnings or errors in the Output window.

The Design view

The Design view shows the results of both real-time and explicit validation in callout windows on the diagram and the error stripe.

In the diagram, a red cross next to an element on the diagram means that the element has not passed validation and the output contains errors. A yellow triangle with an exclamation mark means that the element has not passed validation and the output contains warnings. If there are both errors and warnings, the Design view shows a red cross. If you click the cross or the triangle, a callout window appears with a list of errors and/or warnings:

Callout window

The callout window includes messages related to validation in accordance with all the criteria listed above. Messages related to the real-time validation are constantly updated.

In the Design view, validation results are also shown by the error stripe, which is a strip to the right of the scroll bar that contains red marks if some elements have not passed validation. The error stripe represents the entire diagram, not just the portion that is currently displayed. You can immediately see if your BPEL process contains errors without having to scroll through the entire diagram. You can click a red mark to jump to the element that causes problems. If no errors are detected, the small square in the error stripe is green.

The Navigator window

The Navigator window shows the results of both real-time and explicit validation by adding a red cross or a yellow triangle to the element's icon if validation has failed. For example, in the screenshot below, the AirlineReserved receive activity has not passed validation and the output contains errors.

Navigator - Validation Failed


Send Us Your Feedback

top