Latitude: Latitude - Paceart Integration 1.01 Guide
Latitude: Latitude - Paceart Integration 1.01 Guide
Latitude: Latitude - Paceart Integration 1.01 Guide
01
GUIDE
LATITUDE®
Patient Management System
LATITUDE®–PACEART® INTEGRATION
SYSTEM DIAGRAM
a. Patient environment
b. LATITUDE environment
c. Clinic environment
f. Patient dismissal
k. Paceart server
l. Paceart client
3. INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
3.1 Basic requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.1.1 Hardware and OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3.1.2 Data storage requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.1.3 Software and environment requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.1.4 User requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3.2 Install application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.3 Install certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.3.1 Creating license file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3.4 Configure Windows services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.5 UEMR.XML configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.6 LPI.XML configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.7 Paceart® Gateway Services configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
3.8 Starting and stopping the service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4. TESTING . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.1 Test protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.2 Expected results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.3 Verification of installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
5. MAINTENANCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
5.1 Certificate renewal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
5.2 Upgrade the LATITUDE®–Paceart® Integration software . . . . . . . . . . . . . . . . . . . 22
5.3 Uninstall the LATITUDE®–Paceart® Integration software . . . . . . . . . . . . . . . . . . . 22
6. REFERENCE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
6.1 LATITUDE®–Paceart® Integration configuration detail . . . . . . . . . . . . . . . . . . . . . 23
6.1.1 Header section parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
6.1.2 Global section parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
6.1.3 Pickup zone section parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
6.1.4 Pickup zone paths tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
6.2 Example LPI.XML configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
6.3 Event logging and log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
6.3.1 Log file configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
6.3.2 lpi.service.log file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
6.3.3 lpi.activity.log file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
6.4 Conversion formula . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
6.5 LPI error code messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3. INSTALLATION
Once both the LATITUDE Integration application and the LATITUDE–Paceart Integration
software have been successfully installed and tested, your clinic will be able to securely
retrieve HL7 data files from the LATITUDE secure server and import them into your
Paceart system. Depending on the needs of your own clinic, patient data may also be
imported into an EMR or CIS system outside the Paceart environment.
NOTE: The LATITUDE Integration application must already have been installed and
tested before attempting to install LPI.
NOTE: The installation assumes that you are a Windows administrator and that are very
familiar with Windows administration tasks. It is also assumed that you are proficient in
using the Windows operating system and understand how to implement your clinic's
security policies for patient data records.
This section describes the step-by-step process of installing the LPI application. The
following steps must be completed in sequence.
6. Although using the default destination folder is strongly advised, you may browse to
and select another location. (The illustrations in this manual refer to the default
destination folder.) Click Install to start the installation process.
2. Ensure that the LATITUDE Integration application, Java Runtime Engine version
1.6.0 or greater (32-bit version), and Java Unlimited Jurisdiction Pack are installed. If
not, go back to those sections and complete those processes before continuing.
3. Locate your clinic–specific certificate (xxxx.P12). This file should have been received
under separate cover from Boston Scientific. If you have not received this certificate,
please contact LATITUDE Customer Support.
6. Open a Command Prompt and navigate to the LPI directory (e.g., C:\Program
Files\Boston Scientific\LATITUDE Integration\LPI).
7. Create your computer specific license file by issuing the following command at the
command prompt:
install_license certs\<cert filename> <cert password>
The command does not return messages for successful file creation or incorrect
password entry.
If you receive a “The system cannot find the path specified” error check the
JAVA_HOME environment variable to ensure that it is set correctly. See the LATITUDE
Integration Guide for more information about the JAVA_HOME environment variable.
You have now created an encrypted license file that LPI will use to authenticate your
clinic when it connects to LATITUDE®. This license file cannot be used on any other
computer in your clinic. If you reinstall the LPI application on a different computer, you
must create a new license file for that computer by following this process again.
NOTE: Startup type should be set to Automatic. This causes the LPI service to be
started when the computer is started.
This allows the LPI service to run under the UEMRAdmin account as required. LPR will
not run under the “Local System account.”
NOTE: The password will need to be entered even though the dots indicate that it is
already there.
You have now configured the LATITUDE®–Paceart® Integration service to use a specific
user account and password. If the user account ever gets deleted or if the password ever
expires, the LPI service will fail to start and data will not be exported to Paceart.
The LPI service is now configured. The next step is to configure the application itself.
Continue to “UEMR.XML Configuration” to properly configure LATITUDE Integration.
Follow the steps below to configure the uemr.xml file to work with LPI. Log on with the
UEMRAdmin account.
1. Locate the uemr.xml file in the <install dir>\config directory. Note there may be other
configuration files in the config directory. These files are used by LATITUDE
Integration and should not be changed unless instructed by Boston Scientific.
2. Edit the uemr.xml file using your favorite text editor. (Notepad or WordPad will work
fine.) Below is an example uemr.xml file before any modifications.
3. Find the end of the global section by searching for the </global> tag.
4. Insert the following line above the </global> tag.
<crc-mode>downstream</crc-mode>
This entry will cause the application to create a CRC file for the LPI software to process.
These files are located in the UEMR installation directory (default is C:\Program
Files\Boston Scientific\LATITUDE Integration\UEMR). See the “Starting and
Stopping the Service” section in LATITUDE Integration Guide for more information.
NOTE:There are other configuration files in the config directory. These files are used by
LATITUDE–Paceart Integration and should not be changed unless instructed by Boston
Scientific.
4. Locate the directory where LPI will read incoming HL7 files. This must be the drop
zone directory configured during LATITUDE EMR Integration. It may be on the local
machine or a network share. Ensure that the UEMRAdmin account has read/write
privileges to this directory.
7. Edit the paceart-uri entry by searching for “ADD PACEART MACHINE” and replace
it with the name of your Paceart server, including the quotes. For example, if LPI is
installed on the Paceart computer, the final Paceart-uri entry would be:
paceart-uri="https://localhost:443"
8. Edit the pickup-zone-path entry searching for “ADD PICKUP PATH” and replace it
with the path to the location of the incoming HL7 files - including the quotes. An
example of the entry would be:
pickup-zone-path path="C:\UEMROutbox".
9. Edit the pickup-zone-path certificate-path entry by searching for “ADD CERT
NAME” and replace it with the name of the .LIC file you created earlier– including the
quotes and .lic extension. In this example it would be: pickup-zone-path certificate-
path="certs\sc_12345.lic". The license file name must be an exact match (with the
addition of the .lic) of the name used in the UEMR.XML config file in order for
decryption to be successful. Ensure that the names match by reviewing the
UEMR.XML configuration file.
10. The final lpi.xml file is shown below. Inspect your lpi.xml file to ensure proper
configuration.
NOTE: You are working with actual patient data. Patients should not be dismissed
without the consent of the clinician. All normal LATITUDE® review procedures should be
followed.
3. Place a check in the box to left of the patient's name to be dismissed and then click
the Dismiss Patient button. This action will remove the patient from the Patients for
Review page and begin the LPI process.
4. Open the ALL PATIENTS tab on the LATITUDE website and find the patient whom
you dismissed in the previous step. Make note of the following information to compare
with the data that Paceart® will import:
a. Patient name
b. Patient date of birth
c. Device model number
d. Device serial number
5. Open the Paceart client and find the most recent data for the patient you dismissed
from LATITUDE in step 3 above. Verify that the content of the four data points shown
on the LATITUDE ALL PATIENTS tab is the same as that shown in Paceart.
NOTE: During the test an Error 6 message might be written to the Paceart log. This
occurs when no patients are found with a matching device model or serial number. Refer
to Paceart System Administrator's Manual for additional information about the Paceart
log.
5. MAINTENANCE
5.1 Certificate renewal
Each certificate used for LPI authentication and authorization has an expiration date. When the
certificate expires, it will be necessary to replace the expired certificate with a new certificate
provided by Boston Scientific. Once the new certificate is received, the following steps will be
used to replace the expired certificate with a new, valid certificate.
1. Stop the LPI and LATITUDE Integration Windows services.
2. Copy the new certificate (.p12 file extension) provided by Boston Scientific to the LPI/
Certs folder. (The default location is C:/Program Files/Boston Scientific/Latitude
Integration/LPI/Certs/). If you receive a “file exists” message, allow the new file to
overwrite the old file.
Certificates .\certs\*.p12
Configurations .\config\lpi.xml
The following parameters may be included in the global section of the configuration file.
They may also be used in other sections which may override the global parameter
setting. See the description of the parameter hierarchy above.
In addition, there are a number of optional parameters available for a pickup zone. Many
of these optional parameters may also be defined in the global section described earlier.
Any optional parameters defined for a pickup zone will override the same parameter
defined in the global section.
Each pickup zone has two complex tags that define the pickup zone paths and the drop
zone paths. The following paragraphs define those tags in more detail.
6.1.4 Pickup zone paths tag
The pickup zone paths tag defines specifically where to retrieve the files from. It may
point to a local or a network path. A pickup zone path tag must have at least one network
path or one local path or LPI will not start.
A local path is a directory on the local machine or clinic network. The LATITUDE®–
Paceart® Integration admin user must have read/write access to this directory.
The local path and network path are complex XML tags with multiple elements in each.
The following table describes the elements.
Although this log entry is more than one line, it is a single action log. The log entry can
be broken down into its components.
Message id T200
Date/time stamp is the date and time this particular log entry occurred. It is taken from
the date and time of the computer.
Message id is an identifier for the location in the program where this error occurred. This
information will only be useful when debugging problems with Boston Scientific.
Action class is the type of log entry as described above.
Message is the action message. It always starts with an identifier which will most
commonly be the pickup zone name from the configuration file.
Launching a JVM...
WrapperManager: Initializing...
2010-10-11 10:34:18,234 STARTUP [WrapperStartStopAppMain] - =======================================
2010-10-11 10:34:18,234 STARTUP [WrapperStartStopAppMain] - Starting up, Version: 1.01
2010-10-11 10:34:18,234 STARTUP [WrapperStartStopAppMain] - JAVA_HOME environment variable: C:\Program
Files\Java\jre6
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - S401:Global configuration : <global>
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - verbose: false
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - log-path: ./log
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - polling-interval: 60
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - retry-count: 4
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - input-file-suffix: hl7
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - crc-input-mode: off
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - crc-output-mode: off
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - crc-suffix: crc
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - crc-input-algorithm: MD5
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - crc-output-algorithm: MD5
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - delete-input-files: true
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - save-input-file-location: ./save
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - save-input-file-suffix: sav
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - save-xml-files: true
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - error-file-dropoff-path: ./error
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - error-file-suffix: err
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - paceart-uri: https://stppartv02:443
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - paceart-certificate-location: ./certs/
Paceart_Root_Cert.jks
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - paceart-transfer-timeout: 50
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - Pickup-zone Configuration Name: PICKUPZONE1
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - Pickup Zone path(s):
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - Local Path (C:\CIS_EMR_Inbox\DZ_1)
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - save-xml-file-path: ./save
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - crc-input-algorithm: MD5
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - crc-input-mode: off
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - crc-output-algorithm: MD5
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - crc-output-mode: off
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - crc-suffix: crc
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - polling-interval: 60
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - retry-per-interval: 4
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - save-input-files-path: ./save
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - save-input-file-suffix: sav
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - Models :
2010-10-11 10:34:19,667 STARTUP [WrapperStartStopAppMain] - 1850=1850 Ventak Prizm VR, 1851=1851 Ventak Prizm
DR, 1852=1852 Ventak Prizm VR HE, 1853=1853 Ventak Prizm DR HE, 1857=1857 Ventak Prizm VR HE, 1858=1858 Ventak
Prizm DR HE, 1860=1860 Ventak Prizm 2 VR, 1861=1861 Ventak Prizm 2 DR, E010=E010 CONFIENT, E020=E020 CONFIENT,
E030=E030 CONFIENT, E040=E040 CONFIENT, E050=E050 PUNCTUA ICD, E051=E051 PUNCTUA ICD, E052=E052 PUNCTUA ICD,
E053=E053 PUNCTUA ICD, E102=E102 Teligen 100, E103=E103 Teligen 100, E110=E110 Teligen 100, E111=E111 Teligen
100, E140=E140 ENERGEN ICD, E141=E141 ENERGEN ICD, E142=E142 ENERGEN ICD, E143=E143 ENERGEN ICD, E160=E160 INCEPTA
ICD, E161=E161 INCEPTA ICD, E162=E162 INCEPTA ICD, E163=E163 INCEPTA ICD, F050=F050 PUNCTUA ICD, F051=F051 PUNCTUA
NE ICD, F052=F052 PUNCTUA ICD, F053=F053 PUNCTUA NE ICD, F102=F102 Teligen 100, F103=F103 Teligen 100, F110=F110
Teligen 100, F111=F111 Teligen 100, F140=F140 ENERGEN ICD, F141=F141 ENERGEN ICD, F142=F142 ENERGEN ICD, F143=F143
ENERGEN ICD, F160=F160 INCEPTA ICD, F161=F161 INCEPTA ICD, F162=F162 INCEPTA ICD, F163=F163 INCEPTA ICD, H115=H115
Contak CD 2, H119=H119 Contak CD 2 HE, H135=H135 Contak Renewal, H155=H155 Contak Renewal 2, H170=H170 Contak
Renewal 3, H171=H171 Contak Renewal 3, H173=H173 Contak Renewal 3, H175=H175 Contak Renewal 3, H176=H176 Contak
Renewal 3 HE, H177=H177 Contak Renewal 3 HE, H179=H179 Contak Renewal 3 HE, H190=H190 Contak Renewal 4, H191=H191
Error code
Message
number
LPI Installer error (install directory). Please, close all
1
applications and try installing LPI again.
Component or
Definition
Actor Name
Clinical
Software package used at clinics and hospitals to electronically
Information
store patient data.
System (CIS)
Clinic
Site where the EMR/CIS applications are installed and used.
Environment
Person with the role of caring for patients who have implanted
Clinician
devices. Could be a physician or an allied health professional.
LATITUDE®–
LATITUDE–Paceart Integration (LPI) is the software used to
Paceart® securely transfer LATITUDE data to Paceart.
Integration
Centralized computer system that stores from LATITUDE
LATITUDE
Communicator. Provides data content for LATITUDE website and
Secure Server
transfer to clinic
LPI File
Conversion See LATITUDE–Paceart Integration (LPI).
Module
Paceart
The relational database that contains and manages Paceart data.
Database
The person that has the implanted cardiac device that is being
Patient
followed by your clinic.
./lib Contains the JAVA code and libraries for LATITUDE Integration.
Additional default directories may be created when the LPI service is started for the first
time.
1.800.CARDIAC (227.3422)
+1.651.582.4000
www.bostonscientific.com
358545-002 EN US 2014-02
*358545-002*