Home

AcuoSemantix Installation and Operations Guide

1. If this setting is enabled and there is a match both a Patient Update and Study Update fixit will be generated assuming UpdatePatient and UpdateStudy are configured in the ActivityList xml file for an ORM message 13 EnableDefaultFixitForDomain FixltDests new in 5 3 1 HF1 These parameters are new in the AcuoSemantix 5 3 1 Hotfix 1 release They enable functionality for sending fixit message to different AcuoMed destinations Server Port Called AE Name based on data in the inbound HL7 message The source data from the inbound HL7 message that is used to determine where to send the fixit is the field mapped to the Issuer of Patient ID tag 0010 0021 in the HL7TagMap xml file See below for a description of each parameter o EnableDefaultFixitForDomain This can be set to either YES or NO It will default to NO if nothing is entered If set to NO and there is NO MATCH to Issuer of PID for any configured Dest a fixit will NOT be sent anywhere and the message will not be processed In addition a Warning event will be output indicating the message was not processed If set to YES and there is NO MATCH to Issuer of PID for any configured Dest a fixit will be sent to the default fixit parameters the parameters above gt HostName ListeningPort AETitle_AcuoMed Note that 1 or more Dests see below must be configured with a Host Name in order for this parameter to take effect o FixltDests This node contains 1 or mor
2. Browse lt Back Next gt Cancel 8 On the HL7 to XML Conversion screen a Check the box for Convert HL7 to XML b Inthe Derivative field select highlight the derivative file inside the appropriate HL7 version node Be sure to select highlight the derivative file subnode not the HL7 version node if a derivative file is being used c Uncheck the Enforce Required Segments and Enforce Required Fields fields Check the Ignore Unexpected Segments and Ignore Unexpected Fields fields e Click Next AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 55 of 75 POWERED BY ACUO Connection Wizard x HL to XML Conversion Specify the HL to XML Conversion options Derivative MV Convert HL to XML Conversion Options Enforce Required Segments Enforce Required Fields V Ignore Unexpected Segments V Ignore Unexpected Fields lt Back Next gt Cancel 9 On the Inbound Delivery Configuration screen leave all defaults then click Next Connection Wizard X Inbound Delivery configuration Specify the MSMO and logging configuration Inbound Post MSMO Path or Format Name private IB_HIS_ADT_ORM_post IV Log messages placed on the Post queue lt Back Next gt Cancel 10 On the Sink Gear Selection screen select RFMDBGear clsALGear from the dropdown
3. lt MESSAGE gt lt MESSAGE name ORMOO1 gt lt ACTIVITY gt UpdateAcuoHISRIS lt ACTIVITY gt lt ACTIVIT Y gt UpdatePatient lt ACTIVITY gt lt ACTIVITY gt UpdateStudy lt ACTIVITY gt lt ACTIVITY gt SendBatchMove lt ACTIVITY gt lt MESSAGE gt lt MESSAGE name Activity Examples gt lt ACTIVIT Y gt UpdateAcuoHISRIS lt ACTIVITY gt lt ACTIVIT Y gt PatientMerge lt ACTIVITY gt lt ACTIVITY gt UpdatePatient lt ACTIVITY gt lt ACTIVITY gt UpdateStudy lt ACTIVITY gt lt ACTIVITY gt SendBatchMove lt ACTIVITY gt lt MESSAGE gt lt ActivityList gt NOTE The ActivityList xml file is generally set up during initial implementation Any changes to this file should be made by Acuo Support personnel changes made to this file may have significant workflow ramifications e Refer to Figure 6 2 above Notes on editing the ActivityList xml file open in Notepad or an XML editor to modify e New message names may be added along with corresponding activities depending on the requirements determined from site assessment and implementation e To add anew message name copy the text from an existing message from the lt MESSAGE name all the way to the end tag lt MESSAGE including the activities in between and paste it just after the end of another message Change the text inside the quotes to the new message name and add or remove any associated activities as needed e The activities that can be co
4. pl QCUO TECHNOLOGIES AcuoSemantix Installation and Operations Guide Release 5 3 Revision A 6 28 2011 AcuoSemantix Installation and Operations Guide Copyright 2011 Acuo Technologies All Rights Reserved License Agreement AcuoSemantix is an Acuo Technologies licensed software product Please refer to the separate Acuo Technologies Software License Agreement for complete licensing information Trademarks All company and product names are trademarks or registered trademarks of their respective holders Corporate Headquarters Acuo Technologies LLC Riverview Office Tower 8009 34 Avenue South Suite 900 Bloomington MN 55425 U S A General 952 905 3440 952 905 3441 FAX info acuotech com Support 1 866 272 ACUO 2286 support acuotech com World Wide Web Site http www acuotech com AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 2 of 75 POWERED BY Contents 1 INTRODUCTION seccionar a A 4 2 ACUOSEMANTIX FUNCTIONAL OVERVIEW eseseseseseseosososcsoseceseseseseoeseosososcseseseseseseseseosososcseseseseseseseseseososcscsesesesesesesesesese 7 2 1 AE IEE OVE E A E E 7 2 2 DETALED OVERVIEW oera E AEE ES 8 3 INSTALL AND CONFIGURE ACUOMED ACUOSTORE ccccccccscccccccccccccccccccccccccccccccccccccccscccccccccccccccccccccccccccccccccccccceees 10 4 ACUOSEMANTIRX SYSTEM PRE REQUISITES ccccccccccccccccc
5. 2 ItemCopy oin data to T_ARPS_HL _TO_XML_REPRESENTATION ARPS_HX_XML_STREAM Source Operand Destination Operand Null Literal Variable Path Metta Data variable Path Meta Data in Unparsed Unparsed Unparsed Semespare Siege pete 5 re Name T_ARPS_HL _TO_XML_REPRESENTATION ARPS_HX_XML_51 Occurrence EN Lo Search GS B Path Container ariables Name T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_GUID T_ARPS_HL _TO_XML_REPRESENTATION ARPS_HX_INSERTDATET T_ARPS_HL _TO_XML_REPRESENTATION ARPS_HX_XML_STREAM Y K 2 f OK Cancel Description Repeat this Form 5 Click the Database tab at the top then click the DBInsert button 2 from the left Select the Association created above leave the Result field blank then click OK to add the DBinsert action y Edit Action List Acuo_ActionList a aay SD siemens E imp ean Resources mi Document Map a Message Control_ B Database Debug MB System ed i Fy D ji Read Modify a Resources Line 1 Action cp x zt 4 33 Se ai 2 Interact E Add action DBInsert 4 DBInsert Acuo_Association all associated columns Association Acuo Association Result Columns Y Xx 2 OK Cancel Description 6 After completing all of the previous steps the configuration for the Action List should look like the screen below Verify this looks correct then click the File menu at the top
6. ACTIVE Clear Complete Cancel all non complete messages in order in the Corepoint Integration Engine amp Acuo HL7 chain Corepoint Integration Engine MSMQ Corepoint Integration Engine Pre amp Post log ASX DB Tables d Batch Patient Update Queue PASSIVE Enable SCP AE which accepts fixit messages from ACTIVE Remote site oS AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 73 of 75 Synchronized HL7 Failover Failback Rev 6 1 Legend DICOM Interface HL7 Interface DNS or Load Balancer or Completed Pending Queue Queue HL7 Sending Interface Contig W7 ACTIVE Corepoint Integration Engine Port 5050 C AcuoSemantix AcuoMed Local Fixit AE PASSIVE r OT 3 Corepoint Integration Engine i Port 5050 AcuoMed Local Fixit AE E AcuoMed Remote Fixit AE ACTIVE On Fix it Propagate Fix it 2 through DBs through DBs AcuoMed Remote Fixit AE AcuoMed Remote Fixit AE AcuoMed Remote Fixit AE AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 74 of 75 Synchronized Failover Failback Requirements 1 All systems are operational with no errors in the Batch Patient Update queue preventing quick final synchronization 2 Customer understands timing considerations DNS time to live and failure point
7. IV not connected IV send failed IV stopping MV stopped Select all Unselect all lt Back Next gt Cancel 12 On the Log Maintenance Configuration screen leave all defaults then click Next AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 57 of 75 A POWERED BY 13 On the Alert Configuration screen leave all defaults then click Next z li 14 Click Finish to complete the configuration of the Receiver Connection AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 58 of 75 POWERED BY Connection Wizard yiz Completing the Connection AK NEOTOOL wizard Singvler Focas gt Hecthcors irtagraed You have successfully completed the Connection Wizard To close this wizard click Finish lt Back Finish Cancel 15 Click Yes on the pop up screen that follows to start the connection Start connection vo Successfully created connection would you like to start this connection now Yes No i Set up anew Subscription Pool 1 After performing the previous step go back to the Corepoint Integration Engine Configuration setup by navigating from the Start Menu to Start Programs NeoTool gt Corepoint Integration Engine gt Corepoint Integration Engine Configuration 2 Right click on the right side of the screen and select Rout
8. Ifthe service is started successfully a series of blue informational events will appear in the Acuo Event Log the screenshot below is after a complete restart of the service that was already running prior to the restart There is an event output when the service is stopped one when the service starts some initialization messages and 1 final initialization message when the service is ready F ASXConsole Console Root Classic Event Viewer Local Acuo File Action View Favorites Window Help salu EB vE fa 3 Console Root Type Date Time F Source Category i Event User gt AcuoSemantix Configuration Mana f G Information 5 25 2011 1 19 18 PM_ AcuoSemantis AcuoSemantixService 25987 N A E gj Classic Event Viewer Local Information 5 25 2011 1 19 18PM AcuoSemantix AcuoSemantixService 25873 N A 3 Acuo l E Information 5 25 2011 1 19 18 PM AcuoSemantis Acuo Medical Library 16385 N A Application QD Information 5 25 2011 1 19 18 PM AcuoSemantix Acuo Medical Library 16388 N A H Harware Events Information 5 25 2011 1 19 17 PM_ AcuoSemantis AcuoSemantis Service 25873 N A Aino a D Information 5 25 2011 1 1917 PM_ AcuoSemantis AcuoSemantix Service 25856 N A oona ere Information 5725 2011 1 19 06PM_ AcuoSemantix AcuoSemantix Service 25857 N A MyNewLog Microsoft Office Diagnostics 8 Microsoft Office Sessions 8 Security 3 System Windows PowerShell 3 Ifthe AcuoSemantix Service star
9. ia Corepoint Health Solutions InstallShield Wizard Destination Folder 4 Click Next to install to this Folder or click Change to install to a different Folder Cy Install Corepoint Health Solutions to C Program Files Corepoint Health Change InstallShield lt Back Cancel AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 34 of 75 f Onthe Installation Type screen select the option Production a Installation Type Select your Installation Type InstallShield Select Products Select the products you want to install Installshield Corepoint Integration Engine Options Select the Corepoint Integration Engine Options you need TETTES Sample configuration and applications Installshield ek ST core AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 35 of 75 IELO i Ifthe following Port Conflict screen appears select Use these ports anyway then click Next is Corepoint Health Solutions InstallShield Wizard Port Conflict Select web server ports It appears that another application is already using one or both of the ports listed below HTTP Port conflict HTTPS Port Click Next to Try Again Use these ports anyway Installshield Help lt Back Cancel j Onthe Administrator Password scre
10. parameter may effectively override this setting and potentially prevent a Batch Move job from being queued for an ORM O01 message See next parameter below EnableBatchMoveStudyStatus If a value is configured in this parameter and an order message ORM O01 is received a batch move will only be queued if the value in the ORC 1 Order Control segment matches the value configured here If no match occurs no Batch Move will be queued To turn this functionality off delete the value in this parameter o This setting only takes effect if SendBatchMove is configured in the ActivityList xml file for 1 or more message types o Example The value NW may be present in the ORC 1 segment to indicate it is a new order If NW is configured for this parameter in the configuration file batch moves will only be queued if there is a match if a new order is received Subsequent ORM messages with a different order status will NOT generate an additional Batch Move job DisablePIDOnMove Controls whether a Batch Move job queued from AcuoSemantix uses PID or Patient Name as the move criteria o If set to NO Batch Moves will be queued using Patient ID PID as the move criteria A wildcard character will be used for Patient Name This is the default o Ifsetto YES the Patient Name will be used as the move criteria and a wildcard will be used for PID If set to YES the components used for the Patient Name are last nam
11. AcuoStore install e The AcuoMed Image Manager DICOM Conformance Statement This document is available in PDF format at the Acuo Technologies Web site http www acuotech com e The AcuoSemantix HL7 Conformance Statement This document is available in PDF format at the Acuo Technologies Web site http www acuotech com e DICOM and HL7 conformance statements for integrated devices e The DICOM 3 0 Standard e The Windows Server Help System and the Microsoft SQL Server Help System accessed by choosing Help from the Windows Start menu e If you are using tape for near line or offline storage refer to the documentation supporting these products This includes device documentation and related HSM Hierarchical Storage Management information such as Microsoft RSS AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 4 of 75 VN POWERED BY and RSM information in the Microsoft Windows Help System or other vendor s tape based storage management systems e Ifyou are using tape or other HSM products used as a backup utility please refer to the documentation supporting these products Conventions Used in this Guide It is important to keep in mind a few basic conventions used for presenting information in this document These conventions are summarized below Procedures As much as possible instructions for performing installation and operational tasks are presented by mean
12. Code sets Map vocabularies Action List Set Routing Subscription Pool E Namespace Database 4m Message Association Message Formats Alerts Schedule 2 Name it Acuo_ActionList then click the button Create and Edit Create Action List object X Create a new Action List object Press Create to create only Press Create and Edit to create and launch editor Name acu ActionList Description ee O Create Create and Edit Cancel 3 Click the Message tab at the top then click the MsgLoad button found at the far left side of the screen AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 49 of 75 POWERED BY a Inthe Message Variable field enter the text in Click Select and change the Type to Unparsed Click OK then OK again to add the MsgLoad action Ney Edit Action List Acuo_ActionList AR Resources Document Map ap 3 Message ssage o E control J Database base Debug g System r gx lt OWA ps BH OG oe Bae Yv a al m BE Ea A Msg Flow a MsgMgr m Modify E Convert Associate MetaData Resources Line Action P amp I 3 gt S a 2 al dd Delete Edit Up Down Addaspeer Find Font Description Test Add action MsgLoad MsgLoad into in as Unparsed Unparsed Unparsed X Message Message Unparsed Unparsed S
13. G5 Bing Bar Update S Keeps Bing Bar up to date Disabling this service might p Manual Local System GA BitLocker Drive En BDESVC hosts the BitLocker Drive Encryption service BitL Manual Local System ewe ois em Saa seeme tree Cal 4 p Extended A Standard NOTE By clicking the Trace Settings node you can see a summary of which traces are On or Off e The following 3 traces are available for AcuoSemantix o AcuoSemantix_GeneralTraceFacility o AcuoSemantix_DiLib Dul Trace o AcuoSemantix_Server_Trace e To change various properties for the individual traces right click one of the traces and select Modify Trace Settings from the pop up menu For further assistance please contact an Acuo Support Engineer AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 70 of 75 Manual Delivery of Error Trace Data There may be cases when the Acuo Support staff will want you to manually collect and send trace information either via email or by FTP You need to locate zip and send the trace contents for AcuoSemantix To do this follow these steps 1 To collect traces navigate to the Windows directory then the Tracing folder This is typically C WINDOWS Tracing 2 Select and copy all of the trace files into a newly created folder 3 Create a zip file with the contents of the folder and email it to an Acuo Support Engineer and or copy it t
14. NEW jobs will be expedited if their run times fall within the ExpediteBatchMoveDaysAhead parameter e Note For a newly queued job under this scenario the resulting run time is equal to the Scheduled Study Date minus the of days configured to prefetch ahead of time according to the esdefault prefetch rule e Example Current date is 5 5 2011 An HL7 message is received that generates a Batch Move and the Scheduled Study Date is 5 23 2011 The esdefault prefetch rule is configured to schedule prefetch jobs 7 days prior gt thus on 5 16 2011 If the ExpediteBatchMoveDaysAhead parameter is set to 15 any newly queued Batch Move job will run have its run time set to 1 year earlier since 5 16 lt 5 20 AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 27 of 75 20 21 NOTE 22 NOTE 23 SkipHL7MessagesWithErrors new in 5 3 1 This setting is related to message retry behavior for messages in error that are considered retryable The status of a message that has been processed or failed processing is logged in the T_ARPS_RIS_EVENTS table ARPS_RE_EVENT_PROCESSED column of the AcuoSemantix database The following are the general states values that may be logged into this column o ARPS_RE_EVENT_PROCESSED 0 A value of 0 is set momentarily for all messages just before they are processed o ARPS_RE EVENT PROCESSED 1 A value
15. SCPAETitle gt AcuoMedFixit2 lt SCPAETitle gt lt Dest gt lt FixItDests gt lt Batch Move Prefetch ameters gt cfhtatakihBtationttapping gt 7 PVA PV1 3_AssignedPatientLocation PL_FacilityHd HD_NamespacelId 1 lt PrefetchStationMapping gt lt AcuoBatchMoveServer gt localhost lt AcuoBatchMoveServer gt lt EnableBatchMoveDBFilter gt YES lt EnableBatchMoveDBFilter gt lt EnableBatchMoveStudyStatus gt lt DisablePIDOnMove gt NO lt DisablePIDOnMove gt lt ExpediteBatchMoveServer gt lt ExpediteBatchMoveDaysAhead gt 30 lt ExpediteBatchMoveDaysAhead gt ee eee lt Error Processing F aters gt lt SkipHL7MessagesWithErrors gt YES lt SkipHL7MessagesWithErrors gt lt Miscellaneous Parameters gt lt MasterDEServerName gt locathost lt MasterD ServerName gt lt HL7MessagePollingTimer gt 1 lt HL7MessagePollingTimer gt lt CleanUpDelayDays gt 2 lt CleanUpDelayDays gt lt EnableXMLFiles gt NO lt EnableXMLFiles gt lt TempFolderPath gt lt AcuoSemantixConfig gt Open the AcuoSemantixConfig xml file in Notepad or an xml editor to edit it The following is a description of all parameters in this file reference Figure 6 1 above NOTE Many of the parameters in the AcuoSemantixConfig xml file correspond to information pertaining to Acuo Fixit messages sent from AcuoSemantix see the first 10 parameters below An Acuo Fixit message is a message sent from one Acuo system to another to keep m
16. T_ARPS_RIS_EVENTS gt T_ARPS_RIS_IDENTIFICATION T_UPGRADE_BITMASK T_UPGRADE_DETAIL T_UPGRADE_HISTORY a T_VERSION_VER Add CHECK_CONSTRAINTS COLUMN_DOMAIN_USAGE COLUMN_PRIVILEGES COLUMNS CONSTRAINT_COLUMN_USAGE CONSTRAINT_TABLE_USAGE DOMAIN_CONSTRAINTS DOMAINS KEY COLUMN USAGE oe e de de AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 45 of 75 POWERED BY INCASE f Set up a new Database Association 1 Right click on the right side of the screen and select Database gt Database Association g users 2 Connection g Mapping e Hil Code sets Map vocabularies gt Sa Routing Subscription Pool j Database gt i A Message Formats b ia Namespace d Alerts gt amp Data Point ey Schedule gt 2 Name the Association Acuo_Association then click the button Create and Edit Create Association object X Create a new Association object Press Create to create only Press Create and Edit to create and launch editor Name cua Association Description OOO O O O Create Create and Edit Cancel 3 Click the Select Data Point button In the Data Point field select the Data Point created above if not already populated it is usually already there Click the Show Tables button Highlight the T_ARPS_HL7_TO_XML_REPRESENTATION table and click OK
17. another possible pop up message is Corepoint Health Solutions InstallShield Wizard Installing Corepoint Health Solutions ij The program Features you selected are being installed Please wait while the InstallShield Wizard installs Corepoint Health Solutions This may take several minutes Status Open File Security Warning Ea Do you want to run this file P Name Corepoint Health Setup 4 0 5 exe Publisher Corepoint Health LLC Type Application From mdx052 MedSemantix NeoTool amp Corepoint So Bun Cancel Installshield _ IV Always ask before opening this file potentially harm your computer Only run software from publishers While files from the Internet can be useful this file type can you trust What s the risk m Ifa pop up message is received indicating The installation of Microsoft Visual C 2008 Redistributable Package x86 appears to have failed Do you want to continue the installation click Yes to continue the installer should then complete successfully n When the installation completes leave the box checked to launch the license manager and click Finish A 30 day demo license key should be temporarily obtained from Corepoint until a license key is provided by an Acuo Technologies Support Engineer iz Corepoint Health Solutions InstallShield Wizard InstallShield Wizard Completed The InstallShield Wizard has successfully instal
18. apply tweaks to the configuration that are specific to each site a Export a Configuration Pre Requisite to Importing 1 Importing an existing configuration first requires a configuration to have been previously exported To export a configuration launch the Corepoint Integration Engine Configuration panel through Start Programs Corepoint Health gt Corepoint Integration Engine gt Corepoint Integration Engine Configuration 2 Onthe right side of the screen where all of the objects are listed right click on the Connection and select Export Select the option to Export This Connection then click OK 3 Leave all objects checked and click OK Enter the file name and directory to be saved then click Save b Verify the Corepoint Integration Engine Service is Started on the system where the import will occur 1 To check whether or not the Corepoint Integration Engine Service is started and start it one of the following 2 options can be used i From the Start Menu navigate to Start Programs Corepoint Health gt Corepoint Integration Engine gt Legacy Tools gt Monitor Alerts and Status Under the Corepoint Integration Engine Service node check the My Computer node for whether or not the service is started right click the My Computer node and select Start Service to start it ii Goto the system Control Panel Administrative Tools Services node and go to the Corepoint Integration Engine Serv
19. connection will handle this these type s of M Demographics ADT MV Orders ORM l Results ORU Charges DFT Documents MDM P Other Proposed connection name IB_HIS_AD T_ORM lt Back Next gt Cancel 4 On the General Information screen leave all defaults then click Next AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 53 of 75 IB_HIS_ADT_ORM cll O V 5 On the TCP IP Information screen enter a Server Port of 5050 leave all other defaults then click Next E HL Minimal Layer Protocol HL Minimal Layer Protocol 7 6 On the Inbound Arrival Configuration screen check the box to Log messages placed on the Pre queue then click Next AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 54 of 75 ACUO Connection Wizard X Inbound Arrival configuration Specify the MSMO and logging configuration Inbound Pre MSMO Path or Format Name privates B_HIS_ADT_ORM_pre M Log messages placed on the Pre queue lt Back Next gt Cancel 7 On the Receiver Acknowledgement Information screen leave all defaults then click Next Connection Wizard X Receiver ACKnowledgement Information Enter the Receiver ACKnowldgement information V HL Messages MV Send ACK M SendHL7 ACK Omit ACK Trigger Static ACK string
20. lists merge type messages It was not present in version 5 2 1 o This file contains 2 relevant tags for each merge message Match Tag Non Surviving PID Dest Change Tag Surviving PID 6 Error Processing gt gt In previous releases if an HL7 message could not be successfully processed it was logged in the database as an error however messages in error were never retried automatically In 5 3 1 the default behavior for AcuoSemantix is now to automatically retry or attempt to reprocess messages in error assuming the message in error is classified as retryable Messages in error classified as non retryable will never be retried on their own and thus behavior is the same as in 5 2 1 o Example of message logged with retryable error A fixit could not be queued to AcuoMed because the AcuoMed service was being restarted at the time o Example of message logged with non retryable error An HL7 message is received that is corrupted or has a missing Patient ID Please reference the section in this manual titled Modify AcuoSemantixConfig xml and go to the description for parameter SkipHL7MessagesWithErrors for further details AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 66 of 75 ACUS Appendix B FAQs General Questions 1 How does assigned patient location where the exam will occur information inside an HL7 message get used by AcuoSemantix and
21. may be prompted to insert the Windows 2003 and Windows 2003 SP2 CD or will need to browse to a directory where files have been extracted NOTE MSMQ is an optional component available with Windows that enables applications running at different times to communicate across heterogeneous networks and systems that may be temporarily offline MSMQ ensures reliable delivery by placing messages that fail to reach their intended destination in a queue and then resending them once the destination is reachable Message Queuing provides guaranteed message delivery efficient routing security and priority based messaging Corepoint Integration Engine utilizes MSMQ as it receives messages from an HL7 source To view the GUI component for the MSMQ available within Windows navigate to the following location Control Panel gt Administrative Tools gt Computer Management gt Services and Applications node gt Message Queuing subnode On Windows 2008 or Windows 2008 R2 1 Steps to perform on Windows 2008 or 2008 R2 a Goto the Control Panel Programs and Features or just Programs on Windows 2008 R2 b Click the link Turn Windows features on or off c Inthe Features Summary section click the link Add Features d Check the box for Message Queuing the boxes underneath this option titled Message Queuing Services and Message Queuing Server are automatically selected All other boxes under Message Queuing can r
22. name Ix 3 AcuoServiceUser Password essssese00 Select the button below to specify information about a new user that will be created during the installation New User Information InstallShield f If needed click the New User Information to create a new user AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 16 of 75 ACUO r i fe New User Information G X i Domain or server Ix 3 Browse Group Acuo Administrators Browse Service user name AcuoTestUser Password eeeeeeeeeeee Confirm password feeeeeeeseeee Lox g On the SQL Server screen select the database server you are installing the AcuoSemantix database to as well as the authentication method Windows authentication or SQL Server authentication using a login password K AcuoSemantix Configuration Manager InstallShield Wizard SQL Server Select database server and authentication method Database server that you are installing to X3 Y Browse Connect using C Windows authentication credentials of current user Server authentication using the Login ID and password below Login ID sa Password esses InstallShield Co h On the Database Installation screen enter the following a Database Name i If this is an upgrade installation AcuoSemantix upgrade from a version prior to 5 3 1 the da
23. of 1 indicates the message was processed successfully o ARPS RE EVENT PROCESSED gt 2 and lt 15 A value between 2 and 15 indicates a non retryable error If a message is logged with a non retryable error it will never be retried again on its own If this message needs to be processed again for example to troubleshoot the problem with the message a manual change to the database is needed the entry with the non retryable error Please contact Acuo Technologies Support for further assistance The SkipHL7MessagesWithErrors parameter does NOT affect non retryable errors This setting is related only to retryable errors see next item below o ARPS RE EVENT PROCESSED gt 16 A value equal to or greater than 16 indicates a retryable error Messages logged with these errors will generally be retried on their own periodically however the behavior is affected by the parameter SkipHL7MessagesWithErrors e If set to YES retryable messages in error will be skipped and retried automatically This is the recommended setting for all current versions of AcuoSemantix e If set to NO and a message is logged as a retryable error processing of all subsequent messages is halted until the error is resolved The same message will retry automatically on its own until it is successfully processed All other subsequent messages received after the errored message will not be processed until the errored message is processed successfu
24. priority important critical updates from the Microsoft Windows Update website 4 Install SQL Server Management Studio Express if needed GUI tool to manage the database AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 14 of 75 5 Install AcuoSemantix 5 1 General Installation amp Upgrade Requirements There are specific requirements for installing uninstalling and upgrading Acuo products when AcuoSemantix is involved The following is the initial install order when AcuoSemantix AcuoStore and AcuoMed are all on the same system Please reference the most recent release notes for installation of other Acuo components The information listed here is a subset of the full installation instructions and is intended to indicate when AcuoSemantix should be installed relative to AcuoMed AcuoStore General Installation Order 1 Install AcuoStore AcuoMed 2 Install AcuoSemantix AB If AcuoStore AcuoMed or AcuoSemantix need to be subsequently upgraded at a Patch or Hotfix level the upgrades can be performed without removing uninstalling through the Control Panel Programs and Features Add or Remove Programs in Windows 2003 f AcuoStore or AcuoMed need to be upgraded at a Service Pack level or above AcuoSemantix should be manually removed through Programs and Features first before performing the upgrade All XML files in the C Program Files x86 Acuo Te
25. significant The following is an example of a note they are enclosed within a solid horizontal line at the top and bottom NOTE You should read all notes to be sure not to miss any important installation or operations information AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 5 of 75 POWERED BY ACUS How to Get Assistance Recommended Support Process In order to appropriately track your support requests during or after business hours please use our automated web based support system Login to our web portal at http www acuotech com support html or email your request to support acuotech com By logging into our web based support portal our case tracking system will automatically generate a case number notify our support staff and return a reply email with case number to you for your records Customers partners have the ability to login and view outstanding resolved cases published solutions in our knowledge base and other related material If you choose to email your support request possibly with lower priority our professional services personnel will create a case assign a case number and contact you at their earliest convenience Recommended support request email content e From The registered email of your Designated Support Personnel e Subject Short description of the problem e Body Detailed description of the problem INCLUDING contact information Other wa
26. the REM AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 11 of 75 BESS POWERED BY c On the Connection Dicom Tag Info tab select MedSemantix es as the HIS RIS Type If reconciliation is to be used select the appropriate Matching and Auto Mapping tags Leave all other defaults as is Click OK to add the connection MedS emantix es inehde Tag ry Description Required V Study Level Match AutoMap a Cee p o a Dw coos oso aaa n E BIO Retaereed Say Seares N Do Z mm pano o o y LE oam mezesme O w o ON EO AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 12 of 75 A POWERED BY 5 Set up a new default prefetch rule and enter the text esdefault in the Station AE Title field Edit all other fields in the Prefetch Station AE Title Rule Properties screen as necessary Batch Queue Information Routing Information and Move Criteria sections Click OK to add the prefetch rule Prefetch Station AE Title Rule Properties 2 x Prefetch Station AE Title Rule Properties Prefetch Station AE Title Jesdefaul l Use Default Config Schedule Prefetch Jobs z Days Prior To the Scheduled Event Batch Queue Information Database Instance VMWARE MSXALLI Browse Run Time 01 00 00 AM Priority Medium z El Routing Information Route
27. the connected AcuoMed system If a new HL7 message is received and data is present in the Assigned Patient Location segment typically the PV1 3 segment it will automatically get added to the FFFF 0007 AcuoSemantix Prefetch Location tag of the Dicom Tag Customization node on the AcuoMed machine The contents of the AcuoSemantix Prefetch Location tag are therefore available as a pre populated list when configuring prefetch rules on the AcuoMed server This can increase the speed and efficiency in setting up prefetch rules driven by inbound HL7 messages If a prefetch rule is set up and the assigned patient location from the HL7 message matches a prefetch rule that prefetch rule and its parameters will be used to generate a Batch Move job on the AcuoMed system prefetch Note There is currently a limitation on new installs where this data is not getting added automatically to the Dicom Tag Customization node To work around this issue manually add a value to the Dicom Tag Customization node for the tag FFFF 0007 MedSemantix es Prefetch Location After manually adding a value all subsequent messages received will automatically have their values added 2 What are the minimum configuration requirements in order to only capture sample inbound HL7 messages Part of the implementation process for AcuoSemantix requires sample messages to be captured The following are the minimally required steps to capture inbound messages in Corepo
28. the right side of the screen in the blank white space and select Database gt Data Point B Users gt 4a Connection 3 Mapping gt fal Code sets Map vocabularies gt 2a Routing Subscription Pool A Message Formats Alerts gt ey Schedule 2 Name the Data Point Acuo_Datapoint then click the button Create and Edit NOTE For this step and all steps below the format used for naming items will be Acuo_ItemType This naming format is only used for the purposes of this guide and may be changed Create Data Point object x Create a new Data Point object Press Create to create only Press Create and Edit to create and launch editor Name facuc_D atapoint Description Create Create and Edit Cancel 3 For steps 4 13 below refer to the following screenshot AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 43 of 75 2 Data point type Static Dynamic Description Test m Database Type Database Type SQL Server Owner o SOL Server Configuration Server Name ymwae sql DatabaseName MedSemantives SSS Login MedSemantiwes m Dynamic Data Points Do not add to a Dynamic Data Point C Create New Dynamic Data Point Add to existing Dynamic Data Point v Test Run Test Limit Items Displayed By Type By Name Tables only Include Stored Pr
29. 2 J 3 3 2 Select Data Point Select Namespace To Database From Database Match Criteria Description it amp Select table Of x Schema l Data point Acuo_Datapoint Include Exclude I show tables 5 Data Point Ei Filter table names Tables E Tables T_APRS_MMC_INUSEBY T_ARPS_CONFIG T_ARPS_HL7_TO_XML_REPRESENTATION T_ARPS_MASTER_CONFIGURATION_INFORMATION T_ARPS_RIS_EVENTS T_ARPS_RIS_IDENTIFICATION _UPGRADE_HISTORY T WYECOCINM WED y OK Cancel 4 Click the Select Namespace button In the Namespace field make sure the Namespace created above is present if not select it Click OK to add the Namespace AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 46 of 75 POWERED BY VAN i aye JE FT AR 3 j 1 2 Select Data Point To Database From Database Match Criteria Description Definition Configuration Ir Select Namespace to view ariables Datapoint j r Schema Namespaces Acuo_ Namespace Namespace Variables in this Namespace T_ARPS_HL _TO_XML_REPRESENTATION ARPS_H _GUID T_ARPS_HL _TO_XML_REPRESENTATION ARPS_H _INSERTDAT T_ARPS_HL _TO_XML_REPRESENTATION ARPS_HX_XML_STREAM y OK Cancel 5 Click the To Database button On the left hand side of the screen click on the last row that ends in XML_STREAM it should become highlighted Next on the right han
30. 2 patients into 1 AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 9 of 75 ACUS 3 Install and Configure AcuoMed AcuoStore AcuoSemantix requires a separate install of AcuoMed AcuoStore that will receive RIS updates and DICOM messages from AcuoSemantix Please reference the most recent Acuo Release Notes for currently supported Operating Systems versions of SQL Server and corresponding Service Packs The following steps are required for the AcuoMed AcuoStore system 1 Install and configure AcuoMed AcuoStore Supported versions include version 5 3 X and later the X in this version may change as subsequent Service Packs are released for AcuoMed AcuoStore Please refer to the AcuoMed and AcuoStore installation and operations guides for more details NOTE The version of AcuoMed AcuoStore to be installed is referenced above as 5 3 X The X represents the Service Pack Level of the release and since subsequent Service Packs could be supported and released this number could change Contact an Acuo Support Engineer for the most recently released Service Pack 2 If fixit messages will be generated by AcuoSemantix and sent to AcuoMed the Basic Text SR SOP 1 2 840 10008 5 1 4 1 1 88 11 must be configured as accepted under the configuration of the Called AE Name that will receive fixit messages NOTE The Called AE Name that will receive fixit messages is confi
31. AcuoServiceUser ty AcuoSemantix_Server_Trace WEO eps a AcuoMed Started Manages and routes medical images Automatic AcuoServiceUser Ty AcuoSemantix_DiLib_Dul_Trace in skaap s T me 5 AcuoSemantix Enterprise Synchronization RIS to PACS Automatic AAcuoServiceUser AcuoSemantix_GeneralTraceFacility E Classic Event Viewer Local 4 AcuoStore Started Stores and retrieves digital assets Automatic AcuoServiceUser Sy Services Local Adaptive Brightness Monitors ambient light sensors to detect changes in amb Manual Local Service ve AMD External Eve Started Automatic Local System Andrea RT Filters Started Automatic Local System Application Experi Started Processes application compatibility cache requests for ap Manual Local System a Application Identity Determines and verifies the identity of an application Dis Manual Local Service lt Application Infor Facilitates the running of interactive applications with ad Manual Local System Application Layer Provides support for 3rd party protocol plug ins for Inter Manual Local Service S4 Application Mana Started Processes installation removal and enumeration request Manual Local System ve ASP NET State Ser Provides support for out of process session states for AS Manual Network Service G Background Intelli Started Transfers files in the background using idle network band Automatic D Local System Gh Base Filtering Engi Started The Ba
32. Dest gt o lt IssuerPIDValue gt 1234 lt IssuerPIDValue gt o lt HostName gt Server1 lt HostName gt o lt Port gt 4321 lt Port gt o lt SCPAETitle gt AcuoMedFixit1 lt SCPAETitle gt e lt Dest gt e lt Dest gt o lt IssuerPIDValue gt 5678 lt IssuerPIDValue gt o lt HostName gt Server2 lt HostName gt o lt Port gt 4321 lt Port gt o lt SCPAETitle gt AcuoMedFixit2 lt SCPAETitle gt e lt Dest gt lt FixitDests gt AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 25 of 75 NOTE 14 15 16 17 18 o Ifthe Issuer of Patient ID tag in the HL7TagMap xml file is mapped correctly and this data is present in the incoming HL7 message it will be inserted into the HRP_ISSUEROFPATIENTID column of the T_HISRISPATIENTINFO_HRP table the HisRis Patient table The Issuer of PID is the identifier of the Assigning Authority system organization agency or department that issued the Patient ID The standard location in an HL7 message for Issuer of Patient ID is PID 3 4 Segment PID Field 3 Component 4 HL7 Version 2 The DICOM equivalent tag is Issuer of Patient ID 0010 0021 PrefetchStationMapping renamed in 5 3 1 formerly DestPath The segment of the incoming message listing the location of the patient or the location where the exam will occur The data found in this segment can be used to trigger a Batch Move
33. E aceeceseuees seats 67 APPENDIX C TROUBLESHOOTING esesesesesesesescsecscccscsesesesesesesesesececscsesesesesesesesessssososeseseseseseseseosseoscscseseseseseseseseseosossscseseseseses 69 APPENDIX D HL7 FAILOVER OPTIONS esesesesesesecscscscsesesecseseseseseocoscsesesesesesesesesesessosososesesesesesesesesscsosesesesesesesesesessossseseseseseses 72 AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 3 of 75 ACUS 1 Introduction Purpose of this Installation and Operations Guide Acuo Technologies prides itself on the customized assistance it provides to customers in support of the installation and implementation of new systems This guide is to be used in conjunction with that process and serves as a reference for how to perform operational tasks for AcuoSemantix This guide describes and assumes all AcuoMed features are licensed and available as part of your current implementation However certain features are individually licensed and may therefore not be part of your currently installed AcuoMed system Please contact Acuo Technologies if you would like to add more capabilities to your current AcuoMed implementation Who Should Read this Guide This guide is written primarily for a system administrator who may typically work with a database administrator responsible for maintaining the Acuo Technologies server and applications Much of what is involved with actually opera
34. ITCPy IP MLP Components License wizard Refresh Exit q On the License Wizard welcome screen click Next Welcome to the License Wizard wk Corepoint A R HEALTH This Wizard will guide you through the licensing process for your Corepoint Integration Engine installation To continue click Next Cancel r Select the option to get an evaluation key through an internet connection Follow through remaining steps to get an evaluation key You may need to go to the Corepoint website to create a new login password during this process Please contact Acuo Technologies Support if any assistance is needed s When complete a message should appear indicating a demo key was successfully obtained Click Finish to close the license wizard AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 38 of 75 NOTE After an evaluation demo key is obtained full functionality of Corepoint should be available for 30 days During this time an Acuo Support Implementation Engineer will go through the process of obtaining and applying a valid license key NOTE If an install of Corepoint Integration Engine is re imaged or restored to different hardware the Corepoint Integration Engine license file may be invalidated and a new license will be needed The Corepoint Integration Engine license will be invalidated if any one of the following has changed gt MAC Address gt Number o
35. MedSemantix es is properly removed from the Service Name in the Acuo MMC File Directory and Registry When AcuoSemantix is re installed for the upgrade this ensures a clean upgrade path without duplicate references for MedSemantix es AcuoSemantix AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 19 of 75 ii XML configuration files for AcuoSemantix from 5 2 1 will NOT be retained and carried over when 5 3 1 is installed The configuration files in 5 3 1 have changed significantly however some existing settings and values that haven t changed will generally need to be maintained and set to the same values upon upgrade to preserve the same behavior before and after the upgrade The configuration files should generally be backed up prior to starting the upgrade see step above for backing up the folder file directory so the old configuration files should be readily accessible g If other Acuo products are being upgraded uninstall them through Control Panel Programs and Features For example a Uninstall ALO and AcuoHA b Uninstall AcuoMed c Uninstall AcuoStore d Uninstall all versions of Acuo Host Server Setup NOTE If AcuoSemantix is the only product being upgraded this step can be skipped h If other products were uninstalled in the previous step run through the installation instructions for all products in the reverse order as the previous step except AcuoSe
36. Name To All Local DBs Move Destination 4E Title Archive m Move Criteria 36 months back through fo months back OK Cancel NOTE The default prefetch rule used by AcuoSemantix is esdefault This is minimally required in order to utilize prefetching the queuing of Batch Move jobs to an AcuoMed system Other prefetch rules may optionally be set up to do prefetching however the Station AE Title of the prefetch rule must match the Assigned Patient Location in the PV1 3 segment or another defined segment of the incoming HL7 message in order to take effect For further information see the PrefetchStationMapping parameter in the Modify AcuoSemantixConfig xml section sub section under Configure AcuoSemantix below AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 13 of 75 ACUS 4 AcuoSemantix System Pre Requisites The following steps should be performed to satisfy the pre requisites for the system where AcuoSemantix is installed Please reference the most recent Acuo Release Notes for currently supported Operating Systems versions of SQL Server and corresponding Service Packs 1 Install one of the following operating systems o Windows Server 2008 R2 o Windows Server 2008 x64 or x86 with SP2 2 Install one of the following versions of SQL Server O SQLServer 2008 R2 o SQL Server 2008 with SP2 3 Install ALL high
37. System i Windows PowerShell e The Acuo subnode inside the Event Viewer is the log that will contain information specific to AcuoSemantix NOTE When using the Information Warning and Error messages to diagnose a problem you should review several messages around a particular timeframe to gain a more comprehensive picture of what is happening AcuoSemantix Traces e As with all Acuo products AcuoSemantix has the capability to output tracing information to help troubleshoot and debug specific problems To access the traces and trace settings launch the AcuoSemantix Configuration Manager and navigate to the AcuoSemantix Server Trace Settings node The individual traces and trace settings become visible AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 69 of 75 DEDS T ASXConsole Console Root Services Local one Mer agp Oo Silo B X jm File Action View Favorites Window Help e9 200E oss Em gt an p Console Root Name Status Description Startup Type Log On As 4 AcuoSemantix Configuration Manager local 4 Tr AcuoSemantix Server 4 Y Trace Settings ty AcuoSemantix_Server_Trace Ty AcuoSemantix_DiLib_Dul_Trace ty AcuoSemantix_GeneralTraceFacility lt mr z i ee SA AcuoStore Started Stores and retrieves digital assets Automatic AcuoServiceUser S ActiveX Installer Provides User Account Control validation for the installati Manual Loc
38. a Click the Configure the Gear button b Select the Acuo Action List created from previous steps above and leave the Sender field unchecked Click OK Click Next AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 56 of 75 DEOS NOTE If RFMDBGear clsALGear is not found in the dropdown list try performing one of the following to resolve the issue gt Go to C Program Files x86 Common Files NeoTool Gears RFMDB and double click gear reg search for this file if not found in this path gt Run a repair install on Corepoint Integration Engine from Control Panel Programs and Features Connection Wizard x Sink Gear Selection Select a Gear object to consume messages in the connection Use this Gear to sink consume messages RFMDBGear cls4LGear v This gear runs Action Lists to create and or process messages including reading and writing database tables and performing message transformations Select Action List x Action Lists Acuo_244ctionList Configure the Gear Sender Timer frequency in seconds Cancel 11 On the Connection State Log Options screen click the button to Select All connection states Click Next Connection Wizard x Connection State Log Options Select the connection state logging options Log an event when this connection is Iv starting IV started I connecting I connected
39. al System Ss Acuo Tier Manager Manages offline content Disabled AcuoServiceUser G AcuoAudit Started Captures security audits for Acuo Technologies products Automatic AcuoServiceUser Gh AcuoMed Started Manages and routes medical images Automatic AcuoServiceUser AcuoSemantix Enterprise Synchronization RIS to PACS Automatic AcuoServiceUser Sy Services Local H Adaptive Brightness Monitors ambient light sensors to detect changes in amb Manual Local Service SA AMD External Eve Started Automatic Local System Andrea RT Filters Started Automatic Local System Gs Application Experi Started Processes application compatibility cache requests for ap Manual Local System GA Application Identity Determines and verifies the identity of an application Dis Manual Local Service GA Application Infor Facilitates the running of interactive applications with ad Manual Local System G Application Layer Provides support for 3rd party protocol plug ins for Inter Manual Local Service S Application Mana Started Processes installation removal and enumeration request Manual Local System SA ASP NET State Ser Provides support for out of process session states for AS Manual Network Service S Background Intelli Started Transfers files in the background using idle network band Automatic D Local System Ch Base Filtering Engi Started The Base Filtering Engine BFE is a service that manages f Automatic Local Service
40. ally be the queued time plus the number of minutes configured in this parameter The Queued Time column will list the time the job was queued AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 23 of 75 11 UseHisRisAsFilter This is set to either YES or NO This setting allows Patient Update and Study Update fixit messages to be filtered suppressed from being sent if data in the Acuo His Ris tables matches data in an inbound HL7 message for the same patient O O If set to NO fixits should be generated for all messages if the activity is set in the ActivityList xml file If UpdatePatient is configured in the ActivityList xml file for a message a Patient Level Update fixit will be generated If UpdateStudy is configured in the ActivityList xml file for a message a Study Level Update fixit will be generated If PatientMerge is configured in the ActivityList xml file for a merge message a Patient Level Merge fixit will be generated If set to YES AcuoSemantix looks at the Dest tags as configured in either the PatientUpdate xml or StudyUpdate xml file If there is a difference in 1 or more of these configured Dest tags between the inbound HL7 message and the data in the His Ris tables a fixit is generated If all are the same no fixit will be generated Further details are as follows If UpdatePatient is configured
41. ate The RIS SCHEDPROCSTARTDATE column in the table T_HISRISEVENTINFO_ RIS cannot be NULL and should contain a valid date The mapping of this field from an HL7 message is normally configured during initial site implementation and testing The above functionality is effective in 5 3 1 HF1 and beyond In the base 5 3 1 release a record was NOT inserted into the His Ris Event table for ADT messages O O PatientMerge new in 5 3 1 This activity will generate a Patient Level Merge Fixit Message on the AcuoMed server Previously in 5 2 1 the UpdatePatient activity queued the merge fixit message In 5 3 1 the PatientMerge activity queues the merge fixit and the UpdatePatient activity only queues a Patient Update fixit This activity should be configured for ANY merge message type e g ADT A18 ADT A34 ADT A4O etc The recommended order of activities for a merge message in 5 3 1 is PatientMerge followed by UpdatePatient For example the listing of all activities for an ADT A18 in 5 3 1 is as follows e UpdateAcuoHlISRIS always first e PatientMerge listed before UpdatePatient e UpdatePatient listed after PatientMerge e SendBatchMove last if needed The parameters in the AcuoSemantixConfig xml file that affect Merge fixits are the following e HostName ListeningPort AETitle AcuoMed AETitle ImplementationUID ImplementationName where the fixits will go e UpdateDelaylnMinutes e EnableDefaultFixitFo
42. ble a fixit will be generated 12 EnableFixitStudyStatus renamed in 5 3 1 formerly ProcessOnORMStudyStatus If configured AcuoSemantix will only queue a fixit for an Order Message ORM O01 if there is a match between the value configured in the parameter and the value from the incoming HL7 message that is mapped to the Dicom Study Status ID tag 0032 000a in the HL7TagMap xml file O O Example of excerpt from HL7TagMap xml file for the ORMOO1 message lt TAGPAIR gt e lt HL7PATH gt ORC ORC_1_ OrderControl lt HL7PATH gt e lt DICOMTAG gt 0032 000A lt DICOMTAG gt e lt REQUIRED gt NO lt REQUIRED gt e lt NEWTAGNAME gt ORC_1_OrderControl lt NEWTAGNAME gt e lt OCCURRENCE gt 1 lt OCCURRENCE gt lt TAGPAIR gt Using the HL7TagMap xml example file above Ifavalue is configured in the EnableFixitsStudyStatus parameter the same value must also be found in the following segment of the incoming HL7 message in order for a fixit message to be queued ORC ORC_1_OrderControl If no value is configured in this parameter this functionality should NOT take effect this is the default This value is NOT case sensitive This parameter affects both Patient Update and Study Update fixit messages If this setting is enabled and there is NOT a match neither fixit message will be queued AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 24 of 75
43. ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccecccccccccces 14 5 INSTALLACUOSEMANTIX ccescoe ccc ccaccansaccceccssecccaccacctecececeoe lt siceccsecacscecanscaaesecscadcseseaescesussadesenseacsusesueseaesickecsccaescecssssueesevsecs 15 5 1 GENERAL INSTALLATION amp UPGRADE REQUIREMENTS cecescecececcscecececccecscecsccscecececesescececscseececscecescecececesesescececeseseececs 15 5 2 ACUOSEMANTIX NEW INSTALLATION cccsccscosceccecceccscesccceccsceecuccescecescescscscteceecescectscescecescssescescescescscescescesessescesceseeses 15 5 3 ACUOSEMANTIX UPGRADE INSTALLATION SERVICE PACK LEVEL UPGRADE ccccccccesecccescceceusccceusecsceusecsseueccseueessseeessseees 19 6 CONFIGURE ACUOSEMANT IX ccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccecccccccccccccccccccccccceccecccccccoccs 21 6 1 MODIFY ACUOSEMANTIXCONFIG MMe rcestasecanacts awessecccnaectacnnnatsaeacna te ciussdecscaaactasoennaydabaces dsetawadnccciwascteaceneduaubuees EENEN 21 6 2 Yeo Va a2 a LV Bik LST 4 Dt oe ee re ee er eee 30 6 3 MIODIFY REPLACE OTHER XML FILES csccccceeccccecccceccececccceccccsecccceccenseccesccccseccenecensecceecccaecccueceuececsesceaececaeccensecensecs 32 7 COREPOINT INTEGRATION ENGINE SYSTEM PRE REQUISITES cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccoecs 33 8 INSTALL COREPOINT INTEGRATION ENGINE cccccccsccsccsccccsccsces
44. cccccccscescescccccccscescesccccscescescccccccscescescccccccscescesccccscescesccecs 34 8 1 NEW INSTALLATIONS OF COREPOINT INTEGRATION ENGINE eccsceccececcsceccececcecccecececcecescecececsseecesesceseecesescscescscesesceeesces 34 8 2 UPGRADING COREPOINT INTEGRATION ENGINE cecesceccccecccceccececccecscsceccececcececeecsceecsceecscescscsececssesceseeceseececscscsesceeences 39 9 CONFIGURE COREPOINT INTEGRATION ENGINE cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccoecs 40 9 1 CONFIGURE COREPOINT INTEGRATION ENGINE BY IMPORTING AN EXISTING CONFIGURATION ccceccecescececcsceccececcscecesceceececess 40 9 2 CONFIGURE COREPOINT INTEGRATION ENGINE MANUALLY 2cccceccececcececcecccecccsceccececeecsceececeececsscecesescesescesescesesceceseecess 41 10 SERVICE STARTUP amp MESSAGE PROCESSING ccccccccccccsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccecccccccccccceccccoccocces 61 10 1 LAUNCHING THE ACUOSEMANTIX CONFIGURATION MIANAGER cceccccecccceccccccecccceccncsccccecsncsccncecencecensecenceceececenceeenceeencenens 61 10 2 MESSAGE PROCESSING AND VERIFICATION cscesceccecceccscescecceccsccscsceccscteceecescscescescecectscescescessesesceecescsceesescscesescescascucees 62 APPENDIX A VERSION 5 3 1 CHANGES amp RECOMMENDATIONS cccccccccsccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccoccccces 65 POP PEIN B FAOS ocorrer
45. ccessed through the standard Windows Services panel or through the default AcuoSemantix MMC which can be launched from the Acuo Technologies folder on the desktop AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 60 of 75 10 Service Startup amp Message Processing After all installation and configuration steps are completed the service may be started and messages may be received 10 1 Launching the AcuoSemantix Configuration Manager 1 To start or restart the AcuoSemantix Service open the Acuo Technologies folder on the desktop click the AcuoSemantix folder then launch the shortcut for the AcuoSemantix MMC Go to the Services node and select the AcuoSemantix service From there click the buttons at the top of the screen or use the right click options available to stop start or restart the service i ASXConsole Console Root Services Local EC o Bo amp 5 File Action View Favorites Window Help e x E a b Hu ba gt a n mp C Console Root Name Status Description Startup Type Log On As 5 4 ad hetero aig Manager local C ActiveX Installer Provides User Account Control validation for the installati Manual Local System l ies FT E ore s Acuo Tier Manager Manages offline content Disabled AcuoServiceUser E a AcuoAudit Started Captures security audits for Acuo Technologies products Automatic A
46. chnologies AcuoSemantix directory should be backed up prior to performing a Service Pack level upgrade for AcuoStore AcuoMed See the section below titled AcuoSemantix Upgrade Installation for details B If AcuoSemantix is the only Acuo product being upgraded at a Service Pack level this is less common the AcuoSemantix upgrade may occur without removing AcuoMed or AcuoStore See the section below titled AcuoSemantix Upgrade Installation for details If all Acuo products are to be completely removed and or upgraded the uninstall order is the reverse of the install order listed above uninstall AcuoSemantix uninstall AcuoMed uninstall AcuoStore General Uninstall Order for Service Pack level upgrades and above 1 Uninstall AcuoSemantix 2 Uninstall AcuoMed AcuoStore 5 2 AcuoSemantix New Installation For new installations of AcuoSemantix perform the following steps NOTE For the 5 3 1 release AcuoSemantix was renamed from Acuo MedSemantix es to AcuoSemantix Acuo MedSemantix es is the old name Some components of the old product name may still be found on older systems and or in various areas of the AcuoSemantix GUI Therefore the old name of Acuo MedSemantix es will be seen and referenced in various areas NOTE The 5 3 1 version of AcuoSemantix is ONLY compatible with the 5 3 1 version of AcuoStore AcuoMed As subsequent Service Packs for Acuo products is released please contact Acuo Technologies Support for sup
47. d it will default to NO This is the same default behavior for releases prior to 5 3 1 It is recommended this setting remain unchanged from the default of NO during normal operation o If set to YES a set of XML files approximately 6 files will be written and saved into the directory configured in the TempFolderPath parameter see description of this parameter below The directory only contains a set of XML files for the single most recent message that has been processed Each time a subsequent message is processed the XML files are overwritten with those from the most recent message therefore files should NOT accumulate in this directory 25 TempFolderPath new in 5 3 1 This is the location of the directory that AcuoSemantix uses to temporary write fixit messages Files are temporarily written here for fixit processing then immediately deleted o If no value is listed the default is to use the Temp subfolder in the directory where AcuoSemantix is installed This is also the same behavior as in previous releases however in previous releases the directory could not be changed For example the following directory is used by default on a 64 bit system C Program Files x86 Acuo Technologies AcuoSemantix Temp o The Temp sub folder is created upon startup inside the directory configured in this parameter o No files should accumulate or be found in this directory Any orphan files that do get left here unintentionally
48. d be processed AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 20 of 75 6 Configure AcuoSemantix There are 3 basic steps to configure AcuoSemantix see the subsections below for complete descriptions 6 1 Modify AcuoSemantixConfig xml The AcuoSemantixConfig xml file is located at C Program Files x86 Acuo Technologies AcuoSemantix This file is used to specify where AcuoSemantix will send update and merge messages Acuo Fixits along with other configuration options used by AcuoSemantix related to message processing and error handling The AcuoSemantix Service needs to be restarted if any changes are made to this file See Figure 6 1 below for a screenshot showing a sample AcuoSemantixConfig xml file A description of all parameters and steps to edit this file follow NOTE In versions previous to 5 3 1 the AcuoSemantixConfig xml file was called ARPSConfig xml In 5 3 1 some of the existing parameters from ARPSConfig xml have been renamed and there are also some new parameters in 5 3 1 that did not exist previously The ARPSConfig xml file is no longer valid in 5 3 1 however some parameters may contain data that has not changed for example server names and Called AE names Parameters that have been renamed between 5 2 1 and 5 3 1 are noted below with the text renamed in 5 3 1 in parenthesis after the name of the parameter Parameters that are new in 5 3 1 are no
49. d into the column ARPS_HX_INSERTDATETIME This logs the Greenwich Mean Time GMT when the event was inserted This information may be useful in troubleshooting scenarios when the timing between message receipt and resulting actions needs to be investigated 4 After an entry is inserted into the T_ARPS_HL7_TO XML_REPRESENTATION table by Corepoint Integration Engine AcuoSemantix recognizes the entry and then logs a corresponding event in the T_ARPS_RIS_EVENTS table Various information is logged in the T_ARPS_RIS_EVENTS table including insert time message type and whether or not it has been processed or validated It essentially indicates the status of all messages that have been received At this point in time AcuoSemantix takes over the processing of the message and resulting activities NOTE The interval of time that AcuoSemantix checks for new messages or new entries inserted into the T ARPS _HL7_TO_XML_REPRESENTATION table is configured in the HL7MessagePollingTimer parameter of the AcuoSemantixConfig xml file See the section below Configure AcuoSemantix for further details The table that Corepoint Integration Engine inserts into XML_REPRESENTATION and the table that AcuoSemantix correspondingly inserts into RIS_ EVENTS should generally remain in sync and have the same number of entries present If these two tables are not in sync and the number of entries starts to drift
50. d side of the screen click on the last row that ends in XML_STREAM Then click the Associate button on the left side of the screen On the right side of the screen only the 3 row listed has an association present under the Variables column Click OK 3 Edit Association fAcuo Association m z A amp 5 E 2 Namespace From Database Match Criteria Description Select Data Point Select To Database From Namespace Yariables Association Namespace ariables Yariable Database Association Fi F F x Associate Auto Match Auto Match All Filter Disassociate Disassociate All Database T_ARPS_HL 7_TO_XML_RE T_ARPS_HL7_TO_XML_RE 7_ARPS_HL _TO_XML_RE T_ARPS_HL _TO_XML_RE Variables T_ARPS_HL _TO_XML_REPRESENTATION ARPS_HX_GUID T_ARPS_HL _TO_XML_REPRESENTATION ARPS_HX_INSERT T_ARPS_HL _TO_XML_REPRESENTATION ARPS_HX y OK Cancel 6 Click the From Database button Click the Auto Match All button on the right side of the screen Click OK to add the association AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 47 of 75 POWERED BY VAN recs JE Mic Edit Association Jacu Association omy f AK a 2 3 Select Data Point Select Namespace To Database Sf e Match Criteria Description E From Database to Namespace Yariables Association 4o x ariable Database Ass
51. e Dests see description of next parameter o Dest Each Dest allows a different Issuer Of PID value to be defined and parameters for defining where the fixit is to be sent Host Name Port Called AE Name if there is a match between the configured value and the value from the HL7 message Each Dest contains the sub nodes below IssuerPIDValue Actual value from the HL7 message that is used to determine if a fixit will be sent to this destination If there a match between the value configured here and the value from the inbound HL7 message that is mapped to the Issuer of Patient ID tag in the HL7TagMap xml file a fixit will be sent to the HostName Port SCPAETitle for that destination Each configured Dest should have a different IssuerPIDValue configured HostName Server name where the fixit will be sent if there is a match Clearing out the HostName for all Dests effectively disables this functionality and the EnableDefaultFixitForDomain setting above Port Port where fixit will be sent if there is a match SCPAETitle Called AE Name where fixit will be sent if there is a match o To setup multiple destinations based on different expected Issuer of PID values the base node Dest and all subnodes can be copied and values in the subnodes can be changed accordingly the parent node Dest remains the same The following is an example of a configuration with 2 destinations lt FixitDests gt e lt
52. e and first initial of the first name o This setting only takes effect if SendBatchMove is configured in the ActivityList xml file for 1 or more message types AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 26 of 75 A POWERED BY 19 ExpediteBatchMoveServer ExpediteBatchMoveDaysAhead ExpediteBatchMovePriority o These 3 parameters work in conjunction with one another These control functionality that will automatically expedite the run time of an existing Batch Move job if an HL7 message is received that generates a Batch Move for the same patient If a Batch Move job is already present on the target server and an HL7 message is received that generates a move for the same patient the Next Run Time will be modified to 1 year back from the current date and the Priority will be changed according to a parameter in the config file generally to Expedited priority o The following is a description of all 3 parameters ExpediteBatchMoveServer e This is the target server name where existing Batch Move jobs can be expedited e Clearing out the value in this parameter to NULL will effectively disable the Expedite Batch Move Functionality this is the default This will also disable the functionality related to the other expedite settings that follow ExpediteBatchMoveDaysAhead e If the Next Run Time of a Batch Move job is within today t
53. elect Message Variable fin ActionListCall result handles Message Manager components Y X a OK Cancel Description 4 Click the Map tab at the top then click the ItemCopy button found at the far left side of the screen a Inthe Source Operand section on the left side of the screen click the Path tab Leave the default variable of in Unparsed Unparsed Unparsed selected in the dropdown The Occurrence field should be set to Current this is the default and should be highlighted orange b Inthe Destination Operand section on the right side of the screen click the Variable tab if it s not already highlighted then select the Acuo_Namespace created from above in this guide Select the T ARPS _HL7_TO_XML_REPRESENTATION ARPS HX XML_STREAM from the variable list it should then appear in the Name field just under the Namespace field Click OK to add the ItemCopy action AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 50 of 75 POWERED BY sr 7 Edit Action List Acuo_ActionList _ yk QD jcs simi Bmap C Message P Control J Database 4t Debug E System HRaomMSs BRAE ta 3 Line 1 Action oP x a 2 3 a a 2 Add Delete Edit Up Down Addaspeer Find Font Description Test B Add action ItemCopy i
54. emain unchecked e Click Next then Install on the following screen to proceed with the installation of MSMQ AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 33 of 75 ACIS 8 Install Corepoint Integration Engine Corepoint Integration Engine should be installed on the same machine where AcuoSemantix is installed 8 1 New Installations of Corepoint Integration Engine NOTE Please see the Corepoint Integration Engine System Prerequisites section above before installing Corepoint If MSMQ is not installed a pop up message may appear and indicate MSMQ is required in order for the Corepoint Integration Engine Service to start a Contact Acuo Technologies to determine the most recently supported tested version of Corepoint Integration Engine Double click the exe to run the installer On the welcome screen click Next iz Corepoint Health Solutions InstallShield Wizard Welcome to the InstallShield Wizard for Corepoint Health Solutions The InstallShield R Wizard will install Corepoint Health Solutions on your computer To continue click Next WARNING This program is protected by copyright law and international treaties Cancel d On the license agreement screen select the option to accept the terms of the license agreement then click Next e On the destination folder screen leave the default install path intact and click Next
55. en enter a password for the Corepoint Integration Engine Administrator user Remember or write down this password as it will be required again at a later stage when performing Administrator functions configuration inside Corepoint Integration Engine is Corepoint Health Solutions InstallShield Wizard Administrator Password Enter a password for the Administrator user Several operations in Corepoint Integration Engine require a user to be logged on One Administrator user comes pre installed enter the password you would like to associate with this user This password may be changed later using the Corepoint Integration Engine Configuration utility Username administrator Password j TTE Confirm Password TTT Write down this username and password somewhere secure as you will need to recall them later InstallShield lt Bark cont k Click Install to perform the installation is Corepoint Health Solutions InstallShield Wizard Ready to Install the Program The wizard is ready to begin installation Click Install to begin the installation IF you want to review or change any of your installation settings click Back Click Cancel to exit the wizard Installshield core AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 36 of 75 A POWERED BY Ifthe following pop up screen appears click Run to continue see next item as well for
56. er details on AcuoSemantix functionality gt PatientUpdate xml Required Change in 5 3 1 o Inthe PatientUpdate xml file any merge message should have the Surviving PID listed as the Match tag Previously in 5 2 1 the Match tag was the Non Surviving PID This recommendation coincides with the change in 5 3 1 where the Patient Merge is now a separate activity o In addition the only Dest tags or Change tags that should be configured for ANY message type are the following Patient Name Patient Birth Date Patient Sex gt HL7TagMap xml Enforce Required Fields Recommendation o The HL7TagMap xml file defines which fields from an inbound HL7 message are marked as required Required fields can be designated for each message type o Ifa required field is set for a particular message type and that message is received WITHOUT the required field present no processing will occur and the message will be marked as a non retryable error in the AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 65 of 75 gt AcuoSemantix database This is preferred since it prevents potential unwanted behavior for a message that is not considered valid o Recommended required fields ORM Messages Patient ID and Accession Number ADT Merge Messages Non Surviving PID amp Surviving PID Other ADT Messages Patient ID PatientMerge xml New File in 5 3 1 o This file is new in 5 3 1 and only
57. f CPUs gt Serial Number of the volume where Corepoint Integration Engine is installed type vol at a command prompt to display this 8 2 Upgrading Corepoint Integration Engine Please contact Acuo Technologies Support before upgrading to a newer version of Corepoint Integration Engine New versions of Corepoint Integration Engine are generally tested in conjunction with the Service Pack Level release of AcuoSemantix The following are the upgrade instructions 1 Export the Receiver Connection and all objects to backup the Corepoint Integration Engine configuration a Launch the Corepoint Integration Engine Configuration panel through Start Programs Corepoint Health Corepoint Integration Engine Corepoint Integration Engine Configuration b On the right side of the screen where all of the objects are listed right click on the Connection and select Export Select the option to Export This Connection then click OK c Leave all objects checked and click OK Enter the file name and directory to be saved then click Save Stop interface services from trading partners to Corepoint Integration Engine if possible Stop the Corepoint Integration Engine service Close all Corepoint Integration Engine GUI windows Stop all background software antivirus antispyware etc Uninstall Corepoint Integration Engine through Programs and Features Add or Remove Programs Install the new version of Corepoint Integration Eng
58. form the steps below to upgrade to a newer Service Pack version Please reference the Acuo Release Notes for additional notes on upgrade instructions a Performa full backup of all databases b Backup the Acuo Technologies folder file directory e g gt C Program Files x86 Acuo Technologies Backup the following Acuo Technologies registry keys perform an export of the keys a HKEY LOCAL MACHINE SOFTWARE Wow6432Node Acuo Technologies 64 bit systems b HKEY LOCAL MACHINE SOFTWARE Acuo Technologies d Close the AcuoSemantix MMC all other open MMCs windows and applications e Stop Disable all Acuo Services and reboot the server f Uninstall AcuoSemantix or Acuo MedSemantix es through Control Panel Programs and Features Add or Remove Programs on Windows 2003 AcuoSemantix should be uninstalled FIRST before other Acuo products a On the pop up message that asks Do you wish to save the current configuration select No Acuo MedSemantix es Configuration Manager InstallShield Wizard EQ You are about to remove product 4Acuo MedSemantix es Configuration Manager and all its features Close all open applications before continuing Do you wish to save the current configuration YES IF you are going to upgrade this product NO To completely and permanently remove this product CANCEL Cancel uninstall Yes No Cancel b Selecting No at this screen results in the following i The old product name
59. gured in the AcuoSemantixConfig xml file under the AETitle_AcuoMed parameter Please refer to the section below Configure AcuoSemantix for details on how to configure AcuoSemantix to send fixit messages 3 Apply a feature key which includes HIS RIS Connectivity This is minimally required for AcuoSemantix NOTE The AcuoMed Database must be installed before a feature key can be applied Feature keys are obtained by contacting Acuo s Professional Services Team C Console Root 4 AcuoMed Image Manager local 4 Sp Image Manager Server Server Identification FD4C2E1 3 B19E 4C1B 920D 14392539DC5E Dy Feature Validation sie Router Configuration Feature Key 40AB6189 9140 594 1896 551CDFBSF48C9D SDE 744 DAEE 0794 5843 C1B342E 97F19 5 DICOM Configuration g Move Route Mapping Managed Digital Assets 8 HIS RIS Connections Te ADAM Manager fil Batch Processing Managers Number of Studies 0 000 0 unlimited F Trace Settings Patient Management B IHE Audit Manager AcuoStore Digital Asset Manager local AcuoSemantix Configuration Manager loc E Classic Event Viewer Local ey Services Local IP Addresses od Configuration Maximums 0 Unlimited Routes fo Tag Rules lo Enterprise Configuration Options r Options AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 10 of 75 POWERED BY aC 4 Set up a new HIS RIS connection and pe
60. hat the default value of 1 remain unchanged If the HL7MessagePollingTimer is set to something greater than the default of 1 second there may be noticeable delays in message processing since this is the interval that AcuoSemantix checks for new messages CleanUpDelayDays This is the number of days that must expire before messages are deleted from the T_ARPS_HL7_TO_XML_REPRESENTATION and T_ARPS_RIS_EVENTS tables in the AcuoSemantix database The AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 28 of 75 current system date is compared to the Acuo Insert Date of the events and deletes events from both tables if the difference exceeds the number configured in this setting The CleanUpDelayDays process runs once every time the AcuoSemantix Service is started or restarted then once every day thereafter at that same time o This value should be determined and set during site implementation dependent upon how long messages need to be kept in the database 24 EnableXMLFiles new in 5 3 1 This parameter can be used to enable writing of XML files to the configured Temp directory see TempFolderPath parameter below for the purposes of troubleshooting and or viewing a snapshot of internal files at the time a single message is being processed This parameter should be set to YES or NO o If set to NO XML files will NOT be written to the Temp directory If no value is entere
61. he catch all for data that does not fit into the HL7 Standard message definitions Z segments can be inserted in any message at any time and Z segments can carry any data you want In HL7 messaging all Z segments within it start with the letter Z Z segments are one of the reasons why the HL7 Standard is sometimes called the flexible standard The HL7 Standard is a framework for negotiation and Z segments are an area ripe for negotiation between healthcare vendors and systems When using Z segments it is important to have adequate documentation of what is included The Z Segment file imported in the above step defines the Study Instance UID Z segment used in an ORM OO1 message Procedure Scheduled It is a segment in the HL7 message that contains the defined study instance UID length is 100 data type is DS c On the left side of the screen double click on the root level This will allow the appropriate options to be present when configuring the items in next steps below After double clicking the root level the right hand side of the screen should be similar to the screenshot below AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 42 of 75 REOS G7 El Standards E HL 2 Name User 1 of 1 User Profile 1 of 1 Connection NeoIntegrate service is not running l Templates d Set up anew Data Point 1 Right click on
62. he number days in this setting the job will be expedited if the PID already exists o Example If today is 5 5 2011 and this parameter is set to 15 all Batch Move jobs with a Next Run Time of 5 20 2011 or earlier will be expedited if the PID already exists ExpediteBatchMovePriority e Ifa Batch Move job is being expedited this allows the Priority of the job to be changed according to the following this should be seen in the Batch Move Manager queue o 4 Expedited o 3 High o 2 Medium o 1 Low O Other notes on the Expedite Batch Move functionality Inthe ActivityList xml file the SendBatchMove activity must be configured for the message type where Batch Moves are being generated and or expedited Inthe AcuoSemantixConfig xml file e The AcuoBatchMoveServer parameter must be configured with a valid AcuoMed server name this field cannot be null e Ifthe ExpediteBatchMoveServer is invalid or unreachable the ARPS _RE_EVENT_PROCESSED column of the T_ARPS_RIS_ EVENTS table will be populated with the value 4096 update expedite Batch Move error This message with the 4096 error should be automatically retried and thus should run successfully once a valid server is entered alternatively the row in the T_ARPS_RIS_EVENTS table can be deleted to retry the message If the AcuoBatchMoveServer and ExpediteBatchMoveServer parameters have the same server configured all
63. how communication to a connected AcuoMed when Acuo Fixit update merge messages are being sent This will appear in the form of a DICOM C Store request from AcuoSemantix outbound to AcuoMed The activity log is always accumulating activity regardless of whether or not it is open e Please reference the AcuoMed Installation and Operations Manual for further details on the Activity Log AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 71 of 75 Appendix D HL7 Failover Options There are 2 states to initiate a failover involving AcuoSemantix Unsynchronized unplanned and Synchronized planned Each of these states has different requirements and corresponding failover actions see below Unsvnchronized HL7 Failover Rev 6 1 Legend DICOM Interface HL7 Interface HL7 Source Completed Pending Queue Queue DNS or Load Balancer or Config ACTIVE ne E BE PASSIVE Pa 6 Corepoint Integration Engine ACTIVE Corepoint Integration Engine Port 5050 Port 5050 AcuoSemantix AcuoMed Local Fixit AE R AcuoMed Remote Fixit AE AcuoSemantix AcuoMed Local Fixit AE AcuoMed Remote Fixit AE W218 Propagate Fix it through DBs Propagate Fix it through DBs 7 AcuoMed Remote Fixit AE AcuoMed Remote Fixit AE AcuoSemantix Installation and Operations Guide Proprietary and Confident
64. i Event Viewer Lc View apa Services Local __ ____ MIN Computer Manar Refresh Sender Export List Help The connection wizard starts up AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 52 of 75 Connection Wizard Xi ye Welcome to the Connection AK NEOTOOL wizard Singvler Focas gt Hecthcors Ieageated This Wizard helps you configure your connection To continue click Next Cancel 3 On the Name the Connection screen REOS a Leave the box checked that indicates Yes please help me name this connection b Enter text in the blank field for the Naming section the recommendation from Corepoint Integration Engine is to enter the remote system function application name or vendor that will be sending to this connection c Inthe Message types section check the boxes for the message types that will be received on this connection The proposed connection name is automatically renamed depending on the message types selected In this version ADTs and ORMss will typically be checked d Click Next Connection Wizard x Name the Connection Let us help you name the new connection IV Yes please help me name this connection Naming Remote system application name Suggestions HIS either application function e g Lab HIS etc or Vendor e g Cerner Eclipsys etc Message types This
65. ial Acuo Technologies Page 72 of 75 Unsynchronized Failover Requirements 1 HL7 Source has capability to resend up to 30 days of messages to Acuo without intermixing the resent messages with new ones Customer understands timing considerations DNS time to live and failure points which may necessitate or complicate a failover Unsynchronized Failover Actions 0 1 Determine a failover is needed benefit outweighs cost ACTIVE Disable Corepoint Integration Engine listening interface at Active site disable service optimal This is essential to preventing a premature fail back Notify customer so they can pause the HL7 source if they desire PASSIVE Disable SCP AE which accepts fixit messages from ACTIVE Remote site Use of SCU Authorization may be most graceful method The last fixit received on this AE will be the start time for the HL7 rewind replay step It s unknown how to best correlate a fixit to a point in time of the HL7 feed CUSTOMER OPTION Disable HL7 prefetch during reception of resent HL7 messages Missing prefetch consistency vs duplicate prefetch performance Rewind the queue on the HL7 feed to 24 hours prior to the last propagated fixit received by the Passive site Fail over the HL7 feed via DNS reconfiguring the HL7 source or other means such that the source now points to the PASSIVE Corepoint Integration Engine instance Start the Corepoint Integration Engine service to start accepting HL7 messages
66. ice C Import a Configuration 1 Launch the Corepoint Integration Engine Configuration panel through Start Programs Corepoint Health gt Corepoint Integration Engine gt Corepoint Integration Engine Configuration 2 Select File gt Import at the top of the screen select the previously exported Corepoint Integration Engine Export nix file then click the Open button 3 Leave all package components checked and click OK d Modify the Server Name in the Data Point Configuration 1 Go into the properties of the Data Point and edit the Server Name to the correct name of the server 2 This should be the only configuration component that needs to be changed e Import any Derivative files into the appropriate HL7 version node 1 On the left side of the screen expand the and navigate to the correct HL7 version node 2 Select or highlight the node with the correct HL7 version then go to the top most line in the Corepoint Integration Engine window and select File gt Import Select the derivative file to import AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 40 of 75 f Edit Verify the Receiver Connection Configuration 1 Right click on the Receiver Connection and select Edit 2 Inside the Queuing and Inter Queue Transformation node Transformation section verify Convert HL7 to XML is selected 3 Inthe Derivative field select high
67. in the ActivityList xml file for a message the PatientUpdate xml file will generally include the Dest Tags Patient Name Birth Date and Patient Sex If there are no differences in these tags between the HL7 message and the data in the His Ris Patient table T_HISRISPATIENTINFO_HRP a fixit will NOT be queued If there is a difference in 1 or more of the above tags the configured Dest tags a fixit will be queued m If UpdateStudy is configured in the ActivityList xml file for a message the StudyUpdate xm file for example may be configured with the Dest Tags Study Description and or Referring Physician If there are no differences in these tags between the HL7 message and the data in the His Ris Event table T_HISRISEVENTINFO_ RIS a fixit will NOT be queued If there is a difference in 1 or more of the above tags the configured Dest Tags a fixit will be queued This setting does NOT apply for the PatientMerge activity A Patient Level Merge fixit will always be generated if the PatientMerge activity is configured inside a merge message This setting should apply for any message type however only if the UpdatePatient or UpdateStudy activity is configured in the ActivityList xml file If a message is logged in error the UseHisRisAsFilter option becomes disabled and does NOT take effect for all subsequent retries of the message If anew message is received and nothing exists in the His Ris Patient ta
68. ine On the install screen select the option for Corepoint Integration Engine only 8 Check that the license file is still valid navigate to the license manager under Start Programs Corepoint Health Corepoint Integration Engine Setup License Manager 9 Start the Corepoint Integration Engine service 10 Re start interface services from trading partners to Corepoint Integration Engine if needed 11 Test monitor and validate functionality as necessary 12 Restart background software antivirus antispyware etc a SY AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 39 of 75 9 Configure Corepoint Integration Engine e There are 2 basic options to configure Corepoint Integration Engine the steps for each are below o Configure Corepoint Integration Engine by Importing an Existing Configuration o Configure Corepoint Integration Engine Manually Not Recommended 9 1 Configure Corepoint Integration Engine by Importing an Existing Configuration This option requires a configuration to have been previously exported to a Corepoint Integration Engine Export nix file This is dependent upon a fixed configuration of all components when originally exported NOTE Importing an existing configuration is generally the preferred method for configuring Corepoint Integration Engine Typically the Acuo Implementation Team will perform an import using a standard base configuration then
69. ing Subscription Pool Users Connection Mapping Code sets Map vocabularies Routing Subscription Pool Database Message Formats Alerts Schedule 3 Name it Acuo_SubscriptionPool then click the button Create and Edit AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 59 of 75 POWERED BY INC es Create Subscription Pool object xX Create a new Subscription Pool object Press Create to create only Press Create and Edit to create and launch editor Name Acuo_SubscriptionPool Description CO 3 Create Create and Edit Cancel 4 Add the connection created from the previous step something like IB_F450 MULTI from the left side to the right side of the screen so it appears under the Subscription Pool Members field on the right side of the screen Leave the Pre Queue radio button checked at the bottom left of the screen 5 See the screenshot of the Subscription Pool below If this looks correct click the File menu at the top left of the screen and select Save and Close 2 2 Connections Manual Entry Description Test Neolntegrate Service Connections Subscription Pool Members IB_Acuo231_ADT_ORM Que IB_Acuo231_ADT_ORM Pre A Add x Remove Pre Queue C Post Queue Restart the NeoTool Corepoint Integration Engine Service after the configuration is complete This can be a
70. int Integration Engine s log a Install Microsoft Message Queuing MSMQ See the section above titled Corepoint Integration Engine System Pre Requisites for details on how to install MSMQ Note this may have already been previously done if a new receiver connection see steps below is simply being added to an existing system b Install Corepoint Integration Engine See instructions above under the section Install Corepoint Integration Engine c Set up a new Receiver Connection The following are the basic steps to set up the receiver connection to only capture inbound data e Create a simple action list with only a MsgLoad action unparsed e Onthe Name the Connection screen name the connection and select all message types e Onthe General Information screen leave all defaults e Onthe TCP IP Information screen enter a port and leave all other defaults e Onthe Inbound Arrival Configuration screen check the box to Log messages placed on the Pre queue e On the Receiver Acknowledgement Information screen leave all defaults e Onthe HL7 to XML Conversion screen leave all defaults the Convert HL7 to XML check box should NOT be checked e Onthe Inbound Delivery Configuration screen leave all defaults e Onthe Sink Gear Selection screen select RFMDB Gear then click the Configure button and select attach the simple action list created in the first step abo
71. ion and storage of DICOM objects based upon AcuoSemantix messaging See the figure below for an overview on AcuoSemantix workflow and tie in to other Acuo components AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 7 of 75 POWERED BY q AcuoSemantix Workflow Overview r and tie in to other Acuo components HL7 Messages Acuo DICOM Fixits Prefetch Acuo HIS RIS SQL Updates XML Old DICOM Images gt Ci ADAM DICOM Migration Of Ki ye AR orm Corepoint essage Integration X Process Engine XML DICO Events a gt Process Messages q Purge Processed Create amp Ka Events amp ae Reconciliation vents HL7 Interface Routes Messages AcuoSemantix Image Tags 5 Acuo Fixits AcuoStore Med 2 2 Detailed Overview The General Overview section above gives a high level summary on what AcuoSemantix does and how it s tied into workflow This Detailed Overview section is intended to provide a greater level of detail into the functionality of AcuoSemantix from initial message receipt to the resulting activities that may occur One of the pre requisites for running AcuoSemantix is the installation and configuration of Corepoint Integration Engine see the sections below Install Corepoint Integration Engine and Configure Corepoint Integration Engine Corepoint Integration Engine provide
72. job if it matches the Station AE Title of a prefetch rule configured on the AcuoMed server If no match occurs the default prefetch rule of esdefault will be used The default value in this field may be changed to a different segment path if Batch Moves need to be triggered from some other segment o The default message segment for the PrefetchStationMapping setting is PV1_3_AssignedPatientLocation 1 PL_FacilityHd HD_Namespaceld AcuoBatchMoveServer renamed in 5 3 1 formerly WhereToTableBatchMoveJob The name of the server where the Batch Move job will be queued This is the AcuoMed system where the default prefetch rule of esdefault is required to be present Optionally other prefetch rules could be set up to drive Batch Moves based on the Assigned Patient Location of the incoming HL7 message see the PrefetchStationMapping parameter above EnableBatchMoveDBFilter new in 5 3 1 This parameter should be set to YES or NO If no value is entered it will default to YES This is the same default behavior for releases prior to 5 3 1 o If set to YES the a Batch Move job will only be queued if the PID does NOT already exist in the Batch Move table If the PID already exists a Bath Move will NOT be queued the general assumption is that it is the same patient o If set to NO a Batch Move will be queued for every message unless the EnableBatchMoveStudyStatus is enabled The EnableBatchMoveStudyStatus
73. led Corepoint Health Solutions Click Finish to exit the wizard J Launch the License Manager Cancel o When the license manager is launched you will be prompted to first enter the Corepoint Integration Engine Administrator password This is the password which was entered during the install of Corepoint Integration Engine above Click OK after entering the correct password Log On X You must log on to use this application Enter your Corepoint Integration Engine username and password below Username administrator Password OK Cancel AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 37 of 75 ACUO p After entering the password the License Manager screen should appear which generally indicates no license key is present Click the License wizard button LicenseManager x Installation folder C Program Files Corepoint Health Corepoint Integration Engine Days Licensed Licensed CPUs 0 System CPUs 2 0 No Connections 0 0 Licensed User Profiles 0 Current Count 1 0 Yes Licensed Action Points D Current 0 0 No Licensed Perspectives 0 Current 0 0 No Licensed Data Stores 0 Current 0 0 No Licensed Data Models 0 Current 0 0 No Licensed Data Tables 0 Current 0 0 No Mode s JM Application enabler 0 No Engine enabler LlAssured Availability Protocols pismo 0 No C
74. left of the screen and select Save and Close AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 51 of 75 ACUO ee 7 Ee Resources m Document Map Message control J Database Debug System EE A 3 a2ad 37 4 0 Read m Modify E Interact la Resources M Line 3 Action P x Z 3 s ai 2 Add Delete Edit Up Down Addaspeer Find Font Description Test MsgLoad into Zin as Unparsed Unparsed Unparsed temCopy in data to T_ARPS_HL 7_TO_XML_REPRESENTATION ARPS_HX_XML_STREAM DBInsert Acuo_Association all associated columns h Set up anew Receiver Connection 1 2 Navigate to Start Menu Programs Corepoint Health Corepoint Integration Engine Legacy Tools Monitor Alerts and Status Under the Corepoint Integration Engine Service node right click on My Computer and select Start Service if the service is not already started Then go to Corepoint Integration Engine Service My Computer Connections Right click Connections and select New gt Receiver im NeoIntegrate Console Root NeoIntegrate Service My computer Connections File Action wiew Help e mB B 2 Console Root Name Queue depths Idle time E amp Neolntegrate Service i My computer H Alerts Bidir Si F Assured ill Tasks gt Gear connection EJ i MSMO Receiver gu
75. lets you view multiple event logs Each of these logs runs constantly and when you encounter a problem you can open the Event Viewer and select from one of the four event logs to obtain more information To open the Event Viewer from the Windows Start menu select Programs Administrative Tools gt Event Viewer Note the same Event Viewer is also visible in the AcuoSemantix Configuration Manager The screenshot below shows the Event Viewer inside the AcuoSemantix Configuration Manager F ASXConsole Console Root Classic Event Viewer Local cuo S Fie Action View Favoites Window Hep l es m Hael Hum C Console Root Type Date Time Source Categoy Event _ User u AcuoSemantix Configuration Mana G Information 5 25 2011 1 19 18 PM__ AcuoSemantix AcuoSemantis Service 25887 N A gal Classic Event Viewer Local E Information 5 25 2011 1 19 18 PM__ AcuoSemantix AcuoSemantis Service 25073 N A ji Acua D Information 5 25 2011 1 19 18 PM AcuoSemantix Acuo Medical Library 16388 N A 8 Application QD Information 5 25 2011 1 19 18PM AcuoSemantix Acuo Medical Library 16388 N A a Hardware Events G Information 5 25 2011 1 19 17 PM_ AcuoSemantis AcuoSemantixService 25873 N A rsa semice ad information 5 25 2011 1 19 17 PM AcuoSemantix AcuoSemantix Service 25856 N A hioNewi on G Information 5 25 2011 1 19 06 PM_ AcuoSemantis AcuoSemantis Service 25057 N A Microsoft Office Diagnostics Microsoft Office Sessions 8 Security
76. light the derivative file inside the appropriate HL7 version node Be sure to select highlight the derivative file subnode not the HL7 version node if a derivative file is being used 4 Uncheck the Enforce Required Segments and Enforce Required Fields fields 5 Check the Ignore Unexpected Segments and Ignore Unexpected Fields fields 6 Continue through all other screens by clicking Next then click Finish at the end to save the Receiver Connection changes g Restart the Corepoint Integration Engine Service 1 Follow the steps above to stop and re start the Corepoint Integration Engine Service 9 2 Configure Corepoint Integration Engine Manually This option involves configuring all components manually inside the Corepoint Integration Engine configuration panel including the following Data Point Namespace Database Association Action List Receiver Connection and Subscription Pool NOTE This method of configuring AcuoSemantix is generally not recommended although it is listed here for reference if needed Newer implementations on version 5 3 1 will generally import a base configuration the previous configuration option with common components where limited changes need to be made a Launch the Corepoint Integration Engine Configuration by navigating from the Start Menu to Start Programs Corepoint Health gt Corepoint Integration Engine gt Corepoint Integration Engine Configuration The Corepoint I
77. lly In cases where the errored message continues to fail after repeated retry attempts a manual change to the database may be needed to allow processing to continue and or troubleshoot the message in error please contact Acuo Technologies Support for assistance MasterDBServerName This is the name of the AcuoMed server where the His Ris Patient and Event tables are updated with patient study information depending on the type of HL7 message received This is also the AcuoMed server where a His Ris feature key must be present previously mentioned above in the AcuoMed AcuoStore System Pre Requisites section above In basic environments the MasterDBServerName is typically the central long term archive but in more complex environments multiple locations may exist in handling multiple RIS sources HL7MessagePollingTimer renamed in 5 3 1 formerly RetryAcuoMedTimer This is the amount of time AcuoSemantix checks for new messages that have been received and need processing messages that have been inserted into the T ARPS HL7_TO_XML_REPRESENTATION table but not yet processed by AcuoSemantix This is also the interval in seconds AcuoSemantix will retry a message in error if the AcuoMed service is down if the His Ris is not configured on the AcuoMed server or the default prefetch rule of esdefault is not present on the AcuoMed server o The default value for the HL7MessagePollingTimer setting is 1 second It is recommended t
78. mantix as noted in the Acuo Release Notes and or User Manual i After installing all other products install the new version of AcuoSemantix by the following the instructions as noted above in the AcuoSemantix New Installation section Notable differences from the New Install section above i On the Database Installation screen the database name and login should default to MedSemantix es or whatever the database name was prior to 5 3 1 the default DB name prior to 5 3 1 was MedSemantix es This may need to be changed accordingly ii On the Database Installation screen it is generally recommended that explicit paths be entered for the AcuoSemantix database file and log file locations rather than leave the 2 fields set to DEFAULT iii Copy in the new set of XML configuration files for 5 3 1 Assistance will generally be needed from the Acuo Implementation or Support Team for this step j Re enable the AcuoSemantix Service back to Automatic and start the service k Verify stability and successful processing of new messages All messages received during the upgrade while the AcuoSemantix Service was disabled should be processed normally NOTE When the AcuoSemantix Acuo MedSemantix es Service is disabled during the upgrade new incoming messages should be logged into the HL7_TO_XML_REPRESENTATION table in the AcuoSemantix Database After the upgrade is complete and the service is restarted these messages shoul
79. n addition there are numerous changes and additions for this configuration file in 5 3 1 AcuoSemantixConfig xml o There are new parameters for this file in 5 3 1 o Some existing parameters from the old configuration file have been renamed o Please reference the section in this manual titled Modify AcuoSemantixConfig xml for details on these changes All parameters that are new to 5 3 1 have the text new in 5 3 1 listed at the title of the parameter in parenthesis All parameters that have been renamed have the text renamed in 5 3 1 4 ActivityList xml gt A new activity called PatientMerge is present in 5 3 1 This activity will queue a Patient Merge Fixit message to the Batch Patient Update Manager gt Previously in 5 2 1 the UpdatePatient activity queued the merge fixit message In 5 3 1 the PatientMerge activity queues the merge fixit and the UpdatePatient activity only queues a Patient Update fixit gt This activity should generally be configured for any merge message Please reference the section in this manual titled Modify ActivityList xml for further details 5 Other XML files gt There are some notes recommendations and requirements that are applicable to other XML configuration files used by AcuoSemantix in 5 3 1 Although these files may vary from site to site and are generally created during initial implementation by Acuo Technologies the information listed here may help in understanding furth
80. nfigured for each message name are the following add the activities as needed for each message name AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 30 of 75 NOTE O UpdateAcuoHISRIS This activity should always be listed first if present If this activity is configured patient information will be logged into the His Ris Patient table T_HISRISPATIENTINFO_HRP and event order information is logged into the His Ris Event table T_HISRISEVENTINFO_ RIS This information is logged to the AcuoMed Server Database found in the MasterDBServerName parameter AcuoSemantixConfig xml file The information logged may depend on the message type and contents received Further details by message type e ORM O01 Order Messages Information is logged into the His Ris Patient AND His Ris Event tables e ADT Messages for example ADT A08 and ADT A18 Information is logged into the His Ris Patient AND His Ris Event tables however the entry into the Event table is generally a dummy record that doesn t contain any relevant information since ADT messages don t generally contain Study Event information If a patient is being reconciled from the Reconciliation Event Manager REM in AcuoMed the records that will be returned during the His Ris search are those with a patient AND event entry In addition the event entry must contain a valid Study Date Scheduled Procedure Start D
81. ntegration Engine user name and password will need to be entered to proceed The user should be administrator and the password was entered during the install step above NeoIntegrate x Enter your username and password Password fe ssSCSCiCS V Remember this username and password Y x OK Cancel b Import any derivative files under the appropriate HL7 version node in the configuration window The following steps are an example on how to import a derivative file into the V2 3 1 node when HL7 V2 3 1 messages are being received 1 Onthe left side of the screen expand the and navigate to Standards HL7 V2 2 3 1 Select or highlight the 2 3 1 node AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 41 of 75 El Standards HL 2 Templates NOTE Any derivative files will typically be provided by an Acuo Support Engineer during site configuration 2 Goto the top most line in the Corepoint Integration Engine window and select File gt Import Select the derivative file to import then click Open After importing the derivative file it should appear as a subnode underneath the applicable HL7 version node E Standards Templates NOTE One type of derivative is called a Z Segment Z segments contain clinical or patient data that the HL7 Standard may not have defined in other areas Essentially it is t
82. o the Acuo Technologies FTP Server Please contact an Acuo Support Engineer for the preferred method Activity Log e The Activity Log is launched by opening the Acuo Technologies AcuoMed Utilities folder on the desktop then clicking the shortcut for the AcuoMed Activity Log es Acuo Technologies MedSe Parsing Asiff Called AE AcuoMed Address les Acuo Technologie dSemantix es Temp 65 9433 8F F493 4531 B O Parsing Asiff File Internal Calling ES Called AE AcuoMed Address Jes Acuo Technologies MedSemantix es Temp 3 10 C Store Request Q c ing A j Called AE AcuoMed O und ing A e Called AcuoMe Inbound AE a Outbound Calling AE Inbound Calling AE Outbound Calling AE ed tion Response Inbound Calling AE MedSemantixEs Called AE AcuoMed Parsing F Internal Calling AE Called AE Address Acuo Technolog dSemantix es Temp 8EDF 2D 2D DB04 4893 BA3 5 Parsi ile Internal A Called AE AcuoMed Address es Ac uo Technolo gies MedSemantix esTemp 8EDF 2D2D DB04 4893 BA34 48 as Parsing Asiff File Internal Calli AE Me f 5 AE AcuoMed Address es Acuo Technolo gies MedSemantix esTemp 8EDF 2D 2D DB04 4893 5 est i d g i li Outbound lling AES re Response Successful Inbound lling AE ed Association Release Request Outbound Calling AE MedSema j AcuoMed Store Re La Ca e The Activity Log displays DICOM related command activities that are occurring For AcuoSemantix the Activity Log will generally s
83. ocedures only Exclude Tables a T_APRS_MMC_INUSEBY T_ARPS_CONFIG T_ARPS_HL _TO_XML_REPRESENTATION T_ARPS_MASTER_CONFIGURATION_INFORMATION T_ARPS_RIS_EVENTS T_ARPS_RIS_IDENTIFICATION 4 Data Point Type at top of screen Leave Static selected this should be the default 5 DB Type SQL Server 6 Owner Leave Blank 7 Server Name Enter the SQL Server Instance Name 8 Database Name AcuoSemantix 9 Login AcuoSemantix 10 Password Secure4321 NOTE The Database Name Login and Password fields are all created automatically when AcuoSemantix is installed They are all fixed and should not be changed 11 Leave the option selected for Do not add to a Dynamic Data Point 12 Click the Test button at the top of the screen then click the green arrow that indicates Run Test If the DB connection is successful all tables should be displayed at the bottom portion of the screen 13 Click the File menu at the top left of the screen and select Save and Close e Setup a new Namespace 1 Right click on the right side of the screen in the open white space and select Database gt Namespace AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 44 of 75 g Users 2 Connection g Mapping b l Code sets Map vocabularies gt Sa Routing Subscription Pool J Database F Message Formats gt d Alert
84. ociation Namespace ariables s a aP Ei i Y Disassociate Disassociate All Associate Auto Match Auto Match All Filter T_ARPS_HL _TO_XML_RE T_ARPS_HL _TO_XML_RFE T_ARPS_HL _TO_XML_REPRESENTATION AR T_ARPS_HL _TO_XML_RE T_ARPS_HL _TO_XML_RFE T_ARPS_HL 7_TO_XML_REPRESENTATION AR T_ARPS_HL _TO_XML_RE T_ARPS_HL _TO_XML_RPE T_ARPS_HL _TO_XML_REPRESENTATION AR Y X OK Cancel 7 Click the Match Criteria button Click the Auto Match All button on the left side of the screen Click OK to add the association Edit Association f4cuo_Association EX Mie a A T J 3 Select Data Point Select Namespace To Database From Database Description Ei Database Field and Namespace Yariable Match Criteria Iof x Namespace ariables ariable Database Association E f x Associate Auto Match Auto Match All Filter Disassociate Disassociate All Database T_ARPS_HL _TO_XML_REPRESENTATION ARP T_ARPS_HL _TO_XML_REPRESENTATION ARP T_ARPS_HL _TO_XML_REPRESENTATION ARP T_ARPS_HL _TO_XML_RE T_ARPS_HL _TO_XML_RE T_ARPS_HL _TO_AML_RE T_ARPS_HL _TO_XML_RE T_ARPS_HL _TO_XML_RE T ARPS_HL _TO_XML_RE wv OK Cancel 8 After completing all of the previous steps the configuration for the Association should look like the screen below Verify this looks correct then click the File menu at the top left of the screen and select Save and Clo
85. ocumentation for an explanation on the types of logs that are generated AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 64 of 75 Appendix A Version 5 3 1 Changes amp Recommendations This section contains information specific to the 5 3 1 Release of AcuoSemantix It lists changes between AcuoSemantix version 5 2 1 and 5 3 1 as well as general configuration recommendations 1 Product Rename gt The product was renamed from Acuo MedSemantix es in 5 2 1 to AcuoSemantix in 5 3 1 There may still be some areas in the GUI MMC and or Database that reference the old product name these will be less common for new installs of 5 3 1 2 Installation Changes amp Enhancements gt In5 3 1 user can now modify the service logon information service user name amp password or create a new user to run the service during install gt In5 3 1 user can now modify the AcuoSemantix database name and login during install and or change the location of the database data and log files o Previously in 5 2 1 the database name could not be changed and was always MedSemantix es In addition the database data and log files were automatically placed in the default database location as defined in SQL Server 3 AcuoSemantixConfig xml formerly ARPSConfig xml gt The configuration file ARPSConfig xml from 5 2 1 was renamed to AcuoSemantixConfig xml in 5 3 1 I
86. odified patient and study data in sync across an enterprise solution Fixit messages are most commonly generated in AcuoSemantix when there are changes to patient demographic information ADT A08 for example or when 2 patients are merged ADT A18 or ADT A40 for example When a fixit message is generated by AcuoSemantix a job is queued on the AcuoMed system inside the Batch Patient Update Manager queue Batch Processing Managers node For more information please refer to the Batch Patient Update Manager section of the AcuoMed Installation and Operations Guide 1 MsgTypeField1 The segment of the incoming message listing the message type ORM for example being sent The information in this field along with MsgTypeField2 serves as the basis for AcuoSemantix message processing The data in this field should not be changed AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 22 of 75 NOTE NOTE NOTE MsgTypeField2 The segment of the incoming message listing the event type 001 for example being sent The information in this field along with MsgTypeField1 serves as the basis for AcuoSemantix message processing The data in this field should not be changed The parameters MsgTypeField1 and MsgTypeField2 can vary by site and are generally determined and set during initial implementation SourcePath The segment of the incoming message listing the sending ap
87. ogin name will generally default to MedSemantix es the default prior to 5 3 1 d The Password field currently cannot be changed Please contact Acuo Technologies Support if this information is needed ze AcuoSemantix Configuration Manager InstallShield Wizard Database Installation SQL database name and physical file location Name of the database catalog AcuoSemantix SQL data file physical folder Ic Acuo DBs and Logs SQL log file physical folder c Acuo DBs and Logs SQL login user name AcuoSemantix SQL login user password eeeceeeeeen SQL login confirm password essss88888 InstallShield i Select Complete for the Setup Type then click Next j Click Install to begin the installation tac ees cae k The following message is displayed upon a successful installation if errors are encountered please contact Acuo Technologies Support for assistance AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 18 of 75 ACUO e ie AcuoSemantix Configuration Manager InstallShield Wizard ci 28 InstallShield Wizard Completed The InstallShield Wizard has successfully installed AcuoSemantix Configuration Manager Click Finish to exit the wizard 5 3 AcuoSemantix Upgrade Installation Service Pack Level Upgrade If an existing version of AcuoSemantix is already installed per
88. ove is followed by other informational events yellow warning events or red error events additional investigation and troubleshooting may be necessary 2 Look at the following 2 tables in the AcuoSemantix database e T_ARPS HL7_TO_XML_REPRESENTATION e T_ARPS RIS_EVENTS e If these 2 tables contain a different amount of rows that may suggest that Corepoint Integration Engine converted the message to XML and inserted it into the DB however AcuoSemantix had trouble processing it This scenario would not be unusual if messages are being sent in with unexpected or atypical characteristics e Check the insert times of the entries in both tables to see if it coincides with the time that messages were sent in e Inthe T_ARPS_RIS_EVENTS table check the columns that end in PROCESSED VALIDATED and RESULT These columns may indicate a problem with message processing or the inability to properly the validate the message against required message components i The PROCESSED column should generally display the number 1 which indicates it was processed Also reference the parameter SkipHL7MessagesWithErrors under the section above Modify AcuoSemantixConfig xml for other values which may be logged when messages are in error ii The VALIDATED column should generally indicate True which means the message was properly validated iii The RESULT column should generally indicate HL7 Mes
89. plementationUID This is the Implementation UID that will be used in the outbound association from AcuoSemantix to AcuoMed when fixits are sent It is recommended that the default of 1 2 840 114158 1 4 1 remain unchanged ImplementationName This is the Implementation Name that will be used in the outbound association from AcuoSemantix to AcuoMed when fixits are sent It is recommended that the default of AcuoSemantix531 remain unchanged As indicated above the parameters AETitle ImplementationUID and ImplementationName should generally remain unchanged from their default values These fields have no functional ramification attached to them unless External SCU Authorization is configured on the Called AE Name receiving fixits The information in these fields would typically be visible in the AcuoMed Activity Log the Calling AE Name or a captured hex trace on the AcuoMed server receiving fixits This information may be helpful in troubleshooting situations by identifying the source of incoming data 10 UpdateDelaylnMinutes This is the amount of time in minutes that fixits jobs queued from AcuoSemantix are delayed from running The default behavior when no value is set is to run fixit jobs immediately o Inthe Batch Patient Update Manager any jobs that have a delayed time due to this parameter UpdateDelayInMinutes can be associated with the column UTC Created Date The UTC Created Date should gener
90. plication The data in this field should not be changed HostName The AcuoMed server name where fixits will be sent Change this value to the AcuoMed server name where fixits will be sent ListeningPort The port number on the AcuoMed system where fixits will be sent The port number here along with the Called AE Name in the next parameter AETitle_ AcuoMed need to match what is configured on the AcuoMed system receiving fixits AETitle_AcuoMed The Called AE Name on the AcuoMed system where fixits will be sent The Called AE Name configured here along with the Port Number from the previous setting ListeningPort should match those configured on the AcuoMed system Change the value in this field to match a Called AE Name on the AcuoMed system o Atthis point you may wish to revert back to the AcuoMed system and edit an existing Called AE Name or set up a new one specifically for receiving fixits The above parameters HostName ListeningPort and AETitle_ AcuoMed are generally considered the default location where fixits will be sent Alternatively fixits may be sent to other destinations if functionality in other parameters is enabled See the EnableDefaultFixitForDomain and FixltDests parameters below AETitle This is the Calling AE Name that will be used in the outbound association from AcuoSemantix to AcuoMed when fixits are sent It is recommended that the default of AcuoSemantix remain unchanged Im
91. ported version combinations AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 15 of 75 POWERED BY NOTE Version numbers referenced or seen in screenshots below may vary newer versions may have been released after this revision of the manual a Double click the Setup exe file to run the installer e This will typically be in the following location inside the install folder for AcuoSemantix AcuoSemantix 5 3 1 X Diskimages DISK1 Setup exe b Click Next on the welcome screen ie AcuoSemantix Configuration Manager InstallShield Wizard S x Welcome to the InstallShield Wizard for AcuoSemantix Configuration Manager The InstallShield R Wizard will install AcuoSemantix Configuration Manager on your computer To continue click Next WARNING This program is protected by copyright law and international treaties c Select the option to accept the license agreement then click Next d Enter any User Name and Organization then click Next e Enter the Service User Name and Password that will be used to run the AcuoSemantix service i we BJ z ie AcuoSemantix Configuration Manager InstallShield Wizard Service Logon Information Specify the log on account for services Specify the user name and password of the log on account for this application The user account must be in the form DOMAIN Username Service user
92. rDomain FixltDests e The UseHisRisAsFilter and EnableFixitStudyStatus parameters are NOT applicable for merge messages UpdatePatient This activity will generate a Patient Level Update Fixit Message on the AcuoMed server The other parameters in the AcuoSemantixConfig xml file that affect Patient fixits are the following e HostName ListeningPort AETitle AcuoMed AETitle ImplementationUID ImplementationName where the fixits will go e UpdateDelaylnMinutes AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 31 of 75 e UseHisRisAsFilter e EnableFixitStudyStatus e EnableDefaultFixitForDomain FixltDests The UpdatePatient activity should be listed after the PatientMerge activity o UpdateStudy This activity will generate a Study Level Update Fixit Message on the AcuoMed server The parameters in the AcuoSemantixConfig xml file that affect fixits are the same as Patient Level see UpdatePatient above o SendBatchMove This will queue a Batch Move job to the server specified in the AcuoBatchMoveServer parameter The other parameters in the AcuoSemantixConfig xml file that affect Batch Moves are the following see the description of these above e PrefetchStationMapping e EnableBatchMoveDBFilter e EnableBatchMoveStudyStatus e DisablePIDOnMove e ExpediteBatchMoveServer ExpediteBatchMoveDaysAhead ExpediteBatchMovePriority No
93. rectory o For example the HL7TagMap xml file needs to be present in the AcuoSemantix directory for AcuoSemantix to function properly not the HL7TagMap_Template xml file NOTE After inserting the customized XML mapping files the file DicomTagInit xml must have write permissions in order for AcuoSemantix to function properly AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 32 of 75 ACUS 7 Corepoint Integration Engine System Pre Requisites The following steps should be performed to satisfy the pre requisites for the system where Corepoint Integration Engine is installed On Windows 2003 1 Install Microsoft Message Queuing MSMQ MSMQ is required for Corepoint Integration Engine however it is NOT installed as part of the default Windows installation Perform the following steps to install MSMQ a Goto the Control Panel Add or Remove Programs b Click Add Remove Windows Components in the left pane c Inthe Windows Components Wizard check the box for Application Server then click Details d Inthe Application Server components windows check the box for Message Queuing then click Details e Check the Common option in the Message Queuing components window the other components are not needed Click OK f Click OK on the Application Server window then click Next to proceed with the installation e Atthis step you
94. rform the following steps in order a On the Connectivity tab enter data in all empty fields gt HIS RIS Name Called AE Name Host Name or IP Listening Port Calling AE Name e The HIS RIS Name is simply a text description of the connection e Anything can be entered in the other fields they are not used for AcuoSemantix HIS RIS Connection Properties fea Es Connectivity Connection Dicom Tag Info Options HIS RIS Name MedSemantix es External Device Called AE Name Teste TCP IP Connectivity Host Name localhost C Ip ddress e s a HIS AIS Listening Port 9876 Calling AE Name AcuoM ed Implementation UID fi 2 840 114158 1 1 3 Version Name cuo WLSCU OK Cancel Apply b On the Options tab change the Request Timer to 86400 and Delete Events After Days to 0 Leave the Search Previous Days and Search Forward Days fields at their defaults 1 and 7 HIS RIS Connection Properties Connectivity Connection Dicom Tag Info Options C FIND Request Control Request Timer Seconds 86400 Search Previous Days A Delete Events After Days fo 0 Keep Forever Search Forward Days fz Force Patients to REM Patient Name or Patient ID Note Find Responses returned from the RIS that start with the above field s will NOT populate the Event tables thus subsequent stores will fail reconciliation and be placed in
95. s gt 3 Data Point ey Schedule 2 Name the Namespace Acuo_Namespace then click the button Create and Edit The screen below then appears Create Namespace object Es Create a new Namespace object Press Create to create only Press Create and Edit to create and launch editor Sears cuo_N amespace Description ee Create Create and Edit Cancel 3 Click the Schema Import button at the top of the screen Select the Data Point created in the previous step Click Open 4 Select the table T_ ARPS HL7_TO_XML_REPRESENTATION and click Add The Namespace Variables section should be populated with the 3 column names prefaced with a S 5 Click the File menu at the top left of the screen and select Save and Close see screenshot below for a snapshot of the Namespace screen before saving AR 9 E 2 Manual Entry Correlation Import Schema Import Description r Fetch DB Table Names Namespace Variables DataPoint Acuo Datapoint be a T_ARPS_HL _TO_ ML_REPRESENTATION ARPS_HX_GUID T_ARPS_HL _TO_XML_REPRESENTATION ARPS_H _INSERTDATETIME s 0 ie a O 1_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_XML_STREAM Exclude r Limit Table names displayed Include nd Exclude ee Database Schema L El Tables T_APRS_MMC_INUSEBY T_ARPS_CONFIG T_ARPS_HL7_TO_XML_REPRESENTATION x T_ARPS_MASTER_CONFIGURATION_INFORMATION nenova
96. s of procedures A procedure consists of several numbered or lettered steps to be performed in sequence Procedure steps are numbered and may include additional explanatory information as is appropriate Here is an example of how procedure steps appear in this manual 1 Before beginning installation review configuration recommendations 2 Backup up the target system databases a Backup the AcuoMed database b Backup the AcuoStore database c Backup all AcuoMed Dicom databases 3 Performa full backup of the target system registry Optional Procedure Steps Certain steps in a procedure may not be required in all cases Procedure steps that contain optional actions are indicated by the word Optional in parenthesis at the beginning of the procedure step as shown in the example here 1 Optional For maximum protection make a second backup of your current data before beginning installation Keys Buttons and Entering Text All references to pushing specific keyboard keys clicking buttons and or entering text generally appear in bold italics and or inside double quotes The following examples are provided for reference e Set up anew default prefetch rule and enter the text esdefault in the Station AE Title field e Name the Data Point Acuo_Datapoint then click the button Create and Edit Notes Notes provide additional explanatory information special instructions and or helpful hints that are deemed
97. s the ability to build and manage interfaces to allow different applications to communicate seamlessly across a healthcare enterprise The following steps describe the flow of activity as Corepoint Integration Engine first receives an HL7 message and how it leads to resulting actions initiated by AcuoSemantix 1 An HL7 message is sent from an HL7 source HIS RIS to Corepoint Integration Engine In other environments the HIS RIS may send to an intermediary HL7 interface that acts as an HL7 router and forwards the message to Corepoint 2 The HL7 message is received by Corepoint Integration Engine and temporarily placed in the Microsoft Message Queue MSMQ AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 8 of 75 NOTE For a more detailed explanation of the MSMQ please reference the Corepoint Integration Engine System Pre Requisites section below 3 Corepoint Integration Engine takes the HL7 message off the MSMQ converts it to XML and inserts it into the T_ARPS_HL7_TO_XML_REPRESENTATION table of the AcuoSemantix database or MedSemantix es database If Corepoint has a problem reading the message and or inserting it into the AcuoSemantix database the message is saved to a Corepoint Error log in the directory where Corepoint is installed generally C Program Files x86 Corepoint Health Corepoint Integration Engine Logs NOTE The insert time of the entry is logge
98. s which may necessitate or complicate a failover Synchronized Failover Back Actions 0 Determine a synchronized failover or failback is needed benefit outweighs cost ACTIVE Disable Corepoint Integration Engine listening interface at Active site disable service optimal This is essential to flushing out the queues such that both sides can be synchronized Notify customer so they can pause the HL7 source if they desire 2 ACTIVE Complete all tasks jobs in order in the Corepoint Integration Engine amp Acuo HL7 chain a b C d Corepoint Integration Engine MSMQ Corepoint Integration Engine Pre amp Post log ASX DB Tables Batch Patient Update Queue 3 PASSIVE Enable Corepoint Integration Engine listening interface at Active site Fail over the HL7 feed via DNS reconfiguring the HL7 source or other means such that the source now points to the PASSIVE Corepoint Integration Engine instance Resume the HL7 source if it was paused earlier AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 75 of 75
99. sage processed if it was processed successfully 3 Review the expected behavior on the connected AcuoMed system the ActivityList xml configuration file will show the expected activities for each message type e f UpdateAcuoHISRIS is configured as an activity for the message that was received check the His Ris Patient and Event tables in the AcuoMed Database to see if new patients events are getting logged AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 63 of 75 e Onarelated note if an unusually high amount of patients are going into the Reconciliation Event Manager REM this may also indicate a problem that not all messages are being processed and new messages are not properly updating the His Ris tables e If SendBatchMove is configured as an activity for the message that was received check the Batch Move Manager queue on the AcuoMed system e ffixit activities are configured PatientMerge UpdatePatient UpdateStudy check the Batch Patient Update Queue on the AcuoMed system and verify jobs are getting logged and are completing 4 Check the Corepoint Integration Engine Logs e Navigate to the C Program Files x86 Corepoint Health Corepoint Integration Engine Logs directory The log folders are generated based on a Year Month Day format An additional sub folder is created under the Day folder for each receiver connection Please reference Corepoint Integration Engine d
100. se AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 48 of 75 POWERED BY BCHINGLG J UES Sareea i Jra JO Edit Association Acuo Association pe ee ae G j cuo a a 3 j 3 2 Select Data Point Select Namespace To Database From Database Match Criteria Description Definition Value Configuration Information Datapoint Acuo_Datapoint Schema T_ARPS_HL _TO_XML_REPRESENTATION Namespace Acuo_Namespace Source Destination From Database T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_GUID T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_GUID T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_INSERTDATE T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_INSERTDATETIME T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_XML_STREAM T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_XML_STREAM Match Criteria T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_GUID T_ARPS_HL _TO_XML_REPRESENTATION ARPS _HX_GUID T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_INSERTDATE T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_H_INSERTDATETIME T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_XML_STREAM T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_XML_STREAM To Database T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_XML_STREAM T_ARPS_HL7_TO_XML_REPRESENTATION ARPS_HX_XML_STREAM g Setup anew Action List 1 Right click on the right side of the screen and select Mapping gt Action List Users Connection
101. se Filtering Engine BFE is a service that manages f Automatic Local Service S5 Bing Bar Update 5 Keeps Bing Bar up to date Disabling this service might p Manual Local System BitLocker Drive En BDESVC hosts the BitLocker Drive Encryption service BitL Manual Local System a oe see iaiia i 6a ee nP i S NOTE The step above describes how to launch the standalone AcuoSemantix MMC AcuoSemantix Configuration Manager that is present in the Acuo Technologies folder after running the installer The Services node and the Event Viewer nodes are also included as part of the default Acuo Technologies MMC that is present in the Acuo Technologies desktop folder Therefore the primary items of significance in the AcuoSemantix Configuration Manager snap in are the Database Connection Parameters right click AcuoSemantix Server select Change Database Connection and access to the Trace Settings Rather than opening up a separate MMC specifically for the AcuoSemantix Configuration Manager the AcuoSemantix Configuration Manager node can simply be added to any other existing MMC To do this open up any existing MMC one which may already contain AcuoMed AcuoStore for example go to the File menu select Add Remove Snap in then add the AcuoSemantix Configuration Manager snap in AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 61 of 75 ACUO 2
102. significantly further analysis should occur as this tends to indicate issues or delays with message processing In some scenarios where a large amount of messages is received in a short period of time messages may get inserted by Corepoint faster than they are processed thus the difference in number of entries between the above 2 tables may be more likely to rise during that time 5 After AcuoSemantix properly picks up the message and puts it into the T_ARPS_RIS_ EVENTS table the next step for AcuoSemantix is to determine which activities or resulting actions should be performed This information comes from the configuration file ActivityList xml found at C Program Files x86 Acuo Technologies AcuoSemantix All actions performed by AcuoSemantix involve sending information to a connected AcuoMed AcuoStore system For further details please see the section Configure AcuoSemantix below Generally the resulting actions that may occur are e Prefetching queuing Batch Move jobs on an AcuoMed system e Updating the Acuo His Ris tables commonly used in conjunction with the Reconciliation and Auto Mapping feature inside AcuoMed e Generating the following patient or study update messages to keep Acuo Databases in sync these are referred to as Acuo Fixit messages i Patient Update Messages update patient demographic information ii Study Update Messages update study order information iii Patient Merge Messages merging
103. tabase name should default to MedSemantix es or whatever the database name was prior to 5 3 1 the default DB name prior to 5 3 1 was MedSemantix es b The location where the AcuoSemantix database file and log file will be saved i The default text for these fields is DEFAULT If DEFAULT is specified in these fields the location of the database file and log file will be determined by the default SQL Server database directory To find the default directory open up SQL Server Management Studio right click on the instance name and select Properties Select the Database Settings page and go to the Database Default Locations section Data and Log fields Note If the default directories are changed in SQL Server a restart of SQL Server is needed AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 17 of 75 POWERED BY Note Prior to 5 3 1 the location of these files could not be changed in the AcuoSemantix MedSemantix es installer Therefore the default SQL Server location was used for the location of the database file and log file ii Itis generally recommended that explicit paths be entered for the AcuoSemantix database file and log file locations rather than leave the 2 fields set to DEFAULT c Enter the Database Login Name i If this is an upgrade installation AcuoSemantix upgrade from a version prior to 5 3 1 the l
104. te Queuing Batch Moves is also commonly referred to as Prefetching 6 3 Modify Replace Other XML Files Other XML and mapping files are present with the install of AcuoSemantix found at C Program Files Acuo Technologies x86 AcuoSemantix These may need to be modified and or replaced accordingly to compensate for differences in the version of HL7 messages being received or varying differences in message components from each HL7 feed Sorting through these differences is generally part of the site assessment and implementation process whereby a sampling of site messages is generated and analyzed by Acuo Technologies Any modified files that are needed will be provided by Acuo when AcuoSemantix is configured and installed after site assessment and implementation In 5 3 1 some XML files installed in the above AcuoSemantix directory are suffixed with Template at the end of the file name These are generally the XML files that may be site specific and therefore require changes or different mappings from site to site The template files are designated to help serve as a baseline showing general content format in these files however they need to be modified accordingly All files designated as template files need to be present in the AcuoSemantix directory in order for AcuoSemantix to function They need to be renamed and saved without the _ Template text or files with the correct names need to be copied into the AcuoSemantix di
105. ted with the text new in 5 3 1 AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 21 of 75 A POWERED BY Figure 6 1 AcuoSemantixConfig xml Sample File lt xml version 1 0 encoding UTF 8 gt gt amen enroute Version 5 3 1 gt lt Messac ntification Parameters gt reS a 9 i essaten MSG_MessageType 1 lt MsgTypeField1i gt lt MsgTypeField2 gt MSH MSH_9_MessageType CM_MSG_TriggerEvent 1 lt MsgTypeField2 gt lt SourcePath gt MSH MSH_ 3_SendingApplication HD_NamespaceId 1 lt SourcePath gt lt Fixit Parameters gt lt HostName gt localhost lt HostName gt lt ListeningPort gt 4321 lt ListeningPort gt lt AETitle_AcuoMed gt AcuoMed lt AETitle_AcuoMed gt lt AETitle gt AcuoSemantix lt AETitle gt lt ImplementationUID gt 1 2 840 114158 1 4 1 lt ImplementationUVID gt lt ImplementationName gt AcuoSemantix531 lt ImplementationName gt lt UpdateDelayInMinutes gt lt UseHisRisAsFilter gt NO lt UseHisRisAsFilter gt lt EnableFixitStudyStatus gt lt EnableDefaultFixitForDomain gt NO lt EnableDefaultFixitForDomain gt lt FixItDests gt lt Dest gt lt IssuerPIDValue gt 1234 lt IssuerPIDValue gt lt HostName gt lt Port gt 4321 lt Port gt lt SCPAETitle gt AcuoMedFixit lt SCPAETitle gt lt Dest gt lt Dest gt lt IssuerPIDValue gt 9876 lt IssuerPIDValue gt lt HostName gt lt Port gt 4321 lt Port gt lt
106. ting Acuo Technologies products is installing and configuring them Someone such as a system administrator or database administrator who is experienced using these types of products on a daily basis will best be able to perform the tasks described in this guide How to Use this Guide Due to the fact that AcuoSemantix works in conjunction with AcuoMed and AcuoStore it is recommended that you become familiar with those products and reference the user manuals for overviews on functionality that are used within the realm of AcuoSemantix If you are simply referring to this guide at some point after the initial installation and implementation of the product you will probably not need to revisit certain material such as the overview and initial installs sections However if you are new to Acuo Technologies products it is recommended that you read the Overview section to get a better understanding of the general environment in which the products operate and the functions they perform After that refer to the other chapters of the guide for specific information on the tasks you need to perform Related Documents and Reference Sources There are a number of very useful related documents and reference sources that you may want to review These include the following e The AcuoMed Image Manager Installation and Operations Guide included with an AcuoMed install e The AcuoStore Digital Asset Manager Installation and Operations Guide included with an
107. ts up normally and is now ready to receive messages the last informational event output is the following The AcuoSemantix service has been initialized and is ready to process Events 10 2 Message Processing and Verification After the service is started up successfully AcuoSemantix is ready to receive messages Once messages are being sent from the HL7 source into Corepoint Integration Engine there are a few options available to verify messages are being processed correctly or that an issue exists with message processing The following options are available 1 Check the Acuo Event Viewer available from the AcuoSemantix Configuration Manager e Every time a new message is received a blue informational event will be output indicating AcuoSemantix is now processing a message The event also lists the message type event type a unique message ID and the queued UTC time See the following example AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 62 of 75 A POWERED BY Event Properties _2 x Event Date 5 25 2011 Source AcuoSemantix Time 1 23 40 PM Category AcuoSemantix Service Type Information EventID 25875 User N A Computer C9 acuotech com sek Description AcuoSemantix is now processing 4 message TYPE ADT EVENT A08 UNIQUE MSG ID 87C03E019 FC86 E011 8B833 00268 938CC7F QUEUVED TIME UTC 5 25 2011 6 23 36 PM e fthe message ab
108. ve e Onthe Connection State Log Options screen click the button to Select All connection states e On the Log Maintenance Configuration screen leave all defaults e Onthe Alert Configuration screen leave all defaults d Restart the Receiver Connection if not prompted to do so in the previous step e Send or initiate the sending of HL7 messages to the Receiver Connection f After messages are received the Pre Log of captured messages will be found in the following location AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 67 of 75 e Program Files x86 Corepoint Health Corepoint Integration Engine Logs Year Month Day Name of Receiver Connection o The ib_pre nil or ib_pre cnz file should contain a capture of messages as they were first received by Corepoint Integration Engine Note The logs are first created with a nil file extension in the current day The next day they are compressed into a cnz format Both formats should open up inside the Corepoint Integration Engine Administration panel AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 68 of 75 ACUS Appendix C Troubleshooting This appendix describes the various steps that you can take when you encounter problems using Acuo products Event Viewer The Event Viewer within Windows
109. will get deleted automatically when the AcuoSemantix service is started or restarted o The AcuoSemantix service should be restarted after making a change to this parameter AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 29 of 75 POWERED BY ACIS 6 2 Modify ActivityList xml The ActivityList xml file is located at C Program Files x86 Acuo Technologies AcuoSemantix This file is used to specify what activities or actions will be performed for each HL7 message type that is received Changes to this file should not require a restart of the AcuoSemantix Service See figure 6 2 below for a screenshot showing a sample ActivityList xml file notes on how this file can be edited follow below Figure 6 2 ActivityList xml Sample File lt xml version 1 0 encoding utf 8 gt lt ActivityList Version 5 3 1 gt lt MESSAGE name ADTAO1 gt lt ACTIVIT Y gt UpdateAcuoHISRIS lt ACTIVITY gt lt ACTIVITY gt SendBatchMove lt ACTIVITY gt lt MESSAGE gt lt MESSAGE name ADTA08 gt lt ACTIVITY gt UpdateAcuoHISRIS lt ACTIVITY gt lt ACTIVIT Y gt UpdatePatient lt ACTIVITY gt lt ACTIVIT Y gt SendBatchMove lt ACTIVITY gt lt MESSAGE gt lt MESSAGE name ADTA18 gt lt ACTIVITY gt UpdateAcuoHISRIS lt ACTIVITY gt lt ACTIVITY gt PatientMerge lt ACTIVITY gt lt ACTIVITY gt UpdatePatient lt ACTIVITY gt lt ACTIVITY gt SendBatchMove lt ACTIVITY gt
110. ys to contact Acuo Support Alternatively either during or after business hours please feel free to contact us directly via telephone at the following number e 1 866 272 2286 AcuoSemantix Installation and Operations Guide Proprietary and Confidential Acuo Technologies Page 6 of 75 ACUS 2 AcuoSemantix Functional Overview 2 1 General Overview AcuoSemantix is an HL 7 XML DICOM based solution designed to bridge the gap between HIS RIS environments and DICOM PACS environments AcuoSemantix receives and decodes HL7 messages and generates DICOM workflow equivalent message s to existing AcuoMed Systems AcuoSemantix creates an environment without the need for a broker supporting multiple HIS RIS and AcuoMed installations in a single solution which can rapidly be added to any existing installation Further AcuoSemantix can scale centrally or control a fully decentralized network of AcuoMed nodes AcuoSemantix receives messages from one or more HIS RIS systems and stores messages as normalized validated XML in a SQL database These events are then converted into DICOM workflow messages and transmitted to an AcuoMed Image Manager for PACS synchronization keeping Patient info and Study info in sync prefetching and or reconciliation AcuoMed s distributed nature is capable of creating a highly customized environment where workflow and intelligence live closest to the user modality This facilitates automated routing reconciliat

AcuoSemantix Installation and Operations Guide

Contents

Download Pdf Manuals

Related Search

Related Contents