ActiveVOS Designer User’s Guide

Previous | Next

Creating a New Interface

No WSDL? You can use the New Interface wizard as a quick start to generating the basics of a WSDL. The starting point for generating a WSDL 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 message(s):
• XML schema
• Sample XML
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. Create more meaningful names for the Port Type, Operation, and Target Namespace elements.

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, different from all other namespaces that are defined.

8. Save the new WSDL 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 may need 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, which represent two different services that communicate asynchronously.) Alternatelty, in the Participants view add a callback interface. See Creating a New Callback Interface.
• Add a meaningful namespace prefix mapping for the tns prefix, and then when you use the operation wizard to create activities, the prefix will be automatically added to the process

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