Preferences

SoapUI Preferences Dialog

Following is the short description of all tabs available in SoapUI Preferences dialog.

Tab	Description
HTTP Settings	Set properties specific to HTTP protocol (protocol version, User-Agent header, request and response compression etc.).
Proxy Settings	Define proxy server (host, port, username, password and excludes). Also this is where user specify whether proxy is in use or not.
SSL Settings	Define keystore, and Mock service SSL parameters.
WSDL Settings	Define WSDL specific properties.
UI Settings	Define user interface properties (backup, autosave, look & feel, items ordering in a tree, tooltips visibility, garbage collection interval etc.).
Editor Settings	Set various editor properties like font, line numbers visibility, request and response validation etc.
Tools	Define external tools executables. To run tools from the Tools main application menu, their executables must be defined here.
WS-I Settings	Define WS-I tools properties.
Global Properties	Define custom global application properties.
Global Security Settings	Define password for shadowing proxy password in settings file.
WS-A Settings	Define parameters related to web services addresing.
loadUI Settings	Define path to loadUI and integration ports.
Web Recording Settings	Define request headers to exclude during web recording.
SoapUI Pro	Set SoapUI Pro spcific properties.
Coverage Settings	Enable or disable autopreparation of coverage reports.
Code Templates	Define code templates.
JDBC Drivers Properties	Declare jdbc drivers and their connection string patterns.

HTTP Settings Tab

Option	Description
HTTP Version	Selects the HTTP version
User-Agent Header	Sets the HTTP User-Agent Header. If none is specified the default HttpClient header is used
Request Compression	Selects the request compression type
Response Compression	Indicates if compressed responses from hosts are accepted
Disable Response Decompression	Disables decompression of compressed responses
Close connections after request	Disables HTTP Keep-Alives by requesting to close the HTTP connection after each request. This will have a negative impact on performance but may give more realistic values during load testing
Chunking Threshold	Using content-chunking for requests larger than threshols, blank to disable
Authenticate Preemptively	Send Authentication headers with each request without first receiving an authentication challenge. This is a potential security hazard but will improve performance since only one request will be required for authenticated endpoints instead of two
Expect-Continue	Adds Expect-Continue header to outgoing request.For further info on this feature check here
Preencoded Endpoints	Do not URL-encode endpoints, set this if your endpoint URLs are already URL-encoded (containing for example %20 or %3A)
Bind Address	The local address to bind to when sending requests, can be overridden on a request level (with the corresponding request property) and on a system level by setting the soapui.bind.address system variable.
Include request in time taken	Includes the time it took to write the request in time-taken
Include response in time taken	Includes the time it took to read the response body in time-taken
Socket Timeout	The socket timeout for HTTP requests in milliseconds
Max Response Size	The maximum number of bytes to read from a response (0 = unlimited)
Max Connections Per Host	The maximum number of simultaneous connections to a specific host. Increase this value if you are running LoadTests with more than 500 threads on a particular host.
Max Total Connections	The total maximum number of connections. Increase this value if you are running LoadTests with more than 2000 threads.
Leave MockEngine	Will leave the MockEngine running even when all MockServices have stopped resulting in much faster startup-times for new MockServices and 404 errors when trying to call a stopped MockService (instead of connection failure)
Enable Mock HTTP Log	Logs wire content of all mock requests. Selecting this option will degrade Mock Engine performance marginally and may require restart to enable or disable.

Proxy Settings Tab

Option	Description
Proxy Host	The HTTP Proxy host to use
Proxy Port	The HTTP Proxy port to use
Proxy Username	The username sent for proxy authentications
Proxy Password	The password sent for proxy authentications
Excludes	A comma-separated list of hosts to exclude, for example "127.0.0.1:8080,myserver.com" will not use a proxy for 127.0.0.1 on port 8080 and myserver.com on any port.
Enable proxy	Flag indicating if supplied proxy properties should be enabled, i.e. if proxy should be used

SSL Settings Tab

Option	Description
KeyStore	Path to the keyStore to use when locating client certificates
KeyStore password	the keyStore password
Enable Mock SSL	Enables SSL support for MockServices
Mock Port	The port for SSL connections
Mock KeyStore	The keystore to use for SSL certificates
Mock Password	The keystore password
Mock Key Password	The default keys password
Mock TrustStore	The truststore to use (optional)
Mock TrustStore Password	The truststore password
Client Authentication	Indicates if client authentication is required

WSDL Settings Tab

