Managing Collections

Collections (sometimes referred to as Cross-Tenant Collections) are a means of granting users access to a set of devices in a highly configurable manner. They can contain individual devices, groups and even entire tenants.

You can also create a publicly accessible map for the group of devices, to share on a blog or social media, for example.

These activities require the View Collections and Manage Collections permissions.

Adding Collections

1. From the GAP Admin home page, click "Collections" under the "Tenants" section.

2. Click the "+ New Collection" button.

3. Enter a name for the collection in the "New collection name" text box.

4. Select a tenant in which the collection will reside from the "Tenant" drop-down list.

5. Click the "Create New Collection" button.

6. Click the "Manage Devices" button.

7. To add devices to the Collection, select them using the check boxes next to each device in the bottom table and click the "+ Add Selected" button. To add all devices listed, click the "+ Add All" button. You can use the "Search in all columns" text box to search for devices by device friendly name or assigned user name.

8. To add groups of devices to the Collection, click the "Groups" tab in the bottom table. Select the groups you want to add using the check boxes next to each group and click the "+ Add Selected" button. To add all groups listed, click the "+ Add All" button. You can use the "Search in all columns" text box to search for groups by name. You can view the group's membership using the > icon next to the check box.

9. All devices in a tenant may be added to the collection by clicking on the "Tenants" tab. Select the tenants you want to add using the check boxes next to each group and click the "+ Add Selected" button. To add all tenants listed, click the "+ Add All" button. You can use the "Search in all columns" text box to search for tenants by name. Use the "Include subtenants" check box at the top of the screen to include all existing and any future new sub-tenants for the selected tenants in the membership of the collection.

10. Click the "Save Changes" button.

11. After adding devices, groups and / or tenants, click the "Users" tab.

12. Click the "Manage Users" button.

13. To assign users to the Collection, select them using the check boxes next to each user in the bottom table and click the "+ Add Selected" button. To add all users listed, click the "+ Add All" button. You can use the "Search in all columns" text box to search for devices by user name, e-mail address or user role.

14. Click the "Save Changes" button.

Editing Collections

1. From the GAP Admin home page, click "Collections" under the "Tenants" section.

2. Click on the name of the collection you wish to edit.

3. To change the membership of the collection, click the "Manage Devices" button.

4. Amend the collection membership, as described in Adding Collections steps 7 - 10.

5. Amend the collection assignment, as described in Adding Collections steps 12 - 14.

6. To rename the collection, click "Rename" next to the collection name.

7. Enter a new name into the "Collection Name" text box and click the "Save" button.

Deleting Collections

1. From the GAP Admin home page, click "Collections" under the "Tenants" section.

2. Click on the name of the collection you wish to delete.

3. Click the "Delete Collection" button.

4. Click the "Delete Collection" button at the confirmation dialog.