(Contents)

 Web Service Parameters

The benefits of the web service functionality are:

Amend Web Service Parameter Record Form

This form is displayed when you select Ford OWS > Ford OWS Claims , select Edit > Parameters or click and then click Ford for the Ford specific parameters. Then click Edit in the Web Service Parameters Group.

Show Passwords: If activated, when you log on to the system, your password is displayed as normal characters, not asterisks (*).

Tabs:

Buttons:

OK: Saves any changes you made and returns you to the Ford OWS Parameters form.

Cancel: Abandons any changes you made and returns you to the Ford OWS Parameters form.

Help: Displays this help topic in your default browser.

General Tab

ID: The unique ID.

Tip: The ID is freeform, but should have a structure. For example, XX_PPPPP, where XX=franchise mneumonic and PPPP=product code or name.

Description: A brief description.

General URL: If the web service has an associated website that users can log onto, enter the URL in this field. Then you can add a button to your own form and navigate to the URL when the user clicks the button.

Multi Tab

ID: A unique ID.  This is usually either a company number or a dealer code.

Free Text: A free form description field to identify the unique record.

To add a new multi record:

  1. Select Manufacturer Systems and Ford.

    The Ford Operations menu is displayed.

  2. Select Ford OWS.

    The Ford GWE Claims menu is displayed.

  3. Select Service and repair claims.

    One of the following will happen:

  4. Select Edit > Parameters or click .

    The Warranty Parameters form is displayed.

  5. Click Add to add a new multi record.

    The Edit Multi Parameter form is displayed.

  6. Input the following information and click OK:

    The new multi parameter will be added to the system.

Web Service Tab

The web service tab contains parameters that relate to the actual connection to the web service.

WSDL: Location of the web service WSDL.

Note: WSDL files can be stored locally or remotely as follows:

- Local: home/MS/wsdl/FO_OWS_STARTransport2005_StageII.wsdl
- Remote: http://www.MyWebService.com?wsdl

Username: Username for accessing the web service. This is linked to the password.

Password: Password for accessing the web service. This is linked to the username.

Literal mode: If selected, literal mode is activated.

Connection timeout: Connection timeout in milliseconds.

Read timeout: Read timeout in milliseconds.

Proxy Tab

This tab contains proxy settings that are used if you use a proxy server to access the internet.

Use proxy server:  If selected, indicates that a proxy server is used.

IP address: IP address or server name of the proxy server.

Port number: Proxy port number.

Username: Username of the proxy. This is linked to the password.

Password: Password of the proxy. This is linked to the username.

Certificate Tab

Some web services require more secure authentication to access them, such as certificates.

X509 Certificate:  The X509 certificate file used to validate messages.

Note: The file must be in PEM or DER format.

Private key file: The private key file used to sign messages.

Note: The file must be in PEM or DER format.

Web service: The X509 certificate file used to identify and secure the web service. Only the web service can data that is encrypted with this certificate's public key (X509 certificate).

Note: The file must be in PEM or DER format.

Stunnel Tab

Stunnel is an SSL interpreter that provides secure encrypted connections for clients who have servers that do not speak TLS or SSL natively.

KCML has integration with OpenSSL, which his the preferred method of encryption.

Note: If Stunnel is required, you can set up the parameters on this tab.

Use Stunnel:  If selected, indicates that Stunnel is being used.

IP address: IP address of the server where Stunnel is running.

Port number: Port number used by Stunnel.

Connection string: Connection string to Stunnel.

Advanced Tab

This tab contains parameters relating to advanced configuration of the web service parameters.

Preferred Service Group:

Service URL: The WSDL contains a service endpoint that, often, is not accessible in its written form. For example, http://localhost/MyWebService. Having localhost would mean that the web service would need to be running on the same server as this system. One solution is to make a copy of the WSDL, modify the endpoint and then store it locally. This parameter enables you to enter the preferred endpoint and still use the remote WSDL.

Service Port:  The port number where the web service is running.

Security Options Group:

Addressing: Indicates if WS-Addressing elements should be added when adding security elements.

Addressing Version: Addressing version.

Timestamp: If selected, indicates that a timestamp should be added to outgoing SOAP messages.

Encryption Algorithm: (Optional).  Indicates the encryption algorithm to use, such as:

Encryption Key Algorithm: (Optional).  Indicates the key encryption algorithm to use, such as:

SOAP Request Security Options:

Sign body: Sign SOAP envelope body.

Sign token: Encrypt SOAP envelope body.

Encrypt body: Sign client security token.

Encrypt token: Encrypt client security token.

SOAP Response Security Options:

Sign body: Sign SOAP envelope body.

Sign token: Encrypt SOAP envelope body.

Encrypt body: Sign client security token.

Encrypt token: Encrypt client security token.

User Defined Tab

This tab can be used to store additional product specific settings relating to web services.

Note: Instead of creating a separate interface, this tab allows very simple settings to be edited by the user.

ID:  The unique identifying name of the user-defined routine.

Value: The exact routine or parameter that is called or run.