The following plugin provides functionality available through Pipeline-compatible steps. Read more about how to integrate steps into your Pipeline in the Steps section of the Pipeline Syntax page.

For a list of other such plugins, see the Pipeline Steps Reference page.

TraceTronic ECU-TEST Plugin

publishATX: [TT] Publish ATX Reports

Publishes the ATX reports of all configured ECU-TEST packages or projects in this job.
These ATX reports are generated automatically in this post-build step and uploaded to TEST-GUIDE.
  • atxName
    • Type: String
  • allowMissing (optional)
    • Type: boolean
  • archiving (optional)
    • Type: boolean
  • keepAll (optional)
    • Type: boolean
  • runOnFailed (optional)
    • Type: boolean

downstreamPublisher: [TT] Downstream Report Generation

Generates report downstream-based on another Jenkins node. In order to work the ECU-TEST workspace has to be copied to that node with all relevant data (i.e. report directory) to generate reports.
This can be achieved for free-style projects with the Copy Artifact Plugin or in pipelines with the stash/unstash commands.
  • workspace
    • Type: String
  • publishers (optional)
      Array/List
      Nested Choice of Objects
    • publishATX
    • Publishes the ATX reports of all configured ECU-TEST packages or projects in this job.
      These ATX reports are generated automatically in this post-build step and uploaded to TEST-GUIDE.
      • atxName
        • Type: String
      • allowMissing (optional)
        • Type: boolean
      • archiving (optional)
        • Type: boolean
      • keepAll (optional)
        • Type: boolean
      • runOnFailed (optional)
        • Type: boolean
    • publishETLogs
    • Publishes the ECU-TEST log files (ECU_TEST_OUT.log and ECU_TEST_ERR.log) and parses them for warning and errors.
      • allowMissing (optional)
        • Type: boolean
      • archiving (optional)
        • Type: boolean
      • failedOnError (optional)
        • Type: boolean
      • keepAll (optional)
        • Type: boolean
      • runOnFailed (optional)
        • Type: boolean
      • testSpecific (optional)
        • Type: boolean
      • unstableOnWarning (optional)
        • Type: boolean
    • publishUNIT
    • Publishes the UNIT reports of all configured ECU-TEST packages or projects in this job.
      These UNIT reports are generated automatically in this post-build step.
      • toolName
        • Type: String
      • allowMissing (optional)
        • Type: boolean
      • archiving (optional)
        • Type: boolean
      • failedThreshold (optional)
        • Type: double
      • keepAll (optional)
        • Type: boolean
      • runOnFailed (optional)
        • Type: boolean
      • unstableThreshold (optional)
        • Type: double
    • publishGenerators
    • Publishes and generates reports by configuration of predefined and/or custom report generators.
      These reports will be generated for all configured ECU-TEST packages or projects in this job.
      • toolName
        • Type: String
      • allowMissing (optional)
        • Type: boolean
      • archiving (optional)
        • Type: boolean
      • customGenerators (optional)
          Array/List
          Nested Object
        • name
          • Type: String
        • settings
            Array/List
            Nested Object
          • name
            • Type: String
          • value
            • Type: String
      • generators (optional)
          Array/List
          Nested Object
        • name
          • Type: String
        • settings
            Array/List
            Nested Object
          • name
            • Type: String
          • value
            • Type: String
      • keepAll (optional)
        • Type: boolean
      • runOnFailed (optional)
        • Type: boolean
    • publishTMS
    • Publishes the test results of all configured ECU-TEST packages or projects in this job to a preconfigured test management system like RQM or ALM.
      • toolName
        • Type: String
      • credentialsId
        • Type: String
      • allowMissing (optional)
        • Type: boolean
      • archiving (optional)
        • Type: boolean
      • keepAll (optional)
        • Type: boolean
      • runOnFailed (optional)
        • Type: boolean
      • timeout (optional)
        • Type: String
    • publishTRF
    • Publishes the TRF reports of all configured ECU-TEST packages or projects in this job.
      • allowMissing (optional)
        • Type: boolean
      • archiving (optional)
        • Type: boolean
      • keepAll (optional)
        • Type: boolean
      • runOnFailed (optional)
        • Type: boolean
    • publishTraceAnalysis
    • Publishes the results of the trace analysis of all configured ECU-TEST packages or projects in this job.
      • toolName
        • Type: String
      • allowMissing (optional)
        • Type: boolean
      • archiving (optional)
        • Type: boolean
      • createReportDir (optional)
        • Type: boolean
      • keepAll (optional)
        • Type: boolean
      • mergeReports (optional)
        • Type: boolean
      • runOnFailed (optional)
        • Type: boolean
      • timeout (optional)
        • Type: String

