OrderList Plug-in Installation & Admin Tool Guide

Transcription

1 OrderList Plug-in Installation & Admin Tool Guide DIR# Rev F Revision Date: 2015/10

2 Prerequisites The user performing the installation has technical/administrative knowledge of CardioPerfect Workstation. The user performing the installation has the necessary Windows privileges to install software. Microsoft.NET Framework 2.0 is installed on the target computer. Installation Steps The OrderList Plug-in has two types of install: Server installation Client installation The server installation (OrderListServer.exe) is typically installed on one computer on the network. All clients can then be configured to communicate with the server software. The client installation (OrderListClient.exe) should be installed on computers that have CardioPerfect Workstation or above installed. Server Installation 1. Double click the OrderList Plug-in server installer executable (OrderListServer.exe). The following dialog appears: DIR# Rev F 2 of 15 Revision Date: 2015/10

3 2. Click Next to continue. The following dialog appears: CardioPerfect Workstation OrderList Plug-in 3. Click Next to Continue. The following license agreement appears: DIR# Rev F 3 of 15 Revision Date: 2015/10

4 4. Read the terms of the license agreement and to proceed, select Next. The following dialog appears: 5. If required, select Browse to change the installation path. Select Next. The following dialog appears. To use this software with a DICOM modality work list server, select YES from the drop-down, otherwise select NO. Select Next to continue. DIR# Rev F 4 of 15 Revision Date: 2015/10

5 6. If YES was selected to install the DICOM Modality Worklist Server in the previous dialog, the following settings dialog will be displayed. Enter the appropriate values for the DICOM configuration. 7. The following dialog is displayed Press Finish to complete the installation. DIR# Rev F 5 of 15 Revision Date: 2015/10

6 Server Uninstall To uninstall the OrderList Plug-in server application: Navigate to Add/Remove Programs Highlight Welch Allyn CardioPerfect OrderList Server Click on Remove button Complete the uninstall by selecting the remaining default options DIR# Rev F 6 of 15 Revision Date: 2015/10

7 Server Configuration (non DICOM installations) The server application is a Windows Service named CPWS.OrderList. An XML text based configuration file OrderList.Service.exe.config is stored in the installation folder of the application. The following settings in the file can be configured manually: Setting Default Value Description MiniWebPort 9249 The server application runs an internal web server, which the client communicates with. This value is the port which the web server operates upon. Indicates a HL7 carriage return string. It is not recommended to change this value. HL7CarriageR \.br\ eturn HL7Tab \sp+5\ Indicates a HL7 tab string. It is not recommended to change this value. SiteIdentifier blank/empty string In some instances, patient numbers are prefixed by a unique code specific to a site/hospital. In these cases, this unique code can be set to filter Order searches EIE connectionstring="data Source=.\sqlexpress;Initial Catalog=WA_EIE_DB;Integrated Security=SSPI;"providerName ="SqlOleDb.1." The connection string to access the database containing the new orders. If the default value is used, the account the CPWS.OrderList service is executing under requires SELECT permissions within the EIE database For changes to take effect, save the file and restart the CPWS.OrderList Windows Service. Server Configuration (DICOM installations) The server application is a Windows Service named CPWS.OrderList. The DICOM settings entered during the installation are stored in the registry at the following location: HKEY_LOCAL_MACHINE\SOFTWARE\OrderList Plug-in\DICOM Worklist. If changes are made, the CPWS.OrderList Windows service needs to be restarted for the changes to take effect. DIR# Rev F 7 of 15 Revision Date: 2015/10

8 Client Installation 1. Double click the OrderList Plug-in client installer executable (OrderListClient.exe). The following dialog appears: 2. Click Next to continue. The following screen appears: DIR# Rev F 8 of 15 Revision Date: 2015/10

9 3. Click Next to continue. The following license agreement dialog appears: 4. Read the terms of the license agreement and to proceed, select Next. The following dialog appears: DIR# Rev F 9 of 15 Revision Date: 2015/10

10 5. If required, enter in a Station Name for the OrderList Plug-in. If no Station Name is entered the Computer Name will be used as the Station Name. Station Name must be no longer than 16 characters in length. Select Next. 6. If required, select Browse to change the installation path. Select Next The software is now installing. Once installation is complete the following dialog appears: 7. To complete the installation, select Finish. DIR# Rev F 10 of 15 Revision Date: 2015/10

11 Client Uninstall To uninstall the OrderList Plug-in client application: Navigate to Add/Remove Programs Highlight Welch Allyn CardioPerfect OrderList Plug-in Click on Remove button Complete the uninstall by selecting the remaining default options DIR# Rev F 11 of 15 Revision Date: 2015/10

