Import UEM users to BlackBerry AtHoc
- Log in to theBlackBerry AtHocmanagement system as an administrator.
- In the navigation bar, clickUsers.
- ClickMore Actions>Import.
- Navigate to the location of the UEM user .csv file on your computer.
- Open the file to enter or modify the user data.
- Ensure that columns with multiple values have the correct format to import correctly.
- The entire entry must be enclosed within double-quotes. This rule is true even if the multi-select picklist has only a single entry.
- A comma must be used to separate each of the values. There can be no spaces before or after the comma.Examples:
- This example shows two column names, separated by a comma (no space before or after the comma).POSITIONSis a multi-select picklist column.USERNAME,POSITIONS
- The next example shows a multi-select picklist attribute column with multiple entries.Cadiz,"ESH Team Tech Supv,FMT Coordinator,SITE 300,Exercise Call Out,Field Monitoring Team,Coordinator DOC"
- The entire entry starts and ends with regular double-quote characters (not the "smart quotes" used by some word-processors).
- Each picklist entry is separated by a comma (no spaces before or after the comma).
- An entry can have a space within it. For example:Field Monitoring Team
- This example shows a multi-select picklist attribute with a single entry.East,"LEDO"
- After you have entered your data, save and close the file.
- Open and review the file in Notepad or a text editor utility.Excel hides some characters from view. If you edit the file in Excel, it might format your entries with extra characters. The incorrect format might cause the import operation to fail.
- Review the syntax, and then save the modified file as a.txtfile.
- Edit the file name and manually change the extension from.txtto.csv.The import function requires a.csvfile type. This method preserves the formatting in the text file.
- Click the filename, and then clickOpento upload the file into the system.The filename appears in theUser CSV Filefield on theImport User Filescreen. Each of the columns from the import file are listed in theSelect the columns to importsection.
- Optionally, selectPartial User Import Enabledto enable partial user data to be imported. When selected, if a user entry contains an invalid value the rest of the user's data is still imported.
- Select each of the columns of data you want to import or clickSelect All.
- Review theColumns that cannot be importedfield list to make sure it does not contain important data that you must be able to view withinBlackBerry AtHoc. If the list contains important columns of information, contactBlackBerry AtHocTechnical Support for help.
- ClickImport. TheImporting Userswindow opens. The import happens in batches of 5000 users.
- While the import is in progress, aStop Importbutton appears on the Importing Users window. Clicking this button stops the import process immediately and prevents the next batch of users from being imported from the file. However, records that have already been added are not removed and records that have been updated are not restored to previous values.
When the import completes, an import summary screen appears, listing the following information:
- Total number of users in the import file
- Total number of users who were processed
- Number of users who were successfully processed
- Number of users who were partially processed
- Number of users who failed to be processed
- Username of the person who imported the file
- Time the file import process started and ended
For more information about managing users in
BlackBerry AtHoc, see the