Example of consuming a simple flat document

To consume a simple flat document

1. InDeveloper Studio, create a form called Stock Quote.
2. Add two fields:
   • A character field called Stock Ticker Symbol, in which you enter the stock ticker symbol, in this scenario, BMC
   • A decimal field called Delayed Stock Quote, in which the stock quotation is set when information is received from the external web service
     
     
3. In Developer Studio, create a filter as follows:
4. 
   
   1. Add the Stock Quote form to the Associated Forms panel.
   2. From the State list, select Enabled.
   3. In the Execution Order field, enter the execution order for the filter.
   4. In the Execution Options panel, select Modify.
      
      
   5. Right-click the If Actions panel, select Add Action, and select Set Fields.
      A new panel appears, where you configure the Set Fields action.
   6. From the Data Source list, select WEB SERVICE.
   7. From the Server Name list, select the server on which to store the web service mappings as a server object.

   8. In the WSDL File field, enter the URL for the WSDL file of the external web service.

      http://services.xmethods.net/soap/urn:xmethods-delayed-quotes.wsdl

      This WSDL reference might not work if its website is not functioning.

   9. Click Reload. If prompted, enter the username and password required by the remote web server for basic authentication.
   10. From the Port list, select the port for the web service.
   11. From the Operation list, select the getQuote operation.
       The menu is automatically populated with the available operations for the web service. This scenario has only one operation.
       
       
   12. In the Input Mapping table, highlight the cell adjacent to the symbol element.
       Important: The ROOT element of the XML schema is automatically mapped to the Stock Quote form.
   13. Click the ellipsis button.
   14. Use the Field Selector to choose the Stock Ticker Symbol field, which you created in step 2.
       The field name appears in the Form/Field column. The symbol element, string type, is now mapped to the Stock Ticker Symbol field, designed to contain a string.
   15. In the Output Mapping table, highlight the cell adjacent to the Result element.
   16. Click the ellipsis button.
   17. Use the Field Selector to choose the Delayed Stock Quote field, which you created in step 2.
       The Result element (string type) is now mapped to the Stock Quote field, designed to contain a string.
   18. Select File > Save, and name your filter Stock Quote Filter.
5. Open a new Stock Quote form in a browser, and enter data in the required fields.
6. Save the form.
7. Run a search to open the form in Modify mode.
   Recall that you created the Stock Quote Filter to execute on Modify (step 10).
8. Enter a symbol (in this scenario, BMC) in the Stock Ticker Symbol field.
9. Click Save or Submit.
   The quote for your stock is displayed in the Stock Ticker Symbol field as shown in the following figure: