com.cognifide.qa.bb.aem.ui

Class AemContentFinder

java.lang.Object

com.cognifide.qa.bb.aem.ui.AemContentFinder

public class AemContentFinder
extends Object

Represents content finder in a AEM page in authoring mode.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AemContentFinder.ResultsView This enum lists all available ways to display results in ContentFinder.

Constructor Summary

Constructors

Constructor and Description
AemContentFinder()

Method Summary

Modifier and Type	Method and Description
void	changeToListViewIfNeeded(AemContentFinderTab currentTab)
AemContentFinder	clickListView() Changes how results are displayed.
AemContentFinder	clickMosaicView() Changes how results are displayed.
AemContentFinder	clickTab(String tabName) Click the tab on icon bar.
AemContentFinder	collapse() Collapses contentFinder if it is not already collapsed.
AemContentFinder	expand() Expand contentFinder if it is not already expanded.
AemContentFinderTab	getCurrentTab()
String	getCurrentTabName()
AemContentFinder.ResultsView	getCurrentView()
int	getCurrentWidth()
Draggable	getElementByIndex(int index) Get dragabbleElement by index.
Draggable	getElementByName(String name) Get dragabbleElement by name.
List<String>	getResults()
boolean	hasResults()
boolean	isCollapsed()
boolean	isExpanded()
AemContentFinder	refreshResults() Clicks the refresh results button.
AemContentFinder	resize(int widthInPixels) Resizes contentFinder.
AemContentFinder	search(String query) Searches for draggable items.

Methods inherited from class java.lang.Object

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

Constructor Detail

AemContentFinder

public AemContentFinder()

Method Detail

search

public AemContentFinder search(String query)

Searches for draggable items. Must be invoked before getElementByName and getElementByIndex methods. Query parameter is case sensitive.

Parameters:

query - the text that will be typed into search input field

Returns:

This AemContentFinder instance.

resize

public AemContentFinder resize(int widthInPixels)

Resizes contentFinder. If widthInPixels is lower or equal 0 then collapse() method is invoked. It may be useful to select tab on icon bar. In Selenium only visible elements are clickable, so sometimes user has to resize contentFinder before clicking the tab.

Parameters:

widthInPixels - new width

Returns:

This AemContentFinder instance.

getCurrentWidth

public int getCurrentWidth()

Returns:

Current width of contentFinder, in pixels.

isCollapsed

public boolean isCollapsed()

Returns:

True if contentFinder is collapsed. False otherwise.

isExpanded

public boolean isExpanded()

Returns:

True if contentFinder is expanded. False otherwise.

collapse

public AemContentFinder collapse()

Collapses contentFinder if it is not already collapsed.

Returns:

This AemContentFinder instance.

expand

public AemContentFinder expand()

Expand contentFinder if it is not already expanded.

Returns:

This AemContentFinder instance.

clickTab

public AemContentFinder clickTab(String tabName)

Click the tab on icon bar. TabName parameter is case sensitive. Correct values usually start from upper case letter e.g Images, Documents

Parameters:

tabName - case sensitive tab name

Returns:

This AemContentFinder instance.

hasResults

public boolean hasResults()

Returns:

True if search method returned any results. False otherwise.

getElementByIndex

public Draggable getElementByIndex(int index)

Get dragabbleElement by index. Indexing starts from 0, counting from the top of the page. Mosaic view is not supported. Before returning the result, method automatically changes search results view to list if needed.

Parameters:

index - of an element (starts from 0)

Returns:

Found draggable element.

getElementByName

public Draggable getElementByName(String name)

Get dragabbleElement by name. Name parameter is case sensitive. Whitespaces are also taken into account. Mosaic view is not supported. Before returning the result, method automatically changes search results view to list if needed.

Parameters:

name - case sensitive name of element

Returns:

Found draggable element.

changeToListViewIfNeeded

public void changeToListViewIfNeeded(AemContentFinderTab currentTab)

clickMosaicView

public AemContentFinder clickMosaicView()

Changes how results are displayed. Performs click at the mosaic view button. At some tabs there is no such button, in that case the IllegalStateException is thrown.

Returns:

This AemContentFinder instance.

clickListView

public AemContentFinder clickListView()

Changes how results are displayed. Clicks the list view button. If the tab doesn't contain this button, in that case IllegalStateException is thrown.

Returns:

This AemContentFinder instance.

getCurrentTab

public AemContentFinderTab getCurrentTab()

refreshResults

public AemContentFinder refreshResults()

Clicks the refresh results button.

Returns:

This AemContentFinder instance.

getCurrentTabName

public String getCurrentTabName()

Returns:

Name of the currently selected tab, e.g. Images, Documents

getCurrentView

public AemContentFinder.ResultsView getCurrentView()

Returns:

Current way of displaying search results. ResultsView.DEFAULT is returned if there is no options to chose from e.g Products tab.

getResults

public List<String> getResults()

Returns:

Ordered search results, where the string value is the title of searched item. These values can be used to get Draggabble item by using getElementByName(java.lang.String).