publishETLogs: [TT] Publish ECU-TEST Logs

Publishes the ECU-TEST log files (ECU_TEST_OUT.log and ECU_TEST_ERR.log) and parses them for warning and errors.
  • allowMissing (optional)
    • Type: boolean
  • archiving (optional)
    • Type: boolean
  • failedOnError (optional)
    • Type: boolean
  • keepAll (optional)
    • Type: boolean
  • runOnFailed (optional)
    • Type: boolean
  • testSpecific (optional)
    • Type: boolean
  • unstableOnWarning (optional)
    • Type: boolean

exportPackages: [TT] Export Packages

Exports ECU-TEST packages and their attributes to a test management system like RQM or ALM.
  • exportConfigs (optional)
      Array/List
      Nested Choice of Objects
    • $class: 'ExportPackageAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ExportPackageConfig'
      • filePath
        • Type: String
      • exportPath
        • Type: String
      • createNewPath
        • Type: boolean
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ExportProjectAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ExportProjectConfig'
      • filePath
        • Type: String
      • exportPath
        • Type: String
      • createNewPath
        • Type: boolean
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportPackageAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportPackageConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportPackageDirConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportProjectArchiveConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • importConfigPath
        • Type: String
      • replaceFiles
        • Type: boolean
    • $class: 'ImportProjectAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportProjectConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • importMissingPackages
        • Type: boolean
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportProjectDirConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String

exportProjects: [TT] Export Projects

Exports ECU-TEST projects and their attributes to a test management system like RQM or ALM.
  • exportConfigs (optional)
      Array/List
      Nested Choice of Objects
    • $class: 'ExportPackageAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ExportPackageConfig'
      • filePath
        • Type: String
      • exportPath
        • Type: String
      • createNewPath
        • Type: boolean
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ExportProjectAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ExportProjectConfig'
      • filePath
        • Type: String
      • exportPath
        • Type: String
      • createNewPath
        • Type: boolean
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportPackageAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportPackageConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportPackageDirConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportProjectArchiveConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • importConfigPath
        • Type: String
      • replaceFiles
        • Type: boolean
    • $class: 'ImportProjectAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportProjectConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • importMissingPackages
        • Type: boolean
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportProjectDirConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String

importPackages: [TT] Import Packages

Imports ECU-TEST packages and their attributes from a test management system like RQM or ALM.
  • importConfigs (optional)
      Array/List
      Nested Choice of Objects
    • $class: 'ExportPackageAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ExportPackageConfig'
      • filePath
        • Type: String
      • exportPath
        • Type: String
      • createNewPath
        • Type: boolean
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ExportProjectAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ExportProjectConfig'
      • filePath
        • Type: String
      • exportPath
        • Type: String
      • createNewPath
        • Type: boolean
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportPackageAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportPackageConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportPackageDirConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportProjectArchiveConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • importConfigPath
        • Type: String
      • replaceFiles
        • Type: boolean
    • $class: 'ImportProjectAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportProjectConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • importMissingPackages
        • Type: boolean
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportProjectDirConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String

