Example: Querying a Web Service

In this example, we'll use the ddtek:wscall function to query the Swanand Mokashi StockQuotes Web service.

To query the Swanand Mokashi Web Service:
2. For our source document, we'll use a simple XML document that contains only a ticker value - PRGS.

For the target, we'll create a root node (right-click the Set Target Document pane and choose Create Root Element), and a child element, my_quote.

When we're done, our Mapper canvas looks like this:

a. Right-click the source document URL, and choose Associate with > Global
b. In the Associate Schema with Variable dialog box, we enter ticker_source and click OK.

Now the document URL appears as $ticker_source, allowing us to easily substitute other source documents for use with this XQuery.

Stylus Studio specified location, payload, and output ports based on the Web service we used to create the wscall function block. (Double-click the ports to display this information.) However, not all of the values required to generate the output we need - the specific company stock ticker we want to look up, and what information about that stock we want Swanand Mokashi to provide - has been specified. We'll do that now.

4. Double-click the payload port, and map the ticker node from the source document to the tns:QuoteTicker node in the payload port information box.

The Web service will be given the value of the ticker element from our source document when the XQuery is run.

5. Close the payload information box.

Next, let's specify the information we want from the Swanad Mokashi Web service.

6. Since we'll want multiple pieces of information from the Web service (we want to see the company name, ticker value, and current stock price in our output), we define a FLWOR block so that we make one call to the Web service.

Right-click the Mapper canvas and choose FLWOR Block.

Stylus Studio adds a FLWOR block to the XQuery Mapper.

7. Double-click the output port and fully expand the output port information box.

9. Next, map the FLWOR block's output port to the my_quote node we created in the target document.

a. Using the right mouse button (mouse button 2), drag the node to the my_quote node in the target document.
b. When we release the mouse button to drop the Web service node, we choose Add Child Element and Map It.
c. We rename the target node, dropping the tns: prefix, in the Name dialog box when the target document element is created.
d. When finished, close the output port information box.

When we're done with this step, our output mappings look like this:

Sample XQuery Code

Here's the XQuery code that Stylus Studio created for us, based on the XQuery mapping:

And when we preview the code, this is our result:

Metals, Mining & Crude-Oil Production

It can be very dark and dreary in a mine. That's why metal, mining & crude-oil production are using Stylus Studio as their light when it comes to data integration. See which of these top companies are using Stylus Studio to show them the way to XML!

Visual Data Integration Using Stylus Studio XML Pipeline

XML Pipeline is a visual data integration tool for designing, editing, debugging and deploying XML applications. This tutorial covers building a data integration application that aggregates CSV and EDI data and publishes a report to HTML and PDF.

Map between EDIFACT and X12

Anything can be mapped to anything: EDIFACT to X12 or vice-versa, either to XML, and any of those to flat files or other formats. Both the XSLT and XQuery mappers can help bridge complex formats with ease.

XSD Documentation Generator

Stylus Studio®'s XSD Editor includes an integrated XSD documentation generator, allowing you to easily publish XML content models defined in XSD in a convenient, HTML format.

Stylus Most Wanted

 
Free Stylus Studio XML Training:
W3C Member