Create Web Service Models

Web services bridge the gap between your existing relational and file-based data sources and the new XML data structures that represent how you plan to exchange data with new applications. Web service models contain the web service interface and operation definitions (which are described in the WSDL interface document) and the procedures executed by the operations to process the input request to the operation and generate the output response.

You can create Web service models using one of the following processes:

- Create new empty model
- Create from relational model
- Create f rom XML Document view model
- Create f rom WSDL

Create new empty Web Service model

Note: This method is recommended for experienced users. It provides detailed control of all Web service interfaces, operations and required transformations from XML Views.

> Step 1: Select New Model action in VDB Explorer toolbar or select VDB, right-click to display the context menu and select the New Model action .

> Step 2: In the "New Model Wizard ", specify the model name, choose "Web Service" model class and click "Finish"

Create Web Service model from relational model

> Note: This method is recommended for consistent and rapid deployment of Web services designed to query relational sources.

> Step 1: Select any combination of Relational models, tables and/or procedures in the VDB Explorer tree.

> > Note: It is recommended that the user selects single source models, which enables auto-naming of input/output schema and Web service models in Step 3.

> Step 2: After selecting objects, right-click to display the context menu and select the "Create Web Service" action.

> Step 3: In the "Create Web Service" dialog, specify file names for the generated Input schema file, Output schema file and Web service model. Change options as desired. Click "Finish" when done.

> Step 4: When model generation is complete, a confirmation dialog should appear. Click OK.

Create Web Service model from XML document view models

Web Service models and their corresponding Intefaces and Operations can be generated in Dimension from XML View model components. Namely, XML View Documents and XML View Document roots.

To create a new Web service model from XML components:

> Step 1: Select either a single XML Document or single XML Document root in VDB Explorer

> Step 2: Right-click select "Create Web Service" action

> Step 3: Fill in missing properties in "Web Service Generation Wizard" shown below

> Step 4: Click "Finish" to generate model. When model generation is complete, a confirmation dialog should appear. Click OK.

> Note: Users can change the Web Service Model and Interface Name values (via "..." buttons) to use existing Web service model components. This will create a new operation in an existing model.

Create Web Service model from WSDL

You can create a Web service in your VDB by importing WSDL files from the file system. Dimension will interpret the WSDL, locate any associated or dependent XML schema files, generate an XML View of the schema components and create a Web service model representing the interfaces and operations defined in the WSDL.

To import from WSDL, follow the steps below...

> Step 1: In the VDB Explorer, choose the Import action in the toolbar .... and select the WSDL File into Web Service Model option.

> Step 2: The first wizard page, Create Web Service from WSDL File , specify a valid name for your Web service model, "Browse..." the file system and select one or more existing WSDL files.

> > Notes:

> > - If no WSDL is selected or specified then the importer will only create an empty Web service model. No XML Schema or XML View models will be generated.
> > - Any referenced files (WSDLs or schemas) must either be embedded in the WSDL file or exist on your file system

> Step 3: The next page is titled "Namespace Resolution". This page identifies successful and errant WSDL namespace resolution. The main WSDL document will essentially always be resolved, since the file chooser is used to obtain the path. Problems will occur when the main WSDL file imports other WSDL files that cannot be resolved..... If no errors, select "Next" to proceed, or "Finish" to complete with default options.

> Step 4: The next page is titled "Schema Workspace Location Selection ". This page lists all schemas imported by the WSDL (along with any dependent schemas referenced within schemas) as well as schemas embedded in the WSDL and indicates whether or not they are resolvable. All resolved schemas will be created in a separate file and added to the workspace. The editor panel allows you to change the default file name of the new schema file(s).

> If no errors, select "Next" to proceed, or "Finish" to complete with default options.

> Step 5: The last page titled "XML Model Generation " allows you to change the name of the XML View model if the "Generate virtual XML document model" is checked. Input desired name or use the default name provide. Select "Finish" to complete.

Related Topics

- Create XML View Model
- Web Service Advisor View
- Getting Started with MetaMatrix Dimension

(c) Copyright © 2000-2006 MetaMatrix, Inc. All rights reserved.
Visit http://www.metamatrix.com