26 September 2007 - 1.7.6 | home user-guide eclipse jbossws intellij netbeans maven 1.X/2.X PDF files forums bugs sourceforge

Home
Getting Started
User Guide

- Overview
  - Tabbed Desktop
  - License Management
  - Preferences
  - XPath Selection
  - Script Library
- Workspaces
- Projects
- Interfaces
  - Interface Viewer
- Operations
- Working with Requests
  - Form Editor
  - Overview View
  - Outline Editor
  - Message Inspectors
  - Attachments/Inline Files
- Functional Testing
  - Getting Started
  - TestSuites
  - TestCases
    - Test Requests
      - Assertions
      - Editor Wizards
    - Property Transfers
    - Conditional Gotos
    - Groovy Scripts
      - Examples
      - GroovyUtils
    - Properties Step
    - Delay Step
    - Mock Response
    - DataSource
    - DataSource Loop
  - Property Expansion
- Load Testing
  - Getting Started
  - Limit & Strategies
  - Execution
  - Assertions
  - Diagrams
  - JMeter comparison
- Mocking
  - Getting Started
  - Mock Services
  - Mock Operations
  - Mock Responses
- Usage Scenarios
  - Data-Driven Testing
  - Template-Driven Testing
  - Interactive Testing
  - Surveillance Testing
- Tool Integrations
  - Code Generation
  - WSDL Generation
  - WS-I Tools
  - Apache Tcp-Mon
- CommandLine Tools
  - TestCaseRunner
  - LoadTestRunner
  - MockServiceRunner
  - ToolRunner
- Keyboard shortcuts

IDE/Tool Plugins
Search soapUI site
Project Documentation

- About soapUI
- Project Info
- Project Reports

## soapUI Preferences

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
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
soapUI Pro Settings | Sets soapUI-Pro specific settings

### 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:

The options are:

- Folder - en existing soapUI (Pro) installation folder
- Import Preferences/Libraries/Scripts/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/extension inconsistencies with the previous installation.

### HTTP Settings

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

### Proxy Settings

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.

### SSL Settings

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

### WSDL Settings

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!.
Strict Schema Types | Check this to not allow schema-type redefinitions in included/imported xsd:s for a specific WSDL (default behaviour 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/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/XSDs will be pretty-printed.

### UI Settings

Setting | 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 Requests | Sorts Requests in alphabetical order in the navigator.
Order TestSuites | Sorts TestSuites in alphabetical order in the navigator.
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.

### Editor Settings

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

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

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

### soapUI Pro Settings

These settings are related to soapUI Pro specific functionality.

Setting | 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
Auto Save Interval | Sets a project-autosave 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
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 ones own memory settings is encouraged
Table Inspector Columns | Sets the maximum number of columns displayed by the Table Inspector (due to performance reasons).
Form Editor Limit | Defines the maximum size of messages to handle in the form editor; since the outline editor consumes a large amount of memory, setting a limit related to ones own memory settings is encouraged
Script Library | Sets the location for the local Script Library.

Next: XPath Selection