# Get Chromebooks
# Overview
The Get Chromebooks functionality is the core way that you will interact with Chromebook Getter. By using this function you will have the option to get a single organizational unit or an organizational unit and all its child organizational units.
# How To Use
- Add-ons -> Chromebook Getter -> Chromebook Actions -> Get Chromebooks
- Use the Dropdown menu to choose the organizational unit you need Chromebook data for.
- If needing child organizational units select the check box.
- Press blue 'Get Chromebooks' button or 'Download Icon'.
- Depending on how many devices you have, this could take a couple of minutes. Grab some coffee and come back. A dialog box will let you know when data is ready.
# Look Under The Hood
function multipleOrgGet(orgToGet: string, getSubOrgs: boolean = false) {
try {
// https://issuetracker.google.com/issues/63418725
const RemoveFirstSlash: string = orgToGet.substring(1)
const chromebooks: GoogleAppsScript.AdminDirectory.Schema.ChromeOsDevices[] = []
let OrgsAndSubOrgs: GoogleAppsScript.AdminDirectory.Schema.OrgUnit[]
if (getSubOrgs === true) {
const ParentOrg = AdminDirectory.Orgunits.get(CUSTOMER, [RemoveFirstSlash])
const ChildrenOrgs = AdminDirectory.Orgunits.list(CUSTOMER, {
type: ALL,
orgUnitPath: ParentOrg.orgUnitId
}).organizationUnits
if (ChildrenOrgs && ChildrenOrgs.length > 0) {
OrgsAndSubOrgs = [ParentOrg, ...ChildrenOrgs]
} else {
OrgsAndSubOrgs = [ParentOrg]
}
} else {
// HANDLE MAIN ORG
if (!RemoveFirstSlash) {
OrgsAndSubOrgs = [{ orgUnitPath: '/' }]
} else {
OrgsAndSubOrgs = [AdminDirectory.Orgunits.get(CUSTOMER, [RemoveFirstSlash])]
}
}
buildDataSheet(
chromebooks
.concat(...OrgsAndSubOrgs.map(orgUnit => getChromebooksInOrg(orgUnit.orgUnitPath)))
)
} catch (error) {
ERROR_MESSAGE(error)
}
}
# Video Walkthrough
COMING SOON
# Screen Shot
# Known Issues
# My Sidebar says 'Loading'
- Ensure your district web filter has the following url unblocked
https://cdn.jsdelivr.net/npm/vue/dist/vue.js
- Ensure that you are a domain super admin.
- Uninstall Chromebook Getter and close your web browser, reinstall Chromebook Getter.
# Recent Users Only Shows The Last User
- chromebookinventory showed me all of the last users?
- This is known by the core team, we have no plans to change this funcationality currently. (7/20/2019)
# Exception: tha data validation rule has more items than the limit of 500. Use the "List from a range" criteria instead.
This error only happens for users with over 500 org units.This issue is caused by a hard limit of app script data validation rules having a limit of 500.We are looking into a fix for this issue (7/25/2019)Patch Issued (8/1/2019) bypassing features for users with more than 500 orgs.- Issue resolved for all users (8/17/2019)
# Certain Organizational Units Will Not Pull Data or Say No Data
We are currently investigating this issue and have been able to recreate this issue locally. (7/20/2019)- Resolved (7/24/2019)