Package de.tracetronic.jenkins.plugins.ecutest.wrapper.com.api

Interface ComTestEnvironment

All Known Implementing Classes:
TestEnvironment
public interface ComTestEnvironment
Represents the ecu.test specific COMTestEnvironment API.

  • Method Details

    • getTestExecutionInfo

      ComTestExecutionInfo getTestExecutionInfo() throws ETComException
      Gets the current test execution info.
      Returns:
      the ComTestExecutionInfo dispatch
      Throws:
      ETComException - in case of a COM exception

    • executePackage

      ComTestExecutionInfo executePackage(String path, boolean runTraceAnalysis, boolean runTest, Map<String,String> parameters) throws ETComException
      Starts the execution of the specified package file. The package must be already opened with ComApplication.openPackage(java.lang.String). If it is not opened a call of this function will raise an error.
      Parameters:
      path - the full path name of the package file to execute
      runTraceAnalysis - specifies whether the trace analysis should be executed
      runTest - specifies whether the test should be executed
      parameters - the package parameters to populate as test variables for the test and the trace analysis
      Returns:
      the ComTestExecutionInfo dispatch
      Throws:
      ETComException - if the package was not opened before or the format of the parameter values is wrong

    • executeProject

      ComTestExecutionInfo executeProject(String path, boolean closeProgressDialog, int jobExecutionMode) throws ETComException
      Starts the execution of the specified project file. The project must be already opened with ComApplication.openProject(java.lang.String, boolean, java.lang.String). If it is not opened a call of this function will raise an error.
      Parameters:
      path - the full path name of the project file
      closeProgressDialog - determines whether the progress dialog will be closed when finished
      jobExecutionMode - specifies whether and how the analysis jobs should be executed: 
                                                             0 .. no job execution
                                                       1 .. sequential job execution (default)
                                                       2 .. parallel job execution
                                                       5 .. sequential job execution with separate test report
                                                       6 .. parallel job execution with separate test report
      Returns:
      the ComTestExecutionInfo dispatch
      Throws:
      ETComException - if the project was not opened before

    • generateTestReportDocumentFromDB

      boolean generateTestReportDocumentFromDB(String dbFile, String reportDir, String reportFormat, boolean waitUntilFinished, Map<String,String> parameters) throws ETComException
      Generates a handler based test report on the file system.
      Parameters:
      dbFile - the full path name of the data base file
      reportDir - the full path name of output directory
      reportFormat - the name of the report format or handler which should be used
      waitUntilFinished - defines whether the API call should block until generation is finished
      parameters - the configuration parameters
      Returns:
      true if successful, false otherwise
      Throws:
      ETComException - in case of a COM exception or invalid parameters

    • generateTestReportDocument

      boolean generateTestReportDocument(String dbFile, String reportDir, String reportConfig, boolean waitUntilFinished) throws ETComException
      Generates a handler based test report on the file system.
      Parameters:
      dbFile - the full path name of the data base file
      reportDir - the full path name of output directory
      reportConfig - the full path to persisted report generator settings file (XML)
      waitUntilFinished - defines whether the API call should block until generation is finished
      Returns:
      true if successful, false otherwise
      Throws:
      ETComException - in case of a COM exception or invalid parameters