Bulk import users

When you need to add many users to your Evidence.com agency, use the Import Users feature. This feature lets you create many user accounts quickly. You specify details about the new users in a file that you upload to Evidence.com.

The Import Users feature provides two import options:

  • Add or update user accounts: Use this option to add new users to Axon Evidence and update existing users based on the information in the CSV file. Any user accounts not explicitly referenced in the CSV file will not be affected. No accounts will be deleted or deactivated unless they are specifically updated in the file.
  • Synchronize all user accounts: This option affects all active user accounts, regardless of whether the account is referenced in the CSV file. Users with a status of Active that are not included in the CSV file will have their status changed to Inactive. This option is useful when you want to use the CSV file as a definitive list of all active user accounts.

The CSV file for importing users must contain a header row and must have eight columns. When updating users, if an optional column is not included in the CSV, the import will make no changes to those attributes. If optional columns are included, the import process uses the values provided in the column for each user. For example, if the CSV file includes the rank column and the value is empty for a specific user, the user’s rank will be removed. The following table describes the required and optional values in the CSV file for importing users:

Header Value Value

EXTERNAL_ID

REQUIRED

A unique value that identifies the user. The external ID is assigned by your organization. Valid external user IDs can be up to 255 characters.

Note: You can use the Export Results option on the All Users search page to export user information that includes the External ID for users.

EMAIL

REQUIRED

The Internet email address of the user. Each user must have a unique email address.

BADGE_NUMBER

REQUIRED

A unique badge ID assigned to each user. Typically, a user’s badge number in Evidence.com should match the badge number in other systems, such as computer-aided dispatch (CAD) systems.

FIRST_NAME

REQUIRED

The user’s first name.

LAST_NAME

REQUIRED

The user’s last name.

STATUS

REQUIRED

Active — The user can register and sign in to Evidence.com immediately after importing.

Inactive — The user cannot register or sign in.

USERNAME

REQUIRED

A unique username for the user.

ROLE

REQUIRED

The role assigned to the user. Valid values are the names of the roles configured in your Evidence.com agency.

SUPERVISOR_EMAIL

OPTIONAL

The user’s direct supervisor's email address, as used in Axon Evidence.

LOCATION

OPTIONAL

Reserved for future use.

RANK

OPTIONAL

The rank assigned to the user. Valid values are the ranks configured in your Evidence.com agency.

EVIDENCE_GROUP_EXT_ID

OPTIONAL

The External_ID of the group assigned to the user. Must be an active group.

PHONE

OPTIONAL

Phone number with leading country code.

To import users into your account:

  1. On the menu bar, click Admin and then under Users, click Import Users. The Import Users page appears.
  2. Download the example file.
  3. Make a copy of the example file and assign it a meaningful file name.
  4. Open the file in a spreadsheet application.
  5. The first row of the file contains column names. The second through fifth rows contain examples.
  6. Delete the data in rows two through five but keep the first row with column names.
  7. Enter the user information in the file:
    • If adding or modifying accounts, include a line for each user with the necessary values.
    • If synchronizing all accounts, include all active users, as unlisted active users will be marked as inactive.
  8. Save the file.
  9. In Axon Evidence, sign in again if necessary, then return to the Import Users page.
  10. Select the Import Option you want to use (Add or update user accounts or Synchronize all user accounts).
  11. Click Select File, choose your file, and click Open.
  12. Click Upload.

Axon Evidence imports the file and displays a summary showing added, updated, or errored entries. You can upload another file or navigate to another page.