The Groups Template

The Groups template (Groups-template.CSV) lets you create Vocera groups.

If you specify a facility, it must already exist in the database; the template does not create it. If a row in this data-loading template references a facility that does not exist, the row causes a validation error and does not load. All other rows that successfully validate are loaded properly.

When you reference other groups within a group record, the referenced group does not need to exist in the database as long as it is defined as another record in the import file.

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

Field

Maximum Length

Description

Group Name

50

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 Group Name to recognize groups. If users refer to a group by something other than the Group Name, provide an Alternate Spoken Name.

Facility

50

Use the Facility field to specify the group's home facility.

If your organization has multiple facilities connected to the same Vocera server, choose the home facility that represents the member's physical location. If the group's membership spans multiple facilities, specify Global.

The Facility field is treated differently if you are importing or updating groups:
  • When importing groups, you cannot leave this field blank.

  • When updating groups, the Facility field is required. You cannot leave the field blank.

Alternate Spoken Name

50

In the Alternate Spoken Name field, optionally enter a variation of the group name. For example, some people might say "the Sales team" instead of "Sales." If you enter the Sales team as an Alternate Spoken Group Name, the Genie will recognize "Call the sales team."

Member Name-Singular

50

In the Member Name-Singular field, enter a name that describes a member of the group. For example, in the group called Sales, a group member would be known as a sales person. This would allow the Genie to recognize a command such as, "Call a sales person."

Best Practice: Do not start the singular name of members with the words "a" or "an" because those words are already in the Vocera grammar.

Member Name-Plural

50

In the Member Name-Plural field, optionally enter a name that collectively describes the members of the group. For example, in the group called Sales, the collection of group members could be called sales people. This would allow the Genie to recognize a command such as, "Send a message to all sales people."

Best Practice: Do not start the plural name of members with the word "all"—for example, all sales people—because that will result in redundant syntax in Genie prompts, such as, "I'm recording a message for all all sales people."

Scheduling Options

n/a

Specify either of the following:

  • Choose Sequential (the default) if you want one person to be the main contact. The second member in the list is called only if the first person is not available, a third member is called only if the first two are unavailable, and so forth.

    The order in which names appear in the Group Member Name list on the Members tab of the Add/Edit Group dialog box is important when you choose Sequential scheduling.

  • Choose Round Robin if you want calls to be distributed as evenly as possible among group members. When you choose round robin, Vocera iterates through members in the group until someone accepts the call; however, the person who most recently accepted a group call is tried last.

If you provide a value other than Sequential or Round Robin in the data-loading template, an error will occur when you try to import the file.

Forwarding Type

  Specify one of the Standard Options: none (the default),contact, off network group member, phone, pager.
Note: Ensure that you enter the field information in lower case.
Note: You must configure a pager number to use Pager as a standard option.

If the Forwarding field references a user or contacts entry that does not exist in the Vocera database, the record will be skipped when you try to import it. To avoid data validation errors, Vocera recommends importing group data in multiple passes.

Forwarding To - Type

 

Specify one of the Standard Options: Groups, Users, PersonalContacts, BusinessContacts.

Note: You must enter a value for Personal Contacts if Forwarding Type is set to Contact.

Forwarding To - Group or Business Contact Name

50

Specify a Group Name that starts with a letter or digit. It must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-).

Specify a Business Contact Name that starts with a letter or digit. It must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-).
Note: The Business Contact Name or Group Name is required if the Forwarding To - Type is set to Groups or Business Contacts.

Forwarding To - User or Personal Contact First Name

50

User First Name - Specify a user's first name, name must start with a letter or digit. User's first name must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-).
Note: User's first name is required if the Forwarding Type is Contact and Forwarding To Type is User.

Personal Contact First Name - Specify a first name for a personal contact, name must start with a letter or digit. It must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-).

Note: Personal Contact first name is required if the Forwarding To Type is set to Users or Personal Contacts.

Forwarding To - User or Personal Contact Last Name

50

User Last Name - Specify a user's last name, name must start with a letter or digit. User's last name must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-).
Note: User Last Name is required if the Forwarding Type is Contact and Forwarding To Type is User.

Personal Contact Last Name - Specify a last name for a personal contact, name must start with a letter or digit. It must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-).

Note: Personal Contact last name is required if the Forwarding To Type is set to Users or Personal Contacts.

Forwarding To - User Login

50

Specify a user name that starts with a letter or digit. It must contain only letters, digits, spaces, apostrophes ('), periods (.), underscores (_), or dashes (-).

Note: This field information is required if the Forwarding Type is a Contact and Forwarding To Type is Users.

Forwarding To - User, Group, or Contact (Facility)

50

Specify the facility information to which a particular user, group, or contact entry belong.

Forwarding To - Another Number

50

Specify the phone number to forward the calls. This field information must be provided if forwarding type of phone is set..

Emergency Broadcast Group

50

Specify the name of the group that receives emergency broadcasts for a functional group. Group name that starts with a letter or digit. Name must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-).

