09 July 2009 - 3.0 user guide eclipse intellij netbeans maven download nightly forum bugs blog sf.net eviware


Eviware Logo

soapUI Preferences

The preferences dialog opened when selecting the "Preferences" option from the file menu contains the following tabs:

TabDescription
HTTP Settings Sets various HTTP-related options
Proxy Settings Sets HTTP Proxy address and authentication
SSL Settings Sets SSL-related options
WSDL Settings Sets WSDL-related options
UI Settings Sets UI-related options
Editor Settings Sets editor-related options
Tools Sets paths to integrated tools
WSI Settings Sets WS-I Basic Profile validation options
Global Properties Manages Global Properties
Global Security Settings Manages Global Security Settings
WS-A Settings Manages WS-A Settings
soapUI Pro Settings Sets soapUI-Pro specific settings
Coverage Settings Coverage related settings
Code Templates Code Templates settings
JDBC Drivers Properties JDBC Drivers Properties

Import Preferences

The global File menu contains a menu action for importing global preferences from an existing installation. In soapUI this will prompt for an existing soapui-settings file, in soapUI Pro the following dialog will be shown:

Importing preferneces from an earlier soapUI Installation

The options are:

  • Folder - en existing soapUI installation folder
  • Import Preferences, Libraries, Scripts, and Extensions - if the corresponding artifacts should be imported
  • Overwrite - overwrites existing files..

If importing more than the preferences, it is recommended to restart soapUI to avoid script or extension inconsistencies with the previous installation.

HTTP Settings

SettingDescription
HTTP VersionSelects the HTTP version
User-Agent HeaderSets the HTTP User-Agent Header. If none is specified the default HttpClient header is used
Request CompressionSelects the request compression type
Response CompressionIndicates if compressed responses from hosts are accepted
Disable Response DecompressionDisables decompression of compressed responses
Close connections after requestDisables 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
Disable ChunkingDisables content-chunking
Authenticate PreemptivelySend 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-ContinueAdds Expect-Continue header to outgoing request.For further info on this feature check here
Preencoded EndpointsDo not URL-encode endpoints, set this if your endpoint URLs are already URL-encoded (containing for example %20 or %3A)
Bind AddressThe 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 takenIncludes the time it took to write the request in time-taken
Include response in time takenIncludes the time it took to read the response body in time-taken
Socket TimeoutThe socket timeout for HTTP requests in milliseconds
Max Response SizeThe maximum number of bytes to read from a response (0 = unlimited)
Max Connections Per HostThe 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 ConnectionsThe total maximum number of connections. Increase this value if you are running LoadTests with more than 2000 threads.
Leave MockEngineWill 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 LogLogs wire content of all mock requests. Selecting this option will degrade Mock Engine performance marginally and may require restart to enable or disable.

The HTTP Settings Tab in soapUI

Proxy Settings

SettingDescription
Proxy HostThe HTTP Proxy host to use
Proxy PortThe HTTP Proxy port to use
Proxy UsernameThe username sent for proxy authentications
Proxy PasswordThe password sent for proxy authentications
ExcludesA 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.

If a \ is part of the username, the credentials are interpreted as NTLM credentials; the string up to the \ will be used as the domain and the string after will be used as username.

The Proxy Settings Tab in soapUI

SSL Settings

SettingDescription
keyStorePath to the keyStore to use when locating client certificates
keyStore passwordthe keyStore password
Enable Mock SSLEnables SSL support for MockServices
Mock PortThe port for SSL connections
Mock KeyStoreThe keystore to use for SSL certificates
Mock PasswordThe keystore password
Mock Key PasswordThe default keys password
Mock TrustStoreThe truststore to use (optional)
Mock TrustStore PasswordThe truststore password
Client AuthenticationIndicates if client authentication is required

Changing either of first two settings should not require a restart of soapUI to get activated. The MockService related settings will get applied the next time the MockEngine is started.

The SSL Settings Tab in soapUI

WSDL Settings

