Configuration: Web Services

This view contains settings that are used to set up an External Web Service URL item.

External Web Service URLs

If you have custom code that requires utilization of external web services, you need to create an entry that contains the service name and URL. Emplifi provides you with the service names that you need to enter for your customizations. You need to know the URL used within your organization.

Under normal circumstances, each service URL needs to end with a forward slash.

Example: http://www.acme.com/internal/service/

General Settings

Field	Description
Web Service Timeout(sec):	When the system needs to make a call to an external web service (typically for custom functionality), this value determines how long the system waits for a response from the web service before giving up.
Network Proxy Server	Enter the location of the Network Proxy Server. This allows Emplifi Agent system to configure the Emplifi Agent Server so that HTTP requests for web services utilize this proxy server.
Bypass Proxy on Local	Select this check box to tell the system to bypass the proxy server for local requests.

To add a new Web Service, click the New Web Service URL button. A new row displays in the table and displays the fields described in the following table. These fields allow you to define the Web Service.

Field	Description
Service ID	Identifies the service that you are registering.
Service WSDL URI	If you have a WSDL document, enter its URI and then select the desired Service. If you do not have a WSDL document, you need to type in the Service URI. Once the configuration data has been entered, click on the Save button in the toolbar to finish the registration process.
Service	A Web Service can offer any number of named services. This field indicates the name of the specific service to use for the Service ID. You may need to enter values into the Authentication fields before the Service drop-down displays any values. Once the Service is selected, click on the Test button and the system populates the Service URI from the WSDL. If a WSDL URI is not provided, this value must be manually entered.
Service URI	The network address of the Web service. When you click the Test button, the system populates this field from the WSDL based on the selected Service.
Authentication Type	This field and the Authentication Name, and Authentication Password are used if the Web Service requires network authentication. The network administrator for the Web Service can provide the setting to use. None - No authentication is required Basic - An authentication name and password are passed to the service unencrypted NTLM - A Window's authentication mechanism in which the user ID that the Emplifi Agent Server is running under is used to gain access to the Web Service Kerberos - A vendor neutral authentication mechanism often used by Unix-hosted Web Services
Authentication Name	Enter the username for the Service. (Basic and Kerberos only)
Authentication Password	Enter the password for the Service. (Basic and Kerberos only)
Interface	When the Web service being defined is intended to support a Web service provider, select the appropriate provider interface from the list of installed providers.
Configuration Doc	When the Web service being defined is intended to support a Web service provider, and the provider requires a configuration document, enter the configuration document as specified by the provider documentation.
Test	This button allows you to test the connection to the WSDL to verify that you have entered all the information correctly.