Important Note: In order to automatically create assets in Incident IQ from the Chrome Console you will need to enable the Create Asset option, as well as have location and models mapped in their respective tabs. Failure to do so can prevent some or all of your assets from importing/updating during scheduled syncs.
The following guide is designed to give district administrators an overview of the following topics:
- Managing what device data is created, updated, and deleted during the Google Device App system syncs
- Setting up model and location mappings
- Reviewing historical system syncs
- Looking up a device's Google data
Not what you were looking for? Perhaps one of these other guides will help:
- Google Device App Installation - A guide designed to provide an in-depth overview of how to install the Google Device App in Incident IQ.
- Managing Incident IQ Apps - A guide designed to provide a brief overview of Incident IQ Apps and how to access app management.
You can use the following links below to quickly navigate to a specific section in this document. To quickly return to this index simply use the "Return to Index" link located at the end of any section.
- App Management Introduction
- Overview Tab
- General Settings Tab
- Assign Users Tab
- Location Mappings Tab
- Model Mappings Tab
- Sync History Tab
- Asset History Tab
App Management Introduction
The Google Device App is designed to give school districts the ability to create, manage, and automatically assign assets to students in Incident IQ by utilizing Google data. In addition, integrating Chrome devices into Incident IQ allows you to view an asset's metadata in one convenient location. This includes basic device information, OS and firmware versions, Google identification, and other data agents may find useful during the course of working a ticket.
When installed, you can access the Google Device App by selecting Incident IQ Apps > Apps Management. This will take you to your Installed Apps page where you can select the Options button to access the Google app management.
The Overview Tab provides allows you to set and review your authentication with Google, as well as provide you basic sync options.
The Status section allows you to quickly determine if your current authentication token is valid and whether or not IIQ can access the devices in Google. If your credentials are invalid, you can easily change the information used to access your console by clicking on the Reset button.
The Sync section allows you to quickly review what occurred during the last scheduled system sync. Clicking on the View Details link will automatically open the last syncs details. Additionally, you can also manually start a sync from here using the Start Sync button.
General Settings Tab
The General Settings Tab allows you to control what devices and device data the Google Devices App will create, update, and delete during system syncs. Additionally, you can also choose what, if any, data changes made in IIQ will be written back into the Google Console.
You can add filters for devices that you do not want to sync with IIQ by using the Filter any property field.
The Mapping section manages what data is created and updated in Incident IQ based on data coming from Google. This includes:
- Create Asset: Selecting this will automatically create assets in IIQ to match any new device discovered in Google during a sync.
- Update Asset: Selecting this will automatically update assets in IIQ to match any updates to a device's data discovered in Google during a sync.
- Delete Asset: Selecting this will automatically delete assets in IIQ to match any assets deletions that have occurred in Google during a sync.
- Create Rooms: Selecting this will automatically create a room at the corresponding location if a room does not already exist prior to a sync.
You can also map any number of values stored in Google to data fields within IIQ. This allows you to easily build custom views and export reports based off of the data pulled from your console.
The Google Options section manages what data is written back from Incident IQ into Google. This includes:
- Write assigned user to Google which will change the assigned user in Google to match the assigned user in IIQ.
- Write assigned location to Google which will change the assigned location in Google to match the assigned user in IIQ.
- Write orgUnitPath to Google which will allow IIQ to update the OU location of a device based upon IIQ location date. Please note, this will only work if the OU already exists in Google and the location mapping has been set between an IIQ location and a valid orgUnitPath.
Assign Users Tab
The Assign Users Tab allows you to manually auto-assign devices to users based on the last user of the device.
This is done by selecting a timeframe from the date field. If the login occurs during this selected time, then the user that logged in will be assigned the as device owner.
Location Mappings Tab
This tab allows you to select or modify your current location mappings between IIQ and the Google Device Data App.
You can choose to automatically assign a device to a default location in Incident IQ if it does not match any location mappings set.
The Custom Mapping Options allows you to choose how you would like devices to map in IIQ.
When either is selected, you will be presented with a list of locations currently in the system. From here, you can select Auto-Map Location Names to match location names between IIQ and Google. Alternatively, you can also manually search for and select your location assignments if needed.
Model Mappings Tab
This tab allows you to select or modify your current model mappings between IIQ and the Google Device Data App.
You can use the Auto-Map Models button to automatically attempt to match models in your list of devices with models that already exist in IIQ.
Alternatively, you can also manually select what model your device should map to using the drop-down menus to the right of each listed device.
If your device will not auto-map and is not available from the drop-down options, then it most likely does not currently exist in IIQ. In this case, simply select the Create New Model button on the right of the device mapping in question to automatically create and activate this model during your data sync.
Sync History Tab
This tab allows you to view your sync history between IIQ and the Google Device Data App.
Every sync, whether it completed successfully or not, is logged for reference purposes and available for review in the View details of a sync list.
Clicking on any sync, in particular, will open that sync's details. From here, you can review the full list of what devices were updated, created, deleted, or skipped during the sync. Additionally, you can narrow down your view by using the filter options at the top of the list.
Asset History Tab
The Asset History tab allows you to search for basic information on any device currently located in your Google Console.
Simply enter in a valid serial number in the Search for asset field to begin your search.
Once you've selected a device, you'll be able to see the following Google information:
- External ID
- Owner Email
- Organizational Unit
- Serial Number
- Location Name
Additionally, you'll also see a list of actions applied to this device during recent system syncs.