Option	Description
Cache WSDLs	Turns on and off caching of WSDL's (Read Reference Caching Definitions ).
Sample Values	Generates example values in requests when creating from schema
Type Comment	Generates comments with type information in new requests
Include Optional	Always includes optional elements in generated requests
Pretty Print	Pretty prints response messages in response editor
Attachment Parts	Generates part-elements in request messages for mime-attachments in RPC messages (required by some ws-stacks)
No Content-Type Validation	Does not validate the content-type of a mime-attachment against the type(s) specified in the SOAP-Binding
Schema Directory	Specifies a directory containing schema (.xsd) files that should be automatically added when parsing or validating wsdl or requests. Changing the contents of this directory requires a restart.
Name with Binding	Tells SoapUI to name imported interfaces with the name of their corresponding soap/http binding, and not with their portType (Read Reference Interfaces). This ensures that WSDL containing bindings for both SOAP 1.1 and SOAP 1.2 will get unique names during import. This setting defaults to true.
Excluded Types	A list of XML-Schema types and global elements in the form of name@namespace which will be used when generating sample requests and responses and input forms in the SoapUI Pro Form editor. By default the XML-Schema root element is added since it is quite common in .NET services and generates a sample xml fragment of about 300 kb!.
Strict Schema Types	Check this to not allow schema type redefinitions in included/imported xsd:s for a specific WSDL (default behavior in versions prior to 1.7.5)
Compression Limit	The minimum message size to compress in the SoapUI project file for preserving space. Compression is performed with gzip and the result is base64 encoded into the project file. For large requests, this can save up to 90% file-space, but be aware that the requests are no longer readable or diffable.
Pretty Print Project Files	Pretty prints project files when they are saved, which makes it easier to work with a source-control system (diffing, etc...). Be aware that when selecting this option the size of the project files will increase substantially and also cached WSDLs and XSDs will be pretty-printed.

UI Settings Tab

Option	Description
Close Projects	Closes all projects at startup for improved startup-time and less memory consumption.
Order Projects	Sorts Projects in alphabetical order in the navigator.
Order Services	Sorts Services in alphabetical order in the navigator.
Order Requests	Sorts Requests in alphabetical order in the navigator.
Show Descriptions	Show description content when available
Save Projects On Exit	Automatically save all projects on exit.
Create Backup	Creates a backup copy of a projects project-file before saving.
Backup Folder	The folder where to save backups, if relative or empty the folder is relative to the project files folder
Auto Save Interval	Sets a project auto save interval (in minutes). If set over 0, SoapUI will automatically save all projects that have no running tests (both Functional and Load) at the specified interval
Desktop Type	Selects which desktop layout to use. SoapUI Pro adds a Tabbed Desktop (Read Reference Tabbed Desktop ) as an alternative to the default layout. Changing this setting will be applied when closing the preferences dialog.
Native L&F	Turns off the use of the default Look & Feel and uses the JRE default instead. Requires a restart.
Do not disable Groovy Log	Keeps the groovy log active during LoadTests, which can be useful for debugging, etc.
Show Log Tabs	Expands the log tabs when starting SoapUI.
Show Startup Page	Opens startup web page when starting SoapUI.
Disable Tooltips	Disables all tooltips
Normalize Line-Break	Normalize line-breaks when saving project
Garbage Collection Interval	Sets the Garbage Collector interval in seconds (o means the garbage collection is only performed by JRE)
Size of Raw Response Message	Sets the size of raw response message to show
Size of Raw Request Message	Sets the size of raw request message to show
Wrap content in Raw Message Viewers	Wraps the content in Raw Message Viewer

Editor Settings Tab

Option	Description
Editor Font	The font to be used by all XML Editors. The "Select Font" button opens a dialog for selecting the desired font and size.
XML Line Numbers	Shows line-numbers by default in all XML-Editors (use Alt-L in editors to toggle).
Groovy Line Numbers	Shows line-numbers by default in all Groovy-Editors (use Alt-L in editors to toggle).
Disable auto-resize	Disables automatic resizing of request/response editors.
Tabbed Request view	Sets the tab-layout as the default layout for request/response editors (Read Reference Requests).
Validate Requests	Turns on automatic validation of requests before they are submitted from a request editor. The validation performed is the same as when pressing Alt-V in the editor.
Abort on Invalid	Enabled in conjunction with "Validate Requests", if selected any requests that fail validation will not be submitted.
Validate Responses	Turns on automatic validation of response messages when they are received in a response editor. The validation performed is the same as when pressing Alt-V in the editor.

Tools Tab

Option	Description
JBossWS wstools	Location of JBossWS wstools
JAX-RPC WSCompile	Location of JAX-RPC wscompile
JAX-WS WSImport	Location of JAX-WS wsimport
Axis 1.X	Location of Axis 1.X
Axis 2.X	Location of Axis 2.X
.NET 2.0 wsdl.exe	Location of .NET 2.0 wsdl.exe
XFire 1.X	Location of XFire 1.X
CXF 2.X	Location of CXF 2.X
ANT 1.6+	Location of Apache ANT 1.6.5 or later
GSoap	Location of GSoap 2.X
JAXB xjc	Location of JAXB xjc
XmlBeans 2.X	Location of XmlBeans 2.X
JDK 1.5 javac	Location of JDK 1.5 javac
Apache TcpMon	Location of TcpMon directory
Oracle wsa.jar	Location of Oracle wsa.jar
WADL2Java	Location of WADL2Java script
Hermes JMS	Location of Hermes JMS