importProjects: [TT] Import Projects

Imports ECU-TEST projects and their attributes from an archive or a test management system like RQM or ALM.
  • importConfigs (optional)
      Array/List
      Nested Choice of Objects
    • $class: 'ExportPackageAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ExportPackageConfig'
      • filePath
        • Type: String
      • exportPath
        • Type: String
      • createNewPath
        • Type: boolean
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ExportProjectAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ExportProjectConfig'
      • filePath
        • Type: String
      • exportPath
        • Type: String
      • createNewPath
        • Type: boolean
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportPackageAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportPackageConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportPackageDirConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportProjectArchiveConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • importConfigPath
        • Type: String
      • replaceFiles
        • Type: boolean
    • $class: 'ImportProjectAttributeConfig'
      • filePath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportProjectConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • importMissingPackages
        • Type: boolean
      • credentialsId
        • Type: String
      • timeout
        • Type: String
    • $class: 'ImportProjectDirConfig'
      • tmsPath
        • Type: String
      • importPath
        • Type: String
      • credentialsId
        • Type: String
      • timeout
        • Type: String

publishUNIT: [TT] Publish UNIT Reports

Publishes the UNIT reports of all configured ECU-TEST packages or projects in this job.
These UNIT reports are generated automatically in this post-build step.
  • toolName
    • Type: String
  • allowMissing (optional)
    • Type: boolean
  • archiving (optional)
    • Type: boolean
  • failedThreshold (optional)
    • Type: double
  • keepAll (optional)
    • Type: boolean
  • runOnFailed (optional)
    • Type: boolean
  • unstableThreshold (optional)
    • Type: double

publishGenerators: [TT] Publish Generator Reports

Publishes and generates reports by configuration of predefined and/or custom report generators.
These reports will be generated for all configured ECU-TEST packages or projects in this job.
  • toolName
    • Type: String
  • allowMissing (optional)
    • Type: boolean
  • archiving (optional)
    • Type: boolean
  • customGenerators (optional)
      Array/List
      Nested Object
    • name
      • Type: String
    • settings
        Array/List
        Nested Object
      • name
        • Type: String
      • value
        • Type: String
  • generators (optional)
      Array/List
      Nested Object
    • name
      • Type: String
    • settings
        Array/List
        Nested Object
      • name
        • Type: String
      • value
        • Type: String
  • keepAll (optional)
    • Type: boolean
  • runOnFailed (optional)
    • Type: boolean

startET: [TT] Start ECU-TEST

Configure and start a preconfigured ECU-TEST installation.
  • toolName
    • Type: String
  • debugMode (optional)
    • Type: boolean
  • keepInstance (optional)
    • Type: boolean
  • settingsDir (optional)
    • Type: String
  • timeout (optional)
    • Type: String
  • workspaceDir (optional)
    • Type: String

startTS: [TT] Start Tool-Server

Configure and start Tool-Server.
  • toolName
    • Type: String
  • keepInstance (optional)
    • Type: boolean
  • tcpPort (optional)
    • Type: String
  • timeout (optional)
    • Type: String
  • toolLibsIni (optional)
    • Type: String

stopET: [TT] Stop ECU-TEST

Shutdown ECU-TEST.
  • toolName
    • Type: String
  • timeout (optional)
    • Type: String

stopTS: [TT] Stop Tool-Server

Shutdown Tool-Server.
  • toolName
    • Type: String
  • timeout (optional)
    • Type: String

publishTMS: [TT] Publish to Test Management System

Publishes the test results of all configured ECU-TEST packages or projects in this job to a preconfigured test management system like RQM or ALM.
  • toolName
    • Type: String
  • credentialsId
    • Type: String
  • allowMissing (optional)
    • Type: boolean
  • archiving (optional)
    • Type: boolean
  • keepAll (optional)
    • Type: boolean
  • runOnFailed (optional)
    • Type: boolean
  • timeout (optional)
    • Type: String

