Create a SOAP web service reference

Create a SOAP web service reference by doing the following.

  1. On the Web service references page, select New.

    The New web service reference dialog box is displayed.

  2. On the Service type list, select SOAP.
  3. Enter a Name for the web service.
  4. 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 their access to specific users.

  5. Specify the URL that is the base address for the service, such as .asmx or .svc.
    If the "Allow all" system setting is disabled, you can only provide a whitelisted web service URL. If the URL connection string is not whitelisted, the connection is denied. See Whitelist a web service URL or a database connection string.
  6. Use the Endpoint URL for changing the web service execution location without regenerating the web service proxy DLLs. For example, using the Endpoint URL to dynamically move the execution location from a Test server to a Production server to facilitate migration. To specify the URL, perform the following steps:
    1. Select Yes for Endpoint URL. (Default: No)
    2. Enter the endpoint URL.

    The Endpoint URL must point to the web service and not the WSDL link.

  7. To control access to the web service and not just restrict access to the configured TotalAgility Enterprise services account, select one of the following options for Authentication:

    Option Description

    Basic

    Enter the User name and Password for the endpoint.

    Certificate

    1. Browse and upload or drag the certificate here to use to authenticate with the web service.

    2. Enter the Certificate password.

      If the certificate is not valid, an error is displayed at runtime.

    3. To view the certificate details, such as Issued to, Issued by, and Validity period, select View certificate, enter the password, and then select Get details.

    None

    No authentication is required.

  8. Add a custom header.
  9. Select Save.