Import UEM users to BlackBerry AtHoc

  1. Log in to the BlackBerry AtHoc management system as an administrator.
  2. In the navigation bar, click Users.
  3. Click Users.
  4. Click More Actions > Import.
  5. Click Browse.
  6. Navigate to the location of the UEM user .csv file on your computer.
  7. Open the file to enter or modify the user data.
  8. 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"

  9. After you have entered your data, save and close the file.
  10. Open and review the file in Notepad or a text editor utility.
    Note: 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.
  11. Review the syntax, and then save the modified file as a .txt file.
  12. Edit the file name and manually change the extension from .txt to .csv.

    The import function requires a .csv file type. This method preserves the formatting in the text file.

  13. Click the filename, and then click Open to upload the file into the system.

    The filename appears in the User CSV File field on the Import User File screen. Each of the columns from the import file are listed in the Select the columns to import section.

  14. Optionally, select Partial User Import Enabled to 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.
  15. Select each of the columns of data you want to import or click Select All.
  16. Review the Columns that cannot be imported field list to make sure it does not contain important data that you must be able to view within BlackBerry AtHoc. If the list contains important columns of information, contact BlackBerry AtHoc Technical Support for help.
  17. Click Import. The Importing Users window opens. The import happens in batches of 5000 users.
  18. While the import is in progress, a Stop Import button 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 BlackBerry AtHoc Manage Users guide.