Mapping Users

Because the core functionality of the Vocera Care Team Sync product is to synchronize assignments between the Vocera Voice Server and a foreign clinical assignment system, you must associate or "map" the u-name values (user IDs) that are used by the two systems with each other.

When the user IDs in the two systems vary systematically, you can accomplish this task by creating a single expression in the Inbound User Criteria Expression field of the New or Update Connection dialog box. For example, if the foreign assignment system uses numeric values as user IDs and the Vocera Voice Server uses the same numeric value prefixed by a "u", the variation is systematic and may be captured by an expression in this connection definition.

Note: When the user IDs in the two systems are identical, you are required to use the Inbound User Criteria Expression field to map the users.

In other situations, the user ID convention implemented by the two systems is so different that no systematic mapping is possible. For example, if the foreign assignment system uses numeric values as user IDs and the Vocera Voice Server uses alphabetic user IDs based on the user name itself, the variation is so extreme that you will likely be unable to describe it in an expression.

In all situations, you must map the user IDs in the two systems: either systematically through an expression when you define the connection, or manually through the CTS Console. In some cases, you may be able to map most users by way of the expression in the connection definition and use the User Mappings page to accommodate any exceptions to this general mapping rule.

Note: If you are comfortable with SQL, you may also create and import a CSV file that maps the user IDs in the two systems. If you choose this approach, create a three-column CSV file with values for the voceraUserId, externalId, and assignmentClientSEQ columns and use the Table Data Import Wizard in MySQL Workbench to import the values. See the MySQL Workbench documentation for further information.