com.appperfect.apptest.script
Interface IWindowsTest

All Superinterfaces:

IScriptTest

public interface IWindowsTest
extends IScriptTest

A WindowsTest is created to represent window project in App Test.

A IWindowsTest object is created using IWindowsTest createWindowsTest(); API of IScriptEngine

Field Summary

Fields inherited from interface com.appperfect.devcommon.script.IScriptTest

BLACKBERRY_MODEL_9000, BLACKBERRY_MODEL_9700, DEVICE_ORIENTATION_HORIZONTAL, DEVICE_ORIENTATION_VERTICAL, ERROR_HANDLING_PROMPT_USER, ERROR_HANDLING_STOP_REPLAY, ERROR_MARK_FAILURE_CONTINUE_NEXT_GROUP, ERROR_MARK_FAILURE_CONTINUE_NEXT_TASK, ERROR_MARK_SUCCESS_CONTINUE_NEXT_GROUP, ERROR_MARK_SUCCESS_CONTINUE_NEXT_TASK, FETCH_VALUES_EVERYTIME, FETCH_VALUES_NOW, FETCH_VALUES_ON_DEMAND, FETCH_VALUES_RUNTIME_BEFORE_TASK_OR_EVENT_EXECUTION, FETCH_VALUES_RUNTIME_BEFORE_TEST_EXECUTION, PASSTHROUGH_RANDOM_VALUE_INDEX, TEST_DEVICE_ANDROID, TEST_DEVICE_BLACKBERRY, TEST_DEVICE_BROWSER, TEST_DEVICE_IPHONE

Method Summary

IApplicationGroup	addActionGroup(java.lang.String groupName, byte applicationType, boolean ignore) This method is used to add new task group.
void	addRemoteMachine(java.lang.String protocol, java.lang.String hostName, int serverPort, java.lang.String path, boolean ignore) This method is used to add remote machine settings where the AppPerfect service is running so that project can be run on remote machine simultaneously
void	setDefaultThinkTime(int seconds) This method is used to set the default think/wait time.
void	setDragPixelCount(int dragPixelCount) To set the number of pixels mouse should be dragged to record drag/drop events
void	setErrorOption(int iErrorOption) To set error option during execution of test
void	setIgnoreThinkTimeWhileReplaying(boolean ignore) This method is used to decide whether to ignore think/wait time during replaying
void	setIterateTestForAllParameterCombinations(boolean all) This method is used to decide whether to iterate test for all the possible parameters combination during replaying
void	setNoOfIterations(int iterations) This method is used to set number of iterations for test
void	setRecordDragDrop(boolean bRecordDragDrop) Whether application should record darg/drop events.
void	setRecordMouseMove(boolean bRecordMouseMove) Whether application should record mouse move events.
void	setRecordThinkTime(boolean record) This method is used to decide whether to record think time or not.
void	setRunProjectOnMultipleMachines(boolean run) This method is used to decide is the project is to be run on multiple machines simultaneously.
void	setRunProjectOnMultipleMachines(boolean run, boolean runOnLocalMachine) This method is used to decide is the project is to be run on multiple machines simultaneously.
void	setSaveSuccessfulWindowImages(boolean save) This method is used to decide whether to save successful window images while replaying
void	setTimeout(int seconds) Few windows may take long time to respond, sometimes forever, due to various reason like element could not be found.
void	setUseAbsoluteIndex(boolean bUseAbsoluteIndex) Whether application should use absolute window index to search the window during execution.
void	setUseAccessibility(boolean bUseAccessibility) Whether application should use Microsoft Active Accessibility framework to record/replay window events.
void	setUseSameTimeOut(boolean usesame) This method is used to use same timeout value for all the tasks throughout the project overriding the individual time out value for each of the task

Methods inherited from interface com.appperfect.devcommon.script.IScriptTest

addLinkProjectGroup, addTestParameter, addTestParameter, addTestParameter, addTestParameter, setCSVDatasource, setDatabaseDatasource, setDateCalculationDatasource, setLastIndex, setNumberCalculationDatasource, setNumberCalculationDatasource, setParameterValues, setPassthroughDatasource, setPassthroughDatasource, setPassthroughDatasource, setPassthroughDatasource, setPassthroughDatasource, setPassthroughDatasource, setReplayLinkedProjects

Method Detail

addActionGroup

IApplicationGroup addActionGroup(java.lang.String groupName,
                                 byte applicationType,
                                 boolean ignore)

This method is used to add new task group.

Parameters:

groupName - name of the Application group

applicationType - possible value are IApplicationGroup.APPLICATION_WINDOWS or IApplicationGroup.APPLICATION_JAVA

ignore - whether to ignore group during replaying

Returns:

object of IApplicationGroup

addRemoteMachine

