MicroNova EXAM

Jenkins Plugin GitHub release Jenkins Plugin Installs

About this plugin

This plugin integrates the RESTapi of the Testautomation tool EXAM for automated test execution. MicroNova EXAM Plugin is available for download at:

exam-testautomation

EXAM icon

EXAM is a graphical test development tool. EXAM defines a comprehensive methodology based on UML to represent, implement and evaluate test cases. It enables you to graphically model test processes in sequence diagrams without programming knowledge. EXAM thus provides a uniform language for the representation of test events. EXAM is suitable for use in Hardware-in-the-Loop simulation (HiL), test bench automation and industrial automation as well as in embedded development and Software-in-the-Loop simulation (SiL).

Table of contents

Requirements

  • EXAM

    • min. v4.4
    • REST-API Plugin for EXAM
  • Jenkins-Plugins

    • shiningpanda
    • workflow-step-api

Configuration

Global Tool Configuration

For this plugin to be used, an Ant installation must be specified in the global Jenkins configuration

Global_Tool_Configuration.png

System Configuration

general
Rest api Port Port for the communication with the EXAM RESTapi
License Server Host host name of the license server
License Server Port port name of the license server

System_Configuration_main.png

EXAM Model Connection
Name Identifier of this connection, which can be selected at the build step
Model Name Name of the model known at the EXAM application server
EXAM version The major and minor version number of EXAM
Target Endpoint url of the EXAM application server

System_Configuration_model.png

EXAM Report Connection
Name Identifier of this connection, which can be selected at the build step
DB Type Supported types are Oracle and PostgreSQL
Service/SID Only needed, when Oracle is choosen as DB Type.

System_Configuration_report.png

Job Configuration

The EXAM plugin provides 3 build steps.

  1. Clear EXAM target (use this to clear all junit formated reports bevor invoking an EXAM test)

    Job_Clear.png

  2. Invoke EXAM model (invoke an EXAM test with a connection to a EXAM model)

    Modeler
    EXAM Version Choose a configured EXAM installation.
    Model Choose a configured Model Connection.
    ModelConfiguration The UUID of the ModelConfiguration, if the used EXAM Version is 4.6 or newer with active versioning
    delete project If selected, the synchronized python code of the choosen model will be deleted at the beginning.
    Testrun
    Python Version Choose a configured Python installation.
    test object Use the UUID, ID or full scoped name of a TestSuite or TestCampaign from the EXAM model.
    SystemConfiguration Use the UUID, ID or full scoped name of the system configuration from the EXAM model.
    configure Testrun Filters Define filter constraints for the given attribute names.
    configure logging A log file is generated automatically during each test run. You can influence the amount of output that gets logged over the LogLevel.
    Report
    Reports Choose a configured Report Connection. If you choose "NO REPORT", no report will be written to a database. Conversion of EXAM Reports to junit report format will be done in any case.
    report prefix Sets a prefix on the report name.
    create pdf report If selected, the report will be exported to a pdf document.

    Job_Model.png

  3. Invoke EXAM execution file (invoke an EXAM test with an exported execution file)

    Modeler
    EXAM Version Choose a configured EXAM installation.
    Testrun
    Python Version Choose a configured Python installation.
    PCode Path Path to pCode directory containing the generated code required by the execution file.
    Execution File Path to the EXAM execution file exported from TestRunner.
    SystemConfiguration Sets the default system configuration. For EXAM, use the UUID and the name of the system configuration from the EXAM model, e.g. "61b56acdbe4247a9e04400144f6890f0 English_EXAM_System"
    configure Testrun Filters Define filter constraints for the given attribute names.
    configure logging A log file is generated automatically during each test run. You can influence the amount of output that gets logged over the LogLevel.
    Report
    Reports Choose a configured Report Connection. If you choose "NO REPORT", no report will be written to a database. Conversion of EXAM Reports to junit report format will be done in any case.
    report prefix Sets a prefix on the report name.
    create pdf report If selected, the report will be exported to a pdf document.

    Job_ExecutionFile.png

Junit Report format

The EXAM reports are converted to standard junit format. To show the result at Jenkins add a junit report step with the following expression:

junit 'target/test-reports/**/*.xml'

License

License

Changelog

Changelog