10 April 2007 - 1.7 |
The preferences dialog opened when selecting the "Preferences" option from the file menu contains the following tabs:
Tab | Description |
---|---|
HTTP Settings | Sets various HTTP-related options |
Proxy Settings | Sets HTTP Proxy address and authentication |
SSL Settings | Sets SSL-related options |
UI Settings | Sets UI-related options |
Integrated Tools | Sets paths to integrated tools |
WSDL Settings | Sets WSDL-related options |
WSI Settings | Sets WS-I Basic Profile validation options |
Setting | Description |
---|---|
User-Agent Header | Sets the HTTP User-Agent Header. If none is specified the default HttpClient header is used |
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 loadtesting |
Authenticate Preemptively | Send 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 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 |
Preencoded Endpoints | Do not URL-encode endpoints, set this if your endpoint URLs are already URL-encoded (containing for example %20 or %3A) |
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) |
Setting | 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-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. |
Setting | Description |
---|---|
keyStore | Path to the keyStore to use when locating client certificates |
keyStore password | the keyStore password |
Changing either of these settings should not require a restart of soapUI to get activated
Setting | 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. |
Order Projects | Sorts projects in alphabetical order in the navigator. |
Order TestCases | Sorts testcases in alphabetical order in the navigator. |
Order Requests | Sorts requests in alphabetical order in the navigator. |
Disable auto-resize | Disables automatic resizing of request/response editors. |
Tabbed Request view | Sets the tab-layout as the defauly layout for request/response editors (see 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. |
Create Backup | Creates a backup copy of a proejcts 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 |
Desktop Type | Selects 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&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 usefull for debugging, etc. |
Setting | Description |
---|---|
Cache WSDLs | Turns on/off caching of wsdls as described under 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 messagas 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/validating wsdl/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 (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 Types | A 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!. |
These settings are related to WS-I Validation functionality as described under WS-I Integrations.
Setting | 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 |
Location | Local path to installed wsi 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-plugins |