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 screen ID and then the screen 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

Previews 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
Reverse 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 Advanced.

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.

The status of the dialog box can be one of the following:

  • Inherited: The system dialog box.
  • New: The dialog box that you have created.
  • Modified: The 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 of 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 selected field is displayed in the dialog box.

Schema Field

The database field selected as the schema for the field.

Field Name

The internal name of the field.

Title

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

From Schema

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

Default Value

The value that is displayed for the field by default.

Required

A check box that indicates (if selected) that the current field is marked as required in the dialog box.

Hidden

The condition under which 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 field is always hidden.
  • Condition: The condition that, if it is met, causes the field to be hidden. If any conditions are specified on the Conditions page for the screen that contains this dialog box, they are available for selection in this column.
Column Span

The number of columns the field will span.

Control Size

The width of the grid column.

Status

The status of the field.

The status of the field 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 values for the field you have selected, or specify these values explicitly.
Element Description
The Summary area of the dialog box contains the following element.
Source of Values

The source of the values for the field.

The following options are available:

  • Take From Source State: The values from the source state of the transition are used. This is the default option for a drop-down list in a new dialog box.
  • Take From Target State: The values from the target state of the transition are used.
  • Specify Explicitly: The values are selected in the table in the dialog box.

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

The table with the values of the combo box 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 field.