com.appperfect.functionaltester.script
Interface IWebTest

All Superinterfaces:

IScriptTest

public interface IWebTest
extends IScriptTest

A Web Test is created to represent Web project in AppPerfect Web Test.

A IWebTest object is created using IWebTest createWebTest(); 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_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

IWebGroup	addActionGroup(java.lang.String groupName, int protocol) This method is used to add new task group.
IWebGroup	addActionGroup(java.lang.String groupName, java.lang.String startingURL, boolean ignore) This method is used to add new task group.
void	addBlackberryDevice(java.lang.String simulatorHome, java.lang.String mdsHome, java.lang.String model, int percentage) In case application is configured to run execution with blackberry device then % of iterations for each blockaberry simulator device should be configured using this api.
void	addBrowserDevice(java.lang.String browserPath, int percentage) In case application is configured to run execution with differnt browsers then % of iterations for each browser should be configured using this api.
void	addIPhoneDevice(int orientation, java.lang.String webkitPath, int percentage) In case application is configured to run execution with iphone device then % of iterations for each iPhone device should be configured using this api.
void	addRemoteMachine(java.lang.String protocol, java.lang.String hostName, int serverPort, java.lang.String path, boolean useMozillaControl, 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 machines simultaneously
void	setAutoDetectMouseHover(boolean bAutoDetectMouseHover) Whether application should Auto-detect mouse-over events for elements having mouse-over event handlers during recording
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	setExactAttributeMatch(boolean bExactAttributeMatch) Whether application should perform strict attributes comparison to find element during replaying.
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	setRecordSubFrames(boolean bRecordSubFrames) Whether application should record all sub frames during recording.
void	setRecordThinkTime(boolean record) This method is used to decide whether to record think/wait time or not.
void	setReplayLowLevelMouseEvents(boolean bReplayLowLevelMouseEvents) Whether application should use low level events to replay mouse events.
void	setRunCrossBrowsers(boolean bRunCrossBrowsers) Whether application should run execution with different browsers for each iteration.
void	setRunProjectOnMultipleMachines(boolean run) This method is used to decide is the project is to be run on multiple machines simultaneously.
void	setSavePageImage(boolean save) This method is used to decide whether to save page images while replaying.
void	setSaveSuccessfulResponseDetails(boolean save) This method is used to decide whether to save successful response details while replaying
void	setTimeout(int seconds) Few urls may take long time to respond, sometimes forever, due to various reason like server is not responding, network failure etc.
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, setReplayLinkedProjects

Method Detail

addActionGroup

IWebGroup addActionGroup(java.lang.String groupName,
                         int protocol)

This method is used to add new task group.

Parameters:

groupName - name of the Web group

protocol - could be one of IWebGroup.GROUP_HTTP or IWebGroup.GROUP_SOAP depending on whether it will have HTTP/S web tasks or SOAP tasks

Returns:

object of IWebGroup

addActionGroup

IWebGroup addActionGroup(java.lang.String groupName,
                         java.lang.String startingURL,
                         boolean ignore)

This method is used to add new task group.

Parameters:

groupName - name of the Web group

startingURL - represents starting url for the group

ignore - whether to ignore group during replaying

Returns:

object of IWebGroup

addBlackberryDevice

void addBlackberryDevice(java.lang.String simulatorHome,
                         java.lang.String mdsHome,
                         java.lang.String model,
                         int percentage)

In case application is configured to run execution with blackberry device then % of iterations for each blockaberry simulator device should be configured using this api.

Parameters:

simulatorHome - specify the path of the directory having \"fledge.exe\" file.

mdsHome - Provide the path for Blackberry MDS service. It is the path of the directory having startup and shutdown scripts for MDS service.

model - specify the handheld model which should be simulated, Could be either "9000" or "9700"

percentage - percentage of iterations to run.

addBrowserDevice

void addBrowserDevice(java.lang.String browserPath,
                      int percentage)

In case application is configured to run execution with differnt browsers then % of iterations for each browser should be configured using this api.

Parameters:

browserPath - complete executable path of the browser, in case device is IScriptTest.TEST_DEVICE_IPHONE then for best results browser path should be the path of browser using webkit engine like Safari

percentage - percentage of iterations to run.

addIPhoneDevice

void addIPhoneDevice(int orientation,
                     java.lang.String webkitPath,
                     int percentage)

In case application is configured to run execution with iphone device then % of iterations for each iPhone device should be configured using this api.

Parameters:

orientation - in case of Phone device the orientation can have any of the following values IScriptTest.DEVICE_ORIENTATION_HORIZONTAL or IScriptTest.DEVICE_ORIENTATION_VERTICAL

webkitPath - complete executable path of the webkit browser, for best results webkit path should be the path of browser using webkit engine like Safari or Chrome

percentage - percentage of iterations to run.

addRemoteMachine

void addRemoteMachine(java.lang.String protocol,
                      java.lang.String hostName,
                      int serverPort,
                      java.lang.String path,
                      boolean useMozillaControl,
                      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 machines 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

setAutoDetectMouseHover

void setAutoDetectMouseHover(boolean bAutoDetectMouseHover)

Whether application should Auto-detect mouse-over events for elements having mouse-over event handlers during recording

Parameters:

bAutoDetectMouseHover - true if application should auto-detect mouse-over events for elements having mouse-over event handlers during recording, false otherwise

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

setExactAttributeMatch

void setExactAttributeMatch(boolean bExactAttributeMatch)

Whether application should perform strict attributes comparison to find element during replaying.

Parameters:

bExactAttributeMatch - true if application should perform strict attributes comparison to find element during replaying, false otherwise

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

setRecordSubFrames

void setRecordSubFrames(boolean bRecordSubFrames)

Whether application should record all sub frames during recording.

Parameters:

bRecordSubFrames - true if application should record all sub frames during recording, false otherwise

setRecordThinkTime

void setRecordThinkTime(boolean record)

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

Parameters:

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

setReplayLowLevelMouseEvents

void setReplayLowLevelMouseEvents(boolean bReplayLowLevelMouseEvents)

Whether application should use low level events to replay mouse events.

Parameters:

bReplayLowLevelMouseEvents - true if application should use low level events to replay mouse events, false otherwise

setRunCrossBrowsers

void setRunCrossBrowsers(boolean bRunCrossBrowsers)

Whether application should run execution with different browsers for each iteration.

Parameters:

bRunCrossBrowsers - true if application should run execution with different browsers for each iteration, 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

setSavePageImage

void setSavePageImage(boolean save)

This method is used to decide whether to save page images while replaying.

Parameters:

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

setSaveSuccessfulResponseDetails

void setSaveSuccessfulResponseDetails(boolean save)

This method is used to decide whether to save successful response details while replaying

Parameters:

save - true if successful response details should be saved while replaying, false otherwise

setTimeout

void setTimeout(int seconds)

Few urls may take long time to respond, sometimes forever, due to various reason like server is not responding, network failure etc. 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.

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.