org.safs.cukes.ai.selenium

Class AIComponentActions

java.lang.Object

org.safs.SAFSPlus

org.safs.selenium.webdriver.SeleniumPlus

org.safs.cukes.ai.selenium.AISearchBase

org.safs.cukes.ai.selenium.AIComponent

org.safs.cukes.ai.selenium.AIComponentActions

public class AIComponentActions
extends AIComponent

Author:

Lei Wang

Nested Class Summary

Nested classes/interfaces inherited from class org.safs.selenium.webdriver.SeleniumPlus

SeleniumPlus.Assert, SeleniumPlus.CheckBox, SeleniumPlus.ComboBox, SeleniumPlus.Component, SeleniumPlus.Counters, SeleniumPlus.EditBox, SeleniumPlus.Files, SeleniumPlus.ListView, SeleniumPlus.Logging, SeleniumPlus.Menu, SeleniumPlus.Misc, SeleniumPlus.Rest, SeleniumPlus.ScrollBar, SeleniumPlus.Strings, SeleniumPlus.TabControl, SeleniumPlus.Tree, SeleniumPlus.WDTimeOut, SeleniumPlus.Window

Nested classes/interfaces inherited from class org.safs.SAFSPlus

SAFSPlus.DriverCommand

Field Summary

Fields inherited from class org.safs.cukes.ai.selenium.AIComponent

libComponent, MAX_TRY_DEFAULT, maxRetry, TYPE

Fields inherited from class org.safs.cukes.ai.selenium.AISearchBase

_abort_on_assert_failure, _abort_on_find_failure, _case_does_not_matter, _log_details, _substring_matches_allowed, _using_cached_component, cachedLibComponents, DEFAULT_SEPLUS_AI_DEFINITIONS, frames, frameTree, GLUE_OPT, searchContext

Fields inherited from class org.safs.selenium.webdriver.SeleniumPlus

PRODUCT_DESCRIPTION, PRODUCT_NAME, PRODUCT_VERSION, Runner, TEMP_SELENIUM_PLUS_RS_VAR

Fields inherited from class org.safs.SAFSPlus

_autorun, _autorunClassProvided, _injectDataAwareness, _isInjected, _isSPC, _junit, allowExit, ARG_AUTORUN, ARG_AUTORUN_CLASS, ARG_JUNIT, ARG_SAFSVAR, DefaultRunner, exitCode, normalizeTextForInput, prevResults, RELATIVE_TO_PARENT, RELATIVE_TO_SCREEN, springApplicationContext

Constructor Summary

Constructors

Constructor and Description
AIComponentActions()

Method Summary

Modifier and Type	Method and Description
void	click_component(java.lang.String criteria, java.lang.String type) Click the component whose text matches the text provided.
void	verify_component_is_displayed(java.lang.String criteria) Verify the requested component is displayed anywhere on the page.
void	verify_component_is_displayed(java.lang.String criteria, java.lang.String type) Verify the requested component is displayed anywhere on the page.

Methods inherited from class org.safs.cukes.ai.selenium.AIComponent

checkForCoord, clearHighlight, doSetText, generateCriteria, generateCriteria, getComponentRectangle, getType, highlight, ignoreCache, initComponent, localProcess, process, process, process, setText

Methods inherited from class org.safs.cukes.ai.selenium.AISearchBase

addNonRepeatedElements, convertElementArrayToList, deduceBenchFile, deduceDiffFile, deduceProjectFile, deduceTestFile, findElementInParent, findElements, findElementsInParent, findSelectableItemFromText, getCachedLibComponent, getFirstIFrame, getXpathType, initializeFrames, logElementIdInfo, logElementProperties, logListElementsInfo, logMapKeyValues, main, matched, resetFrames, runCukesTest, runCukesTest, runCukesTest, runTest, saveCachedLibComponent

Methods inherited from class org.safs.selenium.webdriver.SeleniumPlus

