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.

Pipeline usage
Signatures:
publishATX(String atxName, boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
            
publishATX(ATXInstallation installation, boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
            
ATXServer.publish(boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
            
Examples:
publishATX('TEST-GUIDE', false, false, true, true)
            
def server = ATX.server('TEST-GUIDE')
publishATX atxInstallation: server.installation
            
def server = ATX.newServer('TEST-GUIDE', 'ECU-TEST')
atx.publish()
            
  • atxName
    • Type: String
  • allowMissing (optional)
    • Type: boolean
  • archiving (optional)
    • Type: boolean
  • atxInstallation (optional)
      Nested Object
    • name
      • Type: String
    • toolName
      • Type: String
    • config
        Nested Object
      • settings
          Array/List
          Nested Choice of Objects
        • atxBooleanSetting
          • name
            • Type: String
          • group
            • Values: UPLOAD, ARCHIVE, ATTRIBUTE, TBC_CONSTANTS, TCF_CONSTANTS, SPECIAL
          • value
            • Type: boolean
        • atxTextSetting
          • name
            • Type: String
          • group
            • Values: UPLOAD, ARCHIVE, ATTRIBUTE, TBC_CONSTANTS, TCF_CONSTANTS, SPECIAL
          • value
            • Type: String
      • customSettings
          Array/List
          Nested Choice of Objects
        • atxCustomBooleanSetting
          • name
            • Type: String
          • checked
            • Type: boolean
        • atxCustomTextSetting
          • name
            • Type: String
          • value
            • Type: String
  • keepAll (optional)
    • Type: boolean
  • runOnFailed (optional)
    • Type: boolean

generateCache: [TT] Generate Caches

Generate ECU-TEST file caches (A2L, ELF, Bus, Model and Service caches are supported).
  • caches
      Array/List
      Nested Object
    • type
      • Values: A2L, ELF, BUS, MODEL, SERVICE
    • filePath
      • Type: String
    • dbChannel
      • Type: String
    • clear
      • 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.

      Pipeline usage
      Signatures:
      publishATX(String atxName, boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
                  
      publishATX(ATXInstallation installation, boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
                  
      ATXServer.publish(boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
                  
      Examples:
      publishATX('TEST-GUIDE', false, false, true, true)
                  
      def server = ATX.server('TEST-GUIDE')
      publishATX atxInstallation: server.installation
                  
      def server = ATX.newServer('TEST-GUIDE', 'ECU-TEST')
      atx.publish()
                  
      • atxName
        • Type: String
      • allowMissing (optional)
        • Type: boolean
      • archiving (optional)
        • Type: boolean
      • atxInstallation (optional)
          Nested Object
        • name
          • Type: String
        • toolName
          • Type: String
        • config
            Nested Object
          • settings
              Array/List
              Nested Choice of Objects
            • atxBooleanSetting
              • name
                • Type: String
              • group
                • Values: UPLOAD, ARCHIVE, ATTRIBUTE, TBC_CONSTANTS, TCF_CONSTANTS, SPECIAL
              • value
                • Type: boolean
            • atxTextSetting
              • name
                • Type: String
              • group
                • Values: UPLOAD, ARCHIVE, ATTRIBUTE, TBC_CONSTANTS, TCF_CONSTANTS, SPECIAL
              • value
                • Type: String
          • customSettings
              Array/List
              Nested Choice of Objects
            • atxCustomBooleanSetting
              • name
                • Type: String
              • checked
                • Type: boolean
            • atxCustomTextSetting
              • name
                • Type: String
              • value
                • Type: String
      • 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.

      Pipeline usage
      Signatures:
      publishUNIT(String toolName, double unstableThreshold, double failedThreshold) : void
                  
      publishUNIT(ETInstallation installation, double unstableThreshold, double failedThreshold, boolean archiving, boolean keepAll) : void
                  
      ETInstance.publishUNIT(double unstableThreshold, double failedThreshold, boolean archiving, boolean keepAll) : void
                  
      Examples:
      publishUNIT('ECU-TEST', 10, 20)
                  
      def instance = ET.installation('ECU-TEST')
      publishUNIT installation: instance.installation, unstableThreshold: 10, failedThreshold: 20
                  
      def instance = ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0')
      instance.publishUNIT()
                  
      • toolName
        • Type: String
      • allowMissing (optional)
        • Type: boolean
      • archiving (optional)
        • Type: boolean
      • failedThreshold (optional)
        • Type: double
      • installation (optional)
          Nested Object
        • name
          • Type: String
        • home
          • Type: String
        • properties
            Array/List
            hudson.tools.ToolProperty
      • 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.

      Pipeline usage
      Signatures:
      publishGenerators(String toolName, List<ReportGeneratorConfig> generators, List<ReportGeneratorConfig> customGenerators) : void
                  
      publishGenerators(ETInstallation installation, List<ReportGeneratorConfig> generators, List<ReportGeneratorConfig> customGenerators,
                        boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
                  
      ETInstance.publishGenerators(List<ReportGeneratorConfig> generators, List<ReportGeneratorConfig> customGenerators,
                                   boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
                  
      Examples:
      publishGenerators toolName: 'ECU-TEST', generators: [[name: 'JSON']]
                  
      def instance = ET.installation('ECU-TEST')
      publishGenerators installation: instance.installation, generators: [[name: 'JSON']]
                  
      def instance = ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0')
      instance.publishGenerators([[name: 'JSON']], [name: 'Custom-JSON')])
                  
      • 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
        • usePersistedSettings
          • Type: boolean
      • generators (optional)
          Array/List
          Nested Object
        • name
          • Type: String
        • settings
            Array/List
            Nested Object
          • name
            • Type: String
          • value
            • Type: String
        • usePersistedSettings
          • Type: boolean
      • installation (optional)
          Nested Object
        • name
          • Type: String
        • home
          • Type: String
        • properties
            Array/List
            hudson.tools.ToolProperty
      • 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.

      Pipeline usage
      Signatures:
      publishTMS(String toolName, String credentialsId, int timeout) : void
                  
      publishTMS(ETInstallation installation, String credentialsId, int timeout,
                 boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
                  
      ETInstance.publishTMS(String credentialsId, int timeout) : void
                  
      Examples:
      publishTMS('ECU-TEST')
                  
      def instance = ET.installation('ECU-TEST')
      publishTMS installation: instance.installation, credentialsId: 'id', timeout: 120
                  
      def instance = ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0')
      instance.publishTMS('id')
                  
      • toolName
        • Type: String
      • credentialsId
        • Type: String
      • allowMissing (optional)
        • Type: boolean
      • archiving (optional)
        • Type: boolean
      • installation (optional)
          Nested Object
        • name
          • Type: String
        • home
          • Type: String
        • properties
            Array/List
            hudson.tools.ToolProperty
      • 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.

      Pipeline usage
      Signatures:
      publishTraceAnalysis(String toolName, boolean mergeReports, boolean createReportDir, int timeout) : void
                  
      publishTraceAnalysis(ETInstallation installation, boolean mergeReports, boolean createReportDir, int timeout,
                           boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
                  
      ETInstance.publishTraceAnalysis(boolean mergeReports, boolean createReportDir, int timeout) : void
                  
      Examples:
      publishTraceAnalysis('ECU-TEST')
                  
      def instance = ET.installation('ECU-TEST')
      publishTraceAnalysis installation: instance.installation, mergeReports: true, createReportDir: false
                  
      def instance = ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0')
      instance.publishTraceAnalysis()
                  
      • toolName
        • Type: String
      • allowMissing (optional)
        • Type: boolean
      • archiving (optional)
        • Type: boolean
      • createReportDir (optional)
        • Type: boolean
      • installation (optional)
          Nested Object
        • name
          • Type: String
        • home
          • Type: String
        • properties
            Array/List
            hudson.tools.ToolProperty
      • 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.

Pipeline usage
Signatures:
publishUNIT(String toolName, double unstableThreshold, double failedThreshold) : void
            
publishUNIT(ETInstallation installation, double unstableThreshold, double failedThreshold, boolean archiving, boolean keepAll) : void
            
ETInstance.publishUNIT(double unstableThreshold, double failedThreshold, boolean archiving, boolean keepAll) : void
            
Examples:
publishUNIT('ECU-TEST', 10, 20)
            
def instance = ET.installation('ECU-TEST')
publishUNIT installation: instance.installation, unstableThreshold: 10, failedThreshold: 20
            
def instance = ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0')
instance.publishUNIT()
            
  • toolName
    • Type: String
  • allowMissing (optional)
    • Type: boolean
  • archiving (optional)
    • Type: boolean
  • failedThreshold (optional)
    • Type: double
  • installation (optional)
      Nested Object
    • name
      • Type: String
    • home
      • Type: String
    • properties
        Array/List
        hudson.tools.ToolProperty
  • 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.

Pipeline usage
Signatures:
publishGenerators(String toolName, List<ReportGeneratorConfig> generators, List<ReportGeneratorConfig> customGenerators) : void
            
publishGenerators(ETInstallation installation, List<ReportGeneratorConfig> generators, List<ReportGeneratorConfig> customGenerators,
                  boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
            
ETInstance.publishGenerators(List<ReportGeneratorConfig> generators, List<ReportGeneratorConfig> customGenerators,
                             boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
            
Examples:
publishGenerators toolName: 'ECU-TEST', generators: [[name: 'JSON']]
            
def instance = ET.installation('ECU-TEST')
publishGenerators installation: instance.installation, generators: [[name: 'JSON']]
            
def instance = ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0')
instance.publishGenerators([[name: 'JSON']], [name: 'Custom-JSON')])
            
  • 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
    • usePersistedSettings
      • Type: boolean
  • generators (optional)
      Array/List
      Nested Object
    • name
      • Type: String
    • settings
        Array/List
        Nested Object
      • name
        • Type: String
      • value
        • Type: String
    • usePersistedSettings
      • Type: boolean
  • installation (optional)
      Nested Object
    • name
      • Type: String
    • home
      • Type: String
    • properties
        Array/List
        hudson.tools.ToolProperty
  • keepAll (optional)
    • Type: boolean
  • runOnFailed (optional)
    • Type: boolean

startET: [TT] Start ECU-TEST

Configure and start a preconfigured ECU-TEST installation.

Pipeline usage
Signatures:
startET(String toolName) : void
            
startET(String toolName, String workspaceDir, String settingsDir, int timeout,
        boolean debug, boolean keepInstance, boolean updateUserLibs) : void
            
ETInstance.start(String toolName) : void
            
ETInstance.start(String toolName, String workspaceDir, String settingsDir, int timeout,
         boolean debug, boolean keepInstance, boolean updateUserLibs) : void
            
Examples:
startET('ECU-TEST')
            
def instance = ET.installation('ECU-TEST')
startET installation: instance.installation, workspaceDir: 'C:\\Data'
            
def instance = ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0')
instance.start()
            
  • toolName
    • Type: String
  • debugMode (optional)
    • Type: boolean
  • installation (optional)
      Nested Object
    • name
      • Type: String
    • home
      • Type: String
    • properties
        Array/List
        hudson.tools.ToolProperty
  • keepInstance (optional)
    • Type: boolean
  • settingsDir (optional)
    • Type: String
  • timeout (optional)
    • Type: String
  • updateUserLibs (optional)
    • Type: boolean
  • workspaceDir (optional)
    • Type: String

startTS: [TT] Start Tool-Server

Configure and start Tool-Server.

Pipeline usage
Signatures:
startTS(String toolName) : void
            
startTS(String toolName, String toolLibsIniPath, int tcpPort, int timeout, boolean keepInstance) : void
            
ETInstance.startTS(String toolName) : void
            
ETInstance.startTS(String toolName, String toolLibsIniPath, int tcpPort, int timeout, boolean keepInstance) : void
            
Examples:
startTS('ECU-TEST')
            
def instance = ET.installation('ECU-TEST')
startTS installation: instance.installation
            
def instance = ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0')
instance.startTS()
            
  • toolName
    • Type: String
  • installation (optional)
      Nested Object
    • name
      • Type: String
    • home
      • Type: String
    • properties
        Array/List
        hudson.tools.ToolProperty
  • keepInstance (optional)
    • Type: boolean
  • tcpPort (optional)
    • Type: String
  • timeout (optional)
    • Type: String
  • toolLibsIni (optional)
    • Type: String

stopET: [TT] Stop ECU-TEST

Shutdown ECU-TEST.

Pipelines usage:
Signatures:
stopET(String toolName) : void
            
stopET(String toolName, int timeout) : void
            
ETInstance.stop(String toolName) : void
            
ETInstance.stop(String toolName, int timeout) : void
            
Examples:
stopET('ECU-TEST')
            
def instance = ET.installation('ECU-TEST')
stopET installation: instance.installation
            
def instance = ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0')
instance.stop()
            
  • toolName
    • Type: String
  • installation (optional)
      Nested Object
    • name
      • Type: String
    • home
      • Type: String
    • properties
        Array/List
        hudson.tools.ToolProperty
  • timeout (optional)
    • Type: String

stopTS: [TT] Stop Tool-Server

Shutdown Tool-Server.

Pipelines usage:
Signatures:
stopTS(String toolName) : void
            
stopTS(String toolName, int timeout) : void
            
ETInstance.stopTS(String toolName) : void
            
ETInstance.stopTS(String toolName, int timeout) : void
            
Examples:
stopTS('ECU-TEST')
            
def instance = ET.installation('ECU-TEST')
stopTS installation: instance.installation
            
def instance = ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0')
instance.stopTS()
            
  • toolName
    • Type: String
  • installation (optional)
      Nested Object
    • name
      • Type: String
    • home
      • Type: String
    • properties
        Array/List
        hudson.tools.ToolProperty
  • 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.

Pipeline usage
Signatures:
publishTMS(String toolName, String credentialsId, int timeout) : void
            
publishTMS(ETInstallation installation, String credentialsId, int timeout,
           boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
            
ETInstance.publishTMS(String credentialsId, int timeout) : void
            
Examples:
publishTMS('ECU-TEST')
            
def instance = ET.installation('ECU-TEST')
publishTMS installation: instance.installation, credentialsId: 'id', timeout: 120
            
def instance = ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0')
instance.publishTMS('id')
            
  • toolName
    • Type: String
  • credentialsId
    • Type: String
  • allowMissing (optional)
    • Type: boolean
  • archiving (optional)
    • Type: boolean
  • installation (optional)
      Nested Object
    • name
      • Type: String
    • home
      • Type: String
    • properties
        Array/List
        hudson.tools.ToolProperty
  • 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.

Pipeline usage
Signatures:
publishTraceAnalysis(String toolName, boolean mergeReports, boolean createReportDir, int timeout) : void
            
publishTraceAnalysis(ETInstallation installation, boolean mergeReports, boolean createReportDir, int timeout,
                     boolean allowMissing, boolean runOnFailed, boolean archiving, boolean keepAll) : void
            
ETInstance.publishTraceAnalysis(boolean mergeReports, boolean createReportDir, int timeout) : void
            
Examples:
publishTraceAnalysis('ECU-TEST')
            
def instance = ET.installation('ECU-TEST')
publishTraceAnalysis installation: instance.installation, mergeReports: true, createReportDir: false
            
def instance = ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0')
instance.publishTraceAnalysis()
            
  • toolName
    • Type: String
  • allowMissing (optional)
    • Type: boolean
  • archiving (optional)
    • Type: boolean
  • createReportDir (optional)
    • Type: boolean
  • installation (optional)
      Nested Object
    • name
      • Type: String
    • home
      • Type: String
    • properties
        Array/List
        hudson.tools.ToolProperty
  • keepAll (optional)
    • Type: boolean
  • mergeReports (optional)
    • Type: boolean
  • runOnFailed (optional)
    • Type: boolean
  • timeout (optional)
    • Type: String

getATXServer: Get TEST-GUIDE server by name

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

Signatures:
ATX.server(String atxName) : ATXServer
            
Examples:
ATX.server('TEST-GUIDE')
            
ATX.server atxName: 'TEST-GUIDE'
            
  • atxName
    • Type: String

getETInstallation: Get ECU-TEST installation by name

Gets an ECU-TEST installation instance by name which must be present in Jenkins global tool configuration.

Signatures:
ET.installation(String toolName) : ETInstance
            
Examples:
ET.installation('ECU-TEST')
            
ET.installation toolName: 'ECU-TEST'
            
  • toolName
    • Type: String

isConfigStarted: Check ECU-TEST configuration status

Checks whether the currently selected ECU-TEST configurations are started.

Signatures:
ETInstance.isConfigStarted() : boolean
            
Examples:
def instance = ET.installation('ECU-TEST')
boolean isConfigStarted = et.isConfigStarted()
            
  • toolName
    • Type: String

newATXServer: Return new TEST-GUIDE server

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

Signatures:
ATX.newServer(String atxName, String toolName) : ATXServer
            
ATX.newServer(String atxName, String toolName, String serverUrl, boolean uploadToServer, String authKey, String projectId) : ATXServer
            
Examples:
ATX.newServer('TEST-GUIDE', 'ECU-TEST')
            
ATX.newServer('TEST-GUIDE', 'ECU-TEST', 'http://localhost:8085', false, '', '1')
            
ATX.newServer atxName: 'TEST-GUIDE', toolName: 'ECU-TEST', serverUrl: 'http://localhost:8085', uploadToServer: false, authKey: '', projectId: '1'
            
  • atxName
    • Type: String
  • toolName
    • Type: String
  • config
      Nested Object
    • settings
        Array/List
        Nested Choice of Objects
      • atxBooleanSetting
        • name
          • Type: String
        • group
          • Values: UPLOAD, ARCHIVE, ATTRIBUTE, TBC_CONSTANTS, TCF_CONSTANTS, SPECIAL
        • value
          • Type: boolean
      • atxTextSetting
        • name
          • Type: String
        • group
          • Values: UPLOAD, ARCHIVE, ATTRIBUTE, TBC_CONSTANTS, TCF_CONSTANTS, SPECIAL
        • value
          • Type: String
    • customSettings
        Array/List
        Nested Choice of Objects
      • atxCustomBooleanSetting
        • name
          • Type: String
        • checked
          • Type: boolean
      • atxCustomTextSetting
        • name
          • Type: String
        • value
          • Type: String

newETInstallation: Return new ECU-TEST installation

Creates a new dynamic ECU-TEST installation instance which is only accessible during pipeline execution.

Signatures:
ET.newInstallation(String toolName, String installPath) : ETInstance
            
ET.newInstallation(String toolName, String installPath, String progId, int timeout) : ETInstance
            
Examples:
ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0')
            
ET.newInstallation('ECU-TEST', 'C:\\Program Files\\ECU-TEST 8.0', 'ECU-TEST.Application', 120)
            
ET.newInstallation toolName: 'ECU-TEST', installPath: 'C:\\Program Files\\ECU-TEST 8.0', progId: 'ECU-TEST.Application', timeout: 120
            
  • toolName
    • Type: String
  • installPath
    • Type: String
  • property
      Nested Object
    • progId
      • Type: String
    • timeout
      • Type: int

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.