This documentation supports the 19.11 version of Remedy Action Request System, which is available only to BMC Helix subscribers (SaaS).
To view an earlier version, select the version from the Product version menu.

Consuming a simple flat document scenario

In this scenario, you access an external web service and, using a Set Fields filter action, set the data into a BMC Remedy AR System form. The external web service takes a stock ticker symbol as input and returns the 20-minute delayed stock quotation for that stock.

To consume a simple flat document

  1. In BMC Remedy Developer 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

      Stock Quote form in BMC Remedy Developer Studio
      (Click the image to expand it.)

  3. In BMC Remedy Developer Studio, create a filter as follows:
    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.

      Stock Quote filter — Associated Forms and Execution Options panels
      (Click the image to expand it.)

    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

      Note

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

    9. Click Reload. (If prompted, enter the user name 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.

      Stock Quote filter — If Actions and Set Fields panels
      (Click the image to expand it.)

    12. In the Input Mapping table, highlight the cell adjacent to the symbol element.
      Note that 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.
  4. Open a new Stock Quote form in a browser, and enter data in the required fields.
  5. Save the form.
  6. Run a search to open the form in Modify mode.
    Recall that you created the Stock Quote Filter to execute on Modify (step 10).
  7. Enter a symbol (in this scenario, BMC) in the Stock Ticker Symbol field.
  8. Click Save or Submit.
    The quote for your stock is displayed in the Stock Ticker Symbol field (see the following figure).

    Stock Quote form
    (Click the image to expand it.)

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Moiz Samiwala

    Can you please give another example for the wsdl link, as the current one is not working. it would help alot as I am currently working on developing web services and I dont have any wsdl files to test the scenario.

    Thanks.

    Dec 24, 2019 04:26
    1. Anagha Deshpande

      Hello Moiz,

      Apologies for responding late. We are working on your query.

      We will reply soon.

      Regards,

      Anagha

      Jan 07, 2020 02:27
    1. Chaitanya vikas Ghanta

      Hello Moiz, I checked with the SME and found that you can try an internal link of the following format:

      Internal web service: http:///arsys/WSDL/public//User

      You can also try the following external link. Please note that we have no control over this external location and we cannot guarantee that this may work for you: http://www.dneonline.com/calculator.asmx?WSDL

      This external location was from http://www.dneonline.com/calculator.asmx

      Please let me know if you have more queries.

      Regards, Chaitanya

      Jul 02, 2020 01:18