void addRemoteMachine(java.lang.String protocol,
                      java.lang.String hostName,
                      int serverPort,
                      java.lang.String path,
                      boolean ignore)

This method is used to add remote machine settings where the AppPerfect service is running so that project can be run on remote machine simultaneously

Parameters:

protocol - protocol used to connect to remote machine.

hostName - Host/Machine name of remote machine

serverPort - port where the AppPerfect Service is running on remote machine

path - context path for the AppPerfect Service.

ignore - whether this machine settings should be ignored

setDefaultThinkTime

void setDefaultThinkTime(int seconds)

This method is used to set the default think/wait time.

Parameters:

seconds - is the no. of seconds to wait.

setDragPixelCount

void setDragPixelCount(int dragPixelCount)

To set the number of pixels mouse should be dragged to record drag/drop events

Parameters:

dragPixelCount - number of pixels mouse should be dragged to record drag/drop events

setErrorOption

void setErrorOption(int iErrorOption)

To set error option during execution of test

Parameters:

iErrorOption - can be set to one of following IScriptTest.ERROR_HANDLING_STOP_REPLAY or IScriptTest.ERROR_MARK_FAILURE_CONTINUE_NEXT_TASK or IScriptTest.ERROR_MARK_SUCCESS_CONTINUE_NEXT_TASK or IScriptTest.ERROR_MARK_SUCCESS_CONTINUE_NEXT_GROUP or IScriptTest.ERROR_MARK_FAILURE_CONTINUE_NEXT_GROUP or IScriptTest.ERROR_HANDLING_PROMPT_USER

setIgnoreThinkTimeWhileReplaying

void setIgnoreThinkTimeWhileReplaying(boolean ignore)

This method is used to decide whether to ignore think/wait time during replaying

Parameters:

ignore - true if think time should be ignored while replaying, false otherwise

setIterateTestForAllParameterCombinations

void setIterateTestForAllParameterCombinations(boolean all)

This method is used to decide whether to iterate test for all the possible parameters combination during replaying

Parameters:

all - true if test should be iterated for all the parameters combination, false otherwise

setNoOfIterations

void setNoOfIterations(int iterations)

This method is used to set number of iterations for test

Parameters:

iterations - no. of iteration to replay

setRecordDragDrop

void setRecordDragDrop(boolean bRecordDragDrop)

Whether application should record darg/drop events.

Parameters:

bRecordDragDrop - true if application should record drag/drop events, false otherwise

setRecordMouseMove

void setRecordMouseMove(boolean bRecordMouseMove)

Whether application should record mouse move events.

Parameters:

bRecordMouseMove - true if application should record mouse move events, false otherwise

setRecordThinkTime

void setRecordThinkTime(boolean record)

This method is used to decide whether to record think time or not.

Parameters:

record - true if think time should be recorded, false otherwise

setRunProjectOnMultipleMachines

void setRunProjectOnMultipleMachines(boolean run)

This method is used to decide is the project is to be run on multiple machines simultaneously.

Parameters:

run - whether to run project on multiple machines simultaneously

setRunProjectOnMultipleMachines

void setRunProjectOnMultipleMachines(boolean run,
                                     boolean runOnLocalMachine)

This method is used to decide is the project is to be run on multiple machines simultaneously.

Parameters:

run - whether to run project on multiple machines simultaneously

runOnLocalMachine - whether to run project on local machine

setSaveSuccessfulWindowImages

void setSaveSuccessfulWindowImages(boolean save)

This method is used to decide whether to save successful window images while replaying

Parameters:

save - true if images should be saved while replaying, false otherwise

setTimeout

void setTimeout(int seconds)

Few windows may take long time to respond, sometimes forever, due to various reason like element could not be found. This could affect the test execution which will never complete. One can come out of this situation by specifying the no of seconds after which the task execution will be aborted and its status will be marked as timed out.

Parameters:

seconds - no of seconds for the task to complete its execution.

setUseAbsoluteIndex

void setUseAbsoluteIndex(boolean bUseAbsoluteIndex)

Whether application should use absolute window index to search the window during execution. This is helpful where the native class of window changes during each run.

Parameters:

bUseAbsoluteIndex - true if application should use absolute window index to search window during execution, false otherwise

setUseAccessibility

void setUseAccessibility(boolean bUseAccessibility)

Whether application should use Microsoft Active Accessibility framework to record/replay window events.

Parameters:

bUseAccessibility - true if application should use Microsoft Active Accessibility framework to record/replay window events, false otherwise

setUseSameTimeOut

void setUseSameTimeOut(boolean usesame)

This method is used to use same timeout value for all the tasks throughout the project overriding the individual time out value for each of the task

Parameters:

usesame - whether to use same time out value for all the tasks.