WS-I Settings Tab

Option	Description
Verbose	Sets verbose output of WS-I tools
Results Type	Sets which results to show in the generated report
Message Entry	Shows message entries in report
Failure Message	Includes defined failure messages in report
Assertion Description	Includes description of each test assertion in report
Tool Location	Local path to installed WS-I test tools
Show Log	Shows Log window when running WS-I tools
Output Folder	If specified, generated HTML reports will automatically be exported to this folder, which is required when running ws-i validation from the command-line or one of the Maven plug-ins

Global Properties Tab

Option	Description
Global Properties Table	(Read Reference Properties)
Enable Override	Enables overriding of any property-reference with global properties

Global Security Settings Tab

Option	Description
Password	Password for shadowing proxy password in settings file

WS-A Settings Tab

Option	Description
Soap Action Overrides WS-S Action	If present in the WSDL soap action overrides wsa:Action
Use default RelationshipType	Indicates using default 'reply' for RelationshipType as specified in Message Addressing Properties
Use default RelatesTo	Indicates using default 'unspecified' for RelatesTo as specified in Message Addressing Properties
Override existing headers	Indicates replacing/skipping(if unchecked) already existing headers
Enable for optional Addressing policy	Enables WS Addressing for Policy Addressing Assertion attribute Optional="true" (see the WS-Policy Assertions specification)

loadUI Settings Tab

Option	Description
loadUI.bat(.sh) folder	Path to loadUI executable
loadUI integration port	Port on which loadUI integratioin server is running
SoapUI integration port	Port on which SoapUI integratioin server is running

Web Recording Settings Tab

Option	Description
Excluded headers	Request headers to exclude from recording

SoapUI Pro Tab

Option	Description
Default Request Editor	Sets the default Message Editor to use when a Request is opened
Default Response Editor	Sets the default Message Editor to use when a Response is received
Outline Editor Limit	Defines the maximum size of messages to handle in the outline editor; since the outline editor consumes a large amount of memory, setting a limit related to one’s own memory settings is encouraged
Form Editor Limit	Defines the maximum size of messages to handle in the form editor; since the form editor consumes a large amount of memory, setting a limit related to one’s own memory settings is encouraged
Table Inspector Columns	Sets the maximum number of columns displayed by the Table Inspector (due to performance reasons).
Script Library	Part to folder containing groovy object scripts that should be globaly available
Disable Reporting	Disable reporting to preserve memory
Complete Error Logs	Logs complete messages to reports on errors
Custom Report Library	Path to folder containing custom jasper templates or reports

Coverage Settings Tab

Option	Description
Auto Prepare	Automatically prepares for Coverage calculation when opening a window containing Coverage content.

Code Templates Tab

Option	Description
Add	Adds new template
Delete	Removes selected template
Restore	Restores templates to default settings

JDBC Drivers Properties Tab

Option	Description
	Adds a driver to the driver list
	Removes selected driver from the driver list
	Loads driver values from an external file
	Reloads default driver settings

Option	Description
HTTP Version	Selects the HTTP version
User-Agent Header	Sets the HTTP User-Agent Header. If none is specified the default HttpClient header is used
Request Compression	Selects the request compression type
Response Compression	Indicates if compressed responses from hosts are accepted
Disable Response Decompression	Disables decompression of compressed responses
Close connections after request	Disables HTTP Keep-Alives by requesting to close the HTTP connection after each request. This will have a negative impact on performance but may give more realistic values during load testing
Chunking Threshold	Using content-chunking for requests larger than threshols, blank to disable
Authenticate Preemptively	Send Authentication headers with each request without first receiving an authentication challenge. This is a potential security hazard but will improve performance since only one request will be required for authenticated endpoints instead of two
Expect-Continue	Adds Expect-Continue header to outgoing request.For further info on this feature check here
Preencoded Endpoints	Do not URL-encode endpoints, set this if your endpoint URLs are already URL-encoded (containing for example %20 or %3A)
Bind Address	The local address to bind to when sending requests, can be overridden on a request level (with the corresponding request property) and on a system level by setting the soapui.bind.address system variable.
Include request in time taken	Includes the time it took to write the request in time-taken
Include response in time taken	Includes the time it took to read the response body in time-taken
Socket Timeout	The socket timeout for HTTP requests in milliseconds
Max Response Size	The maximum number of bytes to read from a response (0 = unlimited)
Max Connections Per Host	The maximum number of simultaneous connections to a specific host. Increase this value if you are running LoadTests with more than 500 threads on a particular host.
Max Total Connections	The total maximum number of connections. Increase this value if you are running LoadTests with more than 2000 threads.
Leave MockEngine	Will leave the MockEngine running even when all MockServices have stopped resulting in much faster startup-times for new MockServices and 404 errors when trying to call a stopped MockService (instead of connection failure)
Enable Mock HTTP Log	Logs wire content of all mock requests. Selecting this option will degrade Mock Engine performance marginally and may require restart to enable or disable.