com.atlassian.jira.webtest.selenium.harness.util
Interface Navigator

All Known Implementing Classes:
NavigatorImpl

public interface Navigator

Provides helper methods for navigating around JIRA.


Method Summary
 void browseProject(String projectKey)
          Goes to the browse page for the project with the given key.
 BulkChangeWizard bulkChange(IssueNavigatorNavigation.BulkChangeOption bulkChangeOption)
          Initiate the bulk change wizard on the current search results.
 Navigator click(String id)
           
 Navigator clickAndWaitForPageLoad(String id)
          Click and wait for the page to load
 Navigator collapseContentSection(String sectionId)
          Collapses a particular expanded content session in the content pane of the issuenavigator
 String createIssue(String projectName, String issueType, String summary)
          Creates an issue in the database
 Dashboard currentDashboard()
          Goes to the dashboard action which will navigate to the most recent dashboard in the session.
 Dashboard dashboard(String id)
          Returns dashboard navigation and utilities for the dashboard with the given id.
 void disableWebSudo()
           
 Navigator editIssue(String issueKey)
           
 Navigator expandAllNavigatorSections()
          Expands all collapsed navigator sections in the left hand column of the issuenavigator
 Navigator expandContentSection(String sectionId)
          Expands a particular collapsed content session in the content pane of the issuenavigator
 Navigator findAllIssues()
          Finds all issues using simple navigation.
 Navigator findIssuesWithJql(String jql)
           
 Navigator gotoAdmin()
           
 Navigator gotoBrowseProject(String projectName)
           
 Navigator gotoCreateIssueScreen(String project, String issueType)
          Goes to the first page for creating an issue but doesn't actually create an issue.
 Navigator gotoFindIssues()
           
 Navigator gotoFindIssuesAdvanced()
          Goes to the JQL view of the issue navigator.
 Navigator gotoFindIssuesSimple()
          Goes to the issue navigator and ensures the simple search mode.
 Navigator gotoHome()
           
 Navigator gotoIssue(String issueKey)
           
 Navigator gotoManageFilters()
          Navigates to the Manage Filters page.
 Navigator gotoPage(String relativeUrl, boolean waitForPageLoad)
          Navigates to the page specified by the relative URL.
 Navigator gotoUserProfile()
           
 Navigator gotoUserProfile(String user)
           
 Navigator gotoUserProfileTab(String tab)
           
 Navigator gotoUserProfileTab(String tab, String user)
           
 IssueNavigation issue()
          Returns a handle on issue navigation utilities.
 IssueNavigatorNavigation issueNavigator()
          Returns an object that can be used to control the issue navigator.
 Navigator login(String username)
          Login using the user name and password as the same value
 Navigator login(String username, String password)
           
 Navigator login(User user, String destination)
          Login and redirect to a specified destination.
 Navigator loginAsSystemAdmin(String destination)
          Login as the system administrator and redirect to a specified destination.
 Navigator logout(String xsrfToken)
           
 Navigator openHistoryTab()
          Go to the 'History' tab on the view issue screen.
 void webSudoAuthenticate(String password)
          Checks if we have been redirected to the websudo login form and logs in.
 void webSudoAuthenticateUsingLastPassword()
           
 

Method Detail

login

Navigator login(String username)
Login using the user name and password as the same value

Parameters:
username - the username and password to use
Returns:
a Navigator instance of call chaining

login

Navigator login(String username,
                String password)

login

Navigator login(User user,
                String destination)
Login and redirect to a specified destination. User must not be already logged in (leaving full implementation of that for PageObjects).

Parameters:
user - User to extract username and password from
destination - destination to set as os_destination in the login URL
Returns:
a Navigator instance of call chaining

loginAsSystemAdmin

Navigator loginAsSystemAdmin(String destination)
Login as the system administrator and redirect to a specified destination. Waits for the desination page to load. Admin must not be already logged in (leaving full implementation of that for PageObjects).

Parameters:
destination - URL chunk to set as os_destination in the login URL
Returns:
a Navigator instance of call chaining

logout

Navigator logout(String xsrfToken)

gotoPage

Navigator gotoPage(String relativeUrl,
                   boolean waitForPageLoad)
Navigates to the page specified by the relative URL.

NOTE: URL must be relative. Do not use leading '/' as this breaks on Orion server.

Parameters:
relativeUrl - relative URL - not starting with '/'
Returns:
this navigator

gotoHome

Navigator gotoHome()

gotoManageFilters

Navigator gotoManageFilters()
Navigates to the Manage Filters page.

Returns:
this navigator

