Custom Attributes Tutorials

Attributes, and the records that custom attributes can be added to, are explained on Custom Attributes. Custom attributes and their lookup lists are created from the attributes interface, for example, Main Menu > Setup > Attributes or Menu button > Edit Attributes.

💡These tutorials explain how to create, edit and delete custom attribute sets and add them to contacts, service tickets and transactions.


Custom Attributes interface, where attribute sets and their items are created
Custom Attributes Interface

How to Create Custom Attribute Sets

  1. Navigate to Edit Attributes (e.g. Main Menu > Setup > Attributes).
  2. Click Add/Edit (button).
  3. Module = Select one of these options from the dropdown list:
    • All
    • Contacts
    • Customers
    • Suppliers
    • Items
    • Assets
    • Transactions
    • Services
  4. Create an Attribute Set (top row left) as follows:
    1. Code = Enter an abbreviation of the description.
    2. Description = Enter a description for the set.
    3. Multiple = Check the box if the attribute set can be added more than once to the same record.
  5. Add Attribute Items to the set. Click the set on the left and complete the fields in the attribute items section on the right as follows:
    1. Key = Enter a descriptive key (lowercase, no spaces). This key makes finding the attribute easier when creating custom actions or reports.
    2. Caption = Enter a descriptive heading for the attribute (e.g. BEE Rating).
    3. Editor = Select what type of answer the user must provide from these options:
      • Text: Any text can be entered.
      • Number (0 Decimals): Only integers can be entered.
      • Number (2 Decimals): A number with two decimals can be entered.
      • Number (4 Decimals): A number with four decimals can be entered.
      • Combobox (Fixed): An answer must be selected from a lookup list.
      • Combobox (Edit): An answer may be selected from a lookup list or entered directly.
      • Checkbox (Y/N): A checkbox. Checked for yes.
      • Lookup SQL: A fixed lookup list is created using an SQL query (which must be added afterwards).
      • Date: Opens a calendar to select a date.
    4. Lookups = If Combobox (Fixed) or Combobox (Edit) is selected, enter the expected answers in the field provided, one entry per line.
      • Note: Check or uncheck the Auto Height box to display or hide the full lookup list. In certain circumstances, the system lets you create lookup lists without first selecting Combobox, but the lookup lists do not work until you select Combobox in the Editor column.
    5. Default Value = Enter a default value for the attribute (optional).
    6. Read Only = Check the box if the attribute must not be edited on the records it is added to (optional).
      • Note: The default value is still filled in.
  6. Repeat Step 5 to add more attribute items to the set (optional).
  7. Click Save (button).

How to Edit a Custom Attribute Set

  1. Navigate to Edit Attributes (e.g. Main Menu > Setup > Contacts > Menu (button) > Edit Attributes).
  2. Click Add/Edit (button).
  3. Edit the fields as needed.
    • Note: Check or uncheck the Auto Height box to display or hide the full lookup list.
  4. Click Save (button).

How to Delete a Custom Attribute Item

  1. Navigate to Edit Attributes (e.g. Main Menu > Setup > Contacts > Menu (button) > Edit Attributes).
  2. Right-click an attribute item on the right and select Delete.
  3. Confirm the deletion on the popup.

How to Delete a Custom Attribute Set

Note
  • All the attribute items on the right must be removed from the set before it can be deleted (see How to Delete a Custom Attribute Item).
  • Sets must be removed from the records to which they were added (e.g. contacts, transactions) before they can be deleted.
  1. Navigate to Edit Attributes (e.g. Main Menu > Setup > Contacts > Menu (button) > Edit Attributes).
  2. On the left in the Sets section, right-click a set and select Delete.
  3. Confirm the deletion on the popup.

How to Add Attribute Sets to a Contact

Info

Fixed attribute sets appear under System. Custom attributes appear under Custom.

  1. Navigate to Contacts (Main Menu > Setup > Contacts).
  2. Right-click the contact you want to edit and select Edit Contact.
  3. Click Edit (button) on the top row if it is not blue.
  4. Click Attributes (tab).
  5. On the right side, click Attributes (button) next to Add/Remove.
  6. Move your mouse over Add and click the Attribute Group you want to add.
  7. Enter the information in the Value column.
  8. Repeat Steps 5-7 to add more attribute groups.
  9. Click Save (button) on the top row.

How to Remove Attribute Sets From a Contact

Note

System attributes cannot currently be removed.

  1. Navigate to Contacts (Main Menu > Setup > Contacts).
  2. Right-click the contact you want to edit and select Edit Contact.
  3. Click Edit (button) on the top row if it is not blue.
  4. Click Attributes (tab).
  5. On the right side, click Attributes (button) next to Add/Remove.
  6. Move your mouse over Remove and click the Attribute Group you want to remove.
  7. Confirm the deletion on the popup.
  8. Repeat Steps 5-7 to remove more custom attribute groups.
  9. Click Save (button) on the top row.

How to Update Modules When Attribute Items Are Edited

  1. Navigate to Edit Attributes (e.g. Main Menu > Setup > Contacts > Menu (button) > Edit Attributes).
  2. Click Actions (button) > Update Attributes on Modules.
    • Note: The attributes are updated and a confirmation message appears.

How to Add or Edit Attribute Sets on a Service Ticket

  1. When editing a ticket, click Menu (button) > View/Edit Attributes.
  2. On the popup:
    1. Click Add (button) and select one of the available attributes.
    2. Enter the required information in the Value column.
    3. Click Save (button).

How to Add an Attribute Set to a Transaction

Info

If an attribute set is selected in the Transaction Type setting General > Default – Attribute Sets, it appears on the transaction automatically.

  1. When editing a transaction, click Menu (button) > View/Edit Attributes.
  2. On the popup:
    1. Click Add (button) and select one of the available attributes.
    2. Enter the required information in the Value column.
    3. Click Save (button).

How to Edit an Attribute Item on a Transaction

Note

Attributes can be edited if the transaction can be edited.

  1. When editing a transaction, click Menu (button) > View/Edit Attributes.
  2. On the popup:
    1. Enter the required information in the Value column.
    2. Click Save (button).

Report an issue with this page

For more useful feedback, select the text on the page you are reporting on, then click Feedback again — or continue without selecting anything.