Skip to content
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
Cannot retrieve contributors at this time

Junit plugin

JUnit Plugin

JUnit plugin will allow you to launch JUnit tests from a Clarive instance.

What is JUnit

JUnit is a unit testing framework for the Java programming language. JUnit has been important in the development of test-driven development, and is one of a family of unit testing frameworks which is collectively known as xUnit that originated with SUnit.


JUnit is needed in order for it to work properly.


To install the plugin, place the cla-junit-plugin folder inside the $CLARIVE_BASE/plugins directory in a Clarive instance.


This palette service will let you call the test that you wish to perform with JUnit. The various parameters from the palette service are:

  • Server (variable name: server) - Choose the generic server where you wish to execute the JUnit test.
  • User (user) - User which will be used to connect to the server.
  • Libraries path (lib_path) - Full path for the library or libraries needed.
  • Test class (test_class) - Name of the class to test.

Only Clarive EE

  • Errors and output - These two fields are related to manage control errors. Options are:
    • Fail and output error - Search for configurated error pattern in script output. If found, an error message is displayed in monitor showing the match.
    • Warn and output warn - Search for configurated warning pattern in script output. If found, an error message is displayed in monitor showing the match.,
    • Custom - In case combo box errors is set to custom a new form is showed to define the behavior with these fields:
    • OK - Range of return code values for the script to have succeeded. No message will be displayed in monitor.
    • Warn - Range of return code values to warn the user. A warn message will be displayed in monitor.
    • Error - Range of return code values for the script to have failed. An error message will be displayed in monitor.

How to use

In Clarive EE

Once the plugin is placed in its folder, you can find this service in the palette in the section of generic service and can be used like any other palette op.

Op Name: Junit test


    Server: Junit-Server
    Libraries path: /opt/src/lib/junit.jar
    Test class: TestClass
    Errors: fail

In Clarive SE


If you want to use the plugin through the Rulebook, in any do block, use this ops as examples to configure the different parameters:

rule: JUnit demo
   - junit_task:
       server: junit_server   # Required. Use the mid set to the resource you created
       user: ${username}     
       test_class: "TestClass"  # Required
       lib_path: ["/opt/lib1/junit.jar", "/opt/lib2"]  # Required   

The service will return the console output for the test you have executed.

Possible configuration failures

Variable required

Error in rulebook (compile): Required argument(s) missing for op "junit_task": "server"

Make sure you have all required variables defined.

Not allowed variable

Error in rulebook (compile): Argument `Test` not available for op "junit_task"

Make sure you are using the correct paramaters (make sure you are writing the variable names correctly).

More questions?

Feel free to join Clarive Community to resolve any of your doubts.