Create a Web service reference

  1. Navigate to Integration > Web service references.

    The Web service references page appears.

  2. Click New.

    The New web service references dialog box is displayed.

    Note You can whitelist a web service reference. If Allow All in the system settings is not selected, you can only add the whitelisted web service references. See Configure the server URLs and database connection strings.
  3. By default, the system automatically saves a new web service reference in your working category. To store the web service reference in a different category, select a category on the Category list.

    The categorization of web services helps restrict access to web services to specific users.

    Note When you export/import a process map or a form that has a web service, TotalAgility also exports/imports the category of the web service. If the category does not already exist, TotalAgility also creates the category for the web service.

  4. Select a web Service type to configure. 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.

  5. Enter a Name for the web service.
  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 Endpoint URL to dynamically change the execution location from Test server to 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.

    Note 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 Username and Password.
  9. To add a custom header to a web service, perform the following steps:
    1. Click for Custom header.
    2. Enter a Name, such as Host.
    3. Enter a Value, such as localhost.
    4. Click Add.
  10. Click Save.

Create a web service activity or add a web service event to interact with internet web services. You can call any web service with a public class and public methods from a web service activity. Each public method has a list of parameters to which you must assign variables.

See also: