Conditions

Page ID: (AU201000)

You use the Conditions page to construct a condition that can later be specified as a property value for the following items on a particular screen (that is, a form in MYOB Acumatica):

  • A UI control
  • An action, including an auto-run action
  • Transition
Tip:
You open the Conditions page by clicking Conditions under the screen ID (of the form for which you are constructing the condition) in the navigation pane of the Customization Project Editor. In the name that appears on the page, Conditions: is followed by the form ID and then the form name in parentheses.

Page Toolbar

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

Condition Properties Dialog Box

This dialog box opens when you click Add New Record on the page toolbar of the Conditions page, or when you click a link of an existing condition in the Condition Name column of the table on the page.

This dialog box shows the rows that make up the condition. You can add new rows and modify existing rows of the conditions that you have created previously.

Table 1. Condition Properties Dialog Box: Summary Area
Element Description
Condition Name

The name of the condition.

Append System Condition

A check box that indicates (if selected) that a predefined condition will be used along with the condition specified in the table.

System Condition

The predefined condition that will be used along with the condition specified in the table.

This box is available only if you select the Append System Condition check box.

Operator

The logical operator to join the system condition specified in the System Condition box and the condition specified in the table in a logical expression. Possible values are And or Or.

This box is available only if you select the Append System Condition check box.

Table 2. Condition Properties Dialog Box: Table

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

Column Description
Active

A check box that indicates (if selected) that the row is an active condition.

Brackets

The opening bracket or brackets for composing a logical expression with multiple conditions.

Field Name

The field to whose value the condition should be applied.

Condition

The logical condition that will be applied to the value of the field specified in the Field Name box and the values in the Value and Value 2 fields, if applicable.

One of the following logical conditions should be selected:

  • Equals: Returns TRUE if the field value is equal to the value specified as Value.
  • Does Not Equal: Returns TRUE if the field value is not equal to the Value value.
  • Is Greater Than: Returns TRUE if the field value is greater than the Value value.
  • Is Greater Than or Equal To: Returns TRUE if the field value is greater than or equal to the Value value.
  • Is Less Than: Returns TRUE if the field value is less than the Value value.
  • Is Less Than or Equal To: Returns TRUE if the field value is less than or equal to the Value value.
  • Is Between: Returns TRUE if the field value is between the Value and Value 2 values. (For this option, you must specify both Value and Value 2.)
  • Contains: Returns TRUE if the field value (string) contains the Value value.
  • Does Not Contain: Returns TRUE if the field value (string) does not contain the Value value.
  • Starts With: Returns TRUE if the field value begins with the Value value.
  • Ends With: Returns TRUE if the field value ends with the Value value.
  • Is Empty: Returns TRUE if the field value is empty (null).
  • Is Not Empty: Returns TRUE if the field value is not empty (not null).
From Schema

A check box that indicates (if selected) that in the Value and Value 2 columns, you can select one of the predefined values of the field selected in the Field Name column (for example, a document type or a document status).

Value

The value to be used in the selected condition. You can select a field, or you can click the Edit button to open the Formula Editor dialog box and create a formula.

For the date-related data fields, you can use the date-relative parameters either by selecting the parameter in the Calendar dialog box (if the field is based on a schema field and the From Schema check box is selected) or by using the date-relative parameter in a formula (if the field is not based on a schema field and you use the formula editor). The following date-relative parameters are available:

  • @Today: The business day.
  • @WeekStart and @WeekEnd: The start and end, respectively, of the current week. The start and end of the week are determined according to the default system locale or the locale the user has selected when signing in to MYOB Acumatica. The system locales are specified and configured on the System Locales (SM200550) form.
  • @MonthStart and @MonthEnd: The start and end, respectively, of the current month.
  • @QuarterStart and @QuarterEnd: The start and end, respectively, of the current quarter.
  • @PeriodStart and @PeriodEnd: The start and end, respectively, of the current financial period. The financial periods are defined on the Financial Year (GL101000) form.

    For more information on financial periods in MYOB Acumatica, see Managing Financial Periods.

  • @YearStart and @YearEnd: The start and end, respectively, of the current calendar year.
Tip:
All the date-relative parameters use the date (in UTC) of the server used to run the MYOB Acumatica instance as the current date.

Additionally, you can modify the date-relative parameters by adding or subtracting integers. The unit of measure of the parameter is determined automatically and the reference point is moved according to the measurement of the parameter—for example, @WeekStart+1 relate to the start of the next week.

You can use the following company-related parameters to filter records or show values that depend on a branch or a company selected by a user in the Company and Branch Selection menu:

  • @branch: The branch specified for an entity
  • @company: The company specified for an entity

You can also use the following user-relative parameters for the workgroup-related data fields with the Is In or Is Not In condition:

  • @MyGroups: The workgroups in which the current user is a member, excluding the workgroups that are the subordinates of these workgroups
  • MyWorktree: The workgroups in which the current user is a member, including the groups that are subordinates of these groups according to the tenant tree structure
Value 2

The second value to be used, if the selected condition requires another value. You select a field, or you click the Edit button to open the Formula Editor dialog box and create a formula.

For the date-related data fields that are not based on a schema field (that is, the From Schema check box is cleared), you can use one of the date-relative parameters, as described in the previous description.

Brackets

The closing bracket or brackets for composing a logical expression with multiple conditions

.
Operator

The logical operator to join conditions in a logical expression, which can be And or Or.

Table 3. Condition Properties Dialog Box: ButtonsThe dialog box includes the following buttons.
Button Description
OK

Adds the condition to the list of conditions on the page or updates the existing condition; closes the dialog box.

Cancel

Closes the dialog box without making any changes.

Table

The table on the page displays the conditions added in the predefined workflow and the conditions that have been added in previous versions of MYOB Acumatica.

Table 4. Table Columns
Column Description
Condition Name

The internal name of the condition. When you click the name of the user-defined condition, the Condition Properties dialog box is opened, which shows the properties.

Expression

The short version of the condition that you have constructed in the table of the Condition Properties dialog box.

Status

The status of the condition, which can be one of the following: System Read-Only, Inherited, or New.

Table 5. Shortcut Menu

If you right-click within the rows of a table, the system opens a shortcut menu. The commands you see in the menu are duplicates of actions on the table toolbar and are listed below.

Command Description
Refresh

Refreshes the data in the table.

Delete

Deletes the selected row.