Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry AtHoc
  3. 7.18
  4. Operator Roles and Permissions
  5. Importing and exporting operators
  6. Import operators using a CSV file

Import operators using a CSV file

When you import operator details into
BlackBerry AtHoc
 using a CSV file, the values that exist in the CSV file overwrite any existing values in the database. If the file contains blank fields, the current values in the database are replaced by empty values. You should make sure that all required fields are populated before you upload the file.
To import operators from a file, the file must be correctly formatted. If you do not know how to format the file, see Format an operator import file.
If duplicate operators (identified by username or mapping ID) are found in the CSV file, they are not imported and one of the following error messages is displayed:
[Username]: <username> already exists in the payload
[Mapping ID]: <mapping id> already exists in the payload
The remaining non-duplicate operators in the CSV file are imported.
If a username contains a space or one of the following characters, the user is not imported and an error message is displayed:
[ ] : : | = , + * ? < >
Leading or trailing spaces are ignored and trimmed during the import process. After the spaces are trimmed, the username is accepted and the operator is imported.
  1. In the navigation bar, click
    Users
     >
    Users
    .
  2. On the
    Users
     screen, click
    More Actions
     >
    Import
     >
    Operators
    .
  3. Optionally, to download a blank CSV file to use as a template for your import operator file, click the
    Download a template CSV file
    . Save the file to your computer and fill in the appropriate operator information.
    Using the template ensures that all of the mandatory attribute columns are included in the import file.
  4. Click
    Browse
    .
  5. Navigate to the location of the import operator file on your computer.
  6. Open the file to enter or modify the operators' data.
    Microsoft Excel hides some characters from view. If you edit the file in
    Microsoft
     Excel, it might format your entries with extra characters. The incorrect format might cause the import operation to fail. If you are using anything other than a text editor to modify the CSV file, open the file in a text editor such as
    Microsoft
     Notepad, review the syntax for problems, then save the modified file as a .txt file. Edit the file name to change the extension from .txt to .csv. This method preserves the formatting in the text file.
  7. Verify 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 a multi-select picklist has only a single entry.
    • Use a comma to separate each value. Do not include spaces before or after the comma.
    • If you are importing user base restrictions, you must enclose each value with double quotation marks ("").
  8. After you have entered your data, save and close the file.
  9. Click the filename, and click
    Open
     to upload the file into the system.
    The filename appears in the Operator CSV File field on the Import Operator screen. Each of the columns from the import file are listed in the
    Select the columns to import
     section.
  10. Select the columns of data you want to import or click
    Select All
    .
  11. Review the
    Columns that cannot be imported
     list to verify that 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
     Customer Support for help.
  12. Click
    Import
    . The Importing Operators window opens.
When the import completes, the Import Details: Import Completed screen displays the following information:
  • Total number of operators in the import file
  • Total number of operators who were processed
  • Number of operators who were successfully processed
  • Number of operators who failed to be processed
  • Username of the person who imported the file
  • Time the file import process started and ended
Click
Download Log
 on the Import Details: Import Completed screen to download a CSV file that includes information about the sync status of the operator import.