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:
- The Add or update user accounts option is used to add new users to Axon Evidence and update existing users based on the information in the CSV file. Any user accounts that are not explicitly referenced in the CSV file will not be affected.
- The Synchronize all user accounts option affects all active user accounts, regardless of whether the user account is explicitly referenced in the CSV file. Users that have a status of Active that are not included the CSV file have their status changed to Inactive. This option is useful when you want to use the contents of 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 of a user. 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. It is recommended that you determine a user ID strategy that best suits your needs. Note: The external user ID is an immutable value. After a user account is created, you cannot change its external ID. If you try to change the external ID of an existing user account, Evidence.com interprets the new external ID as a new user and attempts to create a new user account. If you are synchronizing the users in your Evidence.com agency with users in another application, you may want to use an ID value provided by the other application, such as a GUID. You can also simply assign a descriptive name. If a user account was created through the Evidence.com web user interface, the external user ID is a GUID assigned by Evidence.com and is included in the response to any user-related request. 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. |
REQUIRED The Internet email address of the user. Each user in your agency must have a unique email address. |
|
BADGE_NUMBER |
REQUIRED A unique badge ID that you assign. Typically, a user’s badge number in Evidence.com should match the user’s badge in other systems such as computer-aided dispatch (CAD) systems. This practice simplifies analysis and reporting of data aggregated from multiple systems. It also simplifies Evidence.com integration with your CAD system. Note: If your organization does not assign badge numbers to users, it is recommended that you put user email addresses in the BADGE_NUMBER column, too. |
FIRST_NAME |
REQUIRED The user’s first name. |
LAST_NAME |
REQUIRED The user’s last name. |
STATUS |
REQUIRED
|
USERNAME |
REQUIRED A unique username. |
ROLE |
REQUIRED The role that you want to assign to the user. Valid values are the names of the roles configured in your Evidence.com agency. |
SUPERVISOR_ID |
OPTIONAL Reserved for future use. |
LOCATION |
OPTIONAL Reserved for future use. |
RANK |
OPTIONAL The rank that you want to assign to the user. Valid values are the names of the ranks configured in your Evidence.com agency. |
EVIDENCE_GROUP_EXT_ID |
OPTIONAL The External_ID of the group to be assigned to the user. Must be an active group. |
PHONE |
OPTIONAL Phone number in full, with the leading country code |
To import users into your account:
- On the menu bar, click Admin and then under Users, click Import Users.
The Import Users page appears. - Download the example file.
- Make a copy of the example file and assign it a meaningful file name.
- Open the file in the appropriate application using a spreadsheet application.
The first row or line of the file contains column names. The second through fifth rows are examples. - Delete the information in the second through fifth lines. Do not delete the first line. Evidence.com expects the first line to contain the column names.
- Enter the user information in the file. The information entered depends on if you are only adding or modifying user accounts or if you are synchronizing all user accounts.
- If you are adding or modifying user accounts, for every user that you want to add or edit include a line in the file that specifies values for the user. When editing a user account, enter the new value in the appropriate column.
Example: If you are changing a user from active to inactive, you would enter Inactive in the Status column for the user. - If you are synchronizing all user accounts, you must include all active user in the file. Even if there are no changes to the user’s information. Users that have a status of Active that are not included the CSV file have their status changed to Inactive.
- If you are adding or modifying user accounts, for every user that you want to add or edit include a line in the file that specifies values for the user. When editing a user account, enter the new value in the appropriate column.
- Save the file.
- In Evidence.com, if your session has timed out, sign in again and return to the Import Users page by clicking Admin and then, under Users, clicking Import Users.
- Select the Import Option you want to use (Add or update user accounts or Synchronize all user accounts).
- Click Select File and, in the dialog box that opens, select the file on your computer, and then click Open.
- Click Upload.
Evidence.com imports the file. When the upload is complete, a summary of import is displayed showing which users were added, updated, and where there are errors.
You can upload another file or navigate to another action.