Welcome > Integration module > Web services > Create a web service reference

Create a web service reference

See Web Services.

  1. On the Home page, click Integration > Web Service References.

    The Web Service References page appears.

  2. Click Add Add for Web Services.

    The Web Service Reference page appears. The system automatically saves a new web service reference in your working category.

    Note You can whitelist a web service reference. If Allow All in the system settings is set to No, you can only add the whitelisted web service references. See Configure the server URLs and database connection strings.
  3. To store the web service reference in a different category, consume the category in the Category box.

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

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

  4. Select the web Service Type. See Web services supported by TotalAgility for more information about supported web services.
  5. Enter a Name for the web service.
  6. Enter the URL:

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

    • To configure a SOAP WCF web service, specify a web service with a .svc extension.

    • To configure the RESTful web service, specify the URL which maps the four HTTP methods: GET, PUT, POST and DELETE. See RESTful Service activity and Configure a RESTful Service activity.

  7. Use the Endpoint URL to change 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.
    1. Click Yes for Endpoint URL.
    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. Endpoint URL does not support RESTful web services.

  8. Enter User Credentials (Username and Password) to control access to the web service and not just restrict access to the configured TotalAgility Enterprise services account.
  9. To add a custom header to a web service, do the following:
    1. Enter a Name, such as Host.
    2. Enter a Value, such as localhost.
    3. Click AddAdd.
  10. Click OK.

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.