Attributes
In MYOB Acumatica, you can define attributes for flexible, meaningful classification of leads, opportunities, customers, and inventory items in your company. An attribute is a property (such as age or industry) that enables you to specify additional information for objects in the system. For some entities, attributes are defined in the context of a class, which is a grouping of the business accounts (including leads, opportunities, customers, and cases), projects, and stock and non-stock items by one or more of their properties. For other entities, attributes can be added directly to a corresponding data entry form.
For each class, you can define a list of attributes to gather class-specific information about members of the class; for example, attributes may carry the information about product brand, manufacturer, lead age, gender, or industry. You can use attributes for entities related to the following functionality:
- Customer relationship management: Attributes enable you to define additional elements to store information about individual leads, contacts, cases, opportunities, business accounts, and marketing campaigns. For more details, see Defining Lead Classes, Defining Business Account Classes, Defining Contact Classes, Defining Campaign Classes, Defining Opportunity Classes, and Defining Case Classes.
- Accounts payable: Attributes may be used for storing additional information about vendors. You define a list of attributes on the Vendor Classes (AP201000) form and then fill in attribute values for a vendor on the Vendors (AP303000) form.
- Accounts receivable: Attributes store additional properties of contracts and information
about customers. You define a list of attributes for customers on the Customer Classes (AR201000) form and then fill in attribute values
for particular customers on the Customers (AR303000) form.
For contracts, you use Contract Templates (CT202000) to define the
list of attributes and then use the Customer Contracts (CT301000)
form to fill in attribute values for each individual contract.Note:
Some entities are related, such as a customer and its associated business account, or a vendor and its associated business account. However, an attribute defined on the Customer Classes or Vendor Classes form is class-specific. Therefore, it does not appear for the business account associated with the customer or vendor on the Business Accounts (CR303000) form unless the same attribute is also defined on the Business Account Classes (CR208000) form for the business account class to which the business account belongs. Similarly, an attribute defined for a particular business class does not appear for the associated customer or vendor on the Customers or Vendors form unless the attribute is defined for the customer class or vendor class.
- Inventory: Attributes store additional properties of stock and non-stock items. You define a list of attributes on the Item Classes (IN201000) form for each class, and then you fill in attribute values for individual inventory items on the Stock Items (IN202500) and Non-Stock Items (IN202000) forms.
- Projects: Attributes store additional properties of projects, projects tasks, equipment, account groups, and service contracts. You define a list of attributes on the Project Attributes (PM202000) form.
- Organization: You can use attributes for additional classification of employees. You define a list of attributes on the Employee Classes (EP202000) form and then fill in attribute values for each particular employee on the Employees (EP203000) form.
- Service management: Attributes store additional properties of service orders and appointments. You define a list of attributes for service orders and appointments on the Service Order Types (FS202300) form and then fill in attribute values on the Service Orders (FS300100), Appointments (FS300200), Service Contract Schedules(FS305100), and Route Service Contract Schedules (FS305600) form.
- Equipment management: Attributes store additional properties of equipment and service contracts. You define a list of attributes on the Equipment Types (FS200800) form for each equipment type and on the Project Attributes (PM202000) form for contracts. You then fill in attribute values for equipment on the Equipment (FS205000) form. For service contracts, you use the Service Contracts (FS305700) form to fill in attribute values.
- Route management: You can use attributes to store additional properties of vehicles, route executions, and route service contracts. You define a list of attributes on the Vehicle Types (FS204200) form for each vehicle type, on the Routes (FS203700) form for each route, and on the Project Attributes (PM202000) form for route service contracts. You then fill in attribute values for vehicles on the Vehicles (FS203600) form. For route executions, you fill in attribute values on the Route Document Details (FS304000) form. For route service contracts, you use the Route Service Contracts (FS300800) form to fill in attribute values.
Attributes assigned to an entity are displayed on the Attributes tab of a corresponding data entry form. Also, attributes can be added as boxes to an additional tab (the User-Defined Fields tab) of a data entry form.
Attributes in Classes
A class contains a set of attributes that must be available in any instance of the class. For example, any lead of a given class must contain all the attributes defined for the lead class.
The sets of attributes for specific classes is defined on the following forms:
- Lead Classes (CR207000)
- Contact Classes (CR205000)
- Opportunity Classes (CR209000)
- Case Classes (CR206000)
- Business Account Classes (CR208000)
- Campaign Classes (CR202500)
- Project Attributes (PM202000)
- Item Classes (IN201000)
- Employee Classes (EP202000)
- Vendor Classes (AP201000)
- Customer Classes (AR201000)
- Contract Templates (CT202000)
For each attribute in a given class, you can specify whether the attribute is required. When creating an instance of the class, you must define the values for all the required attributes.
You specify the attributes for a class by selecting the attributes from the attributes available in the system. If you need an attribute that is not available in the system, you can use the Attributes (CS205000) form to create the attribute, as well as any other attributes you may need. Then you will be able to select the new attribute in any class.
You can deactivate an obsolete attribute for a particular entity class by clearing the Active check box for this attribute on the entity class form. In this case, the deactivated attribute will no longer be displayed for records of the class, but all attribute values that have already been specified for existing records still will be stored in the database. If you reactivate the attribute, its values will become visible in the system again. However, if it is not necessary to preserve the data related to an obsolete attribute, you can deactivate the attribute and then delete it by using the Delete Row button on the table toolbar. In this case, the attribute will be permanently deleted from the class and all attribute values will be cleared for the records of the class.
Import of Records with Attributes
When a record with attributes is being imported to the system through an import scenario, an error may occur if the target class of the record does not include any of the attributes specified for the record. If this is the case, you may need to verify whether the attribute is correctly specified in the source record or consider adding the attribute to the target class.
Attribute Types
For each attribute created by using the Attributes (CS205000) form, you need to specify its type, which can be one of the following:
- Text: A text box into which the user can type text
- Combo: A list box that users can use to type or select options
- Multi Select Combo: A list box where users can select multiple options
- Checkbox: A check box users can select or clear
- Datetime: An element for selecting date and time
- Selector: A box with the lookup table in which users can select a record and then set the ID of this record as the value of the box
For a Text attribute, you can specify an input validation rule based on an input mask or a regular expression. Input validation ensures that the entered data is valid and usable. For details, see Examples of the Usage of Masks and Regular Expressions.
For a Combo and Multi Select Combo attribute, you can create a list of possible values, so that the user can select (respectively) one value or multiple values from the drop-down list. You can also specify the order of the values listed.