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

Interface ComTestExecutionInfo

All Known Implementing Classes:

TestExecutionInfo

public interface ComTestExecutionInfo

Represents the ecu.test specific COMTestExecutionInfo API.

Method Summary

Modifier and Type	Method	Description
boolean	abort()	Aborts the current test execution.
boolean	abortAfterCurrentProjectStep(int timeout)	Aborts the current project test execution but waits for report generation.
String	getLogFolder()	Folder where trace and log files of the currently executed package are stored.
String	getReportDb()	Queries the path to report database of current (or most recent) test run.
String	getResult()	Returns the result of the project execution or package execution, depending on which method ( TestEnvironment.executeProject(String path) or TestEnvironment.executePackage(String path)) has called before.
String	getReturnValue(String varName)	Returns the final value of a package variable.
String	getState()	Returns the state of the current test execution.

Method Detail

abort

boolean abort()
       throws ETComException

Aborts the current test execution.

Returns:

true if the abortion succeeded, false, if the test execution has already finished or aborted

Throws:

ETComException - in case of a COM exception

abortAfterCurrentProjectStep

boolean abortAfterCurrentProjectStep(int timeout)
                              throws ETComException

Aborts the current project test execution but waits for report generation.

Parameters:

timeout - the timeout in seconds to wait for aborting the current step

Returns:

true if the abortion succeeded, false, if the test execution has already finished or aborted

Throws:

ETComException - in case of a COM exception

getReportDb

String getReportDb()
            throws ETComException

Queries the path to report database of current (or most recent) test run.

Returns:

the path to report database

Throws:

ETComException - in case of a COM exception

getLogFolder

String getLogFolder()
             throws ETComException

Folder where trace and log files of the currently executed package are stored. If there is no test execution in progress the log folder of the most recent package run is returned. Please note, each package run has got a separate log folder.

Returns:

the log folder

Throws:

ETComException - in case of a COM exception or when using this method on project executions

getResult

String getResult()
          throws ETComException

Returns the result of the project execution or package execution, depending on which method ( TestEnvironment.executeProject(String path) or TestEnvironment.executePackage(String path)) has called before. If the test execution has not finished yet, the result equates the test result at calling time.

Returns:

the current overall test result. One of:

1. NONE
2. SUCCESS
3. FAILED
4. ERROR

Throws:

ETComException - in case of a COM exception

getState

String getState()
         throws ETComException

Returns the state of the current test execution.

Returns:

the state current test execution. One of:

1. IDLE
2. RUNNING
3. ABORTED
4. FINISHED

Throws:

ETComException - in case of a COM exception

getReturnValue

String getReturnValue(String varName)
               throws ETComException

Returns the final value of a package variable.

Parameters:

varName - the variable name

Returns:

the final variable value

Throws:

ETComException - in case of a COM exception