FormDialog (Atlassian JIRA 7.1.7 API)

java.lang.Object
- com.atlassian.jira.pageobjects.dialogs.JiraDialog
- - com.atlassian.jira.pageobjects.dialogs.FormDialog

Direct Known Subclasses:

AbstractAddWorkflowToSchemeDialog, AbstractAssignIssueTypesDialog, AbstractIssueDialog, AddFieldConfigurationDialog, AddFieldConfigurationSchemeDialog, AddFieldScreenDialog, AddFieldScreenSchemeDialog, AddIssueTypeDialog, AddIssueTypeScreenSchemeDialog, AddIssueTypeToFieldConfigurationDialog, AddIssueTypeToScreenSchemeAssociationDialog, AddNewIssueTypeToSchemeDialog, AddProjectWizardPage, AddSubtaskTypeDialog, AddWorkflowDialog, AssignIssueDialog, AssociateIssueOperationToScreenDialog, AvatarDialog, CloseIssueDialog, CommentDialog, CopyWorkflowDialog, DeleteAttachmentDialog, DeleteIssueDialog, DeleteTabDialog, DiscardDraftDialog, DiscardDraftWorkflowSchemeDialog, EditCommentDialog, EditWorkflowNameAndDescriptionDialog, JiraSudoFormDialog, LabelsDialog, LinkIssueDialog, LogWorkDialog, ProjectIntroVideoDialog, PublishDialog, ResolveIssueDialog, ViewWorkflowTextDialog, WorkflowTransitionDialog, XsrfDialog
```
public class FormDialog
extends JiraDialog
```
Represents a JIRA from dialog. These type of Dialogs basically slurp HTML from the server and display it on the client side. Input is submitted to a back end action. This action will either indicate that the action was a success or will return HTML with errors in it for display to the user.

Since:

v4.4

Field Summary

Fields
Modifier and Type	Field and Description
`protected com.atlassian.pageobjects.elements.PageElement`	`form`
`static String`	`FORM_SUBMITTING_CLASS`
`protected com.atlassian.pageobjects.elements.PageElement`	`header`
`protected com.atlassian.pageobjects.elements.PageElement`	`loading`
`protected FormMessages`	`messages`

Fields inherited from class com.atlassian.jira.pageobjects.dialogs.JiraDialog
binder, CONTENT_AREA_CLASS, CONTENT_READY_CLASS, DIALOG_CLASS, DIALOG_OPEN_CLASS, driver, extendedFinder, HEADING_AREA_CLASS, id, locator, queryFactory

Constructor Summary

Constructors
Constructor and Description

FormDialog()

FormDialog(String id)

Constructors
Constructor and Description
`FormDialog()`
`FormDialog(String id)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected void`	`assertDialogClosed()`
`protected void`	`assertDialogOpen()`
`void`	`close()` Close the dialog by clicking on the kindly ever-present cancel button.
`void`	`escape()` Closes the dialog by hitting ESC
`AuiMessage`	`getAuiMessage()`
`protected com.atlassian.pageobjects.elements.PageElement`	`getDialogElement()`
`com.atlassian.pageobjects.elements.query.TimedQuery<Iterable<com.atlassian.pageobjects.elements.PageElement>>`	`getFormErrorElements()`
`List<String>`	`getFormErrorList()` Return a list of the form errors currently on the dialog.
`Map<String,String>`	`getFormErrors()` Return a mapping of the errors currently on the form.
`com.atlassian.pageobjects.elements.query.TimedQuery<String>`	`getTimedTitle()`
`String`	`getTitle()`
`boolean`	`hasFormErrors()` Return true iff the dialog has error messages contained in its associated form.
`void`	`initAbstractDialog()`
`FormMessages`	`messages()`
`void`	`ready()` Called when the dialog is first displayed.
`protected static void`	`setElement(com.atlassian.pageobjects.elements.PageElement element, String value)`
`protected boolean`	`submit(org.openqa.selenium.By locator)` Do a submit on the passed element found using the passed locator.
`protected boolean`	`submit(com.atlassian.pageobjects.elements.PageElement pageElement)` Do a submit on the passed element.
`protected boolean`	`submit(String name)` Do a submit on the passed the form element with the passed name.
`FormDialog`	`waitForFormErrors()` Waits for at least one error to be visible
`protected void`	`waitUntilClosed()`
`protected void`	`waitUntilHidden()`
`protected void`	`waitWhileSubmitting()`

Methods inherited from class com.atlassian.jira.pageobjects.dialogs.JiraDialog
find, find, findAll, findAll, isClosed, isInDOM, isOpen, waitUntilFinishedLoading

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - FORM_SUBMITTING_CLASS
```
public static final String FORM_SUBMITTING_CLASS
```
    See Also:
    
    Constant Field Values
  - loading