gotoFindIssues

Navigator gotoFindIssues()
Returns:

gotoFindIssuesSimple

Navigator gotoFindIssuesSimple()
Goes to the issue navigator and ensures the simple search mode.

Returns:
the Navigator

gotoFindIssuesAdvanced

Navigator gotoFindIssuesAdvanced()
Goes to the JQL view of the issue navigator.

Returns:
the Navigator

gotoAdmin

Navigator gotoAdmin()
Returns:

webSudoAuthenticate

void webSudoAuthenticate(String password)
Checks if we have been redirected to the websudo login form and logs in.

Parameters:
password -

webSudoAuthenticateUsingLastPassword

void webSudoAuthenticateUsingLastPassword()

disableWebSudo

void disableWebSudo()

gotoUserProfile

Navigator gotoUserProfile()
Returns:

gotoUserProfile

Navigator gotoUserProfile(String user)
Parameters:
user -
Returns:

gotoUserProfileTab

Navigator gotoUserProfileTab(String tab)
Parameters:
tab -
Returns:

gotoUserProfileTab

Navigator gotoUserProfileTab(String tab,
                             String user)
Parameters:
tab -
user -
Returns:

gotoIssue

Navigator gotoIssue(String issueKey)
Parameters:
issueKey -
Returns:
this navigator instance

openHistoryTab

Navigator openHistoryTab()
Go to the 'History' tab on the view issue screen.

Returns:
this navigator instance

editIssue

Navigator editIssue(String issueKey)
Parameters:
issueKey -
Returns:

findAllIssues

Navigator findAllIssues()
Finds all issues using simple navigation. Use findIssuesWithJql(String) for JQL searching NOTE: This will reset the issue navigator navType to simple if it is currently JQL

Returns:
this navigator

findIssuesWithJql

Navigator findIssuesWithJql(String jql)
Parameters:
jql -
Returns:

gotoBrowseProject

Navigator gotoBrowseProject(String projectName)
Parameters:
projectName -
Returns:

clickAndWaitForPageLoad

Navigator clickAndWaitForPageLoad(String id)
Click and wait for the page to load

Parameters:
id - element id
Returns:
this navigator

click

Navigator click(String id)
Parameters:
id -
Returns:

createIssue

String createIssue(String projectName,
                   String issueType,
                   String summary)
Creates an issue in the database

Parameters:
projectName - - the name of the project - can be nulll
issueType - the type of issue - can be nulll
summary - the summary of the issue
Returns:
the newly created issue key

browseProject

void browseProject(String projectKey)
Goes to the browse page for the project with the given key.

Parameters:
projectKey - the project's key.

dashboard

Dashboard dashboard(String id)
Returns dashboard navigation and utilities for the dashboard with the given id.

Parameters:
id - the id of the dashboard
Returns:
A Dasbhoard navigation instance

currentDashboard

Dashboard currentDashboard()
Goes to the dashboard action which will navigate to the most recent dashboard in the session.

Returns:
A Dasbhoard navigation instance

expandAllNavigatorSections

Navigator expandAllNavigatorSections()
Expands all collapsed navigator sections in the left hand column of the issuenavigator

Returns:
this navigator

collapseContentSection

Navigator collapseContentSection(String sectionId)
Collapses a particular expanded content session in the content pane of the issuenavigator

Parameters:
sectionId - the id of the section to collapse
Returns:
this navigator

expandContentSection

Navigator expandContentSection(String sectionId)
Expands a particular collapsed content session in the content pane of the issuenavigator

Parameters:
sectionId - the id of the section to expand
Returns:
this navigator

bulkChange

BulkChangeWizard bulkChange(IssueNavigatorNavigation.BulkChangeOption bulkChangeOption)
Initiate the bulk change wizard on the current search results.

Parameters:
bulkChangeOption - whether to bulk change all results or just the current page.
Returns:
an instance of the bulk change wizard which will be used to step through the wizard.

issue

IssueNavigation issue()
Returns a handle on issue navigation utilities.

Returns:
Issue navigation utilities

issueNavigator

IssueNavigatorNavigation issueNavigator()
Returns an object that can be used to control the issue navigator.

Returns:
an object that can be used to control the issuer navigator.

gotoCreateIssueScreen

Navigator gotoCreateIssueScreen(String project,
                                String issueType)
Goes to the first page for creating an issue but doesn't actually create an issue.

Parameters:
project - The name of the project to create the issue in
issueType - The type of issue to create
Returns:
this object


Copyright © 2002-2012 Atlassian. All Rights Reserved.