SoapUI Plugin - Macros


# EXECUTE_SOAPUI {soapui_script}

What ?

This macro loads and executes a {soapui_script}. It then verifies the success of the execution.

Underlying instructions :

LOAD {soapui_script} AS __soapui_script{%%rand1}.file
CONVERT __soapui_script{%%rand1}.file TO script.soapui(structured) AS __soapui_script{%%rand2}.soapui

EXECUTE execute WITH __soapui_script{%%rand2}.soapui AS __exec{%%rand3}.result
ASSERT __exec{%%rand3}.result IS success

> Input :

  • {soapui_script} : path to a SoapUI xml workspace file. It will be converted to a soapui.script resource.

Example :

# EXECUTE_SOAPUI path/to/soapui-script.xml

SoapUI Project as a .xml file in the resources directory :

../../_images/doc-soapui-project.png

SKF script :

../../_images/doc-soapui-macro-execute.png

Result output on error in the SKF script :

In this example we misspelled the name of the SoapUI project in the macro.
../../_images/doc-soapui-macro-execute-skf-error.png

Result output on failure of a test case in the SoapUI project :

../../_images/doc-soapui-macro-execute-soap-fail.png


# EXECUTE_SOAPUI {soapui_script} WITH TEST_SUITE {testsuites}

What ?

This macro loads the {soapui_script} and executes the given {testsuites}. It then verifies the success of the execution.

Underlying instructions :

LOAD {soapui_script} AS __soapui_script{%%rand1}.file
CONVERT __soapui_script{%%rand1}.file TO script.soapui(structured) AS __soapui_script{%%rand2}.soapui

EXECUTE execute WITH __soapui_script{%%rand2}.soapui USING $(soapui.test.suites:{testsuites};soapui.test.cases:{testcases}) AS __exec{%%rand5}.result
ASSERT __exec{%%rand5}.result IS success

> Input :

  • {soapui_script} : path to a SoapUI xml workspace file. It will be converted to a soapui.script resource.
  • {testsuites} : names of the test suites of the SoapUI workspace to execute. It could be one test suite or a list of comma separated test suites to execute.

Example :

# EXECUTE_SOAPUI path/to/soapui-script.xml WITH TEST_SUITE testsuite_name

SKF script with 2 test suites :

../../_images/doc-soapui-macro-execute-with.png


# EXECUTE_SOAPUI {soapui_script} WITH TEST_SUITE {testsuites} AND TEST_CASE {testcases}

What ?

This macro loads a SoapUI xml workspace and executes the given test case(s). The macro then verifies the success of the execution.

Underlying instructions :

LOAD {soapui_script} AS __soapui_script{%%rand1}.file
CONVERT __soapui_script{%%rand1}.file TO script.soapui(structured) AS __soapui_script{%%rand2}.soapui

EXECUTE execute WITH __soapui_script{%%rand2}.soapui USING $(soapui.test.suites:{testsuites};soapui.test.cases:{testcases}) AS __exec{%%rand5}.result
ASSERT __exec{%%rand5}.result IS success

> Input :

  • {soapui_script} : path to a SoapUI xml workspace file. It will be converted to a soapui.script resource.
  • {testsuites} : names of test suites of SoapUI workspace to execute. It could be one test suite or a list of comma separated test suites to execute.
  • {testcases} : names of test cases to execute in the test suite. It could be only one test case or a comma separated list of test cases.

Example :

# EXECUTE_SOAPUI path/to/soapui-script.xml WITH TEST_SUITE issueServiceTest AND TEST_CASE retrieveIssue,issueExists

SKF script :

../../_images/doc-soapui-macro-execute-with-and.png


# EXECUTE_SOAPUI_BUNDLE {soapui_bundle} WITH PROJECT {projectpath}

What ?

This macro executes a SoapUI script embedded in a bundle. The macro then verifies the success of the execution.

Underlying instructions :

LOAD {soapui_bundle} AS __soapui_bundle{%%rand1}.file
CONVERT __soapui_bundle{%%rand1}.file TO script.soapui(structured) AS __soapui_bundle{%%rand2}.soapui

EXECUTE execute WITH __soapui_bundle{%%rand2}.soapui USING $(soapui.project.path:{projectpath}) AS __exec{%%rand3}.result
ASSERT __exec{%%rand3}.result IS success

> Input :

  • {soapui_bundle} : path to the SoapUI bundle to load.
  • {projectpath} : path to the SoapUI xml workspace file (relative to the root of the bundle).

Example :

# EXECUTE_SOAPUI_BUNDLE soapui WITH PROJECT soapui-integration-tests.xml


# EXECUTE_SOAPUI_BUNDLE {soapui_bundle} WITH PROJECT {projectpath} AND TEST_SUITE {testsuites}

What ?

This macro executes the given test suites of the loaded SoapUI bundle. The macro then verifies the success of the execution.

Underlying instructions :

LOAD {soapui_bundle} AS __soapui_bundle{%%rand1}.file
CONVERT __soapui_bundle{%%rand1}.file TO script.soapui(structured) AS __soapui_bundle{%%rand2}.soapui

EXECUTE execute WITH __soapui_bundle{%%rand2}.soapui USING $(soapui.project.path:{projectpath};soapui.test.suites:{testsuites}) AS __exec{%%rand5}.result
ASSERT __exec{%%rand5}.result IS success

> Input :

  • {soapui_bundle} : path to SoapUI bundle to load.
  • {projectpath} : path to SoapUI xml workspace file (relative to the root of the bundle).
  • {testcases} : names of testsuites of soapui workspace to execute. It could be one test suite or a list of comma separated test suites to execute.

Example :

# EXECUTE_SOAPUI_BUNDLE soapui WITH PROJECT soapui-integration-tests.xml AND TEST_SUITE issueServiceTest


# EXECUTE_SOAPUI_BUNDLE {soapui_bundle} WITH PROJECT {projectpath} AND TEST_SUITE {testsuites} AND TEST_CASE {testcases}

What ?

This macro loads a SoapUI bundle and executes the given test cases. The macro then verifies the success of the execution.

Underlying instructions :

LOAD {soapui_bundle} AS __soapui_bundle{%%rand1}.file
CONVERT __soapui_bundle{%%rand1}.file TO script.soapui(structured) AS __soapui_bundle{%%rand2}.soapui

EXECUTE execute WITH __soapui_bundle{%%rand2}.soapui USING $(soapui.project.path:{projectpath};soapui.test.suites:{testsuites};soapui.test.cases:{testcases}) AS __exec{%%rand5}.result
ASSERT __exec{%%rand5}.result IS success

> Input :

  • {soapui_bundle} : path to the SoapUI bundle to load.
  • {projectpath} : path to SoapUI xml workspace file (relative to the root of the bundle).
  • {testsuites} : names of test suites of SoapUI workspace to execute. It could be one test suite or a list of comma separated test suites to execute.
  • {testcases} : names of test cases to execute in the test suite. It could be only one test case or a comma separated list of test cases.

Example :

# EXECUTE_SOAPUI_BUNDLE soapui WITH PROJECT soapui-integration-tests.xml AND TEST_SUITE issueServiceTest AND TEST_CASE retrieveIssue,issueExists