com.atlassian.jira.functest.framework
Interface Dashboard

public interface Dashboard

An abstraction for logically grouping JIRA dashboard functionality for functional tests. When used as a return value it also implies that the current location is the dashboard.

Since:

v3.13

Nested Class Summary

static class

Dashboard.Table Holds the identifiers of the tables that display Portal Pages.

Method Summary

Dashboard	addPage(SharedEntityInfo info, Long cloneId) Add the passed dashboard page to JIRA.
Dashboard	disableConfigureMode() Turns off configuration mode for the dashboard.
Dashboard	editPage(SharedEntityInfo info) Change the passed dashboard page in JIRA.
Dashboard	enableConfigureMode() Turns on configuration mode for the dashboard.
Dashboard	favouriteDashboard(long id) Make the passed dashboard one of the logged in user's favourites.
Long	getDashboardPageId(String dashboardPageName, Locator pagesLocator) Find the id of the dashboard page with the given name from a table to dashboard pages.
Dashboard	navigateTo() Navigates to the dashboard.
Dashboard	navigateTo(long pageId) Navigates to the a specific dashboard page.
Dashboard	navigateToDefaultFullConfigure() Open the default dashboard configuration.
Dashboard	navigateToFavourites() Navigate to the screen that shows favourite dashboards.
Dashboard	navigateToFullConfigure(Long dashboardPageId) Open the full configure screen for the passed dashboard.
Dashboard	navigateToMy() Navigate to the screen that shows my dashboards.
Dashboard	navigateToPopular() Navigate to the screen that shows popular dashboards.
Dashboard	navigateToSearch() Navigate to the screen that allows dashboard searching.
Dashboard	resetToDefault() Reset the dashboard configuration to its initial state.
Dashboard	resetUserSessionState() Reset user session state.
Dashboard	unFavouriteDashboard(long id) Remove the passed dashboard from the user's favourites.

Method Detail

enableConfigureMode

Dashboard enableConfigureMode()

Turns on configuration mode for the dashboard. If it is already turned on, has no effect. If the current user has the default dashboard, subsequently they will have a custom dashboard, even though it will be configured the same as the default dashboard. Needs to be on the dashboard to work.

Returns:

this in a FluentInterface style.

disableConfigureMode

Dashboard disableConfigureMode()

Turns off configuration mode for the dashboard. If it is already off, it has no effect. Expects to be on the Dashboard to work.

Returns:

itself.

navigateTo

Dashboard navigateTo()

Navigates to the dashboard. Request to return to the location represented by this functional area.

Returns:

itself.

navigateTo

Dashboard navigateTo(long pageId)

Navigates to the a specific dashboard page. Request to return to the location represented by this functional area.

Parameters:

pageId - specific page

Returns:

itself.

addPage

Dashboard addPage(SharedEntityInfo info,
                  Long cloneId)

Add the passed dashboard page to JIRA.

Parameters:

info - the basic information for the dashboard.

cloneId - the id of the dashboard to clone. Can be null to clone the blank dashboard.

Returns:

the navigator object.

editPage

Dashboard editPage(SharedEntityInfo info)

Change the passed dashboard page in JIRA.

Parameters:

info - the basic information for the dashboard.

Returns:

the navigator object.

navigateToFavourites

Dashboard navigateToFavourites()

Navigate to the screen that shows favourite dashboards.

Returns:

the navigator object.

navigateToMy

Dashboard navigateToMy()

Navigate to the screen that shows my dashboards.

Returns:

the navigator object.

navigateToPopular

Dashboard navigateToPopular()

Navigate to the screen that shows popular dashboards.

Returns:

the navigator object.

navigateToSearch

Dashboard navigateToSearch()

Navigate to the screen that allows dashboard searching.

Returns:

the navigator object.

getDashboardPageId

Long getDashboardPageId(String dashboardPageName,
                        Locator pagesLocator)

Find the id of the dashboard page with the given name from a table to dashboard pages.

Parameters:

dashboardPageName - the name of the dashboard to find.

pagesLocator - the location of the table listing the dashboard.

Returns:

the identifier if the dashboard page or null if no such page exists.

navigateToFullConfigure

Dashboard navigateToFullConfigure(Long dashboardPageId)

Open the full configure screen for the passed dashboard.

Parameters:

dashboardPageId - the id of the dashboard to navigate to.

Returns:

the navigator object.

navigateToDefaultFullConfigure

Dashboard navigateToDefaultFullConfigure()

Open the default dashboard configuration.

Returns:

the navigation object.

favouriteDashboard

Dashboard favouriteDashboard(long id)

Make the passed dashboard one of the logged in user's favourites.

Parameters:

id - the id of the dashboard to favourite.

Returns:

this object so that the requests can be chained.

unFavouriteDashboard

Dashboard unFavouriteDashboard(long id)

Remove the passed dashboard from the user's favourites.

Parameters:

id - the id of the dashboard to unfavourite.

Returns:

this object so that the requests can be chained.

resetUserSessionState

Dashboard resetUserSessionState()

Reset user session state.

Returns:

this object so that the requests can be chained.

resetToDefault

Dashboard resetToDefault()

Reset the dashboard configuration to its initial state.

Returns:

this object so that the requests can be chained.