com.geotab.model.entity.group

Class Group

java.lang.Object

com.geotab.model.entity.Entity

com.geotab.model.entity.NameEntity

com.geotab.model.entity.group.Group

Direct Known Subclasses:

Defect, SecurityClearance, SystemGroupBase

public class Group
extends NameEntity

A group is one element in a hierarchical tree. Each group can have none or many children, it is the children that define the shape of the hierarchical tree. The parent is not a property of the group object and is only defined by who the group is a child of. It is necessary to know the id of the parent group when adding a new group or removing an existing group.

There are three core Group branches used in MyGeotab.

The most common are "Company Groups", company Groups are used to organize entities Zone, User, Device, Driver and Exception Rules into logical groups related to the organization. A Group structure can be constructed by region, vocation, reporting or anything that makes sense to the business, this allows aggregate reports and rolling up data in a flexible way. These groups have a many to many type of relationship with the entities that are members and are not limited to one type of entity.

The second type is "Security Groups", these are Groups to which User(s) are members of and can only be applied to Users. Each Group has a list of SecurityFilter(s) associated to it. Security Filters control what parts of the application/API a User has access to.

The third type of group is a "Private User Group", this group is used only for scheduling ts and displaying dashboard reports for a User. This Group will only ever apply to one User ill typically be named the user's name.

There is a base structure of Groups which cannot be removed, these are considered to be "System"

• RootGroup
• CompanyGroup
• SecurityGroup
• EverythingSecurityGroup
• SupervisorSecurityGroup
• ViewOnlySecurityGroup
• NothingSecurityGroup
• UserSecurityGroup
• DriveUserSecurityGroup
• PrivateUserGroup
• DefectsGroup

When Groups are retrieved they will always be in a flat list of groups. The hierarchically tree(s) can be reconstructed by looking at the "Children" property of each Group. The "Root" group will never be returned and is only for system use.

Nested Class Summary

Nested classes/interfaces inherited from class com.geotab.model.entity.Entity

Entity.EntityBuilder<C extends Entity,B extends Entity.EntityBuilder<C,B>>

Constructor Summary

Constructors

Constructor and Description
Group()

Method Summary

Methods inherited from class com.geotab.model.entity.Entity

addExtraProperty, getExtraProperties, isSystemEntity

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Group

public Group()