› Integration › Custom service groups › Add web service references

Add web service references

You can add a web service reference from within a custom service group and save it to a category.

  1. Create a custom service group.

    On saving a custom service group, the option to create a web service reference is enabled.

  2. In the New custom service group dialog box, click for Web service references.
    The New web service reference dialog box is displayed.
  3. Select a web Service type to add. Available options are:

    • SOAP (Default): Specify the URL that references the Web Service Description Language (WSDL) file for the web service. For example, http://localhost/PlatformManagerWs/PlatformManagerWs.asmx?WSDL.

    • SOAP WCF: Specify a web service with a .svc extension.

    • RESTful: Specify the URL which maps the four HTTP methods: GET, PUT, POST, and DELETE. See RESTful Service activity and Configure a RESTful Service activity.

    See Web services supported by TotalAgility for more information about supported web services.

  4. Enter a Name for the web service.
  5. By default, the web service belongs to the Category of the custom service group in which it is added.
    If you select a different category, the web service is added to the selected category and does not appear on the current list. Only the web services that belong to the current custom service group's assigned category will be listed under Web service references.
  6. Enter the web service URL.
  7. Use the Endpoint URL for changing the web service execution location without regenerating the web service proxy DLLs. For example, use the Endpoint URL to dynamically change the execution location from the Test server to the Production server to facilitate migration. To specify the URL, perform the following steps:
    1. Click Yes for Endpoint URL. (Default: No)
    2. Enter the endpoint URL.

    The Endpoint URL must be the location of the web service and not the WSDL link. Use an Endpoint URL only for SOAP and WCF. The Endpoint URL does not support RESTful web services.

  8. To control access to the web service and not just restrict access to the configured TotalAgility Enterprise services account, perform the following steps:
    1. Click Yes for User credentials. (Default: No)
    2. Enter the endpoint User name and Password.
  9. To add a custom header to a web service:
    1. Click for Custom header.
    2. Enter a Name, such as Host.
    3. Enter a Value, such as a localhost.
    4. Click Add.
  10. Click Save.
    The web service reference is listed under Web service references.

    You can edit and delete a web service reference.

How to: