|
IBM Rational Functional Tester Version 8.1.1000 IBM Rational Functional Tester API Reference Project Version 2.3 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface ILog
The log interface containing all log methods used by script playback.
Field Summary | |
---|---|
static java.lang.String |
PROP_ACTUAL
The property name to describe the actual data captured with a verification point. |
static java.lang.String |
PROP_ADDITIONAL_INFO
The property name to describe a additional information. |
static java.lang.String |
PROP_APPLICATION
The property name to describe an application name. |
static java.lang.String |
PROP_BASELINE
The property name to describe the baseline data captured with a verification point. |
static java.lang.String |
PROP_BUFFERED_SNAPSHOT
The property name that contains the value of the BufferedImage. |
static java.lang.String |
PROP_DATAPOOL_STORE
Property to encapsulate datapool changes |
static java.lang.String |
PROP_ELAPSED_TIME
The property name to describe a elapsed time. |
static java.lang.String |
PROP_EXCEPTION_CONTEXT
The property name to describe an exception context. |
static java.lang.String |
PROP_EXCEPTION_MESSAGE
The property name to describe an exception message. |
static java.lang.String |
PROP_EXCEPTION_NAME
The property name to describe the name of an exception. |
static java.lang.String |
PROP_EXCEPTION_STACK
The property name to describe an exception stack. |
static java.lang.String |
PROP_EXPECTED
The property name to describe the expected data captured with a verification point. |
static java.lang.String |
PROP_FAILURE_DESCRIPTION
The property name for additional text describing a warning/failure. |
static java.lang.String |
PROP_ITERATION_COUNT
Property to set for the current script iteration count |
static java.lang.String |
PROP_LINENUMBER
The property name to describe the line number in the script at which the error occured. |
static java.lang.String |
PROP_NAME
The property name to describe an object name. |
static java.lang.String |
PROP_SCREEN_SNAPSHOT
The property name to describe a screen snapshot. |
static java.lang.String |
PROP_SCRIPT_ID
|
static java.lang.String |
PROP_SCRIPT_NAME
The property name to describe a script name. |
static java.lang.String |
PROP_SCRIPT_SOURCE_UID
Properties that are for Rational TestManager and that are only emitted when doing TSS logging. |
static java.lang.String |
PROP_SIMPLIFIEDSCRIPT_GRPNAME
The property name to describe the group name in the simplified script(visual script). |
static java.lang.String |
PROP_SIMPLIFIEDSCRIPT_LINE
The property name to describe the line of script in simplified script (visual script). |
static java.lang.String |
PROP_SIMPLIFIEDSCRIPT_LINENUMBER
The property name to describe the line number in the simplified script(visual script). |
static java.lang.String |
PROP_TESTCASE_DESCRIPTION
The property name to describe a test case description. |
static java.lang.String |
PROP_TESTCASE_NAME
The property name to describe a test case name. |
static java.lang.String |
PROP_USER_SCREEN_SNAPSHOT
The property name to describe a screen snapshot taken by a user (via logError, etc). |
static java.lang.String |
PROP_VP_TYPE
The property name to describe a verification point type, for example, an object property. |
static java.lang.String |
SCREEN_SNAPSHOT_FILE_BASE
|
static java.lang.String |
SCREEN_SNAPSHOT_FILE_EXT
The snapshot file extension. |
static java.lang.String |
SCREEN_SNAPSHOT_FILE_NAME
The file name of the snapshot taken at script failure |
static java.lang.String |
USER_SCREEN_SNAPSHOT_FILE_BASE
The base file name (minus number) of snapshots logged by the user |
static java.lang.String |
VP_TYPE_ALPHA_NUM
The property value to describe an alphanumeric verification point. |
static java.lang.String |
VP_TYPE_CLIPBOARD
The property value to describe a clipboard verification point. |
static java.lang.String |
VP_TYPE_FILE_COMPARE
The property value to describe a file-compare verification point. |
static java.lang.String |
VP_TYPE_FILE_EXIST
The property value to describe a file-exist verification point. |
static java.lang.String |
VP_TYPE_FULL_IMAGE
The property value to describe a full image verification point |
static java.lang.String |
VP_TYPE_MENU
The property value to describe a menu verification point. |
static java.lang.String |
VP_TYPE_MODULE_EXIST
The property value to describe a module existence verification point |
static java.lang.String |
VP_TYPE_OBJECT_DATA
The property value to describe an object data verification point |
static java.lang.String |
VP_TYPE_OBJECT_PROP
The property value to describe an object property verification point |
static java.lang.String |
VP_TYPE_OCR_IMAGE
The property value to describe a region image verification point |
static java.lang.String |
VP_TYPE_REGION_IMAGE
The property value to describe a region image verification point |
static java.lang.String |
VP_TYPE_WEBSITE_COMPARE
The property value to describe a website compare verification point |
static java.lang.String |
VP_TYPE_WEBSITE_SCAN
The property value to describe a website scan verification point |
static java.lang.String |
VP_TYPE_WINDOW_EXIST
The property value to describe a window existence verification point |
static java.lang.String |
VP_TYPE_WINDOW_IMAGE
The property value to describe a window image verification point |
Fields inherited from interface com.rational.test.ft.services.ISimpleLog |
---|
DISABLE_LOGGING, EVENT_APPLICATION_END, EVENT_APPLICATION_START, EVENT_APPLICATON_ACTION, EVENT_CALL_SCRIPT, EVENT_CONFIGURATION, EVENT_GENERAL, EVENT_SCRIPT_END, EVENT_SCRIPT_START, EVENT_TIMER_END, EVENT_TIMER_START, EVENT_VP, LOG_DISABLE_GUI_ACTION, LOG_ENABLE_GUI_ACTION, LOG_FAILURE, LOG_FAILURES, LOG_FAILURES_WARNINGS, LOG_FAILURES_WARNINGS_PASS, LOG_FAILURES_WARNINGS_PASS_INFO, LOG_INFORMATION, LOG_PASS, LOG_WARNING |
Method Summary | |
---|---|
void |
applicationStart(java.lang.String name, int status, java.lang.String description, java.lang.String language)
Writes an application-start message into the log. |
void |
applicationStart(java.lang.String name, java.lang.String language)
Writes an application-start message into the log. |
void |
callScript(java.lang.String name, java.lang.String language)
Writes a calling-script message into the log. |
void |
configuration(java.lang.String language)
Writes the system configuration into the log. |
ILogMessage |
createApplicationStartMessage(java.lang.String name, int status, java.lang.String description, java.lang.String language)
Returns an application-start message. |
ILogMessage |
createConfigurationMessage(java.lang.String language)
Creates a system configuration message. |
ILogMessage |
createGUIActionMessage(int resultCode, java.lang.String method, java.lang.String methodSignature, java.lang.Object[] args, java.lang.String testObjectRole, java.lang.String testObjectName)
Creates a GUI Action message. |
ILogMessage |
createTestResultMessage(java.lang.String headline, boolean passed, java.lang.String additionalInfo)
Creates a test result message. |
ILogMessage |
createTimerEndMessage(java.lang.String name, java.lang.String language)
Returns an end-timer message. |
ILogMessage |
createTimerStartMessage(java.lang.String name, java.lang.String language)
Returns a start-timer message. |
ILogMessage |
createVPMessage(int resultCode, java.lang.String type, java.lang.String name, java.lang.String language)
Returns a verification point message. |
void |
exception(java.lang.String note, java.lang.String context, java.lang.String throwableName, java.lang.String throwableMessage, java.lang.String scriptName, int line, java.lang.String stackTrace, java.lang.String language)
Writes an exception message. |
void |
exception(java.lang.String note, java.lang.String context, java.lang.String throwableName, java.lang.String throwableMessage, java.lang.String scriptName, int line, java.lang.String stackTrace, java.lang.String language, java.awt.image.BufferedImage screenSnapshot)
Writes an exception message that includes a screen snapshot. |
int |
getCurrentLogFilter()
Return the current log filter level. |
boolean |
getCurrentScriptResult()
Returns the result of the current script. |
boolean |
getLastScriptResult()
Returns the result of the last script that had ended. |
java.lang.String |
getLogDirectory()
Returns the directory to which the log is being written. |
java.lang.String |
getLogFilename()
Returns the name of the log filename including the file extension but no directory. |
java.lang.String |
getLogType()
Return the type for the log |
boolean |
getTestResult()
Returns the result of the current test. |
double |
getTimerAndEnd(java.lang.String name, java.lang.String language)
Writes an end-timer message into the log and returns the value of the timer |
double |
getTimerValue(java.lang.String name)
Writes a start-timer message into the log. |
void |
info(java.lang.String note)
Writes a simple text informational message into the log. |
boolean |
isLogGuiActionEnabled(java.lang.String methodName)
Returns true if Gui Actions are to be logged for the given method. |
void |
logRootException(java.lang.String scriptName, java.lang.String language, java.lang.String msg, java.lang.Throwable e, java.lang.String headline)
The method can be used if failures occur prior to start of execution of script. |
void |
scriptEnd(java.lang.String name, java.lang.String language)
Writes a script-end message into the log. |
void |
scriptStart(java.lang.String name, java.lang.String language)
Writes a script-start message into the log. |
void |
setCurrentLogFilter(int filterLevel)
Set the log filter for the playback. |
void |
setLogGUIAction(boolean logGuiAction)
Sets the option to log the GUI Action during playback |
void |
timerEnd(java.lang.String name, java.lang.String language)
Writes an end-timer message into the log. |
void |
timerStart(java.lang.String name, java.lang.String language)
Writes a start-timer message into the log. |
boolean |
viewerKnowsHowToBringUpComparator()
Answers yes or no to indicate whether the log viewer associated with this log knows how to bring up the comparator. |
void |
writeGUIAction(ILogMessage message)
Writes an Gui Action message in the log |
Methods inherited from interface com.rational.test.ft.services.ISimpleLog |
---|
close, createMessage, createMessage, open, openLogViewer, write, write |
Field Detail |
---|
static final java.lang.String PROP_VP_TYPE
static final java.lang.String PROP_ACTUAL
static final java.lang.String PROP_EXPECTED
static final java.lang.String PROP_BASELINE
static final java.lang.String PROP_APPLICATION
static final java.lang.String PROP_EXCEPTION_NAME
static final java.lang.String PROP_EXCEPTION_MESSAGE
static final java.lang.String PROP_EXCEPTION_STACK
static final java.lang.String PROP_EXCEPTION_CONTEXT
static final java.lang.String PROP_SCREEN_SNAPSHOT
static final java.lang.String PROP_USER_SCREEN_SNAPSHOT
static final java.lang.String PROP_LINENUMBER
static final java.lang.String PROP_BUFFERED_SNAPSHOT
static final java.lang.String PROP_SIMPLIFIEDSCRIPT_LINENUMBER
static final java.lang.String PROP_SIMPLIFIEDSCRIPT_GRPNAME
static final java.lang.String PROP_SIMPLIFIEDSCRIPT_LINE
static final java.lang.String PROP_SCRIPT_NAME
static final java.lang.String PROP_NAME
static final java.lang.String PROP_TESTCASE_NAME
static final java.lang.String PROP_TESTCASE_DESCRIPTION
static final java.lang.String PROP_ADDITIONAL_INFO
static final java.lang.String PROP_ELAPSED_TIME
static final java.lang.String PROP_FAILURE_DESCRIPTION
static final java.lang.String PROP_SCRIPT_SOURCE_UID
static final java.lang.String PROP_SCRIPT_ID
static final java.lang.String PROP_DATAPOOL_STORE
static final java.lang.String PROP_ITERATION_COUNT
static final java.lang.String VP_TYPE_ALPHA_NUM
static final java.lang.String VP_TYPE_CLIPBOARD
static final java.lang.String VP_TYPE_FILE_COMPARE
static final java.lang.String VP_TYPE_FILE_EXIST
static final java.lang.String VP_TYPE_MENU
static final java.lang.String VP_TYPE_MODULE_EXIST
static final java.lang.String VP_TYPE_OBJECT_DATA
static final java.lang.String VP_TYPE_OBJECT_PROP
static final java.lang.String VP_TYPE_FULL_IMAGE
static final java.lang.String VP_TYPE_OCR_IMAGE
static final java.lang.String VP_TYPE_REGION_IMAGE
static final java.lang.String VP_TYPE_WEBSITE_COMPARE
static final java.lang.String VP_TYPE_WEBSITE_SCAN
static final java.lang.String VP_TYPE_WINDOW_EXIST
static final java.lang.String VP_TYPE_WINDOW_IMAGE
static final java.lang.String SCREEN_SNAPSHOT_FILE_NAME
static final java.lang.String SCREEN_SNAPSHOT_FILE_BASE
static final java.lang.String USER_SCREEN_SNAPSHOT_FILE_BASE
static final java.lang.String SCREEN_SNAPSHOT_FILE_EXT
Method Detail |
---|
java.lang.String getLogDirectory()
LogAdapter
base class returns null
for this; therefore, derived classes should override the method with a real answer. The verification-point logic handles null
and writes the expected or actual results to the datastore directory in that case.
java.lang.String getLogFilename()
void info(java.lang.String note)
note
- The note to write to the logvoid scriptStart(java.lang.String name, java.lang.String language)
name
- The script namelanguage
- The language used for the script ( i.e. java )void scriptEnd(java.lang.String name, java.lang.String language)
name
- The script namelanguage
- The language used for the script ( i.e. java )void callScript(java.lang.String name, java.lang.String language)
name
- The script being calledlanguage
- The language used for the script ( i.e. java )void applicationStart(java.lang.String name, java.lang.String language)
name
- The application's namelanguage
- The language used for the script ( i.e. java )void applicationStart(java.lang.String name, int status, java.lang.String description, java.lang.String language)
name
- The application's namestatus
- Result of starting the application (@see ISimpleLog.LOG_FAILUREdescription
- Additional text for the status (e.g. reason for failure)language
- The language used for the script ( i.e. java )ISimpleLog.LOG_WARNING
,
ISimpleLog.LOG_INFORMATION
ILogMessage createApplicationStartMessage(java.lang.String name, int status, java.lang.String description, java.lang.String language)
name
- The application's namestatus
- Result of starting the application (@see ISimpleLog.LOG_FAILUREdescription
- Additional text for the status (e.g. reason for failure)language
- The language used for the script ( i.e. java )ISimpleLog.LOG_WARNING
,
ISimpleLog.LOG_INFORMATION
void timerStart(java.lang.String name, java.lang.String language)
name
- The timer namelanguage
- The language used for the script ( i.e. java )double getTimerValue(java.lang.String name)
name
- The timer namelanguage
- The language used for the script ( i.e. java )ILogMessage createTimerStartMessage(java.lang.String name, java.lang.String language)
name
- The timer namelanguage
- The language used for the script ( i.e. java )void timerEnd(java.lang.String name, java.lang.String language)
name
- The timer namelanguage
- The language used for the script ( i.e. java )double getTimerAndEnd(java.lang.String name, java.lang.String language)
name
- The timer namelanguage
- The language used for the script ( i.e. java )
ILogMessage createTimerEndMessage(java.lang.String name, java.lang.String language)
name
- The timer namelanguage
- The language used for the script ( i.e. java )
ILogMessage createVPMessage(int resultCode, java.lang.String type, java.lang.String name, java.lang.String language)
resultCode
- One of the LOG_
codestype
- One of the VP_TYPE_
codesname
- The verification point namelanguage
- The language used for the script ( i.e. java )
void configuration(java.lang.String language)
language
- The language used for the script ( i.e. java )ILogMessage createConfigurationMessage(java.lang.String language)
language
- The language used for the script ( i.e. java )
void writeGUIAction(ILogMessage message)
message
- The Gui Action MessageILogMessage createGUIActionMessage(int resultCode, java.lang.String method, java.lang.String methodSignature, java.lang.Object[] args, java.lang.String testObjectRole, java.lang.String testObjectName)
resultCode
- The Result code PASS/FAILURE/WARNING/INFOMATIONmethod
- The method that is getting called in the AUTmethodSignature
- The signature of the methodargs
- The arguments passed to the methodtestObjectRole
- The role of the test objecttestObjectName
- The test object name void exception(java.lang.String note, java.lang.String context, java.lang.String throwableName, java.lang.String throwableMessage, java.lang.String scriptName, int line, java.lang.String stackTrace, java.lang.String language)
void exception(java.lang.String note, java.lang.String context, java.lang.String throwableName, java.lang.String throwableMessage, java.lang.String scriptName, int line, java.lang.String stackTrace, java.lang.String language, java.awt.image.BufferedImage screenSnapshot)
ILogMessage createTestResultMessage(java.lang.String headline, boolean passed, java.lang.String additionalInfo)
headline
- The headline of the testpassed
- A boolean indicating whether the test passed or failedadditionalInfo
- Additional information about the testlanguage
- The language used for the script ( i.e. java )boolean viewerKnowsHowToBringUpComparator()
true
for the TSS log and false
otherwise.
This is used to decide whether to do a BringUpComparator
after playback.
boolean getCurrentScriptResult()
boolean getLastScriptResult()
boolean getTestResult()
int getCurrentLogFilter()
void setCurrentLogFilter(int filterLevel)
filterLevel
- DISABLE_LOGGING The filter level for logging to disable all logging LOG_FAILURES The filter level for logging to log all failures.
LOG_FAILURES_WARNINGS The filter level for logging to log all failures and warnings
LOG_FAILURES_WARNINGS_PASS The filter level for logging to log all failures, warnings and pass results LOG_FAILURES_WARNINGS_PASS_INFO The filter level for logging to log all.
LOG_ENABLE_GUI_ACTION The filter level to log all GUI actions.
LOG_DISABLE_GUI_ACTION The filter level to disable logging of all GUI Actions.boolean isLogGuiActionEnabled(java.lang.String methodName)
void setLogGUIAction(boolean logGuiAction)
logGuiAction
- true if the Gui Action is to be loggedvoid logRootException(java.lang.String scriptName, java.lang.String language, java.lang.String msg, java.lang.Throwable e, java.lang.String headline)
scriptName
- The script namelanguage
- The language usedmsg
- The localized messagee
- The Throwable objectjava.lang.String getLogType()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |