The OU write-back feature in the Google Devices integration allows Incident IQ (iiQ) to automatically update a device’s OrgUnit (OU) path in the Google Admin Console based on iiQ filtering conditions (e.g., Role, Grade, Location, Model). This feature supports multi-conditional mappings per OrgUnit path and conditions beyond device location.
Enable OU Write-Back
Navigate to the Google Devices app management page by clicking Incident IQ Apps > Manage in the left navigation bar.
Click Manage on the app listing.
Select the General Settings tab.
Enable the Write orgUnitPath to Google option.
Requirement: Ensure the target OU already exists in Google and that mappings between iiQ conditions and the valid OrgUnit path are correctly established.
Important Note: It is highly recommended that you regularly back up your Chrome Cloud device data. Changes made by write-back options cannot be reverted through Incident IQ. If you have questions about these options, please consult with iiQ Customer Service before enabling them.
Mapping OrgUnit Paths
Once enabled, configure your filters and map your OU write-back options:
Select New Mapping, then select Add Filter.
To remove filters, hover over the filter and click the “x” in the top-right corner.
After configuring the filters, click Save Filters. There is no limit to the number of filters you can add per mapping.
Enter the destination OrgUnit path where devices should be moved during the nightly sync, based on recent changes in iiQ.
Efficiency Tip: If mappings follow a pattern, you can use the Duplicate icon (to the left of the filters) to copy filter conditions and the OrgUnit path. Then, apply necessary modifications to the duplicate.
Note: The duplicate icon only becomes available after the original mapping is saved.
Troubleshooting Mapping Errors
If an error exists within a mapping structure:
A Show Errors button will appear near the top-right of your mapping list, and an information icon will appear to the right of the specific mapping.
Select Show Errors to isolate and display only the incorrectly mapped OrgUnit paths. This highlights exactly which mappings require adjustment or removal.
Excluding Devices
You may choose to exclude specific devices from the write-back functionality:
Click the option underneath the write-back checkbox (as highlighted in your interface).
Once filters are enabled, click Add Filter.
Select the criteria to include or exclude specific devices during the write-back syncs.
Example: You can filter for the /Kiosks OU and exclude it from OU write-back, allowing all other devices in the fleet to continue updating their OUs as needed.