UDEF
About User-Definable Statuses (UDEF) in Bed Management
User-definable statuses (UDEF) were introduced as part of efforts to enhance flexibility and customization in hospital bed management systems. First implemented to provide custom status tracking for unclean beds, UDEF allows healthcare facilities to label unique conditions that require special attention. This configuration option improves workflow efficiency, safety, and communication within facilities.
Key Configuration Details
What & Why:
UDEF statuses allow hospitals to define two custom bed statuses for specific operational needs beyond the standard options like Clean or Dirty. For example, hospitals can create statuses such as "Contagious" to indicate special cleaning precautions.How:
Custom statuses are configured at the campus level in the system. The following placeholders are available:UDEF-8: Can be renamed based on operational requirements (e.g., "Contagious").
UDEF-9: Can be renamed to a second custom status (e.g., "Special Status").
Configuration Steps:
Navigate to Capacity Management Administration > Enterprise Management > Enterprise Information.
Select the campus and go to the Global Settings Tab.
Choose the BedTracking menu and adjust the User-Definable Statuses.
Enter custom status names and IVR IDs, then click Save.
Troubleshooting Common Issues
Status Names Not Reflecting in the Application:
UDEF changes appear only in single-campus views (e.g., BedTracking > Multi-View Tab) and not in multi-campus displays like BedTracking > Beds Tab.
UDEF-8 or UDEF-9 placeholders remain visible in multi-campus displays regardless of consistent naming across campuses.
Why UDEF Names Don't Update Everywhere:
UDEF statuses are campus-specific by design to support individual facility needs. The system does not verify if custom names are identical across all campuses.
Enhancement Request:
An enhancement request (OP-2661) has been submitted to improve system behavior in newer versions.
This solution provides flexibility for hospitals while ensuring effective communication and bed tracking tailored to their operational requirements.
Units/Wards
Definition
Attributes of logical locations that are contained on one floor of a building.
Units: Organized clusters of rooms and related locations situated on the same floor within a building.
Wards: Logical designations within a building floor that may comprise multiple locations and rooms, including departments that do not accommodate patient beds.
Scope
Users with fixed memberships are assigned to wards or clusters (groups of wards and departments).
Adding or Editing a Unit
Before adding or editing rooms within a campus's physical structure, it is essential to first establish the associated units, as units are part of the logical structure and rooms must be linked to them. Proper preparation ensures seamless association during the setup of physical structures like floors and buildings. To perform this task, users must have the Capacity Management Administration page Menu permission and the Unit-Cluster Management permission with Edit rights. Those with View rights can only observe but not modify information. Additionally, users must have Membership Type "All" with Administrative Rights enabled. Fields marked with a red * on the page are mandatory for data entry.
To add or edit a unit:
Navigate to:
Capacity Management Administration page > Unit/Zone/Location Management > Units, OR
Admin > Settings > Capacity Management > Unit/Zone/Location Management > Units.
Ensure the correct campus is selected in the campus list.
On the Units tab:
To add: Click Add Unit.
To edit: Click the unit name under the Name column.
Complete unit details on the Unit Information tab.
Deleting Units
Users with the appropriate permissions and membership can delete units within the Capacity Management system. To perform this task, the Capacity Management Administration page Menu permission and Unit-Cluster Management permission are required. Users must have Edit rights to make changes, while those with View rights can only observe information. Additionally, Membership Type "All" with Administrative Rights enabled is necessary to authorize unit deletion.
To delete units:
Navigate to:
Capacity Management Administration page > Unit/Zone/Location Management > Units, OR
Admin > Settings > Capacity Management > Unit/Zone/Location Management > Units.
Ensure the correct campus is selected.
Select the units to delete by checking the boxes. To select all units, check the box in the title bar.
Click Delete Selected Records.
Confirm the deletion by clicking OK when prompted.
Viewing the Locations in a Unit
Locations are linked to rooms, and rooms are directly associated with units, establishing a connection between units and locations. Users with the appropriate permissions and membership can view the locations associated with a unit. To access this feature, users must have the Capacity Management Administration page Menu permission and the Unit-Cluster Management permission. Edit rights are required for making changes, while View rights allow observation without modifications. Additionally, Membership Type "All" with Administrative Rights enabled is essential for access.
To view the locations in a unit
Navigate to:
Capacity Management Administration page > Unit/Zone/Location Management > Units, OR
Admin > Settings > Capacity Management > Unit/Zone/Location Management > Units.
Ensure the correct campus is selected.
On the Units tab, click the unit name under the Name column.
On the Unit Information tab, view the Locations in this Unit section.
Filtering Locations:
By Room: Select a room from the Room list and click Go.
By Zone: Select a zone from the Zone list and click Go.
Editing Location Information:
Click the location IVR ID number or the location name to access the location editing page.
Associating an Existing Room with a Unit
You are required to select a unit when you add or edit a room. To associate an existing room with a different unit, edit the room information.
Origin Unit — The Origin Unit refers to the unit associated with a patient placement request, such as the unit a patient is being transferred from. If there is no open placement request, this field remains blank. In the PreAdmitTracking® application, this information is unavailable in the Pending/Confirmed Discharges List view. When a patient record from the ADT system lacks origin unit or requester information, the placement requester can set the origin unit in the Patient/Placement Details form, but it won't formally associate with the patient until the form is saved. If the ADT message includes requester information, the origin unit will be determined based on the requester's membership rather than the patient’s current location. Any origin unit data from the TransferCenter™ application takes precedence over information from the Capacity Management Suite® solution.
Target Unit
The Target Unit is the preferred unit designated for a patient's placement, selected during the creation or modification of a placement request or directly from the Patient Status or Placement Status column in the PatientTracking Portal® application. If no open placement request exists, this column will remain blank. It is used by charge staff, patient placement specialists, and administrators to ensure that patients are assigned to the most appropriate unit based on care requirements, operational efficiency, and bed availability. This process ensures that patients are placed in the correct unit for timely care and effective resource utilization.
Selecting a Target Unit or Assigning a Bed for a Patient
About Selecting a Target Unit or Assigning a Bed
When a patient has a placement status of Requested, users can select a target unit or assign a bed from the list view or the Patient/Placement Details form.
Permissions Required
Maintain Patient/Placement Details (View): Allows access to view the Patient/Placement Details form without editing rights.
Maintain Patient/Placement Details (Edit): Provides access to the form with permission to make changes. Additional permissions may be required for specific edits (e.g., Edit Patient Name, Edit Patient Associated Physicians).
Create New PreAdmits: Allows the creation of new preadmit records.
Edit Target Unit on a Placement: Required to select a target unit.
Set Bed Assignment: Required to initially assign a bed.
Change Bed Assignment: Required to modify an existing bed assignment.
To Access the Target Unit List or Assigned Bed List:
To access these lists, users may proceed via the following methods:
From the Patient/Placement Details Form:
Click the patient’s name in the Name column to display the form.
From the List View:
Click in the ST, Plc Status, or Pt Status column, then select Target Unit/Assign Bed.
Select the patient’s placement status in the Plc Status column.
Alternatively, click in the ST or Pt Status column, select Create Bed Request, and click Save.
To Select a Target Unit:
Access the Target Unit list.
Choose one of the following methods to select a unit:
Start typing the unit name and select it when it appears in the list.
Click the arrow to display available units and select one.
Use the magnifying glass icon to display a list of campuses. Expand the campus by clicking the plus sign (+) to view units. Select the desired unit and click Select.
Click Save.
Note: A warning message may appear if another patient with the same last name is already assigned, targeted, or scheduled for a transport in the selected unit. Adhering to hospital policy may necessitate selecting a different unit to prevent medication distribution errors.
Allowing a Unit to be a Target Unit
For a unit to be selected as a target unit in a bed search on the Patient/Placement Details form, it must be marked as a potential target unit. Units that are not marked with this designation cannot be selected as target units in a bed search.
To enable a unit as a target for placement:
Navigate to the Unit PreAdmit Settings tab.
Under Allow as Target Unit, click the No button to toggle it to Yes (green).
Click Save.
This designation is essential for selecting the unit during a bed search on the Patient/Placement Details form.
Creating New Units
A Unit is a fundamental component of a campus, defined as a grouping of rooms and associated locations within the same building and on the same floor. Each room must be linked to a unit; therefore, units must be created before adding rooms.
Purpose and Usage of Units
Units are essential for various operational functions, including:
Proximity Matching: Used in TransportTracking™
Location Searching: Applied in TransportTracking™
Bedboard Grouping: Used in PreAdmitTracking® and PatientTracking Portal®
Membership: Governs patient visibility for users
Bed Requests: Defines origin and target units
Scenarios for Adding New Units
New units or locations may be added for several reasons, such as:
Community Emergency Response: To meet increased capacity needs during events like hurricanes or pandemics.
Hospital Expansion: To accommodate new capacity due to construction or the addition of new units within existing buildings.
Steps
Create a Unit
Access the Capacity Management Administration Page:
Navigate to Unit / Zone / Location Management.
Select Units.
Add a New Unit:
Click Add Unit.
Complete the Required Information:
Fill in all starred (*) fields on the Unit screen.
Verify PreAdmitTracking Settings:
These are established during the system implementation design process. Use the same settings as existing units to maintain consistency.
Note: Default values may not always be accurate—verify they match other units.
Configure Timer Settings:
Timer settings are defined during system implementation and validated through design processes.
Adjust these settings as needed if the hospital’s time frame philosophy changes.
Timer settings control when alerts (Yellow/Red) notify users of bottlenecks.
Placement Settings:
Define placement-related configurations as required.
Set Discharge Timer Settings:
Determine when the discharge timer turns Yellow or Red in the PatientTracking Portal®.
Configure Bedboard Settings:
Define unit census and available capacity.
Surround census numbers with a border to draw attention.
Set whether the unit appears on the Bedboard.
Staffed Bed Settings:
Identify the number of beds that the unit is staffed to support.
Best Practice
Avoid Deleting Units: Deleting a unit permanently removes all associated data.
Archiving Method: To retain historical data, prepend "zzz" to the unit name instead of deleting it.
Not able to add additional units to the PatientTracking board
Issue:
A user is unable to add additional units to the PatientTracking board.
Solution:
The PatientTracking Portal only displays units within the user's account membership. To resolve this issue, membership settings must be adjusted by an administrator at your facility or hospital system.
Options to Adjust Membership:
Variable User:
Units are grouped into a cluster that users can select when logging in.
This setup allows access to multiple units as needed.
Fixed User:
Change the user's membership from Variable to Fixed.
Fix the membership to include the desired units for consistent access.
Note: These changes require administrative action by the person managing TeleTracking for your hospital system.
Adding Units to a Cluster
Overview
If you have the appropriate permissions and membership, you can add units to a cluster after creating or editing it. Clusters help group units for streamlined capacity management and efficient patient placement.
Permissions Required
To add units to a cluster, the following permissions and access levels are required:
Capacity Management Administration Page Menu Permission: Grants access to the Capacity Management Administration menu.
Unit-Cluster Management Permission: Required to manage unit clusters.
Edit Rights: Necessary to make changes (view rights only allow viewing information).
Membership Type "All" and Administrative Rights: Must be enabled for full access.
Steps to Add Units to a Cluster
Navigate to the Cluster Page:
Go to Capacity Management > Cluster Page.Locate the Add Units to Cluster Section:
This is found on the right side of the page.Complete the Required Selections:
Building List: Select the building containing the unit.
Floor List: Select the associated floor.
Select Units:
You can choose units using one of the following methods:CTRL + Click: Hold down the CTRL key and click the desired units individually.
Drag and Select: Press and hold the right mouse button while dragging the cursor over the desired units.
Add Units:
Click Add Selected. The selected units will now appear under Units in this Cluster on the left.Save Changes:
Click Save to confirm the changes.
Additional Tips
Ensure that the selected units align with the intended cluster configuration for efficient operations.
Double-check your permissions and membership type if the Add Units to Cluster section is inaccessible.
Adding from the Units Tab
Steps:
Select the Correct Campus:
Verify the current campus displayed in the upper-right corner is correct.
Navigate to the Units Tab:
Select the checkboxes for the units you want to add.
Add Selected Units:
Click Add Selected Unit to Cluster to open the cluster selection dialog box.
Select a Cluster:
From the Cluster List, choose the appropriate cluster.
Click Submit.
Note: If a message bar appears at the top of the page prompting you to allow pop-ups, right-click the message bar and select Allow all pop-ups from the site. Without enabling pop-ups, the cluster selection dialog box will not be visible.
Important: If the selected units are already associated with a cluster, a message will appear at the top of the dialog box. In that case, select a different cluster and click Submit again.
Removing Units from a Cluster
If you have the appropriate permissions and membership, after you added units to a cluster, you can remove them if necessary.
Permissions Required:
Capacity Management Administration page menu permission
Unit-Cluster Management permission
Edit Rights: Required for making changes (View Rights only allow viewing).
Membership Type: Must be set to All with Administrative Rights enabled
Steps:
Navigate to Cluster Management:
Go to Capacity Management Administration > Unit/Zone/Location Management > Clusters
OR navigate to Admin > Settings > Capacity Management > Unit/Zone/Location Management > Clusters
Verify the Correct Campus:
Ensure the appropriate campus is selected from the Campus list in the upper-right corner.
Select the Cluster:
On the Clusters tab, locate the cluster in the Name column and click its name.
Remove Units:
In the Units in this Cluster list, choose one of the following:
Select the checkboxes for the units to be removed.
To remove all units, select the checkbox in the title bar.
Delete Units:
Click Delete Selected Records.
Confirm the Action:
When prompted with a confirmation message, click OK.
Unit Filter
Before You Begin
To access the Unit Filter dialog box, on a dashboard or list, click Select next to the Unit Filter box.
Selecting a Unit
The dashboard or list will display only data about the unit that you select.
Selecting a Unit on the Dashboard
Choose a Campus:
In the Please Select a Campus list, select the desired campus (e.g., ABC Children's Hospital).
The Please Select a Unit list will display only the units within the chosen campus.
Select Units or Clusters:
Check the boxes for the desired units or clusters.
To select individual units within a cluster, click the + sign next to the cluster name and select the desired unit checkboxes.
Apply Selection:
Click Apply to display data for the selected units.
Units Not Showing on Bedboard
Ensure the "Show on Bedboard" setting is enabled for the location in question.
Deleting UnitsPermissions Needed:
Capacity Management Administration page menu permission
Unit-Cluster Management permission
Edit rights (View rights only allow viewing, no changes)
Membership Type: All with Administrative Rights enabled
Note: TeleTracking® Support cannot grant these permissions; contact your internal Help Desk or TeleTracking® administrator.
Steps to Delete a Unit:
Navigate to Unit Management:
Go to Admin > Settings > Capacity Management > Unit/Zone/Location Management > Units.
Select the Campus:
Ensure the appropriate campus is selected in the Campus list (upper-right corner).
Select Units:
On the Units tab:
Select the checkboxes for the units to be deleted.
To select all units, check the box in the title bar.
Delete Selected Records:
Click Delete Selected Records and confirm by clicking OK in the confirmation message.
** TeleTracking does not recommend deleting units. We recommend removing any and all permissions from the unit, and adding zzz at the beginning of the units name. All historical data will stay with the unit, and will be available to be reactivated if needed.
Configuring Unit PreAdmitTracking® Application Settings
Overview
System administrators or designated staff with administrative permissions are responsible for configuring unit settings for the PreAdmitTracking® application. This setup is performed during the initial system configuration, when new units are added, or when existing unit settings require updates to accommodate operational changes. The settings are managed within the Capacity Management Administration page under unit configuration. Proper configuration is essential to ensure efficient bed searches and accurate assignments, streamlining patient placement workflows and improving operational efficiency.
Key Settings to Configure
Discipline Association:
Assign the appropriate discipline for the unit (e.g., "Restricted" for units handling special situations such as prisoner patients).
Target Unit for Bed Assignment:
Specify whether the unit can be selected as a target for bed searches and assignments.
Timers for List Views:
Configure the Assignment Timer, Ready-to-Move Timer, and Occupied Timer to display background colors (red/yellow) based on time intervals:
From Placement Request Activation to Bed Assignment
From Activation to Ready-to-Move Time
From Ready-to-Move to Occupied Time
Default Length of Stay (LOS):
Set the default LOS for the unit, which is used to project discharge dates if the global setting Use Length of Stay to Calculate Projected Discharge Date is enabled.
Electronic Bedboard® View:
Choose whether the unit should appear on the electronic bedboard®.
Configure unit headers to display red or yellow borders based on the percentage capacity of staffed beds or physical beds.
Patient Age Cutoff:
Define the cutoff age (e.g., 18 years) to determine whether patients should be assigned to child or adult beds.
Default Housekeeper Assignment:
Specify the default housekeeper for paging when there is a bed size change.
Staffed Bed Counts:
Enter the number of staffed beds per day in the unit for each shift start time.
Permissions Required
To configure these settings, users must have the following permissions:
Capacity Management Administration Page Menu Permission: Access to Admin > Settings > Capacity Management.
Unit-Cluster Management Permission: Required to manage unit settings.
Membership to the Selected Campus:
Admin rights must be enabled within the membership to make changes.
Setting PreAdmitTracking® application Application Unit Attributes
Overview
Hospital Services and Level of Care settings in the PreAdmitTracking® application allow users to efficiently locate appropriate beds for patients. Associating hospital services with levels of care (e.g., Oncology with Critical Care) is essential for accurate bed searches and assignments.
Permissions Required
To access the Capacity Management Administration page menu or Admin > Settings > Capacity Management, you must have the Capacity Management Administration page Menu permission.
In addition to the Unit-Cluster Management permission, which is required to gain access to the unit, you must also have the administrative permission called Unit Attribute Settings.
Accessing the Unit Attributes Tab
On the Unit Attributes tab, you make an association between hospital services and levels of care that have been entered in the Dictionary Management section of the Capacity Management Administration page or Admin > Settings > Capacity Management.
To access the Unit Attributes Tab:
Add or edit the unit.
Complete the unit information.
Configure the unit PreAdmitTracking® application settings.
Click the Unit Attributes tab.
To Set the Unit Attributes:
Access the Unit Attributes tab.
To add a row for associating a hospital service and level of care, click Add.
In the Hospital Service column for that row, select a hospital service name (such as Oncology).
In the Level of Care column for that row, select a level of care name (such as Critical) to associate with the selected hospital service.
To remove associations:
Select the check boxes for the rows that you want to delete, and then click Delete Selected Records.
When a confirmation message appears, click OK.
Click Save.
Accessing the Unit PreAdmit Settings Tab
Unit settings are configured on the Unit PreAdmit Settings tab after you add or edit unit information.
To access the Unit PreAdmit Settings Tab:
Add or edit the unit.
[Complete the unit information]
Click the Unit PreAdmit Settings tab.
Associating the Unit with a Discipline
Disciplines are groups of special related units. For example, there might be a discipline called Restricted that contains units which should house special patient populations that must be segregated from other patients, such as prisoners. Disciplines are used in the PreAdmitTracking® application projected census and in the advanced search feature on the Patient/Placement Details form. They can also appear on the Bed Summary Quick Report.
To associate a unit with a discipline:
Access the Unit PreAdmit Settings tab.
In the Unit Discipline list, select a discipline name.
Click Save.
Allowing the Unit to Have Bed Assignment Priorities
If PreAdmitTracking® application and PatientTracking Portal® application users should be able to set bed assignment priorities in this unit, then enable the Allow Assignment Priority setting. Setting bed priorities means marking beds with numbers from 1 through 9 from a list view. The numbers provide a visual indicator on a list view or bedboard of the order in which beds should be assigned.
To Allow Bed Assignment Priorities to be Set in the Unit:
Access the Unit PreAdmit Settings tab.
Under Allow Assignment Priority, click the gray No button to change it to a green Yes button.
Allowing the Unit to be an Origin Unit
If users who are adding or editing patient placement requests should be able to select this unit as an origin unit for a patient on the Patient/Placement Details form, then enable the Allow as Origin setting.
To Allow the Unit to be an Origin Unit:
Access the Unit PreAdmit Settings tab.
Under Allow as Origin Unit, click the gray No button to change it to a green Yes button.
Allowing Patient Bed Swap without Bed Request
With the Patient Bed Swap without Bed Request unit setting, you can appropriately manage the following scenarios that occur in a given unit:
A patient is being moved from one unit to another, but is placed temporarily in another bed on the original unit before being moved — In this situation, the patient should still be considered a pending transfer and their bed request for the other unit should remain open until they are finally moved. If the Patient Bed Swap without Bed Request setting is enabled, then after the move to the temporary bed, the patient's status will remain Pending Transfer and the patient's bed request for the new unit will be retained. This setting is disabled by default.
A new or transferring patient arrives at the bed they will be assigned to before the bed assignment has been finalized and the bed is not occupied by another patient — If the Patient Bed Swap without Bed Assignment setting is enabled, then the patient's current location changes to the bed they will be assigned to. Then, after the bed assignment is finalized, when the Capacity Management Suite® solution determines that the patient actually is in the assigned bed, then the bed will be marked occupied by that patient.
A new or transferring patient arrives at the bed they have been assigned to, but the bed is occupied by another patient — If the Patient Bed Swap without Bed Assignment setting is enabled, then the new or transferring patient will be considered a visiting patient and the patient who already occupied the bed will be considered the bed's occupying patient.
Two patients on the same unit exchange (or "swap") beds — If the Patient Bed Swap without Bed Assignment setting is enabled, then a bed request will not be required when two patients on the same unit exchange ("swap") beds. Five minutes after TeleTracking RTLS detects the patient in the new bed, the new bed will become the patient's home location.
To enable Patient Bed Swap without Bed Request:
Access the Unit PreAdmit Settings tab.
Under Patient Bed Swap without Bed Request , click the gray Disabled button to change it to a green Yes button.
Setting Whether the Unit Appears on the electronic bedboard® view
You can set whether the unit appears on the electronic bedboard® view. Users who are configuring the electronic bedboard® view in PreAdmitTracking® application or PatientTracking Portal® will only be able to select this unit if the Show on Bedboard option is enabled.
To Allow the Unit to Appear on the electronic bedboard® view:
Access the Unit PreAdmit Settings tab.
If this unit should appear on the electronic bedboard® view, for Show on Bedboard, click the gray Disabled button to change it to a green Enabled button.
Setting the Unit Beds Capacity Indicator
The unit beds percent capacity indicator helps to warn users who are searching for and assigning beds that a percentage of staffed beds or physical beds on a unit are already occupied or assigned. The unit beds capacity percentage is calculated by dividing the number of patients expected to be in a unit at the current time by either by the number of staffed beds OR by the number of physical beds and multiplying by 100.
The number of patients expected to be in the unit is determined by:
The number of occupied census beds + the number of activated and unactivated patient placement requests with assigned beds + the number of activated and unactivated patient placement requests that have requested a bed on the unit - the number of patients departing the unit
Whether the number of patients expected to be in the unit is divided by staffed beds or physical beds is determined by:
A setting in the Master Configuration section of the Capacity Management Administration page or Admin > Settings > Capacity Management called Calculate Bedboard Percent Capacity Indicator by. A TeleTracking Technologies representative can help you to configure this setting.
Note
Patients in Pending or Confirmed Discharge status are not part of this calculation.
The unit header does include the number of patients with Pending statuses
The Projected Census does allow for a more detailed representation as that view includes the ability to include patients based on +/- the number of hours between the current time AND the Projected Discharge Date listed in the patients record.
Example
If the Calculate Bedboard Percent Capacity Indicator by setting is set to Staffed Beds and there are 25 patients expected to be in the unit and 50 staffed beds in a unit, the unit beds capacity percentage would be:
25 / 50 x 100 = 50% of the staffed beds are already occupied or assigned.
If the Calculate Percent Capacity Indicator by setting is set to Physical Beds and there are 25 patients expected to be in the unit and 75 total physical beds in a unit, the unit beds capacity percentage would be:
25 / 75 x 100 = 33% of the physical beds are already occupied or assigned.
The second row in the heading on the electronic bedboard® view can have a green, red, or yellow border based on the unit beds capacity percentage. You can set the border to change to yellow when unit beds capacity reaches a certain percentage (for example, 75%) and then to change to red when the capacity reaches a higher percentage (for example, 95%).
To Set the Unit Beds Percent Capacity Indicator:
Access the Unit PreAdmit Settings tab.
For Percent Capacity Indicator, in the Yellow column type a percentage (for example, 75%) and in the Red column, type a higher percentage (for example, 95%).
Unable to Select a Particular Unit When Logging In
A particular unit is not available when a user with variable membership logs into XT.
Solution
For the unit to be selectable when a variable user logs in, the Allow Floaters setting must be enabled.
From Capacity Management Administration page go to Units
Select the unit that is not displaying upon user login
Enable the Allow floaters setting
Save changes
How to show Units on Bedboard
A unit is not showing on the electronic bedboard.
Solution
Go to Capacity Management Administration page
Select Unit/Zone/location management
Select Units
Select your unit from the list
To confirm that your unit shows, click the electronic bedboard icon and select your bedboard
Click View Options
Click the unit picker (magnifying glass)
You should see your unit. Check it then hit Select.
Now your unit will show on the electronic bedboard.
Note: TeleTracking Client Support is unable to change or enable settings in a production environment.
Note: If you are unable to enable any settings, or do not have the ability to navigate to the sections mentioned above, please reach out to your Supervisor, Internal Help Desk, or Internal Teletracking Administrator so they may assist you.
Configuring Unit PatientTracking Portal® Settings
Overview
Permissions Required
Accessing the Unit Settings Tab
Associating a Unit with a Staff Assignment System
Setting the Staff List Purge Time
Setting the Duration to Highlight Cared for Patients
Setting the Time Prior to a Shift that Incoming Staff List Appears
Setting the Time After a Shift that Outgoing Staff List Appears
Should a Caregiver Remain Assigned to Patient if Patient is Transferred to a Different Bed on the Same Unit?
Should a Caregiver be Unassigned from a Patient Automatically if Patient is Transferred to a Different Unit or is Discharged?
Overview
If your organization will use Staff Assignment in the PatientTracking Portal® application, there are settings for each unit that must be configured. The settings include:
Identifying the staff assignment system to be used with the system. For example, API, NNC, Optilink, Rauland or None. A selection of None would mean that your organization will fully use TeleTracking Technologies Staff Assignment dialog in the PatientTracking Portal® application.
Configuring the number of days that staff members remain on the staff assignment list without being assigned to any beds in that unit.
Configuring the duration, in hours, that the system identifies the names of patients who have been cared for by a selected staff member.
Configuring the amount of time, in minutes, that staff member names appear on the staff assignment list prior to the start of their shift.
Configuring the amount of time, in minutes, that the staff member names appear on the staff assignment list after their shift has ended.
Enabling keeping a caregiver/patient assignment when the patient is transferred to a different bed on the same unit.
Enabling removing a caregiver/patient assignment automatically when the patient is transferred to a different unit or is discharged.
Permissions Required
To access the Capacity Management Administration page menu or Admin > Settings > Capacity Management, you must have the Capacity Management Administration page Menu permission. In addition to the Unit-Cluster Management permission, which is required to gain access to the unit, you must also have membership to the selected campus. Admin rights must be enabled within the membership.
Accessing the Unit PatientTracking Portal® Settings Tab
Staff assignment settings are configured on the Unit PatientTracking Portal® Settings tab after you add or edit unit information.
To access the Unit Settings tab:
Add or edit the unit.
In the Name column, click on the name of the appropriate unit.
Click the Unit PatientTracking Portal® Settings tab.
Associating a Unit with a Staff Assignment System
The Third Party Staff Assignment System setting allows you to associate a staff assignment system with a unit. If your organization does not use a third-party assignment system, select None. If you select None, all staff assignments to beds per shift can be done through the PatientTracking Portal® application. No information from other scheduling or assignment systems will be transferred to the PatientTracking Portal® application.
To associate a staffing assignment system:
Click the Unit PatientTracking Portal® Settings tab.
In the Third Party Staff Assignment System list, select a staff assignment system vendor name.
To save your changes, click Save.
Setting the Staff List Purge Time
(Available only if None is selected in the Third Party Staff Assignment System list.)
The Purge Staff from Staff List After (Days) setting allows you to control how long a staff member who has not been assigned to a bed for a while can remain on the staff list from which assignments are made. This is helpful when staff members have left the unit permanently or when temporary staff members who work infrequently appear on the list. Staff who have not been assigned to beds for the number of days configured for this setting in the set number of days will be removed from the staff list in PatientTracking Portal® application.
To set the staff list purge time:
Click the Unit PatientTracking Portal® Settings tab.
In the Purge Staff from Staff List After (Days) box, enter the number of days after which inactive unit staff will be removed from the Staff Assignment list. Enter a zero to disable this setting. When this setting is zero, the system will not remove staff members from the list.
To save your changes, click Save.
Setting the Duration to Highlight Cared For Patients
(Available only if None is selected in the Third Party Staff Assignment System list.)
When users assign staff members to beds, it is often helpful for them to see which patients a staff member cared for recently. The names of patients whom a selected staff member cared for can be highlighted on the Staff Assignment window in the PatientTracking Portal® application. This is helpful so that you can assign the same staff member to the same patient from day-to-day allowing for continuity of care. The Duration to Highlight Cared for Patients (Hours) setting allows you set the number of hours that the patients’ names are highlighted.
To set the duration to highlight cared for patients:
Click the Unit PatientTracking Portal® Settings tab.
In the Duration to Highlight Cared for Patients (Hours) box, enter the number of hours that the Staff Assignment window highlights patients who have been cared for by the selected staff member. Enter a zero to disable this setting. When this setting is zero, patient names will never be highlighted.
To save your changes, click Save.
Setting the Duration to Highlight Cared For Patients
(Available only if None is selected in the Third Party Staff Assignment System list.)
When users assign staff members to beds, it is often helpful for them to see which patients a staff member cared for recently. The names of patients whom a selected staff member cared for can be highlighted on the Staff Assignment window in the PatientTracking Portal® application. This is helpful so that you can assign the same staff member to the same patient from day-to-day allowing for continuity of care. The Duration to Highlight Cared for Patients (Hours) setting allows you set the number of hours that the patients’ names are highlighted.
To set the duration to highlight cared for patients:
Click the Unit PatientTracking Portal® Settings tab.
In the Duration to Highlight Cared for Patients (Hours) box, enter the number of hours that the Staff Assignment window highlights patients who have been cared for by the selected staff member. Enter a zero to disable this setting. When this setting is zero, patient names will never be highlighted.
To save your changes, click Save.
Setting the Time Prior to a Shift that Incoming Staff List Appears
(Available only if None is selected in the Third Party Staff Assignment System list.)
The Time to Show Staff Before Shift Start (Minutes) setting allows you to set the number of minutes that the Staff Assignment window displays a list of staff members scheduled for the next shift. This may be helpful so that staff members can be assigned to beds prior to their shift starting.
This setting is disabled if shifts are not defined for this unit.
To set the time prior to a shift that incoming staff list appears:
Click the Unit PatientTracking Portal® Settings tab.
In the Time to Show Incoming Staff Before Shift Start (Minutes) box, enter the number of minutes before a shift that you want the incoming staff members to appear. Enter a zero to disable this setting. When this setting is zero, incoming staff members will not appear before their shifts start.
To save your changes, click Save.
Setting the Time After a Shift that Outgoing Staff List Appears
(Available only if None is selected in the Third Party Staff Assignment System list.)
The Time to Show Staff After Shift End (Minutes) setting allows you to set the number of minutes that the Staff Assignment window displays the list of staff members from the previous shift. This setting may be helpful so that the incoming shift knows who on the outgoing shift to talk to about their mutual patients.
This setting is disabled if shifts are not defined for this unit.
To set the time after a shift ends that the outgoing staff list displays:
Click the Unit PatientTracking Portal® Settings tab.
In the Time to Show Staff After Shift Ends(Minutes) box, enter the number of minutes to display staff after the shift has ended. Enter a zero to disable this setting. When this setting is zero, outgoing staff members will not appear after their shifts have ended.
To save your changes, click Save.
Should a Caregiver Remain Assigned to Patient if Patient is Transferred to a Different Bed on the Same Unit?
You can ensure that the same caregiver is assigned to a patient after the patient is transferred to a different bed on the same unit. This can promote consistency of care for patients who are staying in the unit, but will be in different beds. This feature is disabled by default when the Capacity Management Suite® solution is first installed. Enable it manually.
To keep caregiver/patient assignment after patient is transferred to a different bed on this unit:
Click the Unit PatientTracking Portal® Settings tab.
In Retain Caregiver Assignment on Unit Transfer make sure the green Enabled button appears. If a gray Disabled button appears, click it to change it to a green Enabled button.
To save your changes, click Save.
Should a Caregiver be Unassigned from a Patient Automatically if Patient is Transferred to a Different Unit or is Discharged?
A caregiver assignment to a patient can be removed automatically when the patient is transferred to a different unit or is discharged. This can save the staff time and effort, as they do not have to remove a caregiver assignment for a patient who is no longer on the unit manually. This feature is disabled by default when the Capacity Management Suite® solution is first installed. Enable it manually.
To remove caregiver/patient assignment automatically after patient is transferred to a different unit or is discharged:
Click the Unit PatientTracking Portal® Settings tab.
In Remove Caregiver Assignment on Discharge or Off-Unit Transfer make sure the green Enabled button appears. If a gray Disabled button appears, click it to change it to a green Enabled button.
To save your changes, click Save.
Shift
The shift that has been set appears above the columns in the list view. Administrators with appropriate permissions can set the shifts. For more information on setting shifts, Administrators can click Capacity Management Administration page > (or Admin > Settings > Capacity Management) > Unit/Zone/Location > Units, and then Help, and then see Unit, Zone, Physical Structure, and Location Configuration Units and then Configuring Unit PreAdmitTracking® application Application Settings.
Unit Patients Tab
Unit Picker
Unit Picker - Workflow
The unit picker allows you to remove or add units to your console or electronic BedBoard view.
Steps
Console
To select a Unit that you need to see or with you will want to do the following:
Click the magnifying glass icon to display the Unit dialog box.
In the Campus list, select a campus name to display a list of units.
Select the names of the units to place check marks next to them.
Click the Add > button to place the selected units in the list on the right side.
Click the < Remove button to place the selected units back in the list on the left side
Electronic BedBoard
Click the electronic BedBoard icon, then select your BedBoard from the list.
The electronic BedBoard will load, you will then select View Options.
Within View Options you will click on the magnifying glass.
Put a checkmark in front of the campus and unit(s) you want to display, and hit Select when finished.
This will display those selected units on the electronic BedBoard.
Not Able to Select Units
If you are not able to select units following the steps above, you will want to reach out to your internal admin to do so, or have the correct permissions added to your profile.
Users
Converting a Temporary User to Capacity Management Suite® Solution User
About
Your organization may use temporary employees to meet scheduling needs. You may choose to create a temporary user account for temporary employees in the Capacity Management Suite® solution. Temporary users are unable to perform any actions in the Capacity Management Suite® solution. If a temporary employee is converted to a full-time employee at your hospital, you may need to create a permanent user account for that employee in the Capacity Management Suite® solution. For example, your organization might have hired agency staff to supplement staffing. A temporary account was created to enable agency staff to be assigned to beds through the Staff Assignment window in the PatientTracking Portal® application. If that agency staff member becomes a new employee of the hospital, you might want to give her access to the Capacity Management Suite® solution. You can convert that nurse's temporary account into a permanent account using the temporary account as a starting point.
Permissions Required
Which permissions and memberships are required to complete this task? To access the Capacity Management Administration page menu or Admin > Settings > Capacity Management, you must have the Capacity Management Administration page Menu permission. To access administrative groups you must have the Global Admin Permissions-Administrative Controls-User Management permission. To change user information, you must have Edit rights. If you have View rights you can see, but not change, user information. Your Membership Type must be All and Administrative Rights to the membership must be enabled. Or, your Membership Type can be Fixed with a campus-, cluster-, or unit-level membership with Administrative Membership rights enabled. You can only see, add, or edit user information for users within your membership.
Users are assigned levels when their information is added to Capacity IQ®.
Converting a Temporary User
Do one of the following to display the Users tab.
Go to Capacity Management Administration page, > User Management > User Management > Users
Go to Admin > Settings > Capacity Management > User Management > Users.
On the Users tab, in the User type drop down, click Temporary Users.
Find the temporary user to be converted to a Capacity Management Suite<sup>®</sup> solution user.
Note:
You can narrow (filter) the list of users on the Users tab.
You can click the numbered links to see lists of additional users, click
>>
to display the last page, click<<
to display the first page, or click<
or>
to display the previous or next page.If you filter the list of users and then click a name to view or edit a user profile or click Add User to add a new user, and then return to the Users tab, the filtered list will appear on the Users tab.
The column names on the tabs are user attributes (such as last name).
Click the -- ID in the User Login ID column. The profile information for the selected user appears.
Important Note:
The Last Name, First Name, Staff Type, and, if entered Alias, will be pre-populated with the information entered from the Staff Assignment window when the temporary user account was created.
Click Save.
The Membership, BedTracking Assignment, and TransportTracking Assignment tabs appear.
Adding, Copying, or Editing a User
About
Everyone in your organization who will use the Interactive Voice Response (IVR) system or any part of Capacity Management™ Suite is a user. For every user you must:
Add the user's information in the Capacity Management Administration page or Admin > Settings > Capacity Management and select a role.
If the user has a fixed membership type, set the user's membership (and give them administrative rights, if appropriate).
If the user is involved with transport or bed cleaning jobs (for example, is a transporter, bed cleaner, or supervisor), assign the user to sections and zones.
Assign the user's base unit.
You may edit user information later if needed (for example, reset a password, change a membership, or change a last name). You may also copy an existing user's information in order to add a new user.
You can add, edit, or copy user information through the Users tab in the Capacity Management Administration page or Admin > Settings > Capacity Management component.
Permissions Required
Which permissions and memberships are required to complete this task? To access the Capacity Management Administration page menu or Admin > Settings > Capacity Management, you must have the Capacity Management Administration page Menu permission. To access administrative groups you must have the Global Admin Permissions-Administrative Controls-User Management permission. To change user information, you must have Edit rights. If you have View rights you can see, but not change, user information. Your Membership Type must be All and Administrative Rights to the membership must be enabled. Or, your Membership Type can be Fixed with a campus-, cluster-, or unit-level membership with Administrative Membership rights enabled. You can only see, add, or edit user information for users within your membership.
About the XTAdministrator User
(For users who have upgraded from Capacity Management™ Suite version 3.1 and earlier only.)
On the Users tab in the Capacity Management Administration page or Admin > Settings > Capacity Management component, it is possible to see a default user called XTAdministrator. The XTAdministrator user has all of the rights of the BedTracking® application, PreAdmitTracking® application application, and TransportTracking™ application administrators.
DO NOT:
Use the user ID for any reason.
Edit the user profile, membership, or assignments.
Deactivate the user.
Change the ADT ID.
To Navigate to the Users Tab to Add, Copy, or Edit User Information:
Do one of the following:
Go to Capacity Management Administration page, > User Management > User Management>Users
Go to Admin > Settings > Capacity Management > User Management > Users.
If your Capacity Management Suite® solution is IQ-Enabled and you have created a TeleTracking IQ® platform user who has the Capacity Management User role, then select the Access Permissions link in the TeleTracking IQ® platform >User Account > Capacity Management Suite™ Information section. You can then configure the user's permissions in the Capacity Management Suite®.
Note
You can narrow (filter) the list of users on the Users tab.
You can click the numbered links to see lists of additional users, click >> to display the last page, click << to display the first page, or click < or > to display the previous or next page.
If you filter the list of users and then click a name to view or edit a user profile or click Add User to add a new user, and then return to the Users tab, the filtered list will appear on the Users tab.
The column names on the tabs are user attributes (such as last name).
On the Users tab, do one of the following:
To add a new user, click Add.
To edit an existing user's information or to open a user's profile so that you can copy it to create a new user, click the user's login ID in the User Login ID column.
A page for adding or editing user profile information (such as name, password, and title) appears. If the user's information has been saved already, the Membership, (if applicable) TransportTracking™ Assignment, and (if applicable) BedTracking® Assignment tabs appear at the bottom of the page. If you are adding a new user, these tabs do not appear until after you have saved.
For instructions about using this page to copy a user, complete user profile information, set a user's membership, and set a user's assignment, see How to Add, Copy, or Edit User Information.
To Navigate to the Users Tab to Add, Copy, or Edit User Information:
Access the Roles tab.
In the Role name column, click the role that you want to copy to display it on the Role page.
Note
You can narrow (filter) the list of roles displayed.
On the Role page, in the upper-right corner, click Copy.
Note
If you have changed the existing role without saving, the Copy button is not available.
Type a Role Name and Role Description for the new role.
Associate the role with a group for each application following the instructions in To Edit a Role.
Click Save.
Overview
On the User page, you:
Add or edit all information required for a user's profile (for example, name, password, staff type, membership type, and role).
If you select a fixed membership type for the user, select the units and clusters to which that user will have membership. Membership affects users' ability to access patient, transport job, and employee data. For example, to see some reports about employee or transporter data, a supervisor needs to have membership that includes the base units for those employees or transporters.
Select an assignment type for the user. Assignment types affect where transporters and bed cleaners are asked to work on jobs and can affect the alerts that supervisors receive about jobs. If you select a fixed assignment type or (TransportTracking™ application only) fixed and exclusive assignment type**, then assign the user now to the sections and zones where they will always be asked to work on or to supervise jobs.
Note
Transporters, bed cleaners, and supervisors should be given assignment types. If the assignment type is fixed or fixed & exclusive (TransportTracking™ application only), then they should be assigned to sections and zones on the TransportTracking Assignments or BedTracking Assignments tab. Supervisors who do not have saved assignment types might not be able to generate some reports. If you are not going to select a specific assignment type for a user (such as Fixed), select None, and then click Save.
Note
If you click Users at the top of the page to return to the Users tab, the users who were included in your search results still appear on the tab.
Before Using the User Page
When you add or edit user information, you must select some attributes for the users from lists. For example, you must select a user's staff type, role, and title from a list. The available options in these lists are added in other sections of the Capacity Management Administration page or Admin > Settings > Capacity Management component. You or another administrator who has the appropriate permissions must add them before you can select them for a user.
In addition, before you can assign PINs, passwords, and IVR IDs to users, the parameters for them must be configured in the Capacity Management Administration page or Admin > Settings > Capacity Management component. For example, if there is a maximum required password length or if passwords must include a numeric value, that must be configured before you assign the passwords.
General Steps for Using the User Page
The following are the general steps for adding or editing users. Click the links for detailed instructions.
On the top of the page, add or edit general user profile information (such as name, user ID, password, and base unit).
Click Save.
The Membership, BedTracking Assignment, and TransportTracking Assignment tabs appear.If you selected Fixed in the Membership Type list, then on the Membership tab, set the user's membership. (Select the campus, clusters, or units in which this user has membership.)
(Required for transporters, bed cleaners, and transport and EVS supervisors) Set a user's transport assignment type and section and/or zone assignment or set a user's bed cleaning assignment type and section and/or zone assignment. Select one of the following assignment types for the user. Assignment types must be selected for bed cleaners, transporters, and supervisors.
Fixed assignment
Fixed and exclusive assignment (TransportTracking™ Only)
Variable assignment
All assignment
None
Note
If you are not going to select a specific assignment type, such as Fixed, select None, and then click Save.
If you select Fixed or Fixed & Exclusive in the Assignment Type list, then select the sections and/or zones where the transporter or bed cleaner will always be asked to work or the supervisor will always supervise jobs. This assignment could also affect the job alerts that the supervisor receives
Save user information, memberships and section and zone assignments.
If Changes are Made for Signed In Transporters or Bed Cleaners
If you change information for transporters or bed cleaners who are currently signed in to the IVR, the following message appears when you attempt to save:
“The following active users will lose the ability to perform employee activities. Please sign them out before saving changes: <list of users>”
If the transporters and bed cleaners are working on jobs when the changes are made, they could lose the ability to continue in the jobs (for example, they could lose the ability to mark a job completed).
Bed cleaners and transporters must sign out and sign in again for changes to take effect. If a user with both bed cleaner and transporter roles is signed in, changes to either role will require this user to sign out.
Copying an Existing User to Add a New One
You may copy an existing user to add a new one. This is helpful if you want to add a user who will have the same membership, assignment, and base unit as an existing user. The following information is copied from an existing user profile to a new user profile. With the exception of the information noted below, all of the copied information can be changed prior to saving the user record:
Login type
PAT Default Console View
PatientTracking Portal® Default Console View
Default View Group
Device Method
Membership Type and membership clusters and units (Cannot be changed before saving user record)
Base Unit (Cannot be changed before saving user record)
Role
Staff Type
Title
Level
Assignment Type and assignment zones and sections (Cannot be changed before saving user record)
To Copy an Existing User in Standalone Capacity Management Suite®:
With the information of the user to be copied displayed in the User Profile section, click Copy.
Note
If you have changed information but have not yet saved the changes, the Copy button appears gray and unavailable. Click Save to make the Copy button available.
To complete the user's information, follow the steps in Adding or Editing User Profile Information.
To Copy an Existing User in IQ-Enabled Capacity Management Suite®:
If you are an administrator for a health system that has the Capacity Management Suite® solution integrated with the TeleTracking IQ® platform, then you can copy portions of one user's profile to another while creating or editing users.
Create or edit "User A" in the TeleTracking IQ® platform with the Capacity Management User role.
Select the Access Permissions link in the User Account > Capacity Management Suite™ Information section.
"User A's" profile appears in the Capacity Management Suite® solution.
Select the Copy to button to add information from another user to "User A."
The User Search dialog box appears.
In User Login, enter the login for "User B" whose information you want to copy to "User A."
Select Go to search for "User B" with the login that you entered.
The search returns one user who is User B.
Note: You must enter the exact login for the user whose information you want to copy.
Click Select User.
The Capacity Management Suite® details page for "User A" appears. The information from "User B" automatically appears in the correct fields.
Example:
Administrator Alice knows that she wants to create a new user who has Eric McDonald's information. Before she begins, she copies Eric's login. Then, she creates or edits a user named John Jones in the TeleTracking IQ® platform with the Capacity Management User role. The Capacity Management Suite™ Information section appears in John's TeleTracking IQ® platform user account. Alice selects the Access Permissions link to display John Jones' user profile page in the Capacity Management Suite® solution. Then, she selects the Copy to button in the top right to display the User Search dialog box. Alice wants to add information from the user Eric McDonald to John Jones' profile, so in the User Search dialog box, she enters Eric's login, which she previously copied. Alice reviews the user that the search returns. The returned user has Eric McDonald's name, base campus, and assignment as Alice expects. She clicks Select User. John Jones' profile now displays fields populated with Eric McDonald's information.
Configuring Users to Select Campuses
Which Users Can Select Campuses?
EVS employees and transporters who use the TeleTracking EVS™ or the TeleTracking Transporter™ mobile applications can be configured to select the campus at which they will work when they sign in for the day.
How to Configure Transporters and EVS Employees to Select Campuses
Verify the User's Group Configuration
Go to Capacity Management Administration page > User Management > User Management > Groups tab.
Select the name of the user's group to display the group details page.
Do one of the following as appropriate for the type of user you are configuring:
EVS Employees: Go to the Global BedTracking Permissions > BedTracking Functions section, and make sure Employee Workflow is Enabled.
Transporters: In the Global TransportTracking Permissions > TransportTracking Functions section, make sure Transporter workflow, responsible for executing Transport Jobs Workflow is Enabled.
Select the Configuration Options for Select Campus Functionality
Go to Capacity Management Administration page > User Management > User Management > Users tab to display the Users in this enterprise list. Select the user to display the details page.
In the Profile information section, select the Fixed option in the Membership drop-down list.
In the Membership & Assignment section at the bottom of the page, select the Membership tab. Remove any existing units/wards by selecting the top box next to Wards / Clusters in membership, and then select Delete Selected Records.
In the Membership & Assignment section, select Add to display the Membership: Select Clusters and Wards dialog box. Select the plus sign (+) next to the health system name to display its campuses. Select more than one campus for employees who can change the campus at which they work.
Select Add. Then select Close to dismiss the dialog box.
The campuses appear in the Membership & Assignment section > Membership tab.
In the Membership & Assignment section, go to the BedTracking Assignment tab for EVS employees or the TransportTracking Assignment tab for transporters.
In the Assignment type field, select the Variable option in the list.
When the employee signs into the TeleTracking EVS™ or the TeleTracking Transporter™ mobile app, they will be prompted to select the campus at which they will work that day.
Resetting a User's Password or PIN
About
If you have the permission listed below, you may reset a user's password or PIN from the Users tab. Resetting creates a temporary password or PIN. After signing in with the temporary password or PIN, the user will need to change it.
Permissions Required
To access the Capacity Management Administration page menu or Admin > Settings > Capacity Management, you must have the Capacity Management Administration page Menu permission. The Reset User Password/PIN permission is required to perform this task. However, if you also want to add, edit, activate, or deactivate users from the Users tab, you must have the User Management permission.
To Reset a Password or PIN
Do one of the following to access the Users tab:
Go to Capacity Management Administration page > User Management > User Management > Users
Go to Admin > Settings > Capacity Management > User Management > Users
On the Users tab, in the first column, select the check box corresponding to the user whose password or PIN must be changed.
Click Reset Password or Reset PIN.
When a message appears indicating that the password or PIN has been changed to a temporary password or PIN, note the temporary password or PIN so that you can give it to the user, and then click OK to close the message box.
Note:
Users with a Login Type of Standard who have an email address defined for their account will receive an email with the new password to that email address.
Activating or Deactivating a User
If a user should no longer have access to any applications, you can deactivate the user. If a user was deactivated previously but should be able to access the applications now, then you can activate the user. Deactivating prevents users from signing in.
Permissions Required
To access the Capacity Management Administration page menu or Admin > Settings > Capacity Management, you must have the Capacity Management Administration page Menu permission. To access administrative groups, you must have the Global Admin Permissions-Administrative Controls-User Management permission. To change user information, you must have Edit rights. If you have View rights, you can see, but not change, user information. Your Membership Type must be All and Administrative Rights to the membership must be enabled. Alternatively, your Membership Type can be Fixed with a campus-, cluster-, or unit-level membership with Administrative Membership rights enabled. You can only see, add, or edit user information for users within your membership.
To Deactivate or Activate Users
Access the Users tab.
Note: You can narrow (filter) the list of users on the Users tab. You can click the numbered links to see lists of additional users, click >> to display the last page, click << to display the first page, or click < or > to display the previous or next page.
Select the check boxes for the users who should be deactivated or activated.
Do one of the following:
To deactivate users, click Deactivate. A gray background appears around the deactivated user records, and the users' logins are disabled. A confirmation message appears at the top of the tab.
To activate users who were previously deactivated, click Activate. The gray background is removed, and the users' logins are enabled. A confirmation message appears at the top of the tab.
Adding Users in Bulk
About
The Add Bulk User function allows you to add multiple users at one time. You can add the users manually through the Bulk Create page or by uploading an Excel template. The Bulk Create page allows you to enter users through the Capacity Management Administration page component or through Admin > Settings > Capacity Management. The Excel template allows you to create the user list and then upload it to the Capacity Management Suite® solution though the Bulk Create page.
If the Capacity Management suite is TeleTracking IQ-enabled, then the Add Bulk button is not available. In that case, adding users in bulk is completed in the TeleTracking IQ® platform.
Permissions Required
Which permissions and memberships are required to complete this task? To access the Capacity Management Administration page menu or Admin > Settings > Capacity Management, you must have the Capacity Management Administration page Menu permission. To access administrative groups you must have the Global Admin Permissions-Administrative Controls-User Management permission. To change user information, you must have Edit rights. If you have View rights you can see, but not change, user information. Your Membership Type must be All and Administrative Rights to the membership must be enabled. Or, your Membership Type can be Fixed with a campus-,cluster-,or unit-level membership with Administrative Membership rights enabled. You can only see, add, or edit user information for users within your membership.
To Access the Bulk Create Page:
Go to Capacity Management Administration page, > User Management > User Management>User to display the User Management page.
Click Add Bulk to display the Bulk Create page.
To Add Bulk Users using the Bulk Create Page:
Note
Fields on the page marked with a red \* are required.
Access the Bulk Create Page.
Ensure Manual is selected.
Under Login Type, choose from MSAD and Standard. If the user should use an assigned user ID to sign in, select Standard. If the user should use his or her Microsoft® Active Directory credentials to sign in, then select MSAD. This option is only available if the single sign-on feature has been configured at your organization.
Under User Login ID, enter the user's login ID.
Under First Name, enter the user's first name.
Under Last Name, enter the user's last name.
Under IVR ID, enter the IVR ID for the user.
Under User Template Type, select a template to use for the bulk upload. The template assigns additional attributes to the user. See Creating User Template Type for more information regarding the template.
Under Campus, select the campus in which the user's base unit is located.
Under Base Unit, select the base unit to which this user should be assigned.
(Recommended for transporters and transport job requesters) Under Base Location, select a base location for a transporter or transport job requester or a bed cleaner. For transporters, the base location will be the default origin location in transport requests if the transporter presses # on the IVR when prompted for an origin location. For transport job requesters, the base location is the default origin or destination for item requests that have "Base" as the override for origin or destination locations. In the BedTracking® application, a base location could be a central EVS office. The locations in the list are within the unit selected in the previous step.
Under the first column, click the plus sign (+) to add a row to enter user information for additional users.
Repeat steps 1 through 12 for each additional user.
Click Save.
If no errors are present on the form, all new users are saved.
If errors are present, none of the new users are saved. The user rows with the errors are identified.
Correct the errors and click Save.
To Add Bulk Users Using an Excel Template:
Note
Fields on the page marked with a red \* are required.
Access the Bulk Create Page.
Click Spreadsheet.
Click User Template Type to download a template in Excel format. A dialog appears with the following options:
Open—Click Open to open the Excel file and enter the user information. Save the file to your computer.
Save—Click Save to save the file. An Internet Explorer dialog appears with options to open the file or open the folder containing the file. After opening the file, enter the user information, and save the file to your computer.
Save As—Click Save As. A Save As dialog appears. Navigate to the location in which you want to save the file. Click Save. An Internet Explorer dialog appears with options to open the file or open the folder containing the file. After opening the file, enter the user information, and save the file to your computer.
Complete the required information on the Excel template.
Under Login Type, choose from MSAD and Standard. If the user should use the assigned user ID to sign in, select Standard. If the user should use his or her Microsoft® Active Directory credentials to sign in, then select MSAD. This option is only available if the single sign-on feature has been configured at your organization.
Under User Login ID, enter the user's login ID.
Under First Name, enter the user's first name.
Under Last Name, enter the user's last name.
Under IVR ID, enter the IVR ID for the user.
Under User Template Type, select a template to use for the bulk upload. The template assigns additional attributes to the user. See Creating User Template Type for more information regarding the template.
Under Campus, select the campus in which the user's base unit is located.
Under Base Unit, select the base unit to which this user should be assigned.
(Recommended for transporters and transport job requesters) Under Base Location, select a base location for a transporter or transport job requester or a bed cleaner. For transporters, the base location will be the default origin location in transport requests if the transporter presses # on the IVR when prompted for an origin location. For transport job requesters, the base location is the default origin or destination for item requests that have "Base" as the override for origin or destination locations. In the BedTracking® application, a base location could be a central EVS office. The locations in the list are within the unit selected in the previous step.
Go to the next row in the template and repeat steps a through 1 for each user to be added.
Save the file in .csv format.
Click Browse.... The Choose File to Upload dialog appears.
Navigate to the location of the completed template, and select the file name.
Click Open. The location of the file appears in the File Path box.
Click Upload. The user information from the template displays on the Bulk Create page. From here, you can update any user information that may be incorrect.
Click Save.
If no errors are present on the form, all new users are saved.
If errors are present, none of the new users are saved. The user rows with the errors are identified.
Correct the errors and click Save.
Creating and Editing a User Template Type
About
The User Templates define attributes for a user type including role, membership, assignments for the TransportTracking™ application and BedTracking® application, staff type, level, password, pin, and whether or not the user type will receive post dispatch set paging. These templates are used in conjunction with the add bulk user function, see Adding Bulk Users for more information.
Permissions Required
Which permissions and memberships are required to complete this task? To access the Capacity Management Administration page menu or Admin > Settings > Capacity Management, you must have the Capacity Management Administration page Menu permission. To access administrative groups you must have the Global Admin Permissions-Administrative Controls-User Management permission. To change user information, you must have Edit rights. If you have View rights you can see, but not change, user information. Your Membership Type must be All and Administrative Rights to the membership must be enabled. Or, your Membership Type can be Fixed with a campus-,cluster-,or unit-level membership with Administrative Membership rights enabled. You can only see, add, or edit user information for users within your membership.
To Access the User Template Type Page
Do one of the following to display the User management page:
Go to Capacity Management Administration page, > User Management > User Management.
Go to Admin > Settings > Capacity Management > User Management.
Click the User Template Type tab to display a list of available template types.
To Create a User Template Type:
Access the User Template Type page.
Click Add New. The Configure User Template dialog appears.
In Template Name, enter a name for the template.
In Template Description, enter a brief description for the template.
In Role, select the role for this user type.
In Membership, select the membership type for this user type. Choose from fixed for campus or variable.
In TT Assignment, select the assignment type for this user type. Choose from fixed for campus or variable.
In BT Assignment, select the assignment type for this user type. Choose from fixed for campus or variable.
In Staff Type,select the staff type for this user type.
In Level, select a level to assign a level to this user so that alerts about transport or bed cleaning jobs can be escalated to them if a specified amount of time has passed and there is no response for the job. Users with Levels 2 though 5 may subscribe to notifications and receive alerts. If this user should never receive notifications or alerts, select None.
In Password, enter a password for this user type.
In Pin, enter a pin for this user type.
Note
If you are entering a password and pin for this user type, the password and pin must conform to enterprise rules for passwords and pins.
If your site uses active directory for sign in, you will be required to include a password and pin on the template. However, when the user attempts to sign into the Capacity Management Suite® solution, the user will not be required to enter a password or pin.
For TransportTracking™ application users, in Post dispatch paging, select the check box to allow transporters to receive a message with job details after accepting a transport job. Do not select this check box for users who are not transporters.
Click Save. The Configure User Template closes.
To Edit a User Template Type:
Access the User Template Type page.
Under Name, click the name of the user template type to be edited. The Configure User Template dialog appears.
Edit the desired fields. See Create a User Template Type for more information on the fields.
Click Save. The Configure User Template closes.
To Delete a User Template Type:
Access the User Template Type page.
Select the check box for the user template types to be deleted.
Important Note!
There are several User Template Types that appear automatically and cannot be deleted. The check box for these templates is grayed out and cannot be selected.
Click Delete Selected Records. A confirmation dialog appears.
Click Cancel to cancel the deletion.
Click OK to delete the template.
Editing Users in Bulk
About
The User Bulk Edit function allows you to edit attributes for multiple users at one time if you are assigning the same attributes to the selected users. For users, you can update the language users will hear through the IVR, roles, base unit and the campus to which that unit belongs, staff type, alert level, employee category, membership type, default view group, BedTracking® application assignment, TransportTracking™ application assignment, and toggle the post dispatch paging option.
Permissions
Which permissions and memberships are required to complete this task? To access the Capacity Management Administration page menu or Admin > Settings > Capacity Management, you must have the Capacity Management Administration page Menu permission. To access administrative groups you must have the Global Admin Permissions-Administrative Controls-User Management permission. To change user information, you must have Edit rights. If you have View rights you can see, but not change, user information. Your Membership Type must be All and Administrative Rights to the membership must be enabled. Or, your Membership Type can be Fixed with a campus-,cluster-,or unit-level membership with Administrative Membership rights enabled. You can only see, add, or edit user information for users within your membership.
To Edit Users in Bulk:
Do one of the following to display the Users page:
Go to Capacity Management Administration page, > User Management > User Management>Users
Go to Admin > Settings > Capacity Management > User Management > Users.
Select the check boxes for the users whom you want to edit.
Click Edit selected records. The User Bulk Edit page appears.
Note
If the selected users have different values for the same field already assigned (for example, different languages), then "Select..." appears under the Value column for that attribute. If they have the same values (for example, same role), then that value appears.
Under Attribute, select the check box corresponding to the attributes to be updated. The attribute values under Value become active.
Choose from the following to update:
Attribute | To do this.. . . | Complete this procedure . . . |
Language | Select the language in which the user will hear information on the Interactive Voice Response (IVR) system. | The available language options are configured in the Master Configuration>Language section of the Admin Too or Admin > Settings > Capacity Management. A TeleTracking Technologies representative must help you to configure language options in Master Configuration. |
Role | Select the role that the user will have. The selected role determines the user's group of permissions for each application. | Select a role.<br />- Note<br />- If you edit user information and you select a different role for an existing user to give them new permissions, the new permissions will not take effect until the user signs in again. You cannot edit user information while the user is signed in. |
Base Unit and Base Location | Select a TransportTracking™ or BedTracking® base unit and base location or a PreAdmitTracking® application base unit for the user. The base unit affects things such as the user's access to data on reports.For transporters, the base location will be the default origin location in transport requests if the transporter presses # on the IVR when prompted for an origin location. For transport job requesters, the base location is the default origin or destination for item requests that have "Base" as the override for origin or destination locations. In the BedTracking® application, a base location could be a central EVS office. The locations in the list are within the unit selected in the previous step. | Select a unit. Select a base location from that unit. (Selecting a base location is recommended for users who are transporters or transport requesters.) If the selected users already have different base locations associated with their user profiles or if they do not have base locations associated with their user profiles, then no base location appears in the Base Location list. A base location appears only if the selected users have the same base location associated with their user profiles. Only a unit that has at least one location associated with it can be selected as a base unit. |
Staff Type | Select the user's staff type, such as transport requester , EVS bed cleaner or employee, EVS supervisor, Registered Nurse, Licensed Practical Nurse, or Nursing Assistant. | Select a staff type.- Note- Staff types in this list were entered in the Dictionary Management section of the Capacity Management Administration page or Admin > Settings > Capacity Management component. To learn how staff types are entered into this list, see Configuring Staff Types. |
Level | Assign a level to this user so that alerts about transport or bed cleaning jobs can be escalated to them if a specified amount of time has passed and there is no response for the job. Users with Levels 2 though 5 may subscribe to notifications and receive alerts. If this user should never receive notifications or alerts, select None.<br />- Example<br />If there is no response to a request for a transport job after a certain period of time, an automatic message (or alert) is sent to a supervisor at Level 2. If there is still no response after a certain period of time, the alert is escalated and sent to a supervisor at Level 3. This continues until either there is a response or a supervisor at Level 5 receives an alert. | Select a level from the list. |
Employee Category | It is possible to select an employee category (for example, All Transporters) when generating a report instead of, or in addition to, selecting individual employee names. If this user should be grouped with other employees whose data should be included on the same reports, then select an employee category to associate with this user. | Select an employee category name. The employee categories that appear in this list were entered in the Dictionary Management section of the Capacity Management Administration page or Admin > Settings > Capacity Management component. Employee categories are associated with campuses. You may only select an employee category that is associated with the campus containing this employee's base location. A base location cannot be changed after it is saved. Verify that you have selected the base location with which you want to associate this employee before selecting an employee category and before saving. |
Membership Type | Select whether the user has fixed, variable, or all membership. (Click the links for definitions of each type.) Membership can determine the employee, patient, and job data that the user has access to. For example, in the PatientTracking Portal® application, users can select units to display. They can only select units that are included in their memberships. | Select Fixed, Variable, or All.<br />The All membership type is only available to select if your membership type is All.<br />If Fixed is selected, you must set the user's membership.<br />1. Click the magnifying glass. The Membership: Users: Select Campus, Clusters, and Units dialog box.<br />- Note: This dialog box displays the hierarchy of enterprises>campuses>units and/or clusters.<br />- Note<br />You can only add units and clusters to which you have membership and for which you have administrative rights enabled.<br />1. Do one of the following:<br />- To add all of the units and clusters in a campus to the Membership tab, select the check box for that campus, and then click Add.<br />- To add specific units or clusters to the tab, select the check boxes for those units and clusters, and then click Add.<br />- To add everything on the dialog box to the tab, click Add All.<br />Note: If you do not see a specific campus, unit, or cluster, click the + next to the enterprise or campus to display the campuses and units or clusters under them.<br />1. Click Close. The dialog box closes and the selected campuses, clusters and units appear in the Membership Type row. |
Post Dispatch Paging | Allow this transporter to receive a message with job details after accepting a transport job so that they do not have to write down the job details while listening to the IVR. Post Dispatch Paging can reduce a transporter's time and effort when accepting a job over the IVR. The transporter does not have to write down all job details when accepting the job. Instead, a message with job details will be sent to that transporter after the job has been accepted. Because the transporter does not write down patient health information, there is a greater opportunity to protect this information. Transporters using digital pagers cannot receive post-dispatch pages. Post-dispatch pages can only be received on alpha pagers. | Select the Post Dispatch paging check box to allow this transporter to receive a message with job details after accepting a transport job. Do not select this check box for users who are not transporters. |
Default View Group | This is the default view group for which the user may save, load, and delete consoles. View groups are entered in the Dictionary Management section of the Capacity Management Administration page or Admin > Settings > Capacity Management. Users cannot change their own default view groups. | Select the view group name. |
BedTracking Assignment | Both bed cleaners (EVS employees) and EVS supervisors must have assignment types. Bed cleaners' assignment types and assignments affect where they are asked to work and supervisors' assignment types and assignments can affect the alerts that they receive about jobs.<br />Select an assignment type for the user to determine whether the user:<br />- Will always be asked to work on or supervise jobs in specific, selected sections and zones (Fixed).<br />- Will enter the sections and zones where they will work each time they sign in to the IVR (Variable).<br />- Is always eligible to work in or supervise jobs for the entire campus (All). | Select Fixed, Variable, All, or None.<br />If you select Fixed as the assignment type, then assign the user to sections and/or zones within a campus.<br />- Note<br />If a section includes both exclusive and non-exclusive zones, then zones must be assigned individually to variable and fixed (non-exclusive) users.<br />1. Click the magnifying glass. The Select Sections and Zones dialog displays.<br />- Note: This dialog box displays the hierarchy of existing zones and sections. To display the zones names under the sections, click the +.<br />1. In the Campus list, select the appropriate campus.<br />1. Do one of the following:<br />- To add all of the zones within a specific section or sections to the tab, select the check boxes for those sections, and then click Add.<br />- To add specific zones, select the check boxes for those zones, and then click Add.<br />1. Click Close. The dialog box closes and the selected zones and sections appear in the BedTracking Assignment row. |
TransportTracking Assignment | Both transporters and transport supervisors must have assignment types. Transporters' assignment types and assignments affect where they are asked to work and supervisors' assignment types and assignments can affect the alerts that they receive about transport jobs.<br />Select an assignment type for the user to determine whether the user:<br />- Will always be asked to work on or supervise transport jobs in specific, selected sections and zones (Fixed or Fixed & Exclusive).<br />- Will enter the sections and zones where they will work each time they sign in to the IVR (Variable).<br />- Is always eligible to work in or supervise transport jobs for the entire campus (All). | Select Fixed, Fixed and Exclusive Variable, All, or None<br />If you select Fixed or Fixed & Exclusive as the assignment type, then assign the user to sections and/or zones within a campus.<br />1. Click the magnifying glass. The Select Sections and Zones dialog displays.<br />- Note<br />This dialog box displays the hierarchy of existing zones and sections. To display the zones names under the sections, click the +.<br />1. In the Campus list, select the appropriate campus.<br />1. Do one of the following:<br />- To add all of the zones within a specific section or sections to the tab, select the check boxes for those sections, and then click Add.<br />- To add specific zones, select the check boxes for those zones, and then click Add.<br />1. Click Close. The dialog box closes and the selected zones and sections appear in the TransportTracking Assignment row. |
Do one of the following:
Click Save to save the user attribute updates for the selected users and close the User Bulk Edit dialog.
Click Close to close the User Bulk Edit dialog without saving your changes to the selected users.
Setting the User's Transport Assignment Type and Assigned Sections and/or Zones
Both transporters and transport supervisors must have assignment types. Transporters' assignment types and assignments affect where they are asked to work and supervisors' assignment types and assignments can affect the alerts that they receive about transport jobs.
Select an assignment type for the user to determine whether the user:
Will always be asked to work on or supervise transport jobs in specific, selected sections and zones (Fixed or Fixed & Exclusive).
Will enter the sections and zones where they will work each time they sign in to the IVR (Variable).
Is always eligible to work in or supervise transport jobs for the entire campus (All).
If you select Fixed or Fixed & Exclusive as the assignment type, then assign the user to sections and/or zones within a campus.
To Set the User's Assignment Type and (if applicable) Assigned Sections and Zones:
With the user information displayed in the User Profile section of the User page, click the TransportTracking Assignment tab.
In the Assignment Type list, select one of the following assignment types for the user. For more detailed descriptions, click the links below.
Note
Supervisors who do not have saved assignment types might not be able to generate some reports or receive notifications when transporters reject transport jobs. If you are not going to select a specific assignment type, such as Fixed, select None, and then click Save.
Fixed
Fixed & Exclusive
Variable
All
None (No assignment)
If the user has a Fixed or (TransportTracking™ application only) Fixed & Exclusive assignment type, then select specific zones and/or sections to assign. To assign zones and/or sections to the user, add the zones and sections to the TransportTracking Assignment tab.
Note
If a section includes both exclusive and non-exclusive zones, then zones must be assigned individually to variable and fixed (non-exclusive) users.
If some zones or sections should no longer be assigned to the user:
Select the check boxes for them or select the check box in the Sections and Zones in Assignment title bar to select all of them, and then click Delete Selected Records.
When a confirmation message appears, click OK.
Setting the User's Bed Cleaning Assignment Type and Assigned Sections and/or Zones
Both bed cleaners (EVS employees) and EVS supervisors must have assignment types. Bed cleaners' assignment types and assignments affect where they are asked to work and supervisors' assignment types and assignments can affect the alerts that they receive about jobs.
Select an assignment type for the user to determine whether the user:
Will always be asked to work on or supervise jobs in specific, selected sections and zones (Fixed).
Will enter the sections and zones where they will work each time they sign in to the IVR (Variable).
Is always eligible to work in or supervise jobs for the entire campus (All).
If you select Fixed as the assignment type, then assign the user to sections and/or zones within a campus.
Note
If a section includes both exclusive and non-exclusive zones, then zones must be assigned individually to variable and fixed (non-exclusive) users.
To Set the User's Assignment Type and (if applicable) Assigned Sections and Zones:
With the user information displayed in the User Profile section of the User page, click the BedTracking Assignment tab.
In the Assignment Type list, select one of the following assignment types for the user.
Note
Supervisors who do not have saved assignment types and assignments cannot receive No Coverage Alerts.
Fixed (always assigned to the same sections and zones automatically)
Variable (must enter sections and zones when signing in each time)
All (may work in and can receive alerts for all sections and zones)
None (No assignment)
If the user has a Fixed assignment type, then select specific zones and/or sections to assign. To assign zones and/or sections to the user, add the zones and sections to the BedTracking Assignment tab.
If some zones or sections should no longer be assigned to the user:
Select the check boxes for them or select the check box in the Sections and Zones in Assignment title bar to select all of them, and then click Delete Selected Records.
When a confirmation message appears, click OK.
Saving User Information, Memberships, and Section and Zone Assignments
Do one of the following:
To save but keep this user's information displayed, click Save.
To save this user and add another one, click Save and Add New.
How Permissions, Roles, and Groups Affect User Capabilities
The ability to perform tasks such as creating requests for transport jobs, dispatching themselves to a transport job, creating or canceling a bed request, or suspending or canceling a bed cleaning job are controlled by permissions.
Permissions give users rights within applications. Permissions are associated with groups. Groups are associated with roles. Users associated with a role have permission from the group that is connected to that role. Finally, the permissions are restricted or dependent on a user's membership.
Note: Although every role must be associated with one group and one application, it is possible that a role could have no groups associated with it for a particular application.
How Users Receive Permissions
A group is created in the Capacity Management Administration page or Admin > Settings > Capacity Management component.
Selected permissions are associated with the group. (If the permissions are related to the Capacity Management Administration page or Admin > Settings > Capacity Management component, then the users will receive either view rights, edit rights, or no rights).
A role is created in the Capacity Management Administration page or Admin > Settings > Capacity Management component.
The person creating the role selects a group within a specific application (such as the BedTracking® application or TransportTracking™ application) to associate with the role.
When user information is created or edited, the user is placed in a membership and associated with a role.
The user then has all of the permissions associated with the group and the application for the specific areas within the membership.
Flow of Group, Role, and User Permission Assignment
How the assignment of a new permission would happen.
Group is created and permissions are associated with it
Role is created and group is associated with one specific application for that role (such as the TransportTracking™ application). Only one group per role can be associated with each application.
User record is created and placed in a membership.
Role is given to the user and is effective for their membership. Each user can only have one role per enterprise.
Note(s):
If one user has access to multiple campuses but should have different permissions for them, then the system administrators for all of those campuses must work together to determine a set of permissions that is appropriate for all campuses for this user. Then the system administrators must create a role that is associated with a group which includes the agreed-upon permissions for each relevant application and give the role to that user.
If you edit user information and you select a different role for an existing user to give them new permissions, the new permissions will not take effect until the user signs in again. You cannot edit user information while the user is signed in.
User has the permissions associated with the group for the specific application for the areas included in the membership (for example, user has those permissions for the TransportTracking™ application for Unit 1, Floor 3, Building J in main campus).
Permission Effects on Capabilities
We’ll review how groups, roles, and permissions affect user capabilities.
Note: If you edit user information and you select a different role for an existing user to give them new permissions, the new permissions will not take effect until the user signs in again. You cannot edit user information while the user is signed in.
Example Users
Chris Smith, Pat Kelly, and Terry Ramirez are all TransportTracking™ application users.
Example Groups
The following are three of the groups that have been created in the Capacity Management Administration page.
Transport Group A
Transport Group B
Request Group X
Example Permissions
The following are some of the permissions that each group has:
Transport Group A - Round Trips
Transport Group B - Round Trips, Release Self from Job.
Request Group X - User May View Patient Transports, User May Edit Patient Transports
Example Roles
The following are three of the roles that have been created in the Capacity Management Administration page and the groups that they have been associated with for the TransportTracking™ application.
Transporter 1--Associated with Transport Group A
Transporter 2--Associated with Transport Group B
Requester 1--Associated with Request Group X
Example - How the Users Receive Their Permissions
Chris Smith
Chris is placed in a membership that includes Unit 1, of Floor 3 of Building J on the main campus. At this time, Chris is associated with the Transporter 1 role. Due to the Transporter 1 role being associated with Transport Group A, then for the specific areas associated with the membership, Chris can perform round trips, but cannot release self from job, create patient transports, or edit patient transports.
Pat Kelly
Pat is placed in a membership that includes Unit 1, of Floor 3, of Building J on the main campus. At this time, Pat is associated with the Transporter 2 role. Due to the Transporter 2 role being associated with Transport Group B, then Pat can both perform round trips and release self from job, but cannot create or edit patient transports.
Terry Ramirez
Pat is placed in a membership that includes Unit 1, of Floor 3, of Building J on the main campus. At this time, Terry is associated with the Requester 1 role. Due to the Requester 1 role being associated with Request Group X, then for the specific area of the membership, Terry can view and edit patient transports, but cannot perform round trips or release self from job.
Giving a User System Administrator Rights
The Capacity Management™ Suite provides a Default Administrator group. In this group, most of the permissions associated with the Capacity Management Administration page or Admin > Settings > Capacity Management component are enabled. (However, this group can be edited. The permissions can be enabled or disabled according to your needs.) A user who is designated a role that is associated with this group can perform most functions in the Capacity Management Administration page or Admin > Settings > Capacity Management component.
Note: There are other Capacity Management Administration page or Admin > Settings > Capacity Management functions that only TeleTracking Technologies representatives can perform (such as HL7 configuration and configuring the amount of time after which pages are refreshed automatically).
To give users system administrator rights, when you are adding or editing their user information, select a role that is associated with the Default Administrator Group.
To Give Users System Administrator Rights:
Add a new role. In this role:
Complete the required information.
Make sure Admin is enabled. (If the Admin button is gray, click it to make it green).
In the list next to the Admin button, select the Default Administrator Group.
Note: You can also give users most requester, transporter, or supervisor rights by enabling the TransportTracking button and selecting the Default Requester Group, Default Transporter Group, or Default Supervisor Group.
Save the role.
When adding or editing user information for a user who should be a system administrator, select the new role that you created.
Find All Admin Users in User Management
When an admin needs a list of all other users with admin rights enabled you are able to search this in user management.
Explanation
By setting the User Attribute to "Admin Rights enabled" and using "yes" as the filter string, you will be able to find all admin users listed in the application. Conversely, you can use "No" to find all nonadmin users.
External Identifiers
Configuring External Identifiers for a User
About
Third-Party Staff Assignment Systems
Third-party staff assignment systems can integrate with the PatientTracking Portal<sup>®</sup> in the Capacity Management Suite<sup>®</sup> solution to facilitate assignments of staff members to beds. For this to occur, staff members must be mapped to an identifier for each third-party system to which they need access. Administrators with the required permissions can modify the external identifiers settings. By accessing the External Identifiers tab for any employee, an administrator can manage the third-party staff assignment systems to which users are assigned.
Notification Services
Users must be mapped to the notification service that your health system uses so that users can receive notifications.
Permissions Required
Which permissions and memberships are required to complete this task?
To access the Capacity Management Administration page menu or Admin > Settings > Capacity Management, you must have the Capacity Management Administration page Menu permission. To access administrative groups, you must have the global administrative permissions-Administrative Controls- User Management permission. To change user information, you must have Edit rights. If you have View rights, you can see, but not change, user information. Your Membership Type must be All and Administrative Rights to the membership must be enabled. Alternatively, your Membership Type can be Fixed with a campus-, cluster-, or unit-level membership with Administrative Membership rights enabled. You can only see, add, or edit user information for users within your membership.
To Navigate to the External Identifiers Tab to Modify External Identifiers Settings
Do one of the following:
Go to Capacity Management Administration page > User Management > User Management > Users
Go to Admin > Settings > Capacity Management > User Management > Users
On the Users tab, click the user's login ID in the User Login ID column.
Click the External Identifiers tab.
To Associate Third-party Staff Assignment Systems with a User
Navigate to the External Identifiers tab.
In the Identifier column, enter a unique identifier for the employee. This maps the employee name in the Capacity Management Suite<sup>®</sup> solution to the third-party staff assignment system.
To save your changes, click Save.
To Associate WCTP Notification Services with a User
Navigate to the External Identifiers tab.
In the row that displays WCTP in the External System column, enter the WCTP service's unique identifier for the employee in the Identifier column. This maps the employee name in the Capacity Management Suite<sup>®</sup> solution to the notification service.
Profile
Adding or Editing User Profile Information
Complete the following:
Note
Fields marked with \* on the page are required.
List or box | Required or Optional | To do this.. . . | Complete this procedure . . . |
Thumbnail | Optional | To add a .jpg or .gif file with the user's picture, | Click Browse. Navigate to the directory where the file is stored on the computer or network, double-click the file, OR select the file, and then click Open.<br />Note: The file must have a .jpg or .gif extension. The image will not appear above the Browse button until after you save. |
Login Type | Required | Select whether the user will sign in 1) with a standard user ID name and password that you enter in the user's profile OR 2) If the user's Microsoft® Windows® credentials will be used.<br /><br />Important Note! Option 2 is only available if the single sign-on feature has been configured at your organization. | In the Login Type list, select one of the following:<br />- If the user should use the assigned user ID to sign in, select Standard.<br />- If the user should use his or her Microsoft® Active Directory credentials to sign in, then select MSAD. This option is only available if the single sign-on feature has been configured at your organization. |
User Login ID | Required | Enter a user ID (such as pkelly or chris-smith) for a user who will use the Standard login type. | Type a user ID, such as pkelly or chris-smith.<br />Important Notes!<br />- If MSAD was selected in the Login Type list, the user login ID that you enter must match exactly the user's Microsoft® Active Directory user ID.<br />- The required maximum and minimum length of the user ID depend on the login settings that were configured |
Password | Required | Add or reset the password that the user will enter when signing in | Do one of the following:<br />- When adding a new user, in the Password box, type the password that the user should enter when signing in. If MSAD was selected for Login Type, this password must match exactly the user's Microsoft® Active Directory password.<br />- (When editing existing user information only) To cause the user's existing password to expire immediately and be overridden with a new temporary password with a new expiration date, click Reset next to the Password box. A message appears indicating the user's new password. Take note of the password for the user, and then click OK.<br />Note: The first time that the user signs in with the reset password, the user will be prompted to change it immediately. You cannot reset a password or PIN if you are copying an existing user to create a new one, editing multiple users, or if you are adding a new user with a non-standard authentication mode. |
PIN | Required. If your hospital uses PINs for the IVR and/or for signing in to the interactive wall display in PatientTracking Portal® , and this user will use the IVR or the interactive wall display. | Add or reset a personal identification number (PIN) that the user should enter when signing in to the IVR. | Do one of the following:<br />- When adding a new user, type the PIN that the user should enter when signing in to the IVR or to the PatientTracking Portal® interactive wall display in the PIN box.<br />Note: The PIN must meet requirements configured in IVR PIN settings.<br />- (When editing existing user information only) To cause the user's existing PIN to expire immediately and be overridden with a new temporary PIN with a new expiration date, click Reset next to the PIN box. A message appears indicating the user's new PIN. Take note of the PIN for the user, and then click OK.<br />Note: The first time that the user signs in to the IVR with the reset PIN, the IVR will prompt the user to change the PIN immediately. You cannot reset a password or PIN if you are copying an existing user to create a new one, editing multiple users, or if you are adding a new user with a non-standard authentication mode. |
IVR ID | Required if the user will sign in to the IVR to perform tasks such as requesting or accepting bed cleaning jobs, changing a patient's pending or confirmed discharge status, or requesting or accepting transport jobs. If the user will use the interactive wall display in PatientTracking Portal®, then the user must have an IVR ID to sign in to the wall display. | Assign an IVR ID to users who will use the IVR to perform tasks such as accepting or requesting cleaning or transport jobs or setting or cancelling confirmed or pending discharges. | Enter a numeric IVR ID code greater than 0 for the user. Each user must have a different IVR ID.<br />Note: There is a required minimum and maximum length for the IVR ID. The values entered in the IVR ID Min Char and IVR ID Max Char boxes on the Enterprise Wide Settings page in the Capacity Management Administration page or Admin > Settings > Capacity Management component determine the minimum and maximum number of characters that you must enter for the IVR ID. The maximum can be no longer than 10. See Configuring Login Settings. |
Vocera User ID | Required for users who will use a Vocera paging device or send test messages from a Vocera device. | To associate the Vocera user ID with a user who will use a Vocera paging device or who will send test messages from a Vocera device through the Device Management section of the Capacity Management Administration page or Admin > Settings > Capacity Management component. The Vocera User ID is the user name that has been configured to allow the Vocera paging device to interact with your Vocera server. | Enter a Vocera user name. A different name should be entered for each user. The Vocera User ID box only appears if Vocera Integration is enabled the Master Configuration section of the Capacity Management Administration page or Admin > Settings > Capacity Management application. A TeleTracking Technologies representative can help you to enable Vocera Integration. |
Default Console View | Optional | For PreAdmitTracking® application and PatientTracking Portal® view users. Select the default console that will appear when the user accesses these applications. | Select the default console view that should appear when the user first accesses the applications. Console views are saved in the PreAdmitTracking® application and PatientTracking Portal® application.<br /><br />The default console view selected in the user profile overrides other default console views (for example, default console views selected for units). For example, if Console A is selected as the default console in a variable membership user's profile and Console B is selected as the default console for a unit, when the user signs in to that unit, Console A will be the user's default console. |
Alias | For the PatientTracking Portal® list view and staff assignment only. | If you want a pseudonym (for example, a shortened name or "On-Duty Supervisor") to appear in the PatientTracking Portal® staff type column or Staff Assignment dialog instead of this user’s name, then enter an alias. | Type the pseudonym that should appear in the PatientTracking Portal® list view and Staff Assignment dialog for this user. |
Default View Group | For the PatientTracking Portal® application only. | This is the default view group for which the user may save, load, and delete consoles. View groups are entered in the Dictionary Management section of the Capacity Management Administration page or Admin > Settings > Capacity Management. Users cannot change their own default view groups. | Select the view group name. |
Last Name and First Name | Required | Enter the user's first and last name | Type the user's first and last name. They can be no longer than 30 characters each and they cannot include commas. |
Home, Work, and Cell | Optional | Enter the user's home, work, or mobile telephone numbers. | Type the telephone numbers in the boxes. They can be no longer than 25 characters each. |
Required if user will receive notifications through email. | Enter the user's work email address (for example, pkelly@abchospital.com) | Type the email address. The address must match the email address for this user that is on your hospital's email server. It can be no longer than 100 characters. | |
User Abbr | Required | Enter an abbreviation for the user's name that can appear on screen when space is limited (for example, a shortened version of the user's name such as PatKel or the user's first, middle, and last initial, such as PRK). | Type an abbreviated name of no more than 15 characters. |
ADT ID | For the TransportTracking™ application and PreAdmitTracking® application Only. | An ADT ID is used when processing HL7 patient orders to create transport requests and pre-admission placement requests. Each request for a transport job or a pre-admission placement has a user called a requester associated with it. The HL7 patient order message contains an ADT ID code for the requester. That code must match an ADT ID code for a user in Capacity Management™ Suite system. | If the user you are adding or editing will be a TransportTracking™ application and PreAdmitTracking® application application requester, type the user's ADT ID code. This code should be obtained from the ADT ID administrator. It can be no more than 15 characters. |
Device Method | Required for users who use paging devices to receive notifications or alerts or to be notified about jobs. | Select whether the user always has the same paging device (Fixed) or has to enter the number of the paging device to be used when signing in to the IVR each time (Variable) | Select one of the following:<br />- Fixed—User always has the same paging device and DOES NOT have to enter the number of the paging device each time they sign in to the IVR.<br />- Variable—User does not always have the same paging device and DOES have to enter the number of the paging device they are using each time they sign in to the IVR.<br />- For TeleTracking EVS™ and TeleTracking Transporter™ Mobile App Users — Select Variable. The app users do not use paging devices. However, you must select Variable for Device Method for these users. |
Device IVR ID | Required | If this user will always have the same paging device (Fixed),, select the code number of the paging device that will be assigned to this user. Note: The options in this list can be entered through the Device Management section of the Capacity Management Administration page or Admin > Settings > Capacity Management component. See Configuring Paging Devices. | Select the IVR ID code number of the paging device to be assigned to this user. |
Membership Type | Required | Select whether the user has fixed, variable, or all membership. (Click the links for definitions of each type.) Membership can determine the employee, patient, and job data that the user has access to. For example, in the PatientTracking Portal® application, users can select units to display. They can only select units that are included in their memberships. | Select Fixed, Variable, or All.<br />**Notes: **<br />- If Fixed is selected, you must set the user's membership (see instructions). Also, see Understanding Membership Types.<br />- The All membership type is only available to select if your membership type is All. The All membership is not recommended.<br />- For TeleTracking Nurse™ mobile app users, select Fixed for a unit or Variable.<br />- For Charge Nurse mobile app users, select Fixed or All. The Charge Nurse app does not support users who have a Variable membership type. |
Base Unit | Required | Select a base unit for the user. The base unit affects things such as the user's access to data on reports. | Select a unit.<br />Note:<br />- For a unit to be able to be selected as a base unit, the unit must have a location associated with it.<br />- Click the Select button next to the Base Unit box to display the Set Unit dialog box. If you cannot see the entire dialog box, move your cursor to the side or top of the dialog box, press and hold the mouse button, and then drag to make the box larger.<br />- In the Campus list, select the campus where the user's base location should be. The Units list displays all units within the selected campus.<br />- In the Units list, select a unit, and then select Select Unit. The unit appears in the Base Unit field. |
Base Location | Recommended for transporters and transport job requesters | Select a base location for a transporter or a transport job requester. For transporters, the base location will be the default origin location in transport requests if the transporter presses # on the IVR when prompted for an origin location. For transport job requesters, the base location is the default origin or destination for item requests that have "Base" as the override for origin or destination locations. In the BedTracking® application, a base location could be a central EVS office. The locations in the list are within the unit selected in the previous step. | Select a location from the list. |
Language | Required only if the default language for your enterprise is United States English or United Kingdom English and specific users should be able to hear the IVR in Spanish. | Select the language in which the user will hear information on the Interactive Voice Response (IVR) system. | The available language options are configured in the Master Configuration>Language section of the Capacity Management Administration page or Admin > Settings > Capacity Management component. A TeleTracking Technologies representative must help you to configure language options in Master Configuration. |
Role | Required | Select the role that the user will have. The selected role determines the user's group of permissions for each application. | Select a role.<br />Note:<br />- If you edit user information and you select a different role for an existing user to give them new permissions, the new permissions will not take effect until the user signs in again. You cannot edit user information while the user is signed in. |
Staff Type | Required | Select the user's staff type, such as transport requester , EVS bed cleaner or employee, EVS supervisor, Registered Nurse, Licensed Practical Nurse, or Nursing Assistant. | Select a staff type.<br />Note:<br />- Staff types in this list were entered in the Dictionary Management section of the Capacity Management Administration page or Admin > Settings > Capacity Management component. To learn how staff types are entered into this list, see Configuring Staff Types. |
Title | Optional | Select the user's job title (for example, Unit Supervisor or Technician). | Select a title.<br />Note: Titles in this list were entered in the Dictionary Management section of the Capacity Management Administration page or Admin > Settings > Capacity Management component. To learn how titles are entered into this list, see Adding or Editing Titles. |
Level | Required for users who will receive notifications or alerts regarding employee status or bed cleaning or transport jobs | Assign a level to this user so that alerts about transport or bed cleaning jobs can be escalated to them if a specified amount of time has passed and there is no response for the job. Users with Levels 2 though 5 may subscribe to notifications and receive alerts. If this user should never receive notifications or alerts, select None.<br />Example: If there is no response to a request for a transport job after a certain period of time, an automatic message (or alert) is sent to a supervisor at Level 2. If there is still no response after a certain period of time, the alert is escalated and sent to a supervisor at Level 3. This continues until either there is a response or a supervisor at Level 5 receives an alert. | Select a level from the list. |
Employee Category | Optional | It is possible to select an employee category (for example, All Transporters) when generating a report instead of, or in addition to, selecting individual employee names. If this user should be grouped with other employees whose data should be included on the same reports, then select an employee category to associate with this user.<br />Note: Select the Base Unit before attempting to select the Employee Category. The options displayed in the Employee Category field of the User Profile page depend on your selection of a Base Unit for the user. | Select an employee category name. The employee categories that appear in this list were entered in the Dictionary Management section of the Capacity Management Administration page or Admin > Settings > Capacity Management component. Employee categories are associated with campuses. You may only select an employee category that is associated with the campus that is the same as the employee's base unit. |
Post Dispatch Paging | Optional, applies only to users who have the Transporter work flow, responsible for executing transport jobs and should receive a message containing job details after accepting a job. | Allow this transporter to receive a message with job details after accepting a transport job so that they do not have to write down the job details while listening to the IVR. Post Dispatch Paging can reduce a transporter's time and effort when accepting a job over the IVR. The transporter does not have to write down all job details when accepting the job. Instead, a message with job details will be sent to that transporter after the job has been accepted. Because the transporter does not write down patient health information, there is a greater opportunity to protect this information. Transporters using digital pagers cannot receive post-dispatch pages. Post-dispatch pages can only be received on alpha pagers. | Select the Post Dispatch paging check box to allow this transporter to receive a message with job details after accepting a transport job. Do not select this check box for users who are not transporters. |
Click Save.
The Membership, BedTracking Assignment, and TransportTracking Assignment tabs appear. If the user is set to Variable membership, the Variable Membership Campus Map also appears.
Responsibility + Scope
Clients will be responsible for creating and maintaining all areas within a users profile.
Teletracking Client Support is unable to make any changes in a users profile.
Teletracking Client Support can answer questions, and help provide guidance on areas that could be updated to help resolve an issue.
Profile Tab
Row 1
User login ID
Can be alpha numeric
Login Type
MSAD
Standard
Password
Reset
IVR ID
Must be numeric
PIN
Only needed if certain features are used.
PreAdmitTracking Default Console View
Console a variable user will load if the unit/cluster doesn’t have a default console
PatientTracking Portal Default Console View
Console a variable user will load if the unit/cluster doesn’t have a default console
Alias
Alias to be displayed in Portal
Default View Group
Console a variable user will load if the unit/cluster or user doesn’t have a default console
Vocera User ID
Associate User ID with the Vocera system
Row 2
Last name
Home Telephone
Work Telephone
Cell
Email
Row 3
First name
ADTID
Device Method
Select…
No device
Fixed
Device is assigned
Variable
Must select device when logging in via IVR
Device IVR ID
Only available if Device Method is Fixed
If Device has * in front of the IVR ID, it is assigned to another user. Can be assigned to you anyway.
Membership Type
All
Only a membership of All can assign another user the membership of ALL
Variable
Prompted to select membership upon logging in
Fixed
Membership is assigned
Base Unit
Affects things such as the user’s access to data on reports
Base Location
Used for the base location for a transporter or a transport job requester
Row 4
User abbr.
Language
English (United States)
English (United Kingdom)
Spanish
Role
Enter the role from the Roles Tab
Staff Type
Title
Level
Level 1-5
Used to determine the different levels of management for alerts
Employee Category
Used as a reporting filter
Post dispatch paging
Used to receive the transport job details on alpha pager
Membership & Assignment
Membership
Units/Clusters in membership
Displays the following:
Enterprise
Campus
Unit
Cluster
Admin rights
If this is not enabled, the users will see the options in the Capacity Management Administration page but all of the screens will be blank
TransportTracking Assignment
Select…
No assignment
All
When users have an assignment of All, they are not assigned to a specific zone or section and can be dispatched to jobs in any zone or section of the campus when they are logged in to the Interactive Voice Response (IVR) system.
Fixed
They are automatically designated to be dispatched to jobs that are in a specific zone
Fixed and Exclusive
They are automatically designated to do transport jobs that are going out of or coming in to specific zones or sections
NONE
No assignment but NONE is still linked to the campus
Variable
When users have variable assignments, they must indicate specific sections and zones when they log in to the Interactive Voice Response (IVR) system in the Capacity Management Suite™ system each day
BedTracking Assignment
Select…
No assignment
All
When users have an assignment of All, they are not assigned to a specific zone or section and can be dispatched to jobs in any zone or section of the campus when they are logged in to the Interactive Voice Response (IVR) system.
Fixed
They are automatically designated to be dispatched to jobs that are in a specific zone
NONE
No assignment but NONE is still linked to the campus
Variable
When users have variable assignments, they must indicate specific sections and zones when they log in to the Interactive Voice Response (IVR) system in the Capacity Management Suite™ system each day.
User Notifications Tab
Notification Groups
Notifications vs. Alerts
Notifications are triggered based on an action
Alerts are triggered based off of time
Notifications can be delivered in one of the three methods:
Paging Device
Email
Screen Alert
Delivery Methods
Delivery Time
When I am logged in
Specific Time Range
Can not setup times to range over midnight
Typically setup for 12:00 AM to 12:00 AM
Job Alert Matching
Against my assignment
Against my base campus
Job Notification Matching
Against my assignment
Against my membership
TransportTracking Tab
Status
Status job is in
Recipient Qualification
Origin Match
Destination Match
Either Match
BedTracking Tab
Status
Status bed is in
PreAdmitTracking Tab
Discharge Timer
Threshold 1
Threshold 2
Send Alert for patients whose Home Unit is …
Assigned Bed Timer
Threshold 1
Threshold 2
Send Alert for patients whose
Admit Source
Target Unit
Origin Unit
Origin Unit or Target Unit
Observation Timer
Threshold 1
Threshold 2
Send Alert for patients whose Admit Source is
Occupied Timer
•Discharge
•Send Notifications for Patient Discharges in Campus
•Location Change
•Send Notifications for Patient Location Changes in Campus
PatientTracking Portal Tab
Care Progression Threshold Alert
Enable Warning
Enable Alert
Send Alert for patients whose home unit is
For Care Progression Groups
Patient in Isolated Location
Enable/Disable
Send Via
Screen Alert
Full-Screen Alarm
Patient Walkout
Enable/Disable
Send Via
Screen Alert
Full-Screen Alarm
Staff Assistance Requested
Enable/Disable
Send Via
Screen Alert
Full-Screen Alarm
Users Timing Out At Unexpected Times
Users are timing out at unexpected times.
Solution
Cause
A primary cause of this would be the session timeout settings being set to abnormal values, which is generally set on the group level.
Solution
Obtain user examples and review application access audit reports and timeout settings
Once the information is gathered, review the "inactivity timeout period for all screens" for the XT group(s) that apply to the user(s).
TIP: Before doing this, make sure their timeout settings are set on the group level. You can verify this by navigating to Capacity Management Administration page > Master Configuration > Timeout source for session > Group.
The inactivity timeout setting on the group may be set to a smaller value than the client was expecting, which can cause all users within that group to timeout of the application rapidly.
TIP: If the client is reporting that a timeout has occurred, but they are not seeing the user log back into the application, then the user most likely logged into multiple sessions. Whenever the user is logged into multiple sessions, a timeout will only kill one of the sessions and not all of them. This scenario can be verified by running the application access audit report.
Unable to Update User's Profiles
A user with a Supervisor or Administrator Role is unable to update users.
Solution
There are two things you can check when a user is reporting they are unable to update user profiles.
Check the Admin group associated with their assigned role
In the Membership section of User Profile, ensure Admin Rights is enabled
How to get an admin user to see other users under the Capacity Management Administration page
Admin rights need to be enabled under the user profile
Solution
I had to go under the user profile and make sure that under the membership & assignment section that the (Admin Rights) are enabled. Save the profile have the user log out and back in.
They should be able to access the users under the Capacity Management Administration page.
You need to check the users Role, then check the users group. Here you will need to make sure the group admin has the ability to use the Capacity Management Administration page and also the user management option.
Capacity Management Administration page - role - admin group - then have enabled (Capacity Management Administration page Menu & User Management)
If both of these are enabled then go back to the user profile and make sure that under the membership & assignment that the (Admin Rights) are enabled. Save the profile have the user log out and back in.
They should be able to access the users under the Capacity Management Administration page.
Unable to view/add/edit users under the Capacity Management Administration page
User's MSAD account is locked out of XT / MSAD integration is broken
User is unable to login to XT with their MSAD credentials.
Solution
If a user enter the wrong password too many times, their account can become locked if they configured this in the Global Settings. The more times they attempt, the longer the lockout.
The client can unlock an account using MSAD authentication using this process. To unlock a Standard account, have the client use the reset password functionality.
Client will need to find a user with admin rights (whether this is their supervisor or a member of their help desk) in order to cycle their login type from MSAD to Standard and then back to MSAD. This will reset the XT account lockout for the specific user account.
TIP: Tech Support should not be unlocking account or resetting passwords on client systems. Test or Prod.
Details
Have the user with admin rights navigate to Capacity Management Administration page > User Management > User Management.
Select the specific user account which is having the login issue.
Adjust the login type from MSAD to Standard and save.
Change the login type back to original setting and save.
Confirm the user is successfully able to login to XT.
Symptoms
User is unable to login to XT with their MSAD credentials
Need Access Restored
When you need access restored to your Capacity IQ account.
Solution
TeleTracking Client Support is unable to restore access to accounts within a client's environment.
You will need to let your supervisor or local IT department know that you need your Capacity IQ® profile configured.
Unlock Account
User is unable to login to Capacity IQ®
Solution
If a user enters the wrong password too many times, their account can become locked if they configured this in the Global Settings. The more times they attempt, the longer the lockout.
The default time to wait is 15 minutes. After 15 minutes from the last attempt the account will be unlocked.
Teletracking Client Support is unable to unlock accounts, or reset passwords pertaining to client environments.
Standard Account
To unlock a Standard account, have the client click the reset password functionality link.
Enter the User Name
Click Confirm
You will get a message advising where the temporary password will be, and if you don’t receive an email you will need to reach out to your supervisor, or internal Teletracking admin.
Hit confirm
MSAD Account
The client can unlock an account using MSAD authentication using the following process.
Client will need to find a user with admin rights (whether this is their supervisor or a member of their help desk) in order to cycle their login type from MSAD to Standard and then back to MSAD. This will reset the Capacity IQ®account lockout for the specific user account.
Have the user with admin rights navigate to Capacity Management Administration page > User Management > User Management.
Select the specific user account which is having the login issue.
Adjust the login type from MSAD to Standard and save.
Change the login type back to original setting and save.
Confirm the user is successfully able to login to XT.
MSAD vs Standard Accounts
This article will highlight what an MSAD and Standard user is.
Solution
MSAD Account
Microsoft Active Directory (MSAD) is a directory service that allows authentication and authorization of network users.
If MSAD was selected in the Login Type list, the user login ID that you enter must match exactly the user's Microsoft Active Directory user ID.
Users will use their MSAD credentials (what is used to sign into your computer) to sign in.
Standard Account
Accounts that are created one at a time, or through a batch process. These accounts are not associated with MSAD.
User ID name and password that you enter in the user's profile
Users will use the assigned Username and Password to sign in. These will be different than their MSAD credentials.
Error Saving New User
Saving a new user returns the error: "An error has occurred. Please contact your system administrator.”
Solution
The error usually indicates that multiple fields of the new user’s management data are already saved under another user. An example of this would be identical User Login IDs or IVR IDs; ensure those are unique.
Disable Multiple User Sessions
By default, XT allows users to log in to multiple sessions, meaning that if a user logs in on a second workstation without logging out of the first, that user will be able to access XT from both workstations. There is no practical limit to the number of concurrent sessions a single user can have.
Steps
If a client wishes to disable this, the User ID Multiple Login setting must be disabled in Enterprise-Wide settings.
Disable the setting
Using Capacity Management Administration page, go to Enterprise Management > Enterprise-Wide settings.
There is an option on the left side, reading "User ID Multiple Login." By default, this feature is enabled, allowing one user to be logged in from multiple workstations at a time.
If this option is disabled, then users will encounter an error when trying to log in on another workstation.
After saving this change, it will not take effect until IIS is reset on the server.
Best Practices
If the user is not able to get back to the first workstation to log off, then an XT Administrator will need to log the user off through the Capacity Management Administration page.
IIS reset is needed.
User Account Maintenance
Resolve access, membership, or account set-up issues.
Solution
If your campus membership is not set up correctly, you may experience issues logging in, accessing facilities or campuses, or completing tasks.
Membership affects the information that users can see on the application (beds, patients, units, jobs, cleaning requests).
TeleTracking cannot complete any user account maintenance. Reach out to your admin or helpdesk to ensure the correct membership is added to your account.
User account corrections and merging should be addressed by your helpdesk or DBA (database administrator).
Update User's Email
You need to update or change a user's email address inside their TeleTracking user profile.
Solution
TeleTracking no longer handles user account corrections. Your internal help desk or Database Administrator should be able to assist with this request.
User Not able to access Teletracking
If the ADFS, IQ Account, or Capacity IQ®Account are not set up properly then a user will not be able to access TeleTracking appropriately. This diagram will help you determine which account is the issue
Solution
Can the user access the Teletracking IQ home page?
Yes | No |
Is the user missing the Clinical Operations or Care Support tab (Depends on their role)?
| Issue: The user does not have an ADFS account. |
Continue below | Issue resolved no need to continue |
Yes | No |
Issue: The IQ user role is missing.
| Issue: The user Capacity IQ® Account permissions (Profile) need to be reviewed.
|
Issue Resolved |
|
User IDs
Definition
User IDs are unique identification codes used by authorized users to access the Capacity Management Suite™ solution, typically in combination with a password. These IDs are created during system setup, user onboarding, or when modifying access. They are entered into the login field when users access the system and are managed within the user profile settings. User IDs not only provide secure access but also track users' activity within the system, ensuring accountability and aiding in security monitoring. System administrators manage these IDs to ensure proper user access and activity logging.