AbortTest, AltLeftDrag, Click, ClickUnverified, CtrlAltLeftDrag, CtrlClick, CtrlLeftDrag, CtrlRightClick, CtrlShiftLeftDrag, deduceFilterAreas, DoubleClick, executeAsyncScript, ExecuteScript, executeScript, GetGUIImage, GetGUIImage, getObject, getObject, GetVariableValue, Highlight, HoverScreenLocation, LeftDrag, Pause, PrintTestCaseSummary, PrintTestSuiteSummary, RightClick, RightDrag, SetVariableValue, ShiftClick, ShiftLeftDrag, StartTestCase, StartTestSuite, StartWebBrowser, StopTestCase, StopWebBrowser, SwitchWebBrowser, TypeChars, TypeEncryption, TypeKeys, VerifyBinaryFileToFile, VerifyFileToFile, VerifyGUIImageToFile, VerifyTextFileToFile, VerifyValueContains, VerifyValueContainsIgnoreCase, VerifyValueDoesNotContain, VerifyValues, VerifyValuesIgnoreCase, VerifyValuesNotEqual, WaitForGUI, WebDriver

Methods inherited from class org.safs.SAFSPlus

_getMappedValue, _getVariable, _processArgs, _resolveDDVariables, _setVariable, action, actionGUILess, autorun, back, combineParams, command, debug, error, forward, getAllowExit, getExitCode, getRunner, iDriver, normalizeTextForInput, quote, quotePath, replaceSeparator, setAllowExit, setExitCode, setLeveledTest, setNormalizeTextForInput, setRunner, testStatusCode

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AIComponentActions

public AIComponentActions()

Method Detail

click_component

@Then(value="click/tap the {var_mapitem_or_string} {word}")
public void click_component(java.lang.String criteria,
                                                                                         java.lang.String type)
                                                                                  throws SAFSException

Click the component whose text matches the text provided. Partial matching is supported if enabled.

Cucumber Expression: "click/tap the {mapitem_or_string} {word}"
{var_mapitem_or_string} Matches TypeRegistryConfiguration.REGEX_VAR_MAPITEM_OR_STRING, represents a variable, or a map item, such as mapID:section.item or a double-quoted-string or a single-quoted-string. It will be parsed by TypeRegistryConfiguration
{word} Matches words without whitespace, for example banana
They will be parsed by TypeRegistryConfiguration

Examples invocations:

• Then click the "Help" option
• And click the "About" item
  or
  
• Then tap the "Help" option
• And tap the "About" item
• click the tab identified by the text of map item SAPDemoPageAI.BascCompLabel
  == on map chain, a map containing =========
  [SAPDemoPageAI]
  BascCompLabel="Basc.Comp"
  ================================
  Then click the SAPDemoPageAI.BascCompLabel tab
• click the tab identified by the recognition string of map item SAPDemoPageAI.BascCompLabel
  == on map chain, a map containing =========
  [SAPDemoPage]
  SAPDemoPage="class=sapUiBody"
  Basc_ToggleButton="id=layout.center.tab.basc.togglebutton"
  ================================
  Then click the SAPDemoPage.Basc_ToggleButton button

Parameters:

criteria - String, the search-conditions helping to find the component to click.

type - String, allows the user to specify a 'type' (editbox, button, item, option, etc..) to help locate the exact web-element.

Throws:

SAFSObjectNotFoundException - if not found and abort on find failure is enabled.

SAFSException

See Also:

AISearchBase.findSelectableItemFromText(String), AIMiscActions.accept_partial_text_matches(), AIMiscActions.deny_partial_text_matches(), AIMiscActions.abort_testing_on_item_not_found(), AIMiscActions.continue_testing_on_item_not_found(), AIComponent.process(String, String, int, List, String)

verify_component_is_displayed

@Then(value="verify {var_mapitem_or_string} is displayed/visible")
public void verify_component_is_displayed(java.lang.String criteria)
                                                                                                       throws SAFSException

Verify the requested component is displayed anywhere on the page. Partial matching is supPorted if enabled.

Cucumber Expression: "verify {mapitem_or_string} is displayed"
{var_mapitem_or_string} Matches TypeRegistryConfiguration.REGEX_VAR_MAPITEM_OR_STRING, represents a variable, or a map item, such as mapID:section.item or a double-quoted-string or a single-quoted-string. It will be parsed by TypeRegistryConfiguration

Examples invocations:

