Import UEM users to BlackBerry AtHoc Skip Navigation

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).
        POSITIONS
        is 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.
    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 guide.