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

All Known Implementing Classes:

IssueNavigationImpl

public interface IssueNavigation

Provide abstractions for dealing with Issues via Selenium

Since:

v4.2

Method Summary

void	attachFile(String fieldName, String fileName, int size) Attach a file given the input field name, fileName and file size.
void	attachFileInExistingForm(String fieldName, String fileName, int size) Attach a file given the input field name, fileName and file size.
void	attachFileWithComment(String fieldName, String fileName, int size, String comment, String commentLevel) Attach a file given the input field name, fileName and file size.
List<String>	attachFileWithErrors(String fieldName, String fileName, int size) Attach a file given the input field name, fileName and file size.
void	editIssue(String issueKey) Go to the edit screen of the issue specified
List<String>	getAttachmentErrors() Return a list of the current attachment errors.
IssueNavigation	viewIssue(String issueKey) View an issue by key and return a handle to this object

Method Detail

viewIssue

IssueNavigation viewIssue(String issueKey)

View an issue by key and return a handle to this object

Parameters:

issueKey - the key of the issue to view

Returns:

this

attachFile

void attachFile(String fieldName,
                String fileName,
                int size)

Attach a file given the input field name, fileName and file size. The file name can be an absolute path to an existing file, in which case the size will be ignored and the file found at that path will simply be attached. If no file exists yet, a file containing 'x' will be generated of the correct size.

Parameters:

fieldName - The input field name

fileName - The fileName or absolute pat to attach

size - the size of the file to generate

attachFileInExistingForm

void attachFileInExistingForm(String fieldName,
                              String fileName,
                              int size)

Attach a file given the input field name, fileName and file size. The file name can be an absolute path to an existing file, in which case the size will be ignored and the file found at that path will simply be attached. If no file exists yet, a file containing 'x' will be generated of the correct size. This will not try to pop open the attach file dialog, but simply expect that we're already on a form with the attach file field.

Parameters:

fieldName - The input field name

fileName - The fileName or absolute pat to attach

size - the size of the file to generate

attachFileWithErrors

List<String> attachFileWithErrors(String fieldName,
                                  String fileName,
                                  int size)

Attach a file given the input field name, fileName and file size. Rather than successfully attaching a file, this method should be used to assert errors when uploading a file.

Parameters:

fieldName - The input field name

fileName - The fileName or absolute pat to attach

size - the size of the file to generate

Returns:

the errors in the attachment.

attachFileWithComment

void attachFileWithComment(String fieldName,
                           String fileName,
                           int size,
                           String comment,
                           String commentLevel)

Attach a file given the input field name, fileName and file size. The file name can be an absolute path to an existing file, in which case the size will be ignored and the file found at that path will simply be attached. If no file exists yet, a file containing 'x' will be generated of the correct size. This method will also add a comment & commentLevel.

Parameters:

fieldName - The input field name

fileName - The fileName or absolute pat to attach

size - the size of the file to generate

comment - the comment body

commentLevel - the security level for the comment.

getAttachmentErrors

List<String> getAttachmentErrors()

Return a list of the current attachment errors. Empty list will be returned if no errors.

Returns:

a list of the current attachment errors. Empty list will be returned if no errors.

editIssue

void editIssue(String issueKey)

Go to the edit screen of the issue specified

Parameters:

issueKey - the issue to edit