12 Client Configuration Changing the input into the decision tree, as described in the PatientMatchCriteria section in the following table, might result in the establishment of an incorrect diagnosis for a patient due to incorrectly assigned test results. It is highly recommended to keep the input value at the default setting. A XML text based configuration file OrderListConfig.xml is stored in the installation folder of the application. The following settings in the file can be configured manually: Setting Default Value Description MaxResults 100 Maximum number of orders to display in CardioPerfect Workstation UseCPWSLocation FALSE If set to a value other than FALSE, the location specified within CardioPerfect Workstation is used to search for orders only targeted for that particular location. Server CPWSOrderList/OrderQ uery.asmx/ The URL for the Web Service that is hosted on the server. localhost should be updated to be the IP address or machine name of the computer that is hosting the server application ServerTimeout Timeout value (milliseconds) to await a response from the server application ECGServiceID ECG List of all possible test types (OBR-4) originating in the HL7 order request message for which CardioPerfect ECG test type can cater for. For multiple test types split each test type with a pipe symbol ( ), e.g. ECG EKG 12_LEAD_ECG XECGServiceID XECG List of all possible test types (OBR-4) originating in the HL7 order request message for which CardioPerfect stress ECG test type can cater for. For multiple test types split each test type with a pipe symbol ( ), e.g. XECG XEKG ABPMServiceID ABPM List of all possible test types (OBR-4) originating in the HL7 order request message for which CardioPerfect ABPM test type can cater for. For multiple test types split each test type with a pipe symbol ( ), e.g. ABPM BP SpiroServiceID SPIRO List of all possible test types (OBR-4) originating in the HL7 order request message for which CardioPerfect Spirometry test type can cater for. For multiple test types split each test type with a pipe symbol ( ), e.g. SPIRO SPIROMETRY RecollectServiceID RECOLLECT List of all possible test types (OBR-4) originating in the HL7 order request message for which CardioPerfect Recollect test type can cater for. For multiple test types split each test type with a pipe symbol ( ), e.g. RECOLLECT REC HolterServiceID HOLTER List of all possible test types (OBR-4) originating in the HL7 order request message for which the Holter test type can cater for. For multiple test types split each test type with a pipe symbol ( ), e.g. HOLTER HOLTERTYPE HolterExecutable C:\Program The Holter software executable (GIWAHolterSystem.exe) path Files\GIMedical\WAHol ter\1.1\giwaholtersys tem.exe HolterOutputPath C:\temp For Holter integration this value needs to be the same as the EMR file output path in the Holter software DateFormats yyyy-mmddthh:mm:ss The date format of the dates contained within the order related tables in the EIE database DIR# Rev F 12 of 15 Revision Date: 2015/10

13 PatientMatchCriteria MATCH_DOB_GENDER_ LAST_FIRST CardioPerfect Workstation OrderList Plug-in This value is used as input into the decision tree to decide how to process potential duplicate patients. Available values are: MATCH_DOB_GENDER_LAST_FIRST MATCH_DOB_GENDER_LAST MATCH_DOB_GENDER MATCH_DOB_LAST_FIRST If a patient pre-exists in the CardioPerfect database and a patient with the same patient number is then imported via the OrderList Plug-in, the system performs a check on the patient demographics: MATCH_DOB_GENDER_LAST_FIRST: system assumes the patients are the same only if the following are the same for both existing patient and imported patient: Date of Birth, Gender, Last name & First name MATCH_DOB_GENDER_LAST: system assumes the patients are the same only if the following are the same for both existing patient and imported patient: Date of Birth, Gender & Last name MATCH_DOB_GENDER: system assumes the patients are the same only if the following are the same for both existing patient and imported patient: Date of Birth & Gender MATCH_DOB_LAST_FIRST: system assumes the patients are the same only if the following are the same in both existing patient and imported patient: Date of Birth, Last name & First name If the system makes the decision that the patients are not the same, a new patient record shall be created in the CardioPerfect database and the patient number shall be created according to the value in the SuspectFix configuration setting. Changing the input into the decision tree might result in the establishment of an incorrect diagnosis for a patient due to incorrectly assigned test results. It is highly recommended to keep the input value at the default setting. SuspectFix SUSPECT If a potential duplicate patient is imported via the OrderList Plug-in, a new patient record shall be created. The patient number shall be suffixed by the SuspectFix value and an incremental number e.g SUSPECT1 StationName N/A This field is needed only for DICOM installations. For DICOM installations, Station Name is a unique identifier for the CPWS client machine and is sent as field as part of the DICOM output. This value can be configured during installation or if left blank the Computer Name will be used by default. If changes are made to the file, save the file and restart CardioPerfect Workstation. DIR# Rev F 13 of 15 Revision Date: 2015/10

14 OrderList Admin Tool CardioPerfect Workstation OrderList Plug-in The OrderList Admin Tool provides IT administrators the ability to: - Delete orders from the OrderList within CardioPerfect Workstation - Associate a new order with an existing test NOTE: The OrderList Admin Tool deletes orders from the OrderList view within CardioPerfect Workstation. It does not delete orders from the system the order originated from, i.e. the master ordering system/his. The OrderList Admin Tool software is installed as part of the OrderList Client installation. The Admin Tool software can be found in the working directory of the OrderList Client software. Typically this directory is: C:\Program Files\Welch Allyn\CardioPerfect OrderList Client. The software is run by executing the OrderList.AdminTool.exe file. Once the software is started, the following form is displayed: Remove orders from the CardioPerfect Workstation view 1. Start the software 2. Select/highlight the required order in the New Orders grid 3. Press the Delete Order button 4. Press Yes in response to the resulting confirmation window Associate a new order with an existing test 1. Start the software 2. Select/highlight the required order in the New Orders grid 3. Press the Find Tests button 4. In the Patient Tests grid, select/highlight the test you wish to associate with the selected Order 5. Press the Associate Order with Test button 6. Press Yes in response to the resulting confirmation window DIR# Rev F 14 of 15 Revision Date: 2015/10

15 Technical Assistance Welch Allyn Technical Support Tel: (353) Fax: (353) Welch Allyn USA Tel: or Fax: DIR# Rev F 15 of 15 Revision Date: 2015/10