ActiveBPEL™ Designer User’s Guide

Previous | Next | Index

Tutorial Part 3: Adding Web References

If you have not already done so, complete or review Tutorial Part 1: Starting a New Process and Tutorial Part 2: Planning and Designing a Process.

In Part 2 of the tutorial, you learned how to create a top-down design by arranging BPEL activities on the Process Editor canvas. Now you will begin creating an executable process based on a WSDL file.

In the Navigator view of ActiveBPEL, you should have the following:

• ActiveBPEL_Tutorial project
• tutorial.bpel that you created in Part 1

By completing Part 3 of the tutorial, you will be able to:

• Import a samples project containing a completed tutorial file and additional files needed in Tutorial Part 3.
• Add a WSDL file to your project
• Add the WSDL file as a Web Reference
• Use Web Reference view filters

Step 1: Import the ActiveBPEL Designer Samples project

The ActiveBPEL Designer Samples folder contains resources needed in the next part of the tutorial. Also, you can view a completed tutorial and other sample projects by importing the samples project.

1. Select File>Import>General.
2. Select Existing Projects into Workspace, as shown, and click Next.



3. Browse to your ActiveBPEL Designer install folder and select Samples, and click OK. The selected project is displayed, as shown in the example.



4. Click Finish. Your Navigator should look similar to the following example.

Step 2: Add a WSDL folder to the ActiveBPEL_Tutorial project

A Web Services Description Language (WSDL) file describes business operations that are invoked to carry out the activities of a BPEL process. WSDL files are required in order to create a valid executable BPEL file. A good practice is to include relevant WSDL files in your project so that you can easily deploy the files in the project to a deployment package.

Normally you would create a project folder and import a WSDL file into it. We will take a shortcut for the tutorial.

1. Expand the ActiveBPEL_Samples project and select the Completed Tutorial folder.
2. Select the WSDL subfolder and select Copy from the right-mouse menu.
3. Paste the WSDL folder to the ActiveBPEL_Tutorial project. Your Navigator should look like the following example.

Step 3: Add a Web Reference

A Web Reference is a Web Services Description Language (WSDL) file or schema. By adding WSDL files and schemas to the Web References view, you have a convenient registry of namespaces, messages, type definitions, sample data, and other elements to use in your process definitions. In Step 1 you added the loanServicePT.wsdl file to the project. Now you will add the WSDL file to Web References, a powerful registry.

1. Display the Web References view. This view is stacked next to the Navigator view.
2. Select the Globe icon on the Web References toolbar, as shown.



3. In the Add Web Reference dialog, select Browse Projects, as shown.



4. Expand the ActiveBPEL_Tutorial project, expand the WSDL folder, select loanServicePT.wsdl and error-messages.xsd, and click OK. Ensure you select the WSDL and XSD from ActiveBPEL_Tutorial project, as shown. Click OK again.



Your Web References-Schemas view should look like the following illustration.



The schema for error messages is displayed. This file is imported by the WSDL file and provides type definitions for error messages.

5. In the Web References toolbar, select the down arrow, and then select View WSDL.

The files listed above are the WSDL and XSD files you will reference in your loan approval process, tutorial.bpel.

Tip: When you add many Web References, rest your mouse on a Web Reference and use hover help to view location and namespace details for each WSDL, as shown in the example.

Step 4: Use Web Reference view filters

The Web References view displays WSDL definitions and schemas. This view provides a filter for viewing the various components of WSDL files. For example, you can view files according to namespaces, partner link types, or messages.

1. In Web References view, select View Partner Link Types from the drop-down arrow in the toolbar.
2. Expand the partner link type loanPartnerLT to display the request operation, as shown.

Continue to Tutorial Part 4: Using the Operation Wizard to Create Web Interaction Activities.

Copyright (c) 2004-2007 Active Endpoints, Inc.