SettingDescription
Cache WSDLsTurns on and off caching of WSDL's as described under Caching Definitions.
Sample ValuesGenerates example values in requests when creating from schema
Type CommentGenerates comments with type information in new requests
Include OptionalAlways includes optional elements in generated requests
Pretty PrintPretty prints response messages in response editor
Attachment PartsGenerates part-elements in request messages for mime-attachments in RPC messages (required by some ws-stacks)
No Content-Type ValidationDoes not validate the content-type of a mime-attachment against the type(s) specified in the SOAP-Binding
Schema DirectorySpecifies 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 BindingTells soapUI to name imported interfaces with the name of their corresponding soap/http binding, and not with their portType (as described in 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 TypesA 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 TypesCheck 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 LimitThe 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 FilesPretty 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.

The WSDL Settings Tab in soapUI

UI Settings

SettingDescription
Close ProjectsCloses all projects at startup for improved startup-time and less memory consumption.
Order ProjectsSorts Projects in alphabetical order in the navigator.
Order RequestsSorts Requests in alphabetical order in the navigator.
Order TestSuitesSorts TestSuites in alphabetical order in the navigator.
Show DescriptionsShow description content when available
Save Projects On ExitAutomatically save all projects on exit.
Create BackupCreates a backup copy of a projects project-file before saving.
Backup FolderThe folder where to save backups, if relative or empty the folder is relative to the project files folder
Auto Save IntervalSets 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 TypeSelects which desktop layout to use. soapUI Pro adds a Tabbed Desktop as an alternative to the default layout. Changing this setting will be applied when closing the preferences dialog.
Native L&FTurns off the use of the default Look & Feel and uses the JRE default instead. Requires a restart.
Do not disable Groovy LogKeeps the groovy log active during LoadTests, which can be useful for debugging, etc.
Show Log TabsExpands the log tabs when starting soapUI.
Show Startup PageOpens startup web page when starting soapUI.
Start soapUI Testing
Did you know?

In soapUI Pro you can set a whole fresh view of web Service Requests, the tabbed view.

soapUI Pro contains productivity enhancements as well as offers Professional World Class support. contains productivity enhancements as well as offers Professional World Class support.

Try soapUI pro to soap test

The UI Settings Tab in soapUI

Editor Settings

SettingDescription
Editor FontThe font to be used by all XML Editors. The "Select Font" button opens a dialog for selecting the desired font and size.
XML Line NumbersShows line-numbers by default in all XML-Editors (use Alt-L in editors to toggle).
Groovy Line NumbersShows line-numbers by default in all Groovy-Editors (use Alt-L in editors to toggle).
Disable auto-resizeDisables automatic resizing of request/response editors.
Tabbed Request viewSets the tab-layout as the default layout for request/response editors (see Requests).
Validate RequestsTurns 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 InvalidEnabled in conjunction with "Validate Requests", if selected any requests that fail validation will not be submitted.
Validate ResponsesTurns 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.

The Editor Settings Tab in soapUI

Integrated Tools

Paths to integrated Tools as described under Tool Integrations

WSI Settings

These settings are related to WS-I Validation functionality as described under WS-I Integrations.

SettingDescription
VerboseSets verbose output of WS-I tools
Results TypeSets which results to show in the generated report
Message EntryShows message entries in report
Failure MessageIncludes defined failure messages in report
Assertion DescriptionIncludes description of each test assertion in report
LocationLocal path to installed WS-I test tools
Show LogShows Log window when running WS-I tools
Output FolderIf 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

The WS-I Settings Tab in soapUI

Global Properties

Manages global properties, if a soapui.properties file has been specified, that files contents will be available in the table. The "Enable Override" option will make global properties to always override any other property references (see Properties for more information).

The Global Properties Tab in soapUI

Global Security Settings

Manages global SoapUI password. If password set it is used for encrypting soapui-settings file. When opening soapUI with wrong password specified encrypted file backup will be created and new soapui-settings file will be used, with default values.

The Global Security Settings Tab in soapUI

WS-A Settings

Manages WS Addressing settings

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

The soapUI Pro Settings Tab in soapUI

soapUI Pro Settings

These settings are related to soapUI Pro specific functionality.

SettingDescription
Default Request EditorSets the default Message Editor to use when a Request is opened
Default Response EditorSets the default Message Editor to use when a Response is received
Outline Editor LimitDefines 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 LimitDefines 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 ColumnsSets the maximum number of columns displayed by the Table Inspector (due to performance reasons).
Script LibrarySets the location for the local Script Library.

The soapUI Pro Settings Tab in soapUI

Coverage Settings

These settings are related to soapUI Pro specific WSDL Coverage functionality.

SettingDescription
Auto PrepareAutomatically prepares for Coverage calculation when opening a window containing Coverage content.

The Coverage Settings Tab in soapUI

Code Templates

soapUI Pro provides initial functionality to define Code Templates which will be replaced with their corresponding content when typing them and pressing Ctrl-Space in any of the groovy editors. This preferences page allows you to add/remove/modify Code Templates as desired. Use the '|' character to specify the caret position after the template has been inserted (otherwise the caret will be positioned after the inserted template text).

soapUI Pro comes with two initial templates:

  • grut - def groovyUtils = new com.eviware.soapui.support.GroovyUtils( context )
  • xhre - def holder = groovyUtils.getXmlHolder( "|#Response" )

Code Templates Tab in soapUI

JDBC Drivers Properties

soapUI Pro provides functionality of defining JDBC Drivers which will be used for JdbcDataSource Configuration Wizard or JdbcDataSink Configuration Wizard .

Driver configuration table has two columns:

  • Driver: which must be in form unique_identifier/actual_driver_class, for instance MySql /com.mysql.jdbc.Driver
  • Connection string template, for instance
    jdbc:mysql://<HOST:localhost>:<PORT:3306>/<DB>?user=<USER>&password=<PASSWORD>
    Every property in the template can have default value set in form <property:default_value> which will be than prepopulated in configuration wizard

If there are no JDBC Drivers set wizard can't be used.

JDBC Drivers Properties Tab in soapUI

JDBC Drivers Properties Menu Bar

The Project JDBC Drivers Properties tab contains the following menu bar items:

  • Add driver setting. Add a Driver setting to the list
  • Remove driver setting Remove a Driver setting from the list
  • Load drivers settings Load drivers settings from a file.
  • Reload default drivers settings Replace all the existing settings with the default ones.

More information about drivers/connections strings and where to find them can be found here


Next: soapUI Pro XPath Selection