Default language.

Publishing a simple flat document scenario


In this scenario, you publish a web service that includes default operations of Create, Get, GetList, Set, and Service for an employee record.

To publish a simple flat document

  1. Create a form that displays your employee data.
     This is the base form used to create your web service (see Forms and field mappings for web services). The following figure shows a sample form called Employee. All the fields are character fields.

    Sample form for employee record
     (Click the image to expand it.)

    web_services_examples_form01.gif
  2. On the Forms tab, right-click the form name to display its shortcut menu.

    Forms tab showing list of forms and web services selection
     (Click the image to expand it.)

    web_services_create010.gif
  3. Select Create Web Service from the menu.
     A new Web Service tab appears, with default settings based on your form.

    EmployeeWebService web service
     (Click the image to expand it.)

    web_services_mapping010.gif
    BMC Remedy Developer Studio automatically fills in the name of the base form (Employee). The Label and Description fields are optional. Default operations are automatically displayed on the WSDL Operations panel.
  4. Select an operation from the WSDL Operations list, and expand the corresponding panel.
     The fields on your Employee form are mapped to XML-compliant element names in a default XML schema. (You do not need to modify the default mappings for this scenario.)

    EmployeeWebService — Mapping tables for a Create operation
     (Click the image to expand it.)

    web_services_mapping011.gif
  5. Close the WSDL Operations panel.
  6. Set the permissions to Public.
     The Permissions property is modified from the Properties tab corresponding to EmployeeWebService. This step is important if you publish your web service over an Internet or intranet for general use.
  7. Select File > Save, and name your web service EmployeeWebService.
  8. Click the WSDL Publishing Location tab.
     A sample URL for your WSDL file is displayed in the Specify mid tier's WSDL handler URL field.
  9. Modify the URL for your configuration:
    1. Replace <midtier_server> with the name of the web server where the mid tier is running.
    2. Add /public after WSDL.
       In this scenario, if the mid tier server is TestServer, you would use this URL: 


      http://TestServer/arsys/WSDL/public/TestServer/EmployeeWebService

       
      EmployeeWebService--WSDL tab on Create Web Service window
       (Click the image to expand it.)

      web_services_examples_wsdl.gif

  10. Click File > Save to save your changes to EmployeeWebService.
     Administrators with the appropriate SOAP protocol can now access this WSDL file with any browser.
  11. (Optional) Click View to display the contents of your WSDL file.
  12. (Optional) If prompted, enter a user name and password and click Login.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*