Fields

Page ID: (AU201060)

For a particular screen (that is, a form in MYOB Acumatica), you use the Fields page to add existing fields to the customization project and modify the properties of these fields.

Tip:
You open the Fields page by clicking Fields under the screen ID (of the form for which you are modifying the field’s properties) in the navigation pane of the Customization Project Editor. In the name that appears on the page, Fields 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
Combo Box Values

Opens the Combo Box Values dialog box. In this dialog box, you can configure the list of values for fields that are displayed as combo boxes. The command is available only if you have selected this type of field.

View Changes

Opens the Changes dialog box, where you can view the description of the selected field in JSON format. If any changes have been applied to the predefined field, they are highlighted in the dialog box. You can return the field to the predefined state by clicking Reverse Changes in the Changes dialog box.

Note:
The View Changes command is available only if the field has the Inherited status.
Table 1. Add Field Dialog BoxThis dialog box opens when you click Add New Row on the page toolbar. In this dialog box, you can use the elements of the Selection area to narrow the range of the fields listed in the table. You then select the Included check box for each field you want to add and click the appropriate button to add the fields to the page.
Element Description
The dialog box has a Selection area with the following elements.
Container

The form container where the box for the field is located. If you select a container in this box, the table lists only the rows of the fields in the container, and the DAC box is filled in automatically with the corresponding DAC.

DAC

The DAC that contains the field. If you select a DAC in this box, the table narrows the range of listed rows to display the fields of the DAC.

Field Name

The internal name of the field to be added to the customization project. The system lists the available values of the DAC selected in the DAC box.

Display Name The read-only name of the field that is selected in the Field Name box. This name will be displayed on the applicable MYOB Acumatica form.
The dialog box contains a table with the following columns. The table lists the fields that meet any selection criteria you have specified in this dialog box.
Included

A check box that you can select to add the field to the table on the page.

The check box is also selected if the field has already been added to the table.

Container

The form container where the box for the field is located.

DAC

The data access class from the container that is selected in the Container box. The system inserts this value automatically if you are manually adding the row.

Field Name

The internal name of the field that can be added to the customization project.

Display Name

The name of the field that will be displayed on the applicable MYOB Acumatica form.

This dialog box has the following buttons.
Add

Adds the selected field or fields to the table on the page without closing the dialog box.

Add & Close

Adds the selected field or fields to the table on the page and closes the dialog box.

Close

Closes the dialog box without adding any fields to the table on the Fields page.

Table 2. Combo Box Values Dialog BoxThis dialog box opens if on the Fields page, you click a field that is displayed as a combo box on the applicable MYOB Acumatica form and then you click Combo Box Values on the page toolbar. In the dialog box, you can specify or modify the values for the field you have selected.

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

Element Description
The dialog box contains the following columns.
Active

A check box that indicates (if selected) that the current value is active, meaning that it will be available for selection in the combo box on the applicable MYOB Acumatica form.

Custom

A check box that indicates (if selected) that the current value is a user-defined value.

The system automatically selects this check box for the values that you add in the dialog box. The check box is read-only for the default system values.

Value

The internal name of the value.

Description

The name of the value that will be displayed in the combo box on the applicable MYOB Acumatica form.

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.

Table 3. Changes Dialog BoxYou use this dialog box to view the source code of the field; the changes are highlighted in red. The dialog box also contains the following buttons.
Element Description
Revert Changes Returns the field to its predefined state.
Close Closes the dialog box.

Table

This table contains the list of fields and the basic settings of each of them. The columns of the table are described below.

Column Description
Object Name

The data access class that contains the field.

Field Name

The internal name of the field.

Disabled

An indicator of when the field is disabled on the applicable MYOB Acumatica form.

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

  • True: The field is always disabled.
  • Condition: The condition that, if it is met, causes the field to be disabled. If any conditions are specified on the Conditions page for the screen of this field, they are available for selection in this column.
Hidden

An indicator of when the field is hidden on the applicable MYOB Acumatica form.

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 of this field, they are available for selection in this column.
Required

An indicator of when the field is marked as required on the applicable MYOB Acumatica form.

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

  • True: The field is always marked as required.
  • Condition: The condition that, if it is met, causes the field to be required. If any conditions are specified on the Conditions page for the screen of this field, they became available for selection in the box.
Display Name

The name of the field that will be displayed on the applicable MYOB Acumatica form.

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.

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