# SoapUI

First, you go into a test case and click onto *Automation*. Here, you can add a *SoapUI Script*:  

<figure><img src="http://aquawiki.andagon.com/pictures/drex_soapui_rich_client_custom.png" alt=""><figcaption></figcaption></figure>

A new template is created which can be opened using the *External Editor* or replaced by a SoapUI project file. &#x20;

<figure><img src="http://aquawiki.andagon.com/pictures/drex_soapui_rich_client_custom_2.png" alt=""><figcaption></figcaption></figure>

&#x20; &#x20;

<figure><img src="http://aquawiki.andagon.com/pictures/drex_soapui_rich_client_custom_3.png" alt=""><figcaption></figcaption></figure>

By clicking on *External Editor* a blank project will be opened in *SoupUI*. Test cases can be recorded and edited here.&#x20;

To run an automated test, the test case must be executed in the same way as the manual tests. Open the test case and click on the *Run* button. &#x20;

<figure><img src="http://aquawiki.andagon.com/pictures/drex_soapui_rich_client_custom_4.png" alt=""><figcaption></figcaption></figure>

Following the run of an automated test, you can see if the test was successfully completed. In addition, you receive more information from *SoapUI* in the execution log by clicking on the appropriate buttons.&#x20;

&#x20;

<figure><img src="http://aquawiki.andagon.com/pictures/drex_soapui_rich_client_custom_5.png" alt=""><figcaption></figcaption></figure>

### **Parametrization** <a href="#parametrization" id="parametrization"></a>

aqua offers you the option to define parameters and to transmit them to *SoapUI*. To do this, define a set of values in the *Variable Manager* of the test case.&#x20;

<figure><img src="http://aquawiki.andagon.com/pictures/drex_soapui_rich_client_custom_6.png" alt=""><figcaption></figcaption></figure>

When executing this test case, a set of values valid for this version can be selected. The execution log with the selected record can be seen later.&#x20;

To ensure that the values are used in *SoapUI*, properties must be created at top level *SoapUI* project. These properties must have the same identifier as the variables of the aqua-value-set.&#x20;

<figure><img src="http://aquawiki.andagon.com/pictures/drex_soapui_rich_client_custom_7.png" alt=""><figcaption></figcaption></figure>

If you run the test case, these properties will be overwritten by the aqua-agent and the values will be recorded in the log.

## **Configure Agent** <a href="#configure_agent" id="configure_agent"></a>

To configure and start the SoapUI Agent, extract the <mark style="color:orange;">AquaSoapUIAgent-\*.zip</mark>.&#x20;

Here, open agent.properties and insert the agentCode and aquaServiceURL:&#x20;

```csharp
agentCode=pvq6wrb70huknv47ji39
aquaServiceUrl=http://youraquaserver/aquaAPI/aquaagentwebservice.asmx
updateInterval=15000
#The logging level for the execution log sent to the server
# ERRORS_ONLY   : Only abnormal results are logged
# RESULTS_ONLY  : Only results are logged
# DETAILED      : Information on assertions, property transfers and exceptions is logged
# MESSAGE_DUMPS : Request and Response contents are logged
agentLogLevel=ERRORS_ONLY
#The path to the temp directory. The directory must exist when starting the agent.
#Please use \\ to seperate directories.
#Absolute and relative paths are allowed:
#  - D:\\temp
#  - temp
tempDirectory=temp
#Files in temp folder are deleted after the execution finished (true or false)
deleteTempFiles=true
proxyHost=
proxyPort=
proxyUsername=
proxyPassword=
```

Then, open the file <mark style="color:orange;">agent.bat</mark> using the editor and edit the line&#x20;

{% code overflow="wrap" %}

```csharp
if .%SOAPUIPATH% == . set SOAPUIPATH=c:\Program Files\SmartBear\soapUI-4.5.1 
```

{% endcode %}

with your current version. Your agent can now be started with starting <mark style="color:orange;">agent.bat</mark>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aqua-cloud.io/documentation/automation/desktop-client/soapui.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.