Creating a New Interface
You can use the New Interface wizard as a quick start to generate a basic WSDL file if you do not already have one.
If you do not have a WSDL file, you can use the New Interface wizard to generating the basics of a WSDL file. The starting point for generating a WSDL file is to have one or more of the following as a basis for input and output messages of a port type and operation:
- •XML schema
- •Sample XML data
- •Java interface
To create a new interface:
- 1. Do one of the following:
- - Add an XSD or XML file to a project folder within an orchestration project. These files should describe data types, and must include a namespace definition.
- - Follow the steps described in Creating a Java Interface.
- 2. Display the New Interface wizard, either by creating an interface for a participant (Participants view) or by selecting the New Interface icon from the Interfaces view toolbar.
- 3. In the New Interface wizard, select whether the new operation is synchronous or asynchronous:
- - Request-response operation
- - One-way operation
- 4. Select the data type you want to use to describe each of the operation's messages:
- 5. Browse to the schema or sample and select it. For a schema, select the element to use for the message.
If the wizard reports errors, verify that your data file contains valid definitions, declarations, and syntax. For examples, see the sample data files and schema that are in the tutorial project.
- 6. View the message in the preview.
- 7. Based on the names you selected for input and output, the wizard creates the required WSDL elements. You should change the Port Type, Operation, and Target Namespace elements to more meaningful names.
The target namespace is a convention of XML Schema that enables the WSDL document to refer to itself. It is a value that is unique, and is different from all other namespaces that are defined.
- 8. Save the new WSDL file with the suggested name, or type in a new name and save the file to a project location.
- 9. View the generated WSDL in the WSDL editor to make corrections and additions.
The generated WSDL is a good starting point for a process interface. You can to modify the WSDL as follows:
- •Correct or add a schema location.
- •Add fault names and messages.
- •Add another operation and add to the participant (or partner link type) generated. (A partner link type can have two roles. They represent two different services that communicate asynchronously.) Alternatively, in the Participants view add a callback interface. See Creating a New Callback Interface.
- •Replace the tns prefix with a meaningful one. When you use the operation wizard to create activities, the prefix is automatically added to the process.