```
protected com.atlassian.pageobjects.elements.PageElement loading
```
  - form
```
protected com.atlassian.pageobjects.elements.PageElement form
```
  - header
```
protected com.atlassian.pageobjects.elements.PageElement header
```
  - messages
```
protected FormMessages messages
```
- Constructor Detail
  - FormDialog
```
public FormDialog(String id)
```
  - FormDialog
```
public FormDialog()
```
- Method Detail
  - ready
```
public final void ready()
```
    Called when the dialog is first displayed. Waits util the dialog is ready to work with before exiting.
  - initAbstractDialog
```
public final void initAbstractDialog()
```
    Overrides:
    
    initAbstractDialog in class JiraDialog
  - getAuiMessage
```
public AuiMessage getAuiMessage()
```
  - submit
```
protected boolean submit(com.atlassian.pageobjects.elements.PageElement pageElement)
```
    Do a submit on the passed element. The method will then wait for the response from the server before returning.
    
    Parameters:
    
    pageElement - the page element to submit.
    
    Returns:
    
    true if the dialog is still open.
  - submit
```
protected boolean submit(org.openqa.selenium.By locator)
```
    Do a submit on the passed element found using the passed locator. The method will then wait for the response from the server before returning.
    
    Parameters:
    
    locator - for the element to select.
    
    Returns:
    
    true if the dialog is still open.
  - submit
```
protected boolean submit(String name)
```
    Do a submit on the passed the form element with the passed name. The method will then wait for the response from the server before returning.
    
    Parameters:
    
    name - the name of the element to submit.
    
    Returns:
    
    true if the dialog is still open.
  - escape
```
public void escape()
```
    Closes the dialog by hitting ESC
  - close
```
public void close()
```
    Close the dialog by clicking on the kindly ever-present cancel button.
  - messages
```
public FormMessages messages()
```
  - hasFormErrors
```
public boolean hasFormErrors()
```
    Return true iff the dialog has error messages contained in its associated form.
    
    Returns:
    
    true iff the dialog has error messages contained in its associated form.
  - getFormErrorList
```
public List<String> getFormErrorList()
```
    Return a list of the form errors currently on the dialog.
    
    Returns:
    
    a list of form errors currently on the dialog.
  - waitForFormErrors
```
public FormDialog waitForFormErrors()
```
    Waits for at least one error to be visible
    
    Returns:
    
    this
  - getFormErrors
```
public Map<String,String> getFormErrors()
```
    Return a mapping of the errors currently on the form. The mapping if from parameterName -> error.
    
    Returns:
    
    a mapping from parameterName -> error of all the errors currently on the form.
  - getFormErrorElements
```
public com.atlassian.pageobjects.elements.query.TimedQuery<Iterable<com.atlassian.pageobjects.elements.PageElement>> getFormErrorElements()
```
  - getTitle
```
public String getTitle()
```
  - getTimedTitle
```
public com.atlassian.pageobjects.elements.query.TimedQuery<String> getTimedTitle()
```
  - assertDialogOpen
```
protected void assertDialogOpen()
```
  - assertDialogClosed
```
protected void assertDialogClosed()
```
  - waitWhileSubmitting
```
protected void waitWhileSubmitting()
```
  - waitUntilClosed
```
protected void waitUntilClosed()
```
  - waitUntilHidden
```
protected void waitUntilHidden()
```
  - setElement
```
protected static void setElement(com.atlassian.pageobjects.elements.PageElement element,
                                 String value)
```
  - getDialogElement
```
protected com.atlassian.pageobjects.elements.PageElement getDialogElement()
```
    Overrides:
    
    getDialogElement in class JiraDialog

Class FormDialog

Field Summary

Fields inherited from class com.atlassian.jira.pageobjects.dialogs.JiraDialog

Constructor Summary

Method Summary

Methods inherited from class com.atlassian.jira.pageobjects.dialogs.JiraDialog

Methods inherited from class java.lang.Object

Field Detail

FORM_SUBMITTING_CLASS

loading

form

header

messages

Constructor Detail

FormDialog

FormDialog

Method Detail

ready

initAbstractDialog

getAuiMessage

submit

submit

submit

escape

close

messages

hasFormErrors

getFormErrorList

waitForFormErrors

getFormErrors

getFormErrorElements

getTitle

getTimedTitle

assertDialogOpen

assertDialogClosed

waitWhileSubmitting

waitUntilClosed

waitUntilHidden

setElement

getDialogElement