Dialog Boxes

Page ID: (AU201040)

On this page, you configure the dialog boxes that are displayed when a user performs particular actions on the form. In a dialog box, the user enters settings and clicks buttons to perform the applicable action and change the state of the entity associated with the form.

Tip: You open the Dialog Boxes page by clicking Dialog Boxes under the screen ID (of the form for which you are adding or modifying dialog boxes) in the navigation pane of the Customization Project Editor. In the name that appears on the page, Dialog Boxes is preceded by the form ID and then the form name in parentheses.

Page Toolbar and More Menu

The page toolbar includes standard buttons and page-specific buttons and commands. For the list of standard buttons, see Page Toolbar. The page-specific commands can be shown as buttons on the page toolbar, as commands on the More menu, or in both places. These commands are listed in the following table in alphabetical order.

Command Description
Preview Dialog Box

Gives you the ability to preview the selected dialog box.

View Changes

Opens the Changes dialog box, which you use to view the changes in the dialog box.

This command is available only if the selected dialog box is inherited—that is, based on a predefined dialog box.

Table 1. Changes Dialog BoxYou use this dialog box, which opens when you click View Changes, to view the source code of the dialog box; the changes to the currently selected element are highlighted in red. The dialog box also contains the following buttons.
Button Description
Revert Changes

Returns the dialog box to the predefined state.

This button is available if you have made changes to the dialog box.

Close

Closes the dialog box.

Dialog Boxes Pane

The Dialog Boxes pane (the left pane of the page) contains the list of dialog boxes. In the table, you select a dialog box, and then you view its settings in the Settings pane (the right pane of the page). The table has a single column: Dialog Box Name.

The table toolbar includes only standard buttons. For the list of standard buttons, see Table Toolbar.

You add a new dialog box by clicking Add Row on the table toolbar. In the dialog box that is opened, you specify the name of the dialog box and click OK.

Summary Area

The Summary area, located in the right pane, contains the summary settings of the dialog box.

Element Description
Title

The name of the dialog box as it is displayed in MYOB Acumatica.

Dialog Box Name

A read-only box that contains the internal name of the dialog box.

Status

A read-only box that indicates the status of the dialog box, which can be one of the following:

  • Inherited: A system dialog box
  • New: A dialog box that you have created
  • Modified: A system dialog box that you have modified
Number of Columns

The number of columns in which fields are arranged in the dialog box.

Actions

The action or actions that cause the system to display the dialog box.

Dialog Box Fields Table

The Dialog Box Fields table displays the list of fields corresponding to the dialog box selected in the Dialog Boxes pane.

Table 2. Table Toolbar

The table toolbar includes standard buttons and buttons that are specific to this table. For the list of standard buttons, see Table Toolbar. The table-specific buttons are listed below.

Button Description
Combo Box Values Opens the Combo Box Values dialog box, in which you can configure the values displayed for the field selected in the Dialog Box Fields table.
Table 3. Table ColumnsThis table lists the fields in the dialog box that is selected in the Dialog Boxes pane. The columns are described below.
Column Description
Active

A check box that indicates (if selected) that the element corresponding to the selected field is displayed in the dialog box.

Schema Field

The database field selected as the schema for the field.

In this column, you can also select fields that correspond to the following types of elements: a check box, a combo box, and a box with rich text editor support.

Field Name

The internal name of the field.

Title

The name of the element that is displayed in the dialog box.

From Schema

A check box that indicates (if selected) that the field value from the database should be used.

Default Value

The value that is displayed for the field by default.

Required

An indicator of when the element corresponding to the field is marked as required in the dialog box.

By default, the column is empty, indicating that the element is never required. If the column is not empty, it can contain one of the following:

  • True: The element is always marked as required.
  • False: The element is never marked as required.
  • Condition: The condition that causes the element to be required if it is met. If any conditions are specified on the Conditions page for the applicable screen, they became available for selection in the column.
Hidden

The condition under which the element corresponding to the field is not displayed in the dialog box.

By default, the column is empty, indicating that the field is always visible. If the column is not empty, it can contain one of the following:

  • True: The element is always hidden.
  • Condition: The condition that causes the element to be hidden if it is met. If any conditions are specified on the Conditions page for the applicable screen, they are available for selection in this column.
Column Span

The number of columns spanned by the element corresponding to the field.

Control Size

The width of the grid column.

Status

The status of the field, which can be one of the following:

  • Inherited: A system field
  • New: A field that you have added
  • Modified: A system field that you have modified
Table 4. Combo Box Values Dialog BoxThis dialog box opens if you click a field in the Dialog Box Fields table and then click Combo Box Values on the table toolbar. You can then specify the source of the values of the field you have selected. If the source is explicitly specified values, you can enter the values in this dialog box.
Element Description
The Summary area of the dialog box contains the following element.
Source of Values

The source of the values for the field, which can be one of the following options:

  • Take from Source State (default): The values from the source state of the transition are used.
  • Take from Target State: The values from the target state of the transition are used.
  • Specify Explicitly: The system uses the values specified in the table in this dialog box. If you select this option, the table with the dialog box values appears in the dialog box.

This table contains the values of the combo box of the selected field, which appears if Specify Explicitly is selected as the source of the value.

The table toolbar includes only standard buttons. For the list of standard buttons, see Table Toolbar.

The table has the following columns.

Active

A check box that indicates (if selected) that the current value is available for the field that was selected in the Dialog Box Fields table.

Value

The internal name of the field value.

Description

The display name that will be shown in the drop-down box for the selected field.

This dialog box has the following buttons.
OK

Closes the dialog box and applies the changes.

Cancel

Closes the dialog box without applying any changes to the combo box values of the selected field.