The Users Template

The Users template (Users-template.CSV) lets you create new users.

If you specify a facility, department, or conference group, it must already exist in the database; the template does not create it. If a row in this data-loading template references one of those entities, and that entity does not exist, the row causes a validation error and does not load. Any other rows that successfully validate load properly.

The following table describes the fields names, maximum length for fields names, and a brief description of the fields.

Field

Maximum Length

Description

User Login

50

Enter a User ID that is not already assigned to another user on the system, being careful to choose a name that you and the user can easily remember. The user ID is not case-sensitive.

The User ID must contain only letters, digits, spaces, periods (.), underscores (_), or dashes (-). No other characters are allowed. It must not begin or end with a space.

Note: You must have System Administrator or Tiered Administrator permissions to change or enter the User Login.

Last Name

50

Enter the user's Last Name and First Name in the corresponding fields.

The name must start with a letter or digit. It must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-). No other characters are allowed.

By default, the speech recognition system uses the names you enter to recognize users. If people refer to a user by something other than the name you enter here, provide an Alternate Spoken Name.

First Name

50

Enter the user's First Name in the corresponding fields.

The name must start with a letter or digit. It must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-). No other characters are allowed.

By default, the speech recognition system uses the names you enter to recognize users. If people refer to a user by something other than the name you enter here, provide an Alternate Spoken Name.

Facility

 

Specify the name of the facility for the use. If you have not defined any facility, or if you do not want to specify a facility for the new user, use the default Global value for this group.

Identifying Phrase

100

Optionally specify an Identifying Phrase to help Vocera distinguish this user from another whose first and last names are spelled the same.

For example, if there are two users named Mary Hill on the system, but one is on the third floor and the other is on the first floor, you could enter Mary Hill on the third floor as the identifying phrase for one user and Mary Hill on the first floor for the other.

Email

60

Enter the user's email address to take advantage of these features:
  • Other users can send voice messages from their badges to this user's email inbox. Vocera sends voice messages to an email address as .WAV file attachments. Users can listen to these messages with the Windows Media Player and other players.

  • The Vocera system administrator can integrate the user with Vocera Messaging Platform (VMP). If so, enter a unique email address. Otherwise, the VMP Server will not synchronize the user successfully.

Note: To enable email features, you must also configure the settings on the Email page of the Administration Console.

Desk Phone or Extension

75

Enables the following features:

  • Allows users to forward or transfer calls from their Vocera devices to their desk phones.

  • If no Vocera Extension is specified, allows outside callers to connect to a user's Vocera device by entering the user's desk extension at the Vocera hunt group prompt, instead of saying the user's name.

  • Allows users to send a page and receive the return phone call from a person they paged on their badges.

  • If users have appropriate permission and have Vocera Access Anywhere enabled, the Desk Phone or Extension field allows users to be authenticated by Caller ID when they call the Vocera hunt group number.

Cell Phone

75

Allows users to forward calls from a badge to a cell phone.

If users have appropriate permission and have Vocera Access Anywhere enabled, the Cell Phone field allows users to be authenticated by Caller ID when they call the Vocera hunt group number.

Home Phone

75

Allows users to forward calls from their badges to their home phones. It also allows users take advantage of the "Call My House" entry in Contacts.

Alternate Spoken Name 1, Alternate Spoken Name 2, Alternate Spoken Name 3

50

Specify variations of the user's name in the Alternate Spoken Names fields.

The name must start with a letter or digit. It must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-). No other characters are allowed.

  • If users refer to a person or place in various ways, enter each variation in a different field.

    For example, enter Bob Jones and Rob Jones in addition to Robert Jones. Similarly, enter a nickname that the person or place is known by, such as Skip Jones.

  • If people use initials to refer to a user, provide them as a series of letters separated by spaces.

    For example, if users refer to Amardeep Munindar Gill as A.M. Gill, enter A M Gill.

  • If a name has an unusual or confusing pronunciation, enter a name that is spelled as it is pronounced.

    For example, if the system does not recognize the name Jodie Dougherty, you could enter Jodie Dockerty.

  • If users refer to a person by his or her title, provide the full spelling of the title.

    For example, enter Father Brown instead of Fr. Brown.

When you import or update Vocera users using a CSV file, the Alternate Spoken Name values are treated as a set. A user's Alternate Spoken Name fields are replaced by any Alternate Spoken Name values in a CSV row. If all three Alternate Spoken Name fields in a CSV row are empty, no changes will be made to those fields when you update the user. To remove all alternate spoken names for a user, enter the literal string value *blank* in all three Alternate Spoken Name fields in a CSV row.

Device ID

12

Enter the MAC address of the user's badge in the Device ID field as follows:

  • If the system-wide setting Login/Logout Voice Commands is enabled, you do not need to enter the Badge ID, because it will be entered automatically when the user logs in.

  • If Login/Logout Voice Commands is disabled, use the Info menu on the Vocera device to find the Badge MAC address, and enter this address in the Badge ID field. The MAC address of a badge is also printed near the bottom of the white label under the battery.

Home Department

50

Specifies the user's home department.

When you import users through the data-loading template, any value in this field is also imported.

When you export users to a .csv file, Vocera populates this field for informational purposes.

Home Department Facility

50

Specifies the facility for the user's home department.

Conference Group

n/a

Optionally assign the user to a conference group by specifying it here. The template does not create a conference group, it must already exist in the database. If the group does not exist, the row results in a validation error and fails to load.

To qualify a conference group by specifying its facility, use a colon to separate the value from the facility name (GroupName:FacilityName). If you do not specify a facility, the value of the Facility field is used by default.

Conference Group Facility

   

Employee ID

50

Optionally use the Employee ID field to specify a unique value that identifies a Vocera user.

Note: You must have System Administrator or Tiered Administrator privileges to change or enter the Employee ID.

Cost Center

   

PIN for Long Distance Calls

75

Allows an organization to authorize or account for telephone usage and to distribute telephone costs among different users, departments, or facilities.

A PIN template can include digits, special characters, and PIN macros.

Expiation Date

10

Enter the last full day that a temporary user account is available.

The date string must be specified using the following date format:

United States and Canada: mm/dd/yyyy
Other locales: dd/mm/yyyy
                          

For example, the fourth day of September in the year 2010 is written as 09/04/2010 in mm/dd/yyyy format and 04/09/2010 in dd/mm/yyyy format.