Documentation

##### WSO2 WSAS 2.1-RC6

- Contents
- Home

##### Downloads

- Releases

##### Documentation

- User Guide
- FAQs
- Installation Guide
- Source
- Running Behind a Proxy
- Data Services Guide
- EJB Guide
- Clustering Guide
- XKMS Guide
- Changing Keys

##### Samples

- Chad
- Commodity Quote
- Data Services
- Flickr
- Javascript
- STS
- Trader
- Tiny URL

##### API Documentation

- Java Docs

##### Tools

- Code Generation
- Change Password
- Eclipse IDE Integration
- TCP Monitor
- WSDL2Code
- WSDL View
- Try It
- AAR Validation
- MAR Validation

##### Resources

- News

##### Get Involved

- Mailing Lists
- Release Process
- Integration

##### Project Information

- Project Team
- Issue Tracking
- License

[ Download ] | [ Documentation Home ] | [ Release Notes ]

# WSDL Converter - Convert WSDL 1.1 Documents to WSDL 2.0 Documents

The aim of this document is to explain briefly how the WSDL Converter tool works.

## Content

- Introduction
- Usage
- Conclusion

## Introduction

WSDL Converter is a tool available with WSO2 Web Services Application Server that allows the user to generate a WSDL version 2.0 document from a WSDL version 1.1 document.

## Usage

Given a WSDL 1.1 document, the ability to generate a WSDL 2.0 document can be very useful. Currently 1.1 version is the widely used version of WSDL, but recently WSDL 2.0 has been gaining popularity. So WSDL Converter provides an easy path to users who may be looking to make the switch to WSDL 2.0 from 1.1. Using WSDL Converter is quite easy, and as with the other tools provided on the WSO2 Web Services Application Server front page, you don't even need to sign in.

Click on WSDL Converter and you will be taken to the following screen.

There are two different ways of providing input to the WSDL Converter. You can either upload a WSDL 1.1 document existing in your local file system, or you can directly enter the URL of a WSDL 1.1 document that resides on the web.

First lets consider the scenario of uploading a WSDL vsersion 1.1 document. Click on the Browse button in the "Upload your WSDL 1.1" box to search your file system for the WSDL 1.1 file, i.e. the document which represent the Web Service, you want to convert to a version 2.0 document. Once you have selected it, click on "Convert WSDL 1.1 -> 2.0" button to begin the conversion.

Next, lets consider the other scenario of directly pointing to a URL that holds the WSDL 1.1 document. In the "Type WSDL 1.1 document URL" box, type in or paste a valid WSDL 1.1 document URL. Then click on "Convert WSDL 1.1 -> 2.0" button to convert it to its corresponding WSDL 2.0 document.

Note: In the second scenario, the WSDL 1.1 document resource will be downloaded to a tempory location on the server's file system and then the conversion will happen.

After following either of the scenarios, you will be taken to the Results page. This page will display the converted WSDL 2.0 document, given the process happened smoothly without any errors which should be the case for any valid and correct WSDL 1.1 document. You can save the given page on your local file system.

Taking a look at the inside workings of the conversion process, the following steps occur prior to producing the result document. First the WSDL 1.1 document will be parsed to extract the details. Note that no validation of the WSDL against a schema here. After the data is extracted, with it, the WSDL 2.0 document will be generated employing a template with XSL Transformation. While this is happening, any invalid alterations and/or anomalies will be picked up, and if they exist, the conversion process will be aborted.

## Conclusion

WSDL Converter provides an easy method to generate WSDL version 2.0 document from an existing WSDL 1.1 document.