10 April 2007 - 1.7 home user-guide eclipse jbossws intellij netbeans maven 1.X/2.X PDF files forums bugs sourceforge






Vote for soapUI at the WSJ Readers' Choice awards in the

'Best Web Services Utility' and

'Best Web Services Testing Tool'

categories

soapUI Preferences

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

TabDescription
HTTP SettingsSets various HTTP-related options
Proxy SettingsSets HTTP Proxy address and authentication
SSL SettingsSets SSL-related options
UI SettingsSets UI-related options
Integrated ToolsSets paths to integrated tools
WSDL SettingsSets WSDL-related options
WSI SettingsSets WS-I Basic Profile validation options

HTTP Settings

SettingDescription
User-Agent HeaderSets the HTTP User-Agent Header. If none is specified the default HttpClient header is used
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 loadtesting
Authenticate PreemptivelySend Authentication headers with each request without first recieving 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
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
Preencoded EndpointsDo not URL-encode endpoints, set this if your endpoint URLs are already URL-encoded (containing for example %20 or %3A)
Socket TimeoutThe socket timeout for HTTP requests in milliseconds
Max Response SizeThe maximum number of bytes to read from a response (0 = unlimited)

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-seperated 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.

SSL Settings

SettingDescription
keyStorePath to the keyStore to use when locating client certificates
keyStore passwordthe keyStore password

Changing either of these settings should not require a restart of soapUI to get activated

UI 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.
Order ProjectsSorts projects in alphabetical order in the navigator.
Order TestCasesSorts testcases in alphabetical order in the navigator.
Order RequestsSorts requests in alphabetical order in the navigator.
Disable auto-resizeDisables automatic resizing of request/response editors.
Tabbed Request viewSets the tab-layout as the defauly 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.
Create BackupCreates a backup copy of a proejcts project-file before saving.
Backup FolderThe folder where to save backups, if relative or empty the folder is relative to the project files folder
Desktop TypeSelects which desktop layou 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 usefull for debugging, etc.

Integrated Tools

Paths to integrated Tools as described under Tool Integrations

WSDL Settings

SettingDescription
Cache WSDLsTurns on/off caching of wsdls 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 messagas 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/validating wsdl/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/global-elements in the form of name@namespace which will be used when generating sample requests/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!.

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 wsi 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-plugins


Next: Workspaces and Projects