---
url: >-
  /statelake/administering-statelake/designer/data-connections/soap-web-connections.md
---

# SOAP (Web) Connections

**SOAP (Web) Connections** provide a pointer to a SOAP Web Service. You configure the **SOAP Connection** with the appropriate details for connecting to the Web Service.

SOAP Web Services have the distinctive feature that they can be fully defined in a **WSDL** (Web Service Definition Language) file. The WSDL can include the structure of the request and response payloads, and other details. For SOAP, request and response payloads must always be XML. The WSDL file itself is constructed using XML.

**Statelake** knows how to read a WSDL file and will use the information to assist you in creating the SOAP Definitions for the request and response payloads.

By being a separate module from the **SOAP Definition** it allows you to create a single **SOAP Definition** and use it against multiple similar Web Services in different locations, simply by assigning a different **SOAP Connection**. For example, a test web service versus a corresponding Production web service.

When assigning a **SOAP Connection** to a **SOAP Definition** it is considered a design time assignment. When coming to use the **SOAP Definition** in an Action, you have the chance to reassign the **SOAP Connection**. This allows you to use the same **SOAP Definition** in multiple **Actions** each with their own **SOAP Connection**.

![](/statelake/images/image-20230627-014545-1dcbe0ac.png)

## Fields

| FIeld Name | Description |
|---|---|
| SOAP Connection Name | Select a friendly name for the **SOAP Connection**. This is the name that the connection will be known as throughout the configuration. You should enter something meaningful to help you recognise the connection. |
| WSDL Path | Enter the path to the **WSDL** file for the web service. This can be either a local path or a URL. The **WSDL** file will be downloaded from this path to a local cache. |
| Relative Root (optional) | If the WSDL you are processing has **Relative** paths to imported objects, then you can specify the default **Root** path, to resolve the **Relative** path. |
| Web Service Endpoint | Enter the path to the web service. This will include the address of the host server, plus the extra details to identify the required web service endpoint. For example **https://acme.com/soap/orders.aspx**. |
| Authentication *Authorization Type* | Select the **Authorization Type** from the available options. |
| *In Process Auth* | A tick box. Whether authorization occurs during the process of communication, or is sent in an initial request. |
| *User Name* | The **User Name** for the WSDL access. |
| *Password* | The **Password** for the above user. |
| Realm (Domain) | The domain that the user belongs to. This can be left blank. |
| Options *Connect Timeout* | How long in seconds to wait for a connection response from the server. |
| *Handle redirects* | Tick to allow **HTTP** redirects. |
| *Read Timeout* | How long in seconds to wait for the response to complete. |
| *Content Type* | Select from the drop-down box of options. |
| *Charset* | Select the appropriate **Character Set** for the payload from the available options in the drop-down box. |
| *POST HTTP v 1.0* | A tick box to force post requests to use HTTP V 1.0. |

## Buttons

| Button Name | Description |
|---|---|
| Save | Click to save any changes you have made. All changes will be lost if you do not click the Save button. |
| Cancel | Click to cancel any changes you have made |
| Delete | Click to delete this module. You will be asked to confirm your choice. |
| Refresh WSDL | Click to refresh the local cached copy of the WSDL. This will use the value of the WSDL Path to download the WSDL file. The WSDL will be downloaded automatically when saving if it is not already cached. Any change to the WSDL Path will also cause it to download when saving. |
| Proxy Settings | Click to edit the proxy settings used when making the connection to the **HTTP** service. For information regarding this button, please refer to [Proxy Settings](/statelake/administering-statelake/designer/transports/proxy-settings). |
| SSL Settings | Click to edit the SSL settings used when making the connection. Click this button for **TLS**. For information regarding this button, please refer to [SSL Settings (Email Settings)](/statelake/administering-statelake/designer/global-setup/general-setup/email-settings-tab-general-setup/ssl-settings-email-settings). |