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 Overview

Prerequisites

Although soapUI should be easy to get started with, you will need to have a good grasp of the following concepts/technologies to get the most out of soapUI's functionality.

  • WSDL - basic concepts (services, ports, bindings, porttypes), relation to xml-schema
  • SOAP - basic concepts, relation to WSDL (bindings, etc), different encoding types (soap-encoded/literal) and message styles (document/rpc)
  • XML and related technologies - XPath, XML Schema, namespaces, etc

You can find most specifications at W3C and tutorials at several sites, for example W3Schools and zvon.org.

The soapUI interface

soapUI is a standard desktop application adhering to established ui-concepts (as available in for example eclipse, IDEA, etc). Most actions have keyboard shortcuts and tooltips, you should have no problems finding your way around...

The soapUI window is divided into the following views:

left

The main navigator showing a hierarchy of all projects/interfaces/etc. (see below)
  • Selecting an item will show available overview information in the bottom-left "Overview" tab
  • Double-clicking or pressing enter on a selected item will open the items desktop pane to the right (if available)
right

The soapUI "desktop" containing panes for those double-clicked items in the navigator.
  • Cycle between active panes with Ctrl-Tab
  • Maximize/Minimize/Resize/Move as usual using each panes window menu
  • Focusing on a pane will automatically put focus on its item in the navigator (scrolling into view if neccessary)
bottom-left

a tabbed pane containing 2 tabs:
  • The Windows tab show a list of all the windows currently open desktop panes. Double-clicking an item will bring it into focus
  • The Details tab will show information on the item currently selected in the navigator
bottom right

A color-coded log view showing log messages from soapUI. Three tabs will be visible:
  • soapUI log : shows general soapUI messages
  • http log : shows the actual http messages sent (disabled during loadtests)
  • groovy log : shows log output from Groovy Test Steps (optionally disabled during loadtests, see UI Settings)
  • jetty log : shows log output related to MockService functionality from the integrated http server

(One can set a centered background image for the default desktop by placing a soapui-backgroung.gif/jpg/png file in the soapUI bin folder)

Navigator Tree Model

The following objects are currently shown in the navigator tree:
  • Projects node : the soapUI workspace
    • Project node(s) : for each project in the workspace

      • Interface node(s) : for each interface in the project

        • Operation node(s) : for each operation in the interface

          • Request node(s) : for each request created for the operation

      • TestSuite node(s) : for each testsuite in the project

        • TestCase node(s) : for each testcase in the testsuite

          • TestSteps node, contains the TestCases'

            • TestStep node(s) : for each testcase-step, together with a colored icon indicating the status of that step.

          • LoadTests node, contains the TestCases'

            • LoadTest node(s) : for each loadtest in the containing testcase

      • MockService node(s) : for each MockService in the project

        • MockOperation node(s) : for each MockOperation in the MockService

          • MockResponse node(s) : for each MockResponse in the containing MockOperation

The tree can be navigated using the standard keyboard actions. An items' associated desktop panel can be opened by double-clicking it or selecting it and pressing Enter.

Main Menu

Most actions in soapUI are performed through toolbar buttons or context-sensitive right-button menus. The following actions are available from the main menu:

File Menu
  • New WSDL Project - adds a new WSDL-based project to the current workspace
  • Import Project - imports an existing project file into the current workspace
  • Save all projects - Saves the current state of all projects
  • Online Help - displays this page in an external browser
  • Preferences - Sets global soapUI Preferences
  • Save preferences - Saves the current global settings
  • Exit - prompts to exit soapUI
  • Exit without saving - prompts to exit soapUI without saving anything
Tools Menu
  • Contains actions for invoking integrated tools as described in the Tool Integrations section.
Desktop Menu - Shows actions related to the currently selected Desktop.
  • Close Current - closes the currently active desktop pane
  • Close All - closes all desktop panes
  • Closes Others - closes all desktop panes except the currently active one
Help Menu - general information and soapUI Pro specific actions
  • User Guide - Opens the soapUI User Guide
  • Getting Started - Opens the soapUI Getting Started documents
  • System Properties - Opens a list of all currently defined sysem properties (see below)
  • Update License (soapUI Pro only) - see License Management
  • Show License Details (soapUI Pro only) - see License Management
  • soapUI.org - Opens http://www.soapui.org
  • About soapUI - Shows a version information dialog

System Properties

The System Properties option from the help menu opens a simple dialog showing all current defined system properties, which can be usefull for debugging system/security settings, etc..

Log Tabs

The bottom right of the soapUI workspace contains a number of log windows, each displaying corresponding output;

Right clicking on a log will show a popup menu with options to clear and enable/disable the log and to copy selected rows to the clipboard. Also, log-entries can be selected/copied to the clipboard for transfer to external tools. An option to set the maximum number of rows is available (default is 1000), when exceeding this limit, old rows are removed from the log (ie fifo).

soapUI uses log4j for logging, you can customize the log4j configuration by putting a log4j xml configuration file named "soapui-log4j.xml" in the soapUI bin directory (or the current working directory when not running from there).


Next: soapUI Preferences