Using Hierarchy Attributes

Attributes allow you to add custom, descriptive properties to individual hierarchy levels (nodes)–such as alert addresses, email lists, and timezones. When you apply an attribute to a hierarchy level, all members of that level (vehicles, drivers, landmarks and/or users) are automatically assigned to that attribute.

Example
Company XYZ has several dispatch facilities in Arizona and Minnesota. XYZ’s owner wants to specify an email list and a timezone for both facilities so that he can schedule reports that are formatted according to the proper timezone and are automatically sent to the email distribution list per facility.

To create and assign a timezone hierarchy attribute:

From the portal, click the Account menu, click Manage Hierarchy, and click Describe with attributes.

The Manage Attributes page opens in a new browser tab.

At the bottom of the Attribute Definitions grid, click Attribute next to Create New.

From the Assign Hierarchy Node Attributes grid, choose the Hierarchy Tree to which this attribute applies. In the Company XYZ example, we chose the “Company XYZ” hierarchy, which has levels for Arizona and Minnesota.

Click Go.

For each node in the selected hierarchy, choose the attribute value (e.g., Timezone) that you want to apply. Values are automatically saved when you either make a selection (for pre-defined lists) or click/tab outside of the field (for text entry).

In the Company XYZ example, we also need to set up an Email attribute so that we can designate the email addresses per hierarchy node for where we want to send scheduled reports. Let’s create another one in the next set of steps.

To create and assign an email hierarchy attribute:

From the the Manage Attributes page at the bottom of the Attribute Definitions grid, click Attribute next to Create New.

From the Assign Hierarchy Node Attributes grid, choose the Hierarchy Tree you want to use. In the Company XYZ example, we chose the “Company XYZ” hierarchy, which has levels for Arizona and Minnesota.

Click Go.

For each node in the selected hierarchy, choose the attribute value (e.g., email address) that you want to apply. You can specify one or more email addresses per entry (separated by commas). Values are automatically saved when you either make a selection (for pre-defined lists) or click/tab outside of the field (for text entry).

Now you can use this attribute on a scheduled report or alert whenever you filter the vehicle list using one of the nodes in your hierarchy. In the following example, when scheduling a fleet utilization report based on Company XYZ vehicles, the timezones in the report will be formatted according to what was specified when applying the attribute, and the report will be sent to the email addresses set up in the hierarchy.

Email hierarchy attributes can also be used when setting up alerts for automatic escalation: