Attributes

Ground Traffic Control allows the utilization of attributes to filter down report results. An attribute is a characteristic that can be assigned to one or more assets, creating customizable groups.

Pre-defined groups of attributes can be put into an Attribute Filter, which will function like selecting a specific attribute in any Ground Traffic Control report that supports this kind of filtering.

Attribute Filtering logic has been updated to reflect an “AND/OR” filtering. Previous filtering was simply “AND” logic. If you continue to use filtering as you have before, it will function as you expect.

Attributes function on “AND/OR” logic, which means, when filtering, if you select more than one Attribute, the returned assets may meet one or more selected attributes in the returned results. In the example chart, there are two assets with different attributes. Here are some scenarios to help explain how Attributes and Attribute Filters work:

Scenario 1	Filter with “Dump Truck” attribute filter and one asset (The Dump Truck) will be returned in the results.
Scenario 2	Filter with “Service Truck” attribute filter and one asset (The Service Truck) will be returned in the results.
Scenario 3	Filter with “Highway” attribute filter and two assets (Dump Truck & Service Truck) will be returned in the results.
Scenario 4	Filter with “Dump Truck” & “Service Truck” attributes and two assets will be returned (Dump Truck & Service Truck) because each contains one or the other attribute.

Example Chart

Asset Type	Dump Truck	Service Truck
Dump Truck Attribute	X
Service Truck Attribute		X
Highway Attribute	X	X

Attributes can be grouped into pre-defined “Attribute Filters” which function the same as filtering based on one or more attributes. Filters of attributes provide a consistent reporting and can also provide user-specific privacy. Filters can be associated with users and those users can only see assets that meet the specified Attributes.

Manage Attributes

Managing Attributes allows the creation, modification, and deletion of attributes. Manage Attributes also allows the creation, modification, and deletion of Driver Groups. To access the Admin Attributes screen, from the main menu click Manage, then go to System Settings and click Attributes.

Manage Attributes for	Select which attributes should be listed:
	Asset Attributes: Attributes used in conjunction with assets and filtering reports.
	Driver Groups: Drivers can be grouped for reporting and filtering, select this option to customize those groups.
Edit Add Delete	Click Add to start adding a new attribute at the currently selected level. Asset Attributes is the default level. With an attribute Parent or Child selected, click the Edit button to edit its properties or Delete to delete it from the list.
Bus Fleet	This level of Attribute is considered a Parent, which is a container for similar attributes. When used in filter reports, they do not affect the results. These are for organizational purposes only. The name of the parent attribute can be any number of things, Bus Fleet is used only as an example.
White Fleet	This level of Attribute is considered a Child; the child level affects search results. The name of the child attribute can be any number of things, White Fleet is used only as an example.

Add Attribute

Select the parent attribute for the new attribute(s) being created.
Click Add at the top of the page.

If an attribute is still a child, selecting the attribute and creating a child under it will convert that attribute to a parent.
Enter the name of the new attribute and then either click Add to return to the Manage Attributes page, or click Add Another, which will add the new attribute and leave the pop-up open, continuing to add new attributes to the originally selected parent.

Edit Attributes

Select the attribute to be edited.
Click Edit at the top of the page.
Change the attribute name, and then click Edit.

Delete Attributes

Select the attribute to be deleted.
Click Delete at the top of the page.
If there is more than one assigned resource to the attribute, a caution dialogue will appear, asking for confirmation to delete the attribute.

While it is possible to delete an attribute that has been assigned to a resource, it will be required to manually re-assign the resource should the attribute be inadvertently deleted.

It is not possible to delete a parent attribute. Delete all children attributes prior to attempting to delete a parent.

There is no way to undo the deletion of an attribute.

Driver Groups

After selecting Driver Groups from the drop down in the filters and clicking Apply, the list of driver groups will be displayed.
Driver groups allow for grouping of drivers throughout Ground Traffic Control. Quickly filter a list of drivers or restrict users from seeing specific groups of drivers when running reports. It is possible to only have one level of groups, children of a group cannot be created, the Add button will be grayed out if a child of Driver Groups is selected.

Asset Attributes

To access the Asset Attributes screen, from the main menu click Manage, then go to Assets and click Asset Attributes. Asset Attributes allows the assignment of attributes to resources. There are two steps for assigning the attributes:

Step 1	Select one or more assets to assign attributes to.
Step 2	Select the attributes to assign.

Quick Find Tool	Type the asset name in the top left box to filter down the list. The list automatically filters as you type but only returns whole phrases.
Asset List	Assets not selected are in this list. Clicking on the asset name will add it to the selected assets list.
Selected Assets	Assets that will be affected in step two are listed in this column. To remove an asset, click on it in the list.
Modify Attributes	There are two types of attributes that can be assigned to an asset—User Defined and System. User Defined are those created in the Manage Assets section. System attributes are those related to system functions, such as the assets icon when displayed on a map.
Add/Edit	To simply add attribute assignments to an asset, select the Add Asset Attributes radio button. Adding will only append the current assigned attributes. Selecting Edit Asset Attributes will allow the addition of attribute assignments but will also allow the removal. Using this option will also allow the re-assignment of attributes across multiple assets, ensuring they are all identically assigned.