Emergency Broadcast Group (Facility)

50

Specify a facility name that starts with a letter or digit. Name must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-). This field information depends on the Emergency Broadcast Group being set.

Group Type

n/a

Specify either Department, Subdepartment, or Ordinary (the default).

  • Ordinary – a group whose members are NOT considered members of a parent department. Examples of ordinary groups include administrative groups, groups with dynamic membership, role-based groups, and bed/room groups.

  • Department – a group that corresponds to a department within the organization using the Vocera system. By designating a group as a department, you provide accounting features and speech recognition enhancements that are not available to other Vocera groups. For example, you can differentiate users by specifying their department in voice commands.

  • Subdepartment – a subgroup of a department group. Members of a subdepartment are also considered members of a parent department. A subdepartment should be directly contained within an existing department or another subdepartment.

If you provide a value other than Department, Subdepartment, or Ordinary in the data-loading template, an error will occur when you try to import the file.

If you specify Department, the PIN for Long Distance Calls and Cost Center fields can also be entered for accounting purposes.

PIN for Long Distance Calls

50

Optionally specify a value in the PIN for Long Distance Calls field.

A telephony PIN authorizes members of a Vocera department to make phone calls and allows an organization to charge departments for those calls.

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

Use this field only if you are working with a department group.

Cost Center

100

Optionally specify a value in the Cost Center field.

A Cost Center ID enables Vocera to track system usage by department and potentially allows an organization to charge its departments for relative usage.

Use this field only if you are working with a department group.

Forwarding When

n/a

Specify either of the following:

  • all forwards every call that comes in to the group, without notifying group members.

  • unanswered (the default) forwards only calls that are not answered by any member of the group.

    Note: Ensure that you enter the field information for "all" and "unanswered" in lower case. Importing these field values in uppercase may cause the radio buttons to not display correctly in the Web Console User Interface.

If you provide a value other than all or unanswered in the data-loading template, an error will occur when you try to import the file.

Remove Users on Logout

n/a

Specify either True or False (the default) to indicate whether membership in the group is temporary.

If you enter True, Vocera automatically removes users from the group when they log out, but leaves the rest of the user profile in the database. Users are not added into the group automatically when they log back in.

Important: Users are only removed from the group when they log out. Keep in mind that users may place badges in the charger or simply leave the facility without logging out when their shifts end. To accommodate this behavior, consider setting the following options to log users out automatically:

  • Enable the Auto Logout When Badge In Charger setting.

  • Check the Enable Auto-Logout Period setting.

Pager Number

50

Specify the pager number for the group. You can configure Vocera to forward a group’s calls to this specified pager.

If you enter a value for this field, any user can issue the "Send a page" voice command to send a numeric page to this group.

Off-Site Calls

n/a

Specify either True (the default) or False to indicate whether calls to the group can be received by members who are currently at a different facility from the caller. If your Vocera system has only one facility, this option does not apply.

If you don't want members of the group to receive calls from people at other facilities, specify False.

Off-Site Broadcasts

n/a

Specify either True (the default) or False to indicate whether broadcasts to the group can be received by members who are currently at a different facility from the person who initiated the broadcast. If your Vocera system has only one facility, this option does not apply.

If you don't want members of the group to receive broadcasts from people at other facilities, specify False.

Manager Group

50

Specify the group whose members can manage the group you are importing. To qualify a 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 facility of the group you are importing is used by default.

Manager Group Facility

50

Specify a facility name that starts with a letter or digit. Name must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-). This field information depends on the Manager Group \ being set.

Add Group

50

Specify the group whose members are allowed to add themselves to the group you are importing. To qualify a 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 facility of the group you are importing is used by default.

Add Group Facility

50

Specify a facility's name, facility name must start with a letter or digit. It must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-). This field information depends on the Add Group being set.

Device Group

50

Specify the group's name whose members manage the Vocera devices used by the group you are importing.

Device Group Facility

50

Specify a facility name that starts with a letter or digit. Name must contain only letters, digits, spaces, apostrophes ('), underscores (_), or dashes (-). This field information depends on the Device Group being set.

Permission Only

n/a

Specify either True or False (the default) to indicate whether the group is used to grant or revoke permissions only and should not be callable. If you specify True, calling and broadcasting to this group will be disabled.

Forward on Broadcast Number

50

Specify to forward a call to a broadcast number, there is no character limit for this field.

Forward on Conference Number

50

Specify to forward a call to a Conference call, there is no character limits for this field.

Voice Mail Enabled

n/a

Specify either True(the default) or False to indicate whether the voice mail is enabled or not.