Table Of Contents
Implementing the Cisco Imatis Mobile Care Solution
Network Topology
Configuration Task List
Cisco Unified Communications
Communications Manager Configuration
Creating System Users
SNMP Configuration
Creating XML Services
Creating XML Speed Dial Services
IMATIS Mobile Nurse Call Voice Callback Configuration
XML Services Redundancy on CUCM
User Management
IP Phone Configuration
Adding Services to the Phone
Creating Extension Mobility Users
Configuring Speed Dial Button for IMATIS Medical Team Assembly
Services Configuration
IMATIS System Configuration
User ID Management
IMATIS Portal for System Administrator
IMATIS Worklist and INBOX
IMATIS Mobile Nurse Call
IMATIS Mobile Nurse Call Integration
IMATIS Floor Plan and Bedroom Assignment
IMATIS Portal—System Administrator
IMATIS Portal for User Assignment—User
Alarm Types
IMATIS Order Entry Alerts
Ancillary System Integration
User Assignment
Text Messaging
Main Menu Screen and INBOX
Composing a Text Message
Receiving and Answering a Text Message
IMATIS Hospital Orderly Request
IMATIS Portal for System Administration
IMATIS Hospital Orderly Request Interface
IMATIS Dispatcher
Hospital Orderly Workflow
IMATIS Medical Team Assembly
IMATIS Portal for System Administration
IMATIS Medical Team Assembly Request
IMATIS Medical Team Assembly Workflow
IMATIS Mobile Alerts
User Assignment
IMATIS Scalability Considerations
Implementing the Cisco Imatis Mobile Care Solution
This chapter provides implementation details for the services enabled by Cisco Unified Communications, Cisco Unified Wireless Network, and IMATIS for the Mobile Care services. This section describes the steps required to configure features across the components to enable the services. Some design concepts and limitations are provided that you should keep in mind during implementation.
Network Topology
Figure 6-1 provides a frame of reference as you implement the solution. Figure 6-1 should be referred to as you implement the infrastructure steps outlined in Chapter 5, "Designing the Cisco Imatis Mobile Care Solution" and the application components in this chapter. There are many components in this solution and the placement of these components as it pertains to the places in the network helps to ensure better performance, availability, and security for the solution.
Figure 6-1 Network Topology
Configuration Task List
Configuration of the Cisco Imatis Mobile Care solution is a multi-step process that involves components across the network infrastructure, Cisco Unified Communications, Cisco Unified Wireless, the IMATIS servers, and a range of hospital equipment. The goal of this implementation checklist is to provide a list of key areas to cover to achieve a successful implementation. The checklist outlines the key steps to enable Cisco Imatis Mobile Care services, in addition to pointers to several foundational design guides that should be leveraged.
1.
Unified Communications
a.
Communications Manager
–
SNMP Configuration
–
Creating System Users
–
Creating XML Services
–
Creating XML URL Speed Dials
b.
Nurse Call Voice Callback Configuration
2.
XML Services Redundant Configuration
3.
User Management
a.
IP Phone Configuration
b.
Adding Services to the IP Phone
c.
Creating Extension Mobility Users
d.
Configuring Speed Dials for Medical Team Assembly
4.
Services Configuration
a.
IMATIS System Configuration
b.
IMATIS Worklist and INBOX
c.
IMATIS Mobile Nurse Call
d.
IMATIS Order Entry Alerts
e.
Text Messaging
f.
IMATIS Hospital Orderly
g.
IMATIS Medical Team Assembly
h.
IMATIS Mobile Alerts
Note
Refer to Chapter 4, "Cisco Imatis Mobile Care Solution Features and Components" for a list of all the components and software revisions that have been validated.
Note
These configuration steps provide detailed configurations for Cisco products. Configuration details for partner products, such as the IMATIS server or the IMATIS Mobile Nurse Call system, are not described in this document. Some general guidance is provided for the IMATIS server, but for detailed configurations refer to the implementation guides from the partners. For customers deploying Cisco Imatis Mobile Care, work with Imatis and system integrators identified by Cisco and Imatis.
Cisco Unified Communications
Communications Manager Configuration
Configuration of the Communications Manager is outlined in this section. The following provides a detailed checklist of key items to configure to enable Cisco Imatis Mobile Care services.
Summary of CUCM Configurations
1.
Creating System Users
a.
Extension Mobility proxy user for EM login via IMATIS server
b.
Cardiac user to control all the phones associated with the service to send XML services to the phone and interface to the AXL interface from CUCM.
2.
SNMP configuration
3.
Creating XML services
a.
IMATIS Login/Logout
b.
Text Messaging
c.
IMATIS Medical Team Assembly
d.
IMATIS Hospital Orderly service
e.
Main Menu
4.
Creating XML Service Speed Dial
a.
Cardiac Arrest Team
b.
Emergency Doctor
Note
IMATIS Mobile Nurse Call, IMATIS Order Entry Alert, and IMATIS Mobile Alert services do not require a unique XML service to be defined. Once the user is logged into IMATIS and that phone user is then associated with the service in IMATIS, the user is then able to receive mobile nurse call alerts, order entry alerts, or mobile alerts from building or fire alarm systems.
Creating System Users
Creating users for predefined functions is required for system-level functions. This configuration only needs to be performed during the initial installation. These users provide IMATIS the user permission to perform the following two functions. Configuring individual users for Cisco Imatis Mobile Care services is outlined in Services Configuration.
•
Communications Manager User—This user is defined to authorize IMATIS to control the physical phone devices that are used for Cisco Imatis Mobile Care. All phones used for Cisco Imatis Mobile Care should be associated with this user to allow the IMATIS server to post XML messages to these phones.
•
Extension Mobility User—This user is defined to authorize IMATIS to login using Extension Mobility for the IMATIS user defined for the Cisco Imatis Mobile Care service. This user is defined in IMATIS and initiates a proxy login for the corresponding EM user in CUCM. By allowing this proxy login, the mobile care user can have a single logon and therefore is not required to login via IMATIS and then again for Extension Mobility in CUCM.
To add a Communications Manager User:
Step 1
Select User Management -> End User.
Step 2
Select Add New.
Step 3
End User Configuration.
Figure 6-2 Adding a Communications Manager User
Step 4
Enter information in the highlighted fields.
Note
These entries should match the IMATIS configuration files BtImatisLogInOutSettings.xml and BtIpPhoneAdapterSettings.xml
Step 5
Save the configuration.
Step 6
Select Device Association.
Figure 6-3 Device Association Configuration
Step 7
Select the devices that belong to the Cisco Imatis Mobile Care Service.
Step 8
Click the Save Selected/Changes button.
Note
Any new phones that are added later that also require the Cisco Imatis Mobile Care service should be added to this user.
To add an Extension Mobility User and AXL interface system user:
Step 1
Select User Management -> Application User.
Step 2
Select Add New.
Figure 6-4 Application User Configuration
Step 3
Enter information in the highlighted fields.
Note
These entries should match the IMATIS configuration file BtImatisLogInOutSettings.xml.
Step 4
Select Add to User Group.
Figure 6-5 Adding User Groups
Step 5
Select Standard EM Authentication Proxy Rights and and Standard TabSync User, then click Add Selected. Click Save back on the Application User Configuration.
Step 6
After configuring the user, you should see the screen in Figure 6-6. Two selections provide Extension Mobility Login rights and AXL API interface from the IMATIS servers.
Figure 6-6 Application User Configuration Complete
SNMP Configuration
SNMP configurations must be defined so that the IMATIS server receives periodic updates when changes to phone states or configurations occur for the phones used for the Cisco Imatis Mobile Care service.
Step 1
In the CUCM Navigation pull down menu, select Cisco Unified Serviceability.
Step 2
Select SNMP -> V1/V2c -> Community String.
Step 3
Select the publisher server and choose Find.
Step 4
Select Add New.
Step 5
SNMP Community String Configuration.
Figure 6-7 SNMP Community String Configuration
a.
Enter IMATIS for community string and check that the IMATIS server is configured with the same field.
b.
Select Accept SNMP Packets from any host.
c.
Select ReadWriteNotify for access privileges.
d.
Select Apply to All Nodes.
e.
Save this configuration.
Step 6
Select SNMP -> V1/V2c -> Notification Destination.
Step 7
Select the publisher server and choose Find.
Step 8
Select Add New.
Step 9
SNMP Notification Destination Configuration.
Figure 6-8 SNMP Notification Destination Configuration
a.
Enter the IMATIS Server IP address under Host IP Address.
b.
Enter 162 under Port Number.
c.
Select v1 for SNMP version.
d.
Select IMATIS for the Community String.
e.
Select Apply to All Nodes.
f.
Save this configuration.
Check that the IMATIS server filename IMATIS Ccm Integration Service.exe.config is configured accordingly. In this file the IP addresses, Community String, frequency for traps, and other fields are defined for the SNMP interface. The current recommendation is that SNMP traps are pulled from CUCM every 30 seconds. This is the lowest recommended setting. In addition to the periodic pulling of SNMP traps for the changes that have occurred, also configure the system to perform a full SNMP update once a day during a low traffic volume timeframe. The full update clears any conflicts that may occur between the IMATIS server and CUCM database.
Creating XML Services
XML services running on the Cisco IP phone enable the Cisco Imatis Mobile Care services. These services require an initial system level configuration before any of the users and phones can subscribe to these services. This section covers the initial configuration required on the CUCM system.
Note
In all of these examples, the service uses a DNS name for the IMATIS server = IMATIS-server. IMATIS-server resolves to the virtual IP address of the IMATIS server cluster. The primary server of the cluster always serves the request.
IMATIS Login/Logout
Figure 6-9 IMATIS Login/Logout
This service on IMATIS provides the user with single sign-on. Through this login on the IMATIS server, a proxy login to extension mobility is created. More details are provided in the User ID Management section.
Under the Service URL: http://imatis-server/ImatisIpWebService/ImatisLogInOut/ImatisLogInOut.asp?device=#DEVICENAME#
Text Messaging
This service definition enables the text messaging service between users of the system.
Figure 6-10 Text Messaging
Under the Service URL: http://imatis-server/ImatisIpWebService/ImatisMelding/ImatisMelding.asp
IMATIS Medical Team Assembly
This service definition enables the IMATIS Medical Team Assembly service.
Figure 6-11 IMATIS Medical Team Assembly
Under the Service URL: http://imatis-server/ImatisIpWebService/ImatisTilkalling/ImatisTilkalling.asp
IMATIS Hospital Orderly Request
This service definition enables the IMATIS Hospital Orderly Request service.
Figure 6-12 IMATIS Hospital Orderly Request
Under the Service URL: http://imatis-server/ImatisIpWebService/ImatisPortoer/ImatisPortoer.asp
IMATIS Main Menu
This definition enables the user to access the IMATIS main menu from the XML Services menu.
Figure 6-13 IMATIS Main Menu
Under the Service URL: http://imatis-server/ImatisIpWebService/ImatisGetMessageId.asp
The other services, IMATIS Mobile Nurse Call and IMATIS Mobile Alerts, do not require an XML Service Menu definition. These services send alerts to users that are assigned in the roles definition in the IMATIS interfaces for User Management and the IMATIS Mobile Nurse Call IMATIS portal. More details on this configuration are provided in Services Configuration.
Creating XML Speed Dial Services
IMATIS enables a Medical Team Assembly service which can be more easily accessed by mapping the request into a speed dial key on the phone to send a URL request. In order to create this mapping to the speed dial key, the service must be defined. The following provides an example of defining a sample service. This service is later mapped to a speed dial button on a Cisco IP phone.
Figure 6-14 IP Phone Services Configuration
Under the Service URL enter: http://imatis-server/ImatisIpWebService/ImatisTilkalling/ImatisTilkallingSpeedRollePre.asp?Avd=Emergency%20Dept.&Rolle=Emergency%20Doctor
The syntax for requesting a "role" is based on http://imatis-server/ImatisIpWebService/ImatisTilkalling/ImatisTilkallingSpeedRollePre.asp?Avd=/&Rolle=/
Where the name for the department as defined in the IMATIS system administration portal is the name for the role. For example: = Emergency%20Dept. and = Emergency%20Doctor.
The syntax for request a "team" is based on http://imatis-server/ImatisIpWebService/ImatisTilkalling/ImatisTilkallingSpeedTeamPre.asp?Team=/
And is equal to the name of the team as defined in the IMATIS system administration portal. For example: the name for the cardiac arrest team is Cardiac%20Arrest%20Team.
Note
%20 is used to represent a space in the filename as defined in the IMATIS system administration portal.
IMATIS Mobile Nurse Call Voice Callback Configuration
For the IMATIS Mobile Nurse Call service, a voice callback to the patient room may be needed. The voice callback may route the call to another IP-based phone. In that case, no extra configuration is required. If the callback is to interface to legacy-wired connections, such as FXS or PRI connections, the CUCM requires an H.323 voice gateway and possibly a H.323 gatekeeper if the dial plans become more complex. The example provided here shows a sample configuration using an ISR with Gatekeeper and Gateway functions combined.
For simplicity, the dial plan shown in this example shows extension 1061 and 1062 as the POTS line extensions for the FXS extensions to integrate with the IMATIS Mobile Nurse Call System. The extension of 105x are extensions on the CUCM Cisco IP phones.
Step 1
Configure the GK function.
zone local mc-gk isemcca.local 10.1.1.22
zone local mc-gk-cm isemcca.local
zone prefix mc-gk-cm 105.
gw-type-prefix #1* default-technology
Step 2
Configure the POTS lines for the voice gateway.
Step 3
Configure the VoIP extension on Communications Manager.
dial-peer voice 1050 voip
Note
There may be a requirement to manipulate digits to interwork with the dial plan structures of the Nurse Call System from BEST or a hospital PBX system. Some systems may required some leading digits used as an access code or for two stage dialing. The integration with the BEST call system required a 9 to be pre-pended to the dialed digits as the access code for calling a nurse call bedside station. If leading digits are required, perform the digit manipulation on the gateway. See this link for digit manipulation on a voice gateway http://www.cisco.com/en/US/products/sw/iosswrel/ps5207/products_configuration_guide_chapter09186a008086f2e2.html#wp1067071
Step 4
Configure the H.323 Gateway to register to the H.323 Gatekeeper.
interface FastEthernet0?/0
ip address 10.1.1.22 255.255.255.128
h323-gateway voip interface
h323-gateway voip id mc-gk ipaddr 10.1.1.22 1719
h323-gateway voip h323-id mc-voip-gw
Step 5
In the CUCM interface, under Device -> Gatekeeper, define the following:
Figure 6-15 Gatekeeper Configuration
Step 6
In the CUCM interface, under Device -> Trunk, define the following:
Figure 6-16 Trunk Configuration 1
Figure 6-17 Trunk Configuration 2
Step 7
In the CUCM interface, under Call Routing -> Route/Hunt -> Route Pattern, define the extension range for the FXS ports.
Figure 6-18 Route Pattern Configuration
Step 8
On the gatekeeper, type show gatekeeper endpoints to ensure both the gateway and CUCM have registered. Calls route after both devices are registered.
Note
Some legacy voice systems have unique timers for analog interfaces or digital interfaces. Ensure these configurations match the legacy system. See Chapter 5, "Designing the Cisco Imatis Mobile Care Solution" for specifics on disconnect supervision which may cause fxs lines not to release properly.
XML Services Redundancy on CUCM
The XML services or extension mobility defined for a phone typically is configured with a specific Communications Manager IP address. This presents a single point of failure for the service. As a best practice implement a highly-available XML service by using one of the following three methods:
•
First method (recommended)—Use Server Load Balancing (SLB) on an IOS router. The services button is configured with a virtual IP address or hostname that resolves to that virtual IP address. This virtual IP address is configured on the IOS-based router to perform SLB across a list of configured CM servers. When a particular server fails, a probe defined to detect if the server is alive informs the SLB algorithm to remove that server from the available pool of servers. When the probe detects that the server is available again, the recovered server is added back to the available pool of servers. Not all platforms support IOS SLB. Before implementing this feature, ensure your platform supports this feature by searching the Cisco feature navigator on CCO.
•
Second method (recommended)—Use a Content Switch such as CSS 115xx series or ACE module to also perform load balancing.
•
Third method—Round Robin DNS is a simple method for redundancy, but this method results in a percentage of failed service request until the failed CUCM server is restored. The failure rate percentage is based on the number of servers that are part of the DNS pool. When the failed server is selected as part of the round robin, the XML request still fails. But when the server that is alive is returned, the service is successful. The usage of round robin DNS is a short term resolution; the first or second method represent long term solutions.
A sample configuration for the first method is described below. Figure 6-19 shows a view of the redundancy configuration.
Figure 6-19 Redundancy Configuration
Step 1
Define a virtual IP address 10.2.2.22. In this example IP address 10.2.2.22 is the virtual IP address for CUCM and IP address 10.2.2.20 and 10.2.2.21 are the physical CUCM server address. 10.2.2.20 and 10.2.2.21 serve the XML services for the IP phones and the IMATIS server. The DNS server should resolve the CUCM address to this virtual IP address when accessing the CUCM server from the Cisco IP phone or from the IMATIS server. This implementation ensures that all queries to CUCM for XML services resolve once the defined probe has detected that a server is unreachable and removes it from the available set of CUCM servers.
Step 2
On the switch before the server farm, implement the following:
! probe to check for the availability of the server
ip slb probe MY-PROBE tcp
! define a equally balanced access to CUCM servers
ip slb serverfarm MOBILECARE1-0
! define the virtual server
ip slb vserver MOBILECARE
virtual 10.2.2.22 tcp 8080
Step 3
Under the CUCM interface, the setting under System -> Enterprise Parameters should have the following set with the virtual IP address or DNS name for all the Phone URL Parameters:
Figure 6-20 Enterprise Parameters Configuration
User Management
This section describes the configuration of individual Cisco Imatis Mobile Care users. Use the following checklist to create the individual users.
Summary of key items:
•
IP Phone Configuration
•
Adding Services to the Phone
•
Creating Extension Mobility Users
•
Configuring Speed Dial Button for IMATIS Medical Team Assembly
IP Phone Configuration
The two Cisco IP phones that are tested and supported with Cisco Imatis Mobile Care are the 7921 and 7971G phones. The 7921 is only supported in SCCP mode and the 7971 is supported with SCCP and SIP mode.
To create a phone usable with Cisco Imatis Mobile Care Services:
Step 1
Create a new instance of a 7921 or 7971 phone, under Device -> Phone.
Step 2
Define the mandatory and optional settings.
Step 3
Under External Data Locations Information -> Idle, enter http://imatis-server/ImatisIpWebService/ImatisGetMessageid.asp.
Step 4
Under External Data Locations Information -> Idle Timer, enter 4.
Step 5
Click the field Enable Extension Mobility.
A sample of what you should enter is shown in Figure 6-21.
Figure 6-21 Sample IP Phone Configuration
Step 6
Save the configuration.
Step 7
Under User Management -> End User, select the user "cardiac" or the user as defined under the section "Communications Manager User".
Step 8
Select the button Device Association and click Find. Select the Device Name for the phone that has just been defined to add it to the list of devices to which IMATIS may send XML services.
Adding Services to the Phone
Now that the phone has been defined, services can be added to the Cisco IP phone. Follow these instructions if extension mobility is not used for the phone. If extension mobility is used, then only IMATIS Login/Logout should be defined on the IP phone. If Extension Mobility is not used, then add all the relevant services including the IMATIS Login/Logout service.
Step 1
Select under Device -> Phone the device name that requires the services to be added.
Step 2
On the top right under the pulldown menu called "Related Links", select "Subscribe/Unsubscribe Services" and click the "Go" button.
Step 3
Select the service you wish to add and select next.
Figure 6-22 IP Phone Services Information
Step 4
When the following menu appears, select "Subscribe". The window updates with the new service shown in the Subscribed Services.
Figure 6-23 Subscribed IP Phone Services
Repeat this step for all the services you want on the main phone. If Extension Mobility is used, the majority of the services should be reserved for the device profile associated with the EM User.
Creating Extension Mobility Users
The process of creating an extension mobility user is similar to that of creating a phone. You are creating a pointer to a device profile that is then applied to a physical phone after the extension mobility user has logged into a physical phone. To create an extension mobility user:
Step 1
Under Device -> Device Settings -> Device Profile, add a new device profile.
Step 2
Enter the mandatory fields, using Figure 6-24 as an example.
Figure 6-24 Device Profile Configuration
The Device Profile Name is used in the next step.
Step 3
Under User Management -> End User, add a new user used for the extension mobility user. Use Figure 6-25 as an example.
Figure 6-25 End User Configuration
Step 4
In the fields for User ID, Password, and PIN, it is highly recommended that the same field is entered for ease of use.
Note
The extension mobility user is mapped to the IMATIS user described in Services Configuration.
Step 5
Under Available Profiles, select the device profile name defined in Step 2. Use the down arrow and move that field into the Controlled Profiles.
Step 6
Select the option Allow Control of Device from CTI.
This user is now available for use within IMATIS for user login.
Configuring Speed Dial Button for IMATIS Medical Team Assembly
The service for IMATIS Medical Team Assembly may benefit from having speed dials provisioned on phones. This speed dial allows a function such as IMATIS Medical Team Assembly to summon a nurse or emergency doctor by the press of a speed dial button. To achieve this, the setting should be defined for both the main IP phone and the extension mobility user. To configure speed dial buttons for this service:
Step 1
Define a new template under Device -> Device Settings -> Phone Button Template.
Step 2
Configure the options using the following as an example for the 7921 phone.
Figure 6-26 Phone Button Template Configuration
Step 3
Under the Device -> Phone configuration for a device, subscribe to the XML service that has been defined in Creating XML Speed Dial Services.
Step 4
Under the Device -> Phone configuration for a device, select the template defined in Step 2 under the option Phone Button Template and save.
Step 5
Select Modify Button Items and move the speed dial buttons from Unassigned Associated Items to Associated Items. Then move the button into the desired position on the phone.
Figure 6-27 Reorder Phone Button Configuration
Step 6
(Optional if using extension mobility) Under Device -> Device Setting -> Device Profile, select the device profile and apply the template created in Step 2 to the Phone Button Template option and save.
Step 7
Select Modify Button Items and move the speed dial buttons from Unassigned Associated Items to Associated Items. Then move the button into the desired position on the phone.
Note
On a Cisco IP phone, the Speed Dial URL will be covered by the IMATIS main screen. On a 7971, use the 7914 extension module and define the speed dial keys on the extension module.
Services Configuration
This section describes the configuration required to enable the Cisco Imatis Mobile Care Services. Detailed IMATIS configurations can be obtained through IMATIS. This section covers general areas around IMATIS configurations to enable the IMATIS Mobile Care services with Cisco.
Summary of Cisco Imatis Mobile Care configurations:
•
IMATIS System Configuration
•
IMATIS Worklist and INBOX
•
IMATIS Mobile Nurse Call
•
IMATIS Order Entry Alerts
•
Text Messaging
•
IMATIS Hospital Orderly Request
•
IMATIS Medical Team Assembly
•
IMATIS Mobile Alerts
IMATIS System Configuration
IMATIS recommends that each server be configured with redundancy where each server performs these main functions:
•
MT Server 1: IMATIS Server—System and interface server including Web server and system internal interface to catalogue service and Cisco CallManager
•
MT Server 2: Microsoft BizTalk Server—Messaging Server with messaging logic
•
MT Server 3: Microsoft SQL Server—Database server
For instructions on installing IMATIS, check with Imatis. The IMATIS system utilizes Internet Information Services, ASP.NET, COM+ Access, and DTC Access services from Microsoft Windows Server.
After installing the servers in a redundant fashion, a few steps should be performed.
•
AD integration—Create the IMATIS users for the various Cisco Imatis Mobile Care services by integration with active directory. This section does not cover the details of the steps for active directory integration, as those details are provided by Imatis and system integrators identified by Cisco and Imatis. Once this integration is performed, the users are managed through active directory. Inside the IMATIS server for AD users, you see the users as shown in Figure 6-28.
Figure 6-28 IMATIS Users
Once these users are present in the IMATIS database, these users are ready to utilize Cisco Imatis Mobile Care services.
•
IMATIS server configuration with CUCM addresses—There are several integration files that require updates within the IMATIS directory structure to be configured with CUCM addresses. These files require manual updating. A complete set of these integration files are provided by Imatis during the integration.
Note
Any configuration on IMATIS that uses the XML services should be defined with the DNS server name for the CUCM server as defined in XML Services Redundancy on CUCM.
•
For other installation and configuration steps, refer to the IMATIS guides. There are additional installation and configuration required for each Cisco Imatis Mobile Care service. Some applications, such as nurse call, have dependencies which use software applications from National Instruments. Other applications, such as IMATIS Medical Team Assembly and IMATIS Hospital Orderly, require software applications from IMATIS to be installed on user PCs. Ensure that these individual services are installed and functioning properly before proceeding.
Inside the directory structure of the IMATIS system there are names that are translated as follows:
•
pa = nurse call
•
tilkalling = team assembly
•
oppdrag = orderly
•
meldings = messaging
•
portoer = porter (summon service)
User ID Management
There are Extension Mobility users created in CUCM that provide the user a specific directory number and there is also an IMATIS user created through the active directory integration. These users should be identical to enable the proxy login from the IMATIS login. Figure 6-29 shows the flow of operations during a user login. With this implementation, the user only needs to log in through the IMATIS login to be automatically logged into to CUCM extension mobility.
Figure 6-29 User ID Management
Note
A best practice is to use the same userID and password in both places.
IMATIS Portal for System Administrator
On the IMATIS server, the system administrator is provided with a portal for administration of several key parameters that are required for each Cisco Imatis Mobile Care service. This application can be found on the IMATIS server through the path C:\Program Files\CARDIAC\IMATIS\Portal\IMATIS Portal.exe. Initial configurations for users, floor plans, team groups, and many other areas are configured by the system administrator through this tool.
IMATIS Worklist and INBOX
The services appear on the Cisco IP phones as messages and alerts that are organized into worklist and inbox. A worklist stores messages from IMATIS Mobile Nurse Call, Order Entry Alerts, Mobile Alerts, Hospital Orderly, and Medical Team Alerts. Text messages are stored in the INBOX retrieved by accessing the text messaging service.
Orderly worklists are unique as they serve a different role in a hospital and would not typically receive the other services.
The worklist is also ordered by priority, so Medical Team Assembly is always on top of the list, followed by Urgent nurse call and Normal nurse call. If the messages have the same priority, the messages are ordered by timestamp, with the oldest on top.
The alerts in the worklist are also clearly marked with certain tags to indicate the type of message. A normal nurse call has text such as "Bed 201 07:30" to indicate the location is the bedside or "WC 201 7:30" to indicate the location is the bathroom. An urgent call would be "URGENT 201 07:30". Messages from Medical Team Assembly also differ regarding the text using, for example, "**Alarm**, 201" or "*Cardiac Arrest*, 201".
IMATIS Mobile Nurse Call
This section describes several key steps required for integration with nurse call system vendors and a few configuration steps required to set up nurse call alerts to be received by nurses.
IMATIS Mobile Nurse Call Integration
The nurse call system manufactured by Best uses an RS-232 interface to report alerts generated by nurse call stations in a patient room. The RS-232 interface physically connects to an OPC server built by Imatis. Typically the physical location of the nurse call server may not be the same as the OPC server. The recommended implementation is to use RS-232 to IP adapters support the flow of messages from the nurse call system to the IMATIS server via the IP network. For best practices on implementing the RS-232 to IP adapter, refer to Quality of Service in Chapter 5, "Designing the Cisco Imatis Mobile Care Solution."
Using an adapter built by Imatis, these alerts are then passed from the OPC server to the IMATIS server via XML. The alert is then routed to the assigned nurse for the room that the alert originated from based on the business rules implemented by IMATIS. The alerts are sent to IMATIS in the form of OPC messages. OPC specifications can be found at http://www.opcfoundation.org/Default.aspx/01_about/01_whatis.asp?MID=AboutOPC.
For other nurse call system integrations, contact Imatis for more information.
IMATIS Floor Plan and Bedroom Assignment
The integration with nurse call systems requires a floor play layout with room assignments for patients. National Instruments is integrated with IMATIS to create the floor plan design for each hospital setting. This design should be performed in conjunction with building facilities. After this layout has been created, a floorplan will been available in the IMATIS portal. To start the IMATIS portal, use the following http query; enter the proper actual address for the IMATIS server:
http://imatis-server/imatispa
Click on the Bed Area and select a bed area to view. Figure 6-30 provides a sample floorplan layout for a hospital setting.
Figure 6-30 Sample Floorplan Layout
IMATIS Portal—System Administrator
After the floor plan and room layouts have been assigned, the floors and rooms need to be added. The administrator should select "User Manager". Under the directory tree of PA, floors and beds per floor can be defined.
Figure 6-31 Floors and Beds Per Floor
IMATIS Portal for User Assignment—User
Once the users have been added through the active directory integration, the defined users automatically appear within the IMATIS user portal. This portal is the one seen by the users of the system, not the portal used by the system administrator. Figure 6-32 shows the IMATIS portal used to manage the nurse call user assignment to patient rooms.
Figure 6-32 IMATIS Portal for Assignment to Patient Rooms
Click on "Call Plan". On the left is a list of the employees that can be assigned to the nurse call service. On the right side is a list bedrooms on a particular floor. This floorplan has been created in the previous step. To assign a nurse to a bedroom, click on a user from the list on the left that is shown to be online and click on an area on the right side. Click the set of double arrows pointing to the right and this assignment is created. Once the assignment is created, the location has a user shown after the list, as in example Bed 101 and 102. For areas that are not assigned a nurse, Bed 103 shows an example. Once a patient is assigned to Bed 103, a nurse should be assigned to that location.
Alarm Types
Once the nurses are assigned to the bed locations, the system is ready for use. When an alarm is generated from a patient room via the nurse call bedside stations, the alert is sent to the nurse station as the primary alert system. As a secondary alert, the IMATIS Mobile Nurse Call Server sends the alert to the IMATIS server, which forwards the alert to the Cisco IP phone based on the defined business rules. The following example is a walk through with sample screen shots of a few possible paths through a nurse call workflow.
1.
A button press from a nurse call bedside station is sent to a Cisco 7921 phone.
Figure 6-33 Nurse Call Sent to Phone
2.
The nurse now has the option to acknowledge the request by selecting OK or dismissing the request if the nurse is busy. If the nurse decides to dismiss the alert, there must be another nurse defined in the escalation rules to accept the request. If there is no other nurse, then the alert returns to the nurse. A reminder alert may also be sent if the nurse does not enter the patient room and press the nurse call button to indicate the alert has been serviced. These reminder alerts are represented by a "(#)" where # represents the number of times the reminder has been sent. This reminder timer is defined on the IMATIS server. The business rules define it as mandatory that after a nurse call alert is sent to the nurses phone, the nurse must press the nurse call button in the patient room to complete the acknowledgment of the alert.
3.
Once the alert has been received and the OK button is pressed, the nurse has the option to callback via a voice connection into the room. The voice callback could be to a Cisco IP phone in the patient room or a callback to the bedside terminal via a FXS connection into the room.
Figure 6-34 Option to Callback
4.
The location of the alert may also be indicated in the alert. This information must come from the nurse call system, then IMATIS uses these the business rules to send a different type of alert to the phone. Figure 6-35 shows an alert received by the nurse from an alert that came from the restroom area of room 201. This extra information may alert the nurse of the urgency of the alert.
Figure 6-35 Alert Received by Nurse From Restroom Area
5.
As the nurse receives alerts, the workflow process requires that the nurse enter the patient room and press the bedside terminal to acknowledge the alert. In order for the nurse to clear the alert from their worklist, the nurse must press the nurse call bedside terminal button once again to clear the task from their worklist. This is the only method to clear the alert and signifies the completion of the work related to a nurse call alert. Figure 6-36 shows what is seen by the nurse when there are items on their worklist that have not been fully completed. Once the completion of work occurs, the item is automatically removed from the worklist.
Figure 6-36 Nurse View of Outstanding Worklist Items
6.
On the IMATIS Portal, the nurse station can see a view of the floor and receive dynamic updates on alerts seen on that floor. Figure 6-37 shows some of the icons that the nurse sees on this portal. In addition, the nurse also sees a historical log of events that have been received for that floor.
Figure 6-37 Icons on Portal
7.
Escalation rules.
When nurse call alerts go unattended, the business rules in IMATIS force escalations, with escalation rules following the building structure as defined in the IMATIS portal for system administration. Messages that get escalated from a nurse in a particular bed area would escalate to other nurses assigned to that bed area. Once all the nurses in that bed area are exhausted, the next escalation would find other nurses on the same floor. This method of escalation ensures that no nurse call alerts go unattended due to unforeseen circumstances.
8.
Urgent alerts.
Urgent alerts may also be generated by the IMATIS Mobile Nurse Call system. A patient would not initiate this urgent request. Instead, this urgent request may be created by the nurse that walks into the patient room. There are several methods that a nurse can use to originate an urgent request:
•
Medical Team Alert from a XML Phone service
•
Medical Team Alert mapped to a URL speed dial button
•
Nurse call button press unique to the nurse user. This operation is dependent on the IMATIS Mobile Nurse Call System and requires the IMATIS Mobile Nurse Call System to send a message over the OPC protocol to the IMATIS OPC Adapter, which would then map to an urgent alert.
When the urgent request is sent, the business rule creates an alert for all nurses attending that bed area. Other users can also be added to this team.
IMATIS Order Entry Alerts
Ancillary System Integration
The integration with ancillary systems for order entry alerts that lab results are available requires HL7 integration. This HL7 adapter is performed through the BizTalk server. The HL7 alert is received from hospital information systems. Based on the business rules applied to the parameters received through the HL7 interface, the message is then sent to the appropriate user. One critical business rule is based on the confidentiality of patient information. If this flag allows patient information to be sent, then the test results and patient name may be passed onto the alert. Otherwise, the alert only indicates that results are ready for review. Another parameter determines if the lab results are urgent or normal priority. There may be other fields that are deemed important as part of the integration that IMATIS may apply to the business rules.
User Assignment
The ordering system for the laboratory request contains an ordering physician's name. The physician's name is a required field to pass across the HL7 interface into IMATIS, along with the laboratory results message. The name is looked up in Active Directory to match a userID that is used as the unique identifier for IMATIS to determine to whom to send the laboratory results message.
Figure 6-38 shows a few samples of normal/urgent alerts and patient/no patient data.
Figure 6-38 Samples of Alerts and Patient Data
Text Messaging
The implementation of text messaging is automatically available once users are defined through the active directory integration. Users are then able to use text messages.
Main Menu Screen and INBOX
Figure 6-39 shows the main menu when entering the text message service. The service is similar to text messaging using SMS on cellular networks. This service is located within the hospital domain and delivered over the Cisco Unified Wireless Network network. An inbox keeps a list of all received messages until they are deleted.
Figure 6-39 Main Text Message Service Menu
Composing a Text Message
To compose a message to a user, there are several options for finding a user.
•
Search based on a user name
•
Int—When entering a specific extension for the user
•
Pager—When sending a message to a pager system
•
SMS—When sending a SMS to a cellular system
•
Email —To select sending an email to a user
Figure 6-40 Email Options
Once an extension is entered, the user is ready to write the text message.
Figure 6-41 Ready for Text to be Entered
Receiving and Answering a Text Message
Figure 6-42 shows an example of a user receiving a text message. Once this message is read, Figure 6-42 shows a few predefined options for how the text message can be answered. A few predefined messages are created to easily answer the text message or a custom message can be typed. Another option allows a voice call back from the message originator.
Figure 6-42 Example of User Receiving a Text Message and Options for Answering Message
IMATIS Hospital Orderly Request
IMATIS Portal for System Administration
From the IMATIS portal on the IMATIS server used by the system administrator, the orderly groups can be defined. The administrator should select "User Manager". Under the directory tree of OppDrag, individual orderly teams can be defined. A special note on the role attributes is a field called Attended. When this field is set to "1", that means the role is 24x7 and can never be unattended. This setting prevents users from un-enrolling before a new user enrolls to take on that shift.
Figure 6-43 IMATIS Portal
IMATIS Hospital Orderly Request Interface
The Hospital Orderly Request tool as seen by a hospital staff user is retrieved via the http link http://imatis-server/ImatisOrderOrderly/AjaxOrderPage.aspx. This interface provides many options for hospital locations, request types, and the request message. Filling out this form lets hospital staff make a request to an orderly.
Figure 6-44 Hospital Orderly Request Tool
Once the order has been placed, the staff can view the current status of that request. Changes can be made to the request through this same interface. Figure 6-45 shows the order status interface after the order has been placed.
Figure 6-45 Reviewing Requests
This orderly request is they sent to the hospital dispatcher to assign a person to the task.
IMATIS Dispatcher
The dispatcher sees a different interface that allows the dispatcher to see all tasks (incoming, currently unassigned, assigned, and other states) and a list of enrolled orderly staff to which the work can be dispatched. This interface should only be used by the dispatcher. To start this interface, the IMATIS application name is ImatisTransporter.exe. Figure 6-46 is a sample of the interface seen by the dispatcher.
Figure 6-46 Sample IMATIS Dispatcher Interface
Hospital Orderly Workflow
The orderly staff users carry a Cisco 7921 IP phone to facilitate their daily workflow as they move abut the hospital. Through this interface, the staff can sign in and resign from a role, set the status for their role if they are busy or out to lunch, for example, and also receive requests and notify the dispatcher of their progress in handling the request. Figure 6-47, Figure 6-48, and Figure 6-49 show a few phone interfaces as seen by the staff for invoking these work flow states.
Figure 6-47 Main Menu and Enrolling
Figure 6-48 Setting Orderly State
Figure 6-49 Receiving Orderly Request and Acknowledge
IMATIS Medical Team Assembly
IMATIS Portal for System Administration
From the IMATIS portal on the IMATIS server used by the system administrator, the set of teams can be defined for each hospital setting. The administrator should select "User Manager". Under the directory tree of Tikalling -> Team, individual teams and roles can be defined. A special note on the role attributes is a field called Attended. When this field is set to "1", that means the role is 24x7 and can never be unattended. This setting prevents users from un-enrolling before a new user enrolls to take that shift. You can define individual roles, teams, and departments. After these teams and roles are defined, the system can be used to create summons and have users enroll.
Figure 6-50 IMATIS Portal for System Administration
The process for creating the hierarchical structure for these teams is to start with a department. Under the department, there may be various teams that are defined. Then under the teams, define specific roles for these teams. The attributes for these departments, teams, and roles should be defined.
IMATIS Medical Team Assembly Request
After these roles have defined, the system is ready to send summons to users of the system. There are several methods to create a summons:
•
IMATIS summons request tool
•
XML service from a Cisco IP phone
•
URL speed dial defined for a Cisco IP phone
IMATIS Mobile Nurse Call integration for critical summons that has a predefined business rule from IMATIS for that specific alarm generation.
The IMATIS summon tool is shown in Figure 6-51 to illustrate the interface a nurse station might see to request an emergency doctor in room 201. The user may choose to send a summons to a team, an individual role, or a group function. These are specified when the teams and roles are defined by the system administrator. To access this request page, use the following link http://imatis-server/imatisamk/resmon.asp
Figure 6-51 IMATIS Summon Tool
IMATIS Medical Team Assembly Workflow
As a user initially signs onto their shift, they would also enroll in a particular role. If the user is taking over a 24x7 role shift, a message is sent to the current person in the role.
Figure 6-52 Message to Current Person in Role
Using the phone, a request can also be made to summon a particular role or a team.
Figure 6-53 Message to Summon a Particular Role or Team
When a message is received on the phone, the user can ack the request or call 911 to request help.
Figure 6-54 Options for Responding to Message
Note
This workflow can be monitored by a hospital staff member or dispatcher. Use the following link to access the Medical Team Assembly call status: http://imatis-server/imatisamk/callmon.asp.
IMATIS Mobile Alerts
The integration with fire and building alarm systems for alerts requires integration with the building systems. IMATIS uses ESPA 4.4.4 as one standard for this integration. The ESPA adapter is performed through the BizTalk server. The building alert is received from alarm systems. Based on the business rules applied to the parameters received through the ESPA interface, the message is then sent to the appropriate user. IMATIS uses the parameters received to apply business rules. One business rule may be based on whether the received alert is an emergency or just an equipment malfunction. If the alert is an emergency, the user may be presented with an option for immediately calling emergency 911.
User Assignment
Assignment of these alerts to a user is defined by the roles within the IMATIS system administrator portal. A role that is associated with a technical department or emergency department may be created. Users are assigned to these roles and receive building or fire alarm alerts when sent from the ESPA system.
Figure 6-55 Assignment of Alerts
Figure 6-56 shows a sample of three screens with alerts received for fire alarms or building technical problems.
Figure 6-56 Alerts for Fire, Building, and Technical Problems
IMATIS Scalability Considerations
As the deployment of Cisco Imatis Mobile Care services grows and the number of users expands, the scalability of the IMATIS Hospital Communication System is achieved by installing the application over several servers. Using several SQL Servers, the databases and tables can be shared among additional hardware. Microsoft BizTalk is designed to be able to increase performance either by running several servers or by moving components on various servers. The IMATIS servers can run Microsoft Network Load Balancing (NLB) to increase performance or, if necessary, the components can be allocated to different servers.