• Then verify "Help" is displayed
• And verify "Something else" is displayed
• verify the appearance of the text of map item verifMsg_AllowMultiSelect
  == on map chain, a map containing =========
  [ApplicationConstants]
  verifMsg_AllowMultiSelect="allow multiple selection"
  ================================
  Then verify verifMsg_AllowMultiSelect is displayed
• verify the appearance of the component identified by map item SAPDemoPage.Basc_ToggleButton
  == on map chain, a map containing =========
  [SAPDemoPage]
  SAPDemoPage="class=sapUiBody"
  Basc_ToggleButton="id=layout.center.tab.basc.togglebutton"
  ================================
  Then verify SAPDemoPage.Basc_ToggleButton is displayed

Parameters:

criteria - String, the search-conditions helping to find the component to be verified.

Throws:

SAFSObjectNotFoundException - if not found and abort on find failure is enabled.

SAFSException

See Also:

AISearchBase.findSelectableItemFromText(String), AIMiscActions.accept_partial_text_matches(), AIMiscActions.deny_partial_text_matches(), AIMiscActions.abort_testing_on_item_not_found(), AIMiscActions.continue_testing_on_item_not_found(), AIComponent.process(String, String, int, List)

verify_component_is_displayed

@Then(value="verify the {var_mapitem_or_string} {word} is displayed/visible")
public void verify_component_is_displayed(java.lang.String criteria,
                                                                                                                         java.lang.String type)
                                                                                                                  throws SAFSException

Verify the requested component is displayed anywhere on the page. Partial matching is supPorted if enabled.

Cucumber Expression: "verify the {mapitem_or_string} {word} is displayed/visible"
{var_mapitem_or_string} Matches TypeRegistryConfiguration.REGEX_VAR_MAPITEM_OR_STRING, represents a variable, or a map item, such as mapID:section.item or a double-quoted-string or a single-quoted-string. It will be parsed by TypeRegistryConfiguration
{word} Matches words without whitespace, for example banana (but not banana split)

Examples invocations:

• Then verify the "Help" label is displayed
• Then verify the "Submit" button is displayed
• And verify the "Cancel" button is visible
• verify the existence of the editbox identified by xpath
  Then verify the "XPATH=//*[@id='layout.center.tab.basc.firstname.editbox']" editbox is visible
• verify the existence of the label identified by css selector
  Then verify the "CSS=[id='layout.center.tab.basc.firstname.label']" label is visible
• verify the appearance of the text of map item verifMsg_AllowMultiSelect
  == on map chain, a map containing =========
  [ApplicationConstants]
  verifMsg_AllowMultiSelect="allow multiple selection"
  ================================
  Then verify the verifMsg_AllowMultiSelect text is displayed
• verify the existence of the button identified by the value of map item Basc_ToggleButton
  == on map chain, a map containing =========
  [ApplicationConstants]
  Basc_ToggleButton="ToggleButton"
  ================================
  Then verify the Basc_ToggleButton button is visible
• verify the existence of the button identified by the value of map item SAPDemoPage.Basc_ToggleButton
  == on map chain, a map containing =========
  [SAPDemoPage]
  Basc_ToggleButton="id=layout.center.tab.basc.togglebutton"
  ================================
  Then verify the SAPDemoPage.Basc_ToggleButton button is displayed
• verify the existence of the button identified by the value of map item SapDemoApp:SAPDemoPageAI.Basc_ToggleButton
  == SapDemoApp.map file =========
  [SAPDemoPageAI]
  Basc_ToggleButton="ToggleButton"
  ================================
  Then verify the SapDemoApp:SAPDemoPageAI.Basc_ToggleButton button is displayed

Parameters:

criteria - String, the search-conditions helping to find the component to be verified.

type - String, allows the user to specify a 'type' (editbox, button, item, option, etc..) to help locate the exact web-element.

Throws:

SAFSObjectNotFoundException - if not found and abort on find failure is enabled.

SAFSException

See Also:

AISearchBase.findSelectableItemFromText(String), AIMiscActions.accept_partial_text_matches(), AIMiscActions.deny_partial_text_matches(), AIMiscActions.abort_testing_on_item_not_found(), AIMiscActions.continue_testing_on_item_not_found(), AIComponent.process(String, String, int, List)