Interface ComTestEnvironment

  • All Known Implementing Classes:
    TestEnvironment

    public interface ComTestEnvironment
    Represents the ecu.test specific COMTestEnvironment API.
    • Method Detail

      • 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