Once the assets have been selected and the options chosen, clicking the Go button will open up step two.

Reset	Clicking reset will remove any changes already made to the attributes assigned to a resource.
Attribute List	Select each asset from the list that should be assigned to the resource. The currently assigned attributes will be checked. If a child attribute is selected, its direct and successive parents are also selected. In order to unselect a parent, all children must first be unchecked.
Clear All	This will remove all attribute assignments for the selected resources including previously assigned attributes.
View	Clicking on view will open a tree, displaying each of the assigned attributes. If more than one asset is selected in step one, a selection drop down will be available at the top to view each asset’s assignment.

Save	Once the attribute assignments have been updated, clicking save will commit the changes.
Options	Clicking Show Options will open an options tray that allows copying of current assets attribute assignments or pre-defined attribute filters. Select either Assets or Filters and then the source for copying. Clicking copy will apply those attribute assignments to the selected assets. The changes are not saved until you click Save.

Bulk Attributes Update

To access the Asset Attributes screen, from the main menu click Manage, then go to Assets and click Asset Attributes. Bulk attributes update allows users to bulk update the attributes that are assigned to an asset via a Comma Separated Values (CSV) import. Here are the steps for bulk updating the attributes:

Step 1	Download a CSV containing a list of the account’s active assets and their assigned attributes.
Step 2	Important! As a best practice, save a copy of the downloaded CSV with a different file name so that you have a user backup.
Step 3	Edit the CSV and save it.
Step 4	Choose the CSV file that you edited and load it to bulk update the asset attributes.

To use this feature, you must be able to access the Asset Attributes page. If you still cannot see it, contact Zonar Customer Care so they can enable it on your account. Scroll to the bottom of the Asset Attributes screen to see the Upload option.

Download CSV: Click to download a list (in CSV format) of the active assets and assigned attributes for this account.
Browse: Click Browse to select a completed .CSV file to upload.
Load File: Click to upload the CSV file that you edited and bulk update the asset attributes.

Here is an example of a downloaded CSV with the asset attributes.

Column header (top of list)	Do not modify this information (usually row 1).
Asset Id	The import is actually based on the information in this column, NOT the Asset Name or Asset Type – those columns only exist to help you make sure that you are manually updating the right asset.
Root	This column represents the top level attributes with no children. Each parent is represented by a column. You can update multiple attributes (in one column) for the same parent by using the standard “pipe” character (vertical bar) as a separator, for example, PTO Enabled\|Blue if Blue was a valid top level attribute.

Sometimes leading zero values are required in a CSV and while the leading zeros are present in the data they are not displayed. Watch for cells that need to start with a 0 but are strings/keys etc. and correct them as necessary.

Attribute Filters

Attribute Filters create a custom, pre-configured set of Attributes. When running reports throughout Ground Traffic Control, it is possible to filter based on one or more attributes by selecting them individually, filters allow for a pre-defined set of attributes. These filters can also be applied to users, so those users are only able to see resources that have the specific attributes assigned to them. To access the Asset filters screen, from the main menu click Manage, then go to System Settings and click Attribute Filters.

Select Attribute Filter	To edit or delete an existing filter, select it from this drop-down.
Controls	Add, Edit, and Delete an attribute filter.
Clear Attributes	This button will uncheck all attributes for the selected filter.
Change Filter Owner	Quickly change the selected filter’s owner by selecting a Ground Traffic Control user from the drop-down.
Save	After changing the selected attributes for the selected filter or changing the owner, clicking save will commit the changes.
Attribute Filters	When a filter is selected in the drop-down, the attribute will be checked in the list. Add or remove attributes in the list by clicking on their check boxes.

Add Attribute Filter

Clicking on the plus icon at the top will open the Add Attribute filter pop-up.

Enter the name of the filter and select the filter owner. By default, the logged in user is the owner selected but any Ground Traffic Control user can be selected from the drop-down.

By default, the Make Public check box is checked. If this box is unchecked, only the Filter Owner specified in the drop-down will be able to see the filter in reports.

Ground Traffic Control only supports attributes for assets, ensure that the asset check box remains checked. Once the information is selected, click Add to add this filter and close the pop-up or click Add Another to save these changes and leave the pop-up open.

Edit Attribute Filter

Choose the attribute filter that is to be edited from the Select Attribute Filter drop-down at the top.
Click the pencil icon to open the edit pop-up.
Edit the information that needs to be changed and click Edit to save the changes.

Delete Attribute Filter

Choose the attribute filter that is to be deleted from the Select Attribute Filter drop-down at the top.
Click on the minus icon to the right of the drop down. A confirmation pop-up will display, click Delete to remove the filter.

Deleting a filter is permanent; there is no way to undo the deletion.