publishTRF: [TT] Publish TRF Reports

Publishes the TRF reports of all configured ECU-TEST packages or projects in this job.
  • allowMissing (optional)
    • Type: boolean
  • archiving (optional)
    • Type: boolean
  • keepAll (optional)
    • Type: boolean
  • runOnFailed (optional)
    • Type: boolean

testFolder: [TT] Run Test Folder

Execute a test folder.
  • testFile
    • Type: String
  • executionConfig (optional)
      Nested Object
    • timeout
      • Type: String
    • stopOnError
      • Type: boolean
    • checkTestFile
      • Type: boolean
  • packageConfig (optional)
      Nested Object
    • runTest
      • Type: boolean
    • runTraceAnalysis
      • Type: boolean
    • parameters
      Definition of ECU-TEST package parameters consisting of a unique name and a value.
      Numeric value entries will be automatically converted to Numeric type in ECU-TEST.
      For now only Numeric and String types are supported.
        Array/List
        Nested Object
      • name
        • Type: String
      • value
        • Type: String
  • projectConfig (optional)
      Nested Object
    • execInCurrentPkgDir
      • Type: boolean
    • filterExpression
      • Type: String
    • jobExecMode
      • Values: NO_EXECUTION, SEQUENTIAL_EXECUTION, PARALLEL_EXECUTION, SEPARATE_SEQUENTIAL_EXECUTION, SEPARATE_PARALLEL_EXECUTION, NO_TESTCASE_EXECUTION
  • recursiveScan (optional)
    • Type: boolean
  • scanMode (optional)
    • Values: PACKAGES_ONLY, PROJECTS_ONLY, PACKAGES_AND_PROJECTS
  • testConfig (optional)
      Nested Object
    • tbcFile
      • Type: String
    • tcfFile
      • Type: String
    • forceReload
      • Type: boolean
    • loadOnly
      • Type: boolean
    • keepConfig
      • Type: boolean
    • constants
      Definition of global constants consisting of an unique name and a value. Numeric value entries will be automatically converted to a Python integer literal, or to a Python string literal.
      If the global constant does not exist it is created and saved in the current test configuration. This requires always a configuration reload independent of other settings.
        Array/List
        Nested Object
      • name
        • Type: String
      • value
        • Type: String

testPackage: [TT] Run Package

Execute a ECU-TEST package.
  • testFile
    • Type: String
  • executionConfig (optional)
      Nested Object
    • timeout
      • Type: String
    • stopOnError
      • Type: boolean
    • checkTestFile
      • Type: boolean
  • packageConfig (optional)
      Nested Object
    • runTest
      • Type: boolean
    • runTraceAnalysis
      • Type: boolean
    • parameters
      Definition of ECU-TEST package parameters consisting of a unique name and a value.
      Numeric value entries will be automatically converted to Numeric type in ECU-TEST.
      For now only Numeric and String types are supported.
        Array/List
        Nested Object
      • name
        • Type: String
      • value
        • Type: String
  • testConfig (optional)
      Nested Object
    • tbcFile
      • Type: String
    • tcfFile
      • Type: String
    • forceReload
      • Type: boolean
    • loadOnly
      • Type: boolean
    • keepConfig
      • Type: boolean
    • constants
      Definition of global constants consisting of an unique name and a value. Numeric value entries will be automatically converted to a Python integer literal, or to a Python string literal.
      If the global constant does not exist it is created and saved in the current test configuration. This requires always a configuration reload independent of other settings.
        Array/List
        Nested Object
      • name
        • Type: String
      • value
        • Type: String

testProject: [TT] Run Project

Execute a ECU-TEST project.
  • testFile
    • Type: String
  • executionConfig (optional)
      Nested Object
    • timeout
      • Type: String
    • stopOnError
      • Type: boolean
    • checkTestFile
      • Type: boolean
  • projectConfig (optional)
      Nested Object
    • execInCurrentPkgDir
      • Type: boolean
    • filterExpression
      • Type: String
    • jobExecMode
      • Values: NO_EXECUTION, SEQUENTIAL_EXECUTION, PARALLEL_EXECUTION, SEPARATE_SEQUENTIAL_EXECUTION, SEPARATE_PARALLEL_EXECUTION, NO_TESTCASE_EXECUTION
  • testConfig (optional)
      Nested Object
    • tbcFile
      • Type: String
    • tcfFile
      • Type: String
    • forceReload
      • Type: boolean
    • loadOnly
      • Type: boolean
    • keepConfig
      • Type: boolean
    • constants
      Definition of global constants consisting of an unique name and a value. Numeric value entries will be automatically converted to a Python integer literal, or to a Python string literal.
      If the global constant does not exist it is created and saved in the current test configuration. This requires always a configuration reload independent of other settings.
        Array/List
        Nested Object
      • name
        • Type: String
      • value
        • Type: String

publishTraceAnalysis: [TT] Publish Trace Analysis

Publishes the results of the trace analysis of all configured ECU-TEST packages or projects in this job.
  • toolName
    • Type: String
  • allowMissing (optional)
    • Type: boolean
  • archiving (optional)
    • Type: boolean
  • createReportDir (optional)
    • Type: boolean
  • keepAll (optional)
    • Type: boolean
  • mergeReports (optional)
    • Type: boolean
  • runOnFailed (optional)
    • Type: boolean
  • timeout (optional)
    • Type: String

getATXServer: Get TEST-GUIDE installation by name

Gets a TEST-GUIDE server instance by name which must be present in the TEST-GUIDE installations.

Signature:
ATX.getServer(String atxName) : ATXServer

Examples:
ATX.getServer('TEST-GUIDE')
or
ATX.getServer atxName: 'TEST-GUIDE'
  • atxName
    • Type: String

newATXServer: Return new TEST-GUIDE installation

Creates a new dynamic TEST-GUIDE server instance which is only accessible during pipeline execution.

Signatures:
ATX.newServer(String atxName, StringtoolName) : ATXServer
or
ATX.newServer(String atxName, String toolName, ATXConfig config) : ATXServer
or
ATX.newServer(String atxName, String toolName, String serverUrl, boolean uploadToServer, String authKey, String projectId) : ATXServer

Examples:
ATX.newServer('TEST-GUIDE', 'ECU-TEST')
defaults to:
ATX.newServer('TEST-GUIDE', 'ECU-TEST', 'http://localhost:8085', false, '', '1')
or
ATX.newServer atxName: 'TEST-GUIDE', toolName: 'ECU-TEST', serverUrl: 'http://localhost:8085', uploadToServer: false, authKey: '', projectId: '1'
  • atxName
    • Type: String
  • toolName
    • Type: String
  • config
      de.tracetronic.jenkins.plugins.ecutest.report.atx.installation.ATXConfig

publishATXReports: Publish ATX reports

Publishes ATX reports to TEST-GUIDE according to given server settings.

Signatures:
publishATXReports(ATXInstallation installation, boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
or
ATXServer.publish(boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void

Examples:
publishATXReports(atx.installation, false, false, true, true)
or:
ATXServer atx = ATX.newServer('TEST-GUIDE', 'ECU-TEST')
atx.publish()
  • installation
      Nested Object
    • name
      • Type: String
    • toolName
      • Type: String
    • config
        de.tracetronic.jenkins.plugins.ecutest.report.atx.installation.ATXConfig
  • allowMissing
    • Type: boolean
  • runOnFailed
    • Type: boolean
  • archiving
    • Type: boolean
  • keepAll
    • Type: boolean

Was this page helpful?

Please submit your feedback about this page through this quick form.

Alternatively, if you don't wish to complete the quick form, you can simply indicate if you found this page helpful?

    


See existing feedback here.