Home

Compass User Manual

1. Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 53 14 Custom Rule Condition Example using using using using using using using using System System Collections Generic system Text LaurelBridge LaurelBridge LaurelBridge LaurelBridge LaurelBridge namespace Example DCS DCE Compass Core COmpass CoOre Conditions Compass Core Plugins public class CustomExecuteCondition IExecuteCondition public bool Matches IAssociationParameters assocParams DicomDataSet dicomDataSet string name else dicomDataSet getElementStringValue DCM E PATIENTS NAME name name Trim if name Length 5 2 0 return true return false Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 54 15 Custom Job Action Example using using using using using using using System System IO System Collections Generic system Text LaurelBridge DCs LaurelBridge DCF LaurelBridge Compass Core namespace Example class CustomJobAction IJobAction public void Action StoreJobRecord job IDictionary lt string string gt data lock typeof CustomJobAction job LoadImages string dob NOT PRESENT string imagesDir CompassApplication Instance CompassDataDirectory string imageFile job Images 0 GetAbsoluteFilePath imagesDir using DicomFileInput dfi
2. attempts to send instances to the Destination v a the Destination s preferred transfer syntax from the list of enabled transfer syntaxes e Compass Preferred attempts to send instances to the Destination via Compass preferred transfer syntax from the list of enabled transfer syntaxes 5 4 Jobs Settings Under the Jobs heading settings include options which affect how and when jobs are sent to the Destination The Immediate Mode checkbox affects several of the other Jobs settings When Immediate Mode is checked Stable Study Time s is unchecked and disabled and Allow Skip Instances and Continue on Error are checked and disabled When the Immediate Mode checkbox is checked images routed to this Destination will be sent prior to the closing of the inbound association on which the images originated Jobs destined for an Immediate Mode Destination will show up in Compass main jobs table with a State of Pending Running to reflect both the Pending i e currently receiving and Running De currently sending status of the job If an outbound error occurs while processing a Pending Running job e g the Destination unexpectedly terminates the association the job s state will convert to Pending and will from thereon be treated as a non Immediate Mode job If the Stable Study Time checkbox is selected images from the same study that arrive on separate associations will be combined and sent out on a single association once the u
3. For one way anonymization of the patient demographic data and or pixel data re dentification cannot be performed the following feature must be unchecked in the Misc Settings group box e Enable Re ldentification NOTE If the Enable Re Identification setting is enabled without a valid Public Certificate the de identification will fail with the following error Laurel Bridge DCS DCSException Failed to apply filter action gt System Security Cryptography CryptographicException Cannot find the requested object The Public Certificate Path text box will be disabled when performing one way anonymization A valid public certificate is only necessary when Enable Re Identification is checked A valid certificate should either be purchased or generated by the user The expected certificate file formats are e the public certificate export format PEM ct e the private certificate export format PKCS 12 p12 8 4 5 Additional Notes Pixel data and header data re identification are only available with a valid public and private certificate Disable Use Original Attributes Sequence for all de identification filters 1f you are going to anonymize SOP instances Having this option enabled will defeat the purpose of anonymization by embedding the list of attribute tags and their original values that changed after applying the de identification filter action The De Identify Filter Action also supports removing all private tags from th
4. Pixel Representation gt Pixel Padding Value r The Execute act on executes a piece of custom code that adheres to a particular interface public class DateComparisonFilter IFilterAction Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 30 public void ApplyAction CFGGroup config DicomSessionSettings dss RelevantTagMarker tagMarker ref DicomDataSet dds custom code 8 SE JI The Find Replace action changes the value of the selected tag via hardcoded values or regex values a E Find Replace Patient s Name wei Use Reg Exp O Ignore Case AIA gt The Insert Overwrite action creates the specified Tag if it didn t already exist or overwrites the specified tag if it did already exist with the specified Value ei Insertj veren Y Participation DateTime e 11 04 2008 17 04 01 The Mapping List action allows the user to specify an external file that lists match tags and replace tags When creating a Mapping List action in Compass the user specifies the format of the mapping list file The example below shows that the mapping list file will contain three comma separated fields an accession number a patient ID and a patient s name If the match tags on any given row match the current dataset the values of the replace tags are substituted into the dataset Below is an example of a mapping list file that matches the format of the mapping list action PIKRO0
5. class UID field and route those DICOM objects where ever you want including to the Hold queue or just discard them 2 How do I configure Windows Server 2012 for Compass See Appendix B Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 56 Appendix B Enabling ASP NET Components on Windows Server 2012 In order to use the Compass Web UI on Windows Server 2012 certain server roles and features must be enabled on the Windows server Figure 1 Open the Server Manager and select option 2 Add roles and features This will open the Add Roles and Features Wizard Server Manager Dashboard PV manage Tools View Help WELCOME TO SERVER MANAGER Dashboard Local Server Configure this local server ia All Servers RE File and Storage Services b QUICK START 2 Add roles and features Add other servers to manage 4 Create a server group Hide ROLES AND SERVER GROUPS Roles 1 Servergroups 1 Servers total 1 er ee a Ange 1 B Local Server 1 Services Manageability Manageability Events Events Performance Services BPA results Performance BPA results Figure 2 From the Add Roles and Features Wizard choose the Server Roles option on the left hand column You may need to click the Next gt several times to enable the Server Roles menu the defaults on the Installation Type and Server Selection menus should be OK From the Server
6. If selected the list of rectangles defined in the Pixel Regions to Anonymize grid will be removed from the DICOM dataset s pixel data This includes pixel data in 7FEO 0010 and not any additional overlays or private tags This option will be skipped if no valid pixel data is present in the DICOM dataset e Enable Re Identification If checked the original values for each attribute anonymized will be persisted in the resulting de identified dataset using the specified public certificate More information about this process is specified later in this section e Retain Date and Time Information If this option is checked all date and time information DT and TM elements will not be anonymized This option may be useful Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 35 when performing clinical trials where the DICOM dataset s date and time information may need to be retained after de identification e Skip Unsupported Images When anonymizing a dataset s pixel data again referring only to pixel data in 7FEO 0010 enabling this option will cause the filter to not anonymize the pixel data for all unsupported photometric interpretations For instance anonymizing the pixel data for all DICOM datasets with a photometric interpretation of YBR FULL will automatically be skipped The header data for these datasets will still be anonymized For a list of all supported image types see s
7. new DicomFilelInput imageFile DicomDataSet dds dfi readDataSetNoPixels try throws an exception if the tag is not present dob dds getElementStringValue DCM E PATIENTS BIRTH DATE catch leave dob as the default value if it s not there ti string filename data filename File AppendAllText filename string Format 0 1 2 3 4 Job StudyInstanceUid job DestinationName dob DateTime Now Environment NewLine Generate a new accession number for example using any custom code string accessionNumber CreateNewAccessionNumber imageFile Store the value for access later on in job filters or other job actions job UserData accession number accessionNumber private string CreateNewAccessionNumber string imageFile d Create a new accession number based on the data in imageFile return ACC1234 Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 55 Appendix A Compass FAQ 1 How cana SOP class be added to the default list On the Compass GUI Main Dialog stop the Input and Output from the Main Dialog You can go to the Edit gt Options gt System Tab gt Edit Supported Sop Classes and add the SOP classes including private SOP classes to the list of supported SOP classes Make sure you click the plus button to update the list Then Compass will accept them and then you should be able to make Routing Rules based on the SOP
8. 12345 06 01 2004 XC 05 03 2012 09 05 3C TOPCON FA2 140 050906 140 07 26 2005 XC Page 1 of2 20 View 1 20 of 28 Hold Hold Hold Hold Hold Hold Hold Hold Hold Hold Hold Hold Hold Hold Hold Hold 1818 2 2 hd had ua add Jud had dl ld had hd td ad ag The columns can be sorted by clicking on the individual column headers note that not all columns can be sorted Administrator users also have the ability to modify existing jobs such as retrying changing the priority copying the job to a different destination etc The list of available actions depends on the state of the select job s Created Name Patient Id Accession Study Date Modalities 9 B6D1FEES3411 12 2014 MR 75e AQA89DE12FE 11 12 2014 MR of 1 20 e 11 12 2014 02 32 5 MINER Details 11 12 2014 02 29 1 MINER i Hold c Retry to t Set Priority I Remove The navigation bar along the bottom of the table has three buttons on the left side These are Open Details Filter and Refresh The Open Details action is also achieved by double clicking a row of the table DP PRPs ni EHE KA Hold Queue UN 2 wm The Details view which is opened for a job by either clicking the Open Details button or double clicking a job row provides a DICOM header dump and an image preview when possible You can change instances using the left right arrow buttons on the keyboard or the drop down at the Compass User Manual 201
9. 2008 R2 SP2 x64 Microsoft SQL Management Studio for SQL Server 2008 x64 2 4 Installing SQL Server 2008 R2 SP2 Express x64 These are instructions for installing SQL Server Express in its most basic configuration for use by Compass These instructions are valid for Windows 7 Windows 8 1 and Windows Server 2008 and Windows Server 2012 The installation procedure may differ if an older version of SQL Server is installed if the full version of SQL Server is preferred or 1f SQL Server authentication mode must be enabled Ge me gt 9 Log in to Windows as a user with administrative privileges Run the SQL Server 2008 R2 SP2 Express x64 installer On the Setup screen select New installation or add features to an existing installation On the License Terms screen Accept the license click the Next gt button On the Setup Support Files screen make sure all of the checkboxes are checked for all of the Instance Features click the Next gt Button On the Instance Configuration screen the defaults should be correct The named instance should be SQLExpress Allow it to install in the default location which should be C Program Files Microsoft SQL Server On the Server Configuration screen the defaults should be fine for the Service Accounts tab and the Collation tab defaults On the Database Engine Configuration screen on the Account Provisioning tab select Windows Authentication Mode The Current user who must have Administrative Privil
10. C Legacy Components m MI 141 Media Features lt Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 64 And click the OK button Figure 3 If necessary click Download files from Windows Update to continue Windows needs files from Windows Update to finish installing some features Download files from Windows Update gt Dont connect to Windows Update No changes will be made to your PC Figure 4 Click the Close button when finished Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 65 Appendix D Secure Communication with Compass The Compass application may be configured to communicate securely with another device by enabling the appropriate TLS Transport Layer Security options Typically this feature is used to enable secure DICOM communications between two peer copies of Compass 1 Summary Compass supports the Bas c TLS Secure Transport Connection Profile See DICOM PS3 15 2015c Security and System Management Profiles Appendix B 1 for authentication and encryption of communication between it and other DICOM clients and servers Compass supports TLS version 1 0 as required by th s profile Within the Compass application for secure DICOM communication on the sending copy of Compass one should select the Enable TLS option under the Advanced section of the DICOM Destinations pane On the receiv
11. Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 57 Roles menu check the box next to Web Server IIS This will open the wizard for the enabling of IIS Select server roles Before You Begin Installation Type Roles Server Selection ServerRolks L Application Server _ DHCP Server Features TI DNS Server Web Server Role lS C Fax Server Role Services gt E File and Storage Services 1 of 12 installed Confirmation C Hyper V Network Policy and Access Services _ Print and Document Services L Remote Access _ Remote Desktop Services _ Volume Activation Services Web Server Il Select one or more roles to install on the selected server _ Windows Deployment Services L Windows Server Essentials Experience L Windows Server Update Services DESTINATION SERVER WIN FJISTBSP B64 Description Web Server IIS provides a reliable manageable and scalable Web application infrastructure Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 58 Figure 3 Click the Add Features button to continue Add features that are required for Web Server IIS The following tools are required to manage this feature but do not have to be installed on the same server A Web Server IIS 4 Management Tools Tools IIS Management Console Include management tools if applicable Figure 4 There will now be a new option on
12. Under the Advanced heading a user can give more 1n depth control over how Compass communicates with a Destination Filters and Network options are configured in the same fashion as Sources The Schedule specifies the time at which jobs are allowed to be sent to the Destination A green box for the given day and time means jobs may be sent at that time a red box means that jobs may not be sent at that time This affects only the starting time of the job as a whole a currently running job will not stop sending images once it has begun to transmit them Each hour block represented by a green or red square may be toggled individually alternatively right clicking on the schedule allows the schedule to be set to a commonly used setting Be aware that choosing one of these predefined settings will replace the currently specified schedule Verbose DICOM logging can be turned on or off on a per Destination basis by selecting On Off or After Failures in the Dicom Logging chooser Selecting After Failures requires the number of failures before logging to be further specified The Use Throughput Optimization Protoco checkbox controls whether Compass will use proprietary protocols to transfer jobs to this Destination Compass TOPS requires that the Destination be another instance of Compass version 2 1 0 or greater TOPS provides throughput enhancements for jobs with many instances as well as enhanced job restart capability in the event of an error mid transfe
13. a tooltip with a message that further describes the failure 5 3 Transfer Syntax Settings Under the Transfer Syntaxes heading the user can configure the list of allowable transfer syntaxes that Compass will negotiate with the specified Destination Add the desired transfer syntaxes to the list of accepted Transfer Syntaxes by selecting the desired transfer syntax in the combo box and adding it by pressing the provided button After building up the list with the desired Transfer Syntaxes place them in the desired order by selecting each one and moving it up and down in the list by pressing the up and down arrows Selecting one of the options in the Mode combo box will also affect how Transfer Syntaxes are requested Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 20 e As Received or Destination Preferred attempts to send instances to the Destination in the transfer syntax they were received otherwise attempts to send v a the Destination s preferred transfer syntax from the list of enabled transfer syntaxes e As Received or Compass Preferred attempts to send instances to the Destination in the transfer syntax they were received otherwise attempts to send via Compass preferred transfer syntax from the list of enabled transfer syntaxes e As Received attempts to send instances to the Destination in the transfer syntax they were received and will fail otherwise e Destination Preferred
14. an SCU that will issue C STORE requests to Compass There is no limit on the number of Sources though at least one must be defined A Source describes the SCU machine Application Entity titles transfer syntaxes advanced association settings and data Filters on the images received from the SCU A Destination describes an SCP that will receive C STORE requests from Compass There is no limit on the number of Destinations though at least one must be defined A Destination describes the SCP machine Application Entity titles transfer syntaxes advanced association settings data Filters on the images sent to the SCP the sending schedule and the job activation mode which describes how DICOM images are aggregated or split in associations A Rule describes the criteria a DICOM image must meet in order to be sent to the specified Destination s There is no limit on the number of Rules though at least one must be defined A Rule contains one or more conditions conditions based upon the association information conditions based upon DICOM tag information or custom user defined conditions Each individual Rule can be specified such that any or all of the conditions must be met in order for the DICOM image to be tasked for the specified Destination s 3 2 Installing a License The first step after launching Compass 1s to install a license When the About Laure Bridge Compass dialog appears there are two options to install a license Information o
15. certificate and it must contain an exportable private key The Password must be set to the password for the private key in the certificate Note using a certificate format that does not password protect the private key allows the password setting to be ignored This appendix does not describe procedures that may be required to obtain and then implement secure certificates on a particular operating system installation The configured certificate information is provided to any client that connects to Compass on the TLS listen port All communication over this connection 1s then encrypted using the exchanged certificate Note that Compass will not try to further authenticate DICOM clients Source by requesting their certificates again during association negotiation Compass relies on its Source Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 66 configuration and setup mechanisms based on DICOM AE titles and IP addresses to determine whether or not to allow a DICOM chent to connect open a DICOM association to It See DICOM PS3 15 2015c Security and System Management Profiles Appendix B 1 for a further description of the Bas c TLS Secure Transport Connection Profile this document may be found at http medical nema org standard html Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3
16. launch if the Enabled at Startup checkbox is selected senger u Em The port Compass uses to listen for Dicom association reguests een e TT can be configured by specifying the port number in the Listen sa cre Fee ee Pore om Port chooser Er The maximum number of concurrent associations from Sources that Compass will process can be specified by using the Max Connections chooser This is the absolute maximum number of incoming concurrent connections if a Source has its individual maximum connections specified higher than this number then this number takes precedence The Optimize For chooser will direct Compass to optimize its network buffers for your particular network topology If many of your Sources connect to Compass via the Internet it is recommended that you choose WAN for this setting Otherwise the default setting of LAN is appropriate The Enable TLS checkbox will allow incoming encrypted connections to Compass typically such connections are from another copy of the Compass application To properly configure incoming TLS connections the Listen Port TLS Certificate and or Password must be set The Listen Port is the port on which Compass will receive TLS encrypted DICOM associations The TLS Certificate should be set to the location of the certificate that Compass should present for identification to clients It is suggested that the certificate be a standard PKCS 12 certificate and it must contain an exportable p
17. of the Conditions for the Rule pass then the image Action Discard Instance ng currently being processed will have the currently selected action applied Discard Instance or Send to Selected Destinations To add another Destination to the Selected Destinations list select the desired Destination in the Add Destination combo box and press the green plus sign To remove a Destination from the list right click on the desired Destination and choose Remove Selected in the context menu A predefined special Destination exists called the Hold Queue Any jobs routed to the Hold Queue will wait there indefinitely until the user decides to perform an action on them such as sending them to another Destination or deleting them 6 3 Rule Options Uncheck the Rule Enabled checkbox to disable the selected Rule If Rule options unchecked the Rule will be passed over during Rule processing ba ias erated O Stop Rule Processing On Match Priority 5 r Check the Stop Rule Processing On Match checkbox if no further Rules in the Rules list should be processed if this Rule matches Rules are processed sequentially from the top of the list to the bottom of the list If unchecked Rule processing will proceed to the next Rule even if this Rule matches Specify a number in the Priority number chooser to assign the order in which the job that the specified image contains will be processed 1 is the highest priority and 1
18. state 7 2 Destinations A Job Action can be associated with jobs for all destinations or a subset of configured destinations by using the checkboxes to make a selection 7 3 Type 7 3 1 Execute Allows custom actions to be defined Code File For Execute type actions the location of the file containing the code for the action must be specified The button with the folder icon can be used to browse to the location of the code file Parameters Execute actions support parameterization Using the grid a set of key value pairs can be defined which will be passed into the action at runtime Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 25 7 3 2 HL7 Send Send an HL7 message Host HL7 server hostname Port HL7 server listen port HL7 Message HL7 Template A templatized HL7 message This is the HL7 message that will be sent to the server It can contain variables that will be interpolated These include a TIMESTAMP a generated Message Id DICOM elements from the received job values from key value pairs added by custom code and values from the HL7 mapping DB Sample HL7 template message MSH amp IRADICDICIII TIMESTAMP yyyyMMddHHmmss lIORM 0011 GUIDO IPI2 3 PIDII PATIENT_ID ICA00116975IITEST REGEX 0010 0010 RC FAMI1 9370702 FINA GOO 16556211 PV LIOIAGDIDCIlll STAFFID LASTNAMF FIRSTNAMEMAM ORCINW OBRIIDOO0603853AIIUSSARTEXTCNB Arterial Extracrania
19. the Heartbeat fails and reconnects checkbox is checked Compass will send an email detailing the heartbeat failure or reconnection to the notification recipients This notification is only sent for Destinations with Heartbeat Sensing enabled If the Low Disk Space Notifications Enabled checkbox is checked and the computer has less disk space available than the threshold Compass will send an email to the Notification Recipients at the specified frequency To add a new recipient press the green add button located beneath the list of Notification Recipients Specify the recipient s email Compass Email Properties address and press the Enter key The sender of the email From compassadmin yourdomain net can be specified as well Compass Notification Recipients It is necessary to include a valid Mail Server Configuration in order to send emails to the listed recipients Ata minimum a Host and Port are required and optionally SSL can be enabled by selecting the Enable TLS SSL checkbox A Username and Password are also required if the mail server requires authentication ee SMTP Server localhost SMTP Port 25 I Enable TLS SSL Auth Mode SMTP r Test Username Password Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 45 11 Enabling Input and Output To allow Compass to accept incoming association requests press the Pla
20. 0 1 49387 127 0 0 1 106 12 29 34 PM 706 Receive 10 29 MB s 9 61KB s 13 85 KB s Send 25 12 KB s 3 94 MB s 5 67 MB s Receive Total 102 05 MB 75 63 KB 109 12 KB Send Total 249 25 KB 30 96 MB 44 67 MB Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 49 12 5 Status Bar The status bar is displayed at the bottom of Compass main window and displays the counts of various fields of quick interest to the user such as current and maximum allowed inbound and outbound associations as well as current disk space Inbound Associations 0 25 Outbound Associations 0 25 Jobs In View 1 Disk Space Remaining 86 592 1G6 686 3GB 12 6 Web Interface The Compass web interface provides a mechanism for monitoring your imaging workflow The main landing page is the Status page as pictured below It provides a high level overview of the Compass system Laurel bridse Compass Compass Service Overview Category Status Incoming Running 0 of 25 Outgoing Running 0 of 25 Disk 307 95 GB of 465 76 GB remaining 66 12 e Failed Jobs 1 failed jobs Destinations Name Enabled Schedulable Heartbeat Enabled Heartbeat Status e Default e d x N A test ssl HS HS x N A The Jobs and Details pages both require login Login can optionally be persisted Laurel Bridge Compass Log On Account Information User name Password Remember me Compass User Manua
21. 0 is the lowest priority If a job is populated with images that matched different rules containing different priorities the job is assigned the highest priority of the matching rules Jobs with a higher priority will be sent before jobs with a lower priority If a Destination has multiple jobs with the same priority the older job is processed first Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 24 7 Configuring a Job Action Job Actions can be configured by selecting Edit Options from the menu and then selecting the Job Actions pane Press the green plus button located under the Job Actions list This will create a new Job Action with the name New Job Action where is the next available number starting with 0 Job Action names are customizable and can be modified at any time by clicking on the name The list of Job Actions can be reordered by selecting a Job Action and pressing the Up and Down arrows The ordering of Job Actions in the list reflects their order of execution Once a Job Action has been created the next step is to configure its Trigger Type Destinations Code File and Parameters 7 1 Trigger The Trigger can be set to one of the following options e On Sent the action will be executed as jobs become marked as Sent e On Fail the action will be executed as jobs become marked as Failed e On Start the action will be executed each time a job enters the Running
22. 04 PAT124 SMITH JOSEPH ABC123 PAT45 MINER STEVEN Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 2314 amp gt Mapping List Mapping File C filesimappinglist txt Ei Delimiter Mo Match Action Match Tag Patient ID Tag 0010 0010 Patient s Name The Move action moves the tag from its original location to its final location Once moved the tag will not being present in its original location JE Fixel Representation sl Pisel Padding Value 57 The New UID action replaces the Unigue Identification UID value of the specified UID type tag in the Tag field with a new UID value A New UID Device UID r The Pad action pads the specified tag with the specified character The Left and Right radio buttons specify whether to pad the left or right side of the value The new total length of the tag value is specified by the Length field If the length of the original value is equal to or greater than the Length field the value will not be changed 9 Patient s Name r Char a Length 10 2 Left O Right The Prepend Append action prepends or appends the specified text to the specified tag s value Fe dt Om The Regex Substitution action performs a regular expression match on the specified tag s value using the given Pattern It then replaces the value with the Replace string which may contain regex variables from the match The Test box can be filled with an exa
23. 5 Laurel Bridge Software Inc All Rights Reserved v2 2 3 541 top of the page Clicking on the image preview will open a larger lightbox style preview of the image scaled to the current size of your browser window Laurel Bridge Compass The user accounts and their passwords for the web interface can be reset to their factory settings by following these steps 1 Stop the web UI by unchecking the Enabled checkbox for the Web Interface on the Options dialog Click Ok 2 Delete the following file C ProgramData Laurel Bridge Software Compass2 www App_Data CompassData sdf this is the location on Windows 7 Windows 8 Windows Server 2008 and Windows Server 2012 it might be in a different folder path 1f on another OS but the filename will be the same 3 Start the web UI by re checking the Enabled checkbox for the Web Interface on the Options dialog Click Ok Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 52 13 Custom Code Example using System using System Collections Generic using System Text using LaurelBridge DCS using LaurelBridge DCF using LaurelBridge Compass Core namespace Example public class CustomFilterAction IFilterAction public void ApplyAction CFGGroup config DicomSessionSettings dss RelevantTagMarker tagMarker ref DicomDataSet dds removes the private tag 0009 1010 dds removeElement AttributeTag Create 0009 1010
24. 6 AppendixC Enabling NET 3 5 on Windows ln 63 Appendix D Secure Communication with COMPASS csccccssscccesececeececeescecseeceeeeeceseeeeees 65 Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 L SUMMAN E 65 2 Communication Overview sssssseseesssssssossesesesssossesesesssecssseresssossesesesesrcsseereseeoreesereseseseeseres 65 Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 1 Compass Basics 1 1 Overview Compass acts as a store and forward router for DICOM images and can route from one or more Sources to one or more Destinations This process can be described in three phases First a Source or SCU initiates communication with Compass by issuing a C STORE request Compass accepts this request receives the DICOM image from the Source and filters the incoming information based upon any user defined Filters for incoming images Next Compass compares the image information against any user defined Rules and schedules the image to be sent to the Destination s or SCP s defined by any Rules that apply Finally the image is filtered and sent to the determined Destination s at the scheduled time s Sources Destinations Rules and Filters are discussed in further detail in Sections 3 3 3 4 3 5 and 3 6 Compass is comprised of two parts the Compass Service which runs as a Windows Service and the Compass user interface which is used to configur
25. Checking or unchecking the Is on LAN checkbox will optimize network buffer sizes for that particular network topology For both the Compass and Destination AE Title values can be set with a fixed value by selecting Fixed in their corresponding combo boxes Alternately the AE titles can fg A be set to either Source Calling or Host Default 9 SE e Source Called this will use the calling nestnaton ER E or called AE title from the inbound Gelee ae S association that created the job for this um Is Ee Destination In the rare case that an Port am E S Is on LAN Zeien outbound job s made up of images Tet C Treat Warnings as Success that came from different clients using neste St Ss en different AE titles the AE titles from J KEE the first images association will be au 2 used Schedule Normal edit PEG 20 Logging op Once values have been specified for eG Baseine Proce Ter es the Local AE Title the Remote AE eg 5 zeegt Title the Host IP and the Port then D the Test button can be clicked to issue x II eng a DICOM Verification request to the specified Destination A green check next to the Test button indicates a successful connection a red X indicates a connection could not be made or the connection was refused Hover the mouse pointer over the X to read
26. Laurel Bridge Compass User Manual LAUREL BRIDGE Providing DICOM Connectivity for the Medical Community Laurel Bridge Software Inc 302 453 0222 www laurelbridge com Document Version 2 2 3 Document Number LBDC 000062 020203 Last Saved 9 14 2015 8 52 00 AM Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 Table of Contents L ge un 8 72 E e 1 1 1 e acres are pet ses esac INERE stance ec aes E TERRREL E E A E E 1 2 MINS AVA FOU E 2 2 1 Upgrading to 2 2 x from a 2 1 x Version eeeneeseeesnnensneesnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnsnnnnnnnnnnsnsnnennnsssnnnnsnennnne 2 2 2 Recommended System Specification cccccssssecccccsssecccceeseeececsueeccessaueccesauaecessauaeeeesauaecessaaaeeeessaaeeeeees 2 Deo AEREE E E A E E EE A A EE AE E N EE A E E 2 2 4 Installing SOL Server 2008 R2 SP2 Express X64 ueneeeeennensnennnnnnonnnnnnnnennnnnnnnnnnnnnnnennennnnnnnnnnnnnnnnnnnennnnnnennnnnnnnnenn 3 2 Installing SQL Server 2012 Express x64 with Tools cccccccccsssecccceessecceceeeseccesaeeeecessauaescessaeeeecessagaeeeeees 4 2 6 Installing SQL Server 2014 Express x64 with Tools ccccsseccccsececceseccceeeceeseeececseascesseneceseuecesseaseessenseesees 4 2 Vue de CEET 5 3 e ele Started une ae ea 11 3 1 BR ee 11 I Ia e ae TUC N sere a are r E ee 11 A Cee A OU TT 13 4 1 BICONE GUCE ea E ee E E E E 14 4 2 HOG ee Dee EE 15 4 3 KI ER ele e 17 5 Creating a D st
27. Purge Delay SNS Hours Compass s capable of purging itself of Sent Failed and Hold jobs after a configurable amount of time Only Sent jobs older than the time threshold will be automatically purged by default The various Job Purge Delay controls specify how long to keep those types of jobs prior to removal Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 s g 9 5 Destination Heartbeat Sensing Each Destination defined in Compass has several ways of determining when jobs should be sent to nen peoo EE that Destination One way is to enable the Heartbeat Sensing feature on a given Destination Each Destination that has this feature enabled will send a DICOM Verification request to the Destination at the frequency specified 9 6 Web Interface Compass provides a web interface accessible via HTTP You can customize the port number on which the interface will be hosted as well as the hostnames by which it is reachable For example if the computer that Compass is installed on is named dicomrouter and the web interface is configured for port 10400 then you would add dicomrouter to the Hostnames list It would then be reachable with the URL http dicomrouter 10400 If you wanted to specify the fully qualified name of the computer and your domain is mycompany com you would add dicomrouter mycompany com to the hostnames list and the URL would be http dicomrouter mycompany com 10400 Do not
28. Select one of the following actions when re identifying a dataset to dictate how to handle the original SOP Instance UID e Restore Original UID Select this option to restore the original SOP Instance UID This option will not create a Referenced Image Sequence 0008 1140 e Create a New UID and Reference Original Select this option in order to create a new SOP Instance UID and create a Referenced Image Sequence 0008 1140 that references the original SOP Instance UID that was de identified e Create a New UID and Do Not Reference Original This option will create a new SOP Instance UID for the re identified dataset without creating a Referenced Image Sequence 0008 1140 8 5 1 Additional Notes Enable Logging This option enables logging for the re identification process Patient Identity Removed 0012 0062 Attribute Tag will be added to the re identified dataset in all cases including selecting Restore Original UID As per PS 3 15 Annex E Attribute Confidentiality Profile the following Attribute Tags are added when re identifying a given DICOM dataset unless restoring the original SOP Instance UID e Patient Identity Removed 0012 0062 Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 38 e Purpose of Referenced Code Sequence 0040 A170 e Referenced Image Sequence 0008 1140 8 6 Composer Action Examples The Composer action uses NET regular expressions to pars
29. Software Inc All Rights Reserved v2 2 3 63 Appendix C Enabling NET 3 5 on Windows 8 1 If you need to install NET 3 5 in order to install SQL server do the following Figure 1 Go to Programs and Features from the Windows Start Menu vr C t EN gt ControlPanel Programs Programs and Features wl Search Programs and Features b Control Panel Home e Uninstall or change a program View installed updates To uninstall a program select it from the list and then click Uninstall Change or Repair Turn Windows features on or att Organize v Name Publisher InstalledOn Size Version No programs are installed on this computer Currently installed programs Total size 0 bytes y p Ke f 0 programs installed A Figure 2 Click on Turn Windows Features on or off to open the Windows Features dialog Select NET Framework 3 5 includes NEI 2 0 and 3 0 Turn Windows features on or off To turn a feature on select its check box To turn a feature off clear its check box A filled box means that only part of the feature is turned on NET Framework 3 5 includes NET 2 0 and 3 0 I Windows Communication Foundation HTTP Activation 11 Windows Communication Foundation Non HTTP Activa OFF NET Framework 4 5 Advanced Services Active Directory Lightweight Directory Services a DM Hyper V 1 Internet Explorer 11 15 Internet Information Services Internet Information Services Hostable Web Core
30. a given UID to map to the same new UID across multiple instances of the De Identify Filter Action o Replace Replace the current DICOM attribute value with an appropriate replacement value based on the attribute s VR The replacement value is predetermined and is not configurable o UserDefined Replace the current attribute value with the given replacement string defined in the Value column o Default Replace the current DICOM attribute value with a user specified value For example specifying the default of M for Patient s Sex will set all instances of Patient s Sex to M by default o Delete Specifying this option will remove the given attribute from the de identified dataset If Delete is selected for a given attribute and the attribute is present in a sequence SQ that sequence will be removed from the de identified dataset e Value If UserDefined is selected as a replacement value action the string specified in the Value column will be used as a replacement value for the given attribute This value will appear as is Care should be taken when entering a value for non standard string VR types CS for instance e Delete Press the delete button in order to remove the given attribute from the list of attributes to de identify 8 4 2 Miscellaneous Settings These settings allow for finer grained control over common options needed during de identification e Anonymize Pixel Data
31. as making a routing decision based on SC Browse one or both of the AE titles Stabity Tme 6 50 IO alow any File Mask Under the Source heading settings include configuration D ope Path options for the remote AE Title the calling AE title the Path SEPET which should be monitored for DICOM instances this must be Enaties a locally mounted drive and not a network drive a Stability Pe Time which indicates how long to wait for the folder contents to become stable and a File Mask for restricting the hot folder to l ingest specifically named files There is also a checkbox that 1f checked moves non ingested files out of the hotfolder and into another user specified folder for later inspection Add RLE Lossless O Under the Transfer Syntaxes heading the list of transfer syntaxes that Compass will accept for the specified Hot Folder Source can be configured Add the desired Transfer Syntaxes to the list of accepted Transfer Syntaxes by selecting the desired Transfer Syntax in the combo box and adding it by pressing the provided button Compass will only ingest DICOM images that have a transfer syntax listed in the Enabled list Under the Advanced heading Filters can optionally be configured see below for the Source There is also a Logging feature which if set to On logs a descriptive report describing instances that failed to be ingested as well as in
32. be attempted to be sent this option is used only when Trigger is set to On Start Logging Logging Checking this box will log HL7 messages to the Compass application log file Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 28 3 Filters Filters allow an mage s header data to be changed as Compass receives it from a Source or as Compass sends it out to a Destination Actions are only applied f the Conditions are met A new Filter can be DA Edit Filters ethan d a Conditions Match All Match Any SZET created by selecting Edit DEE a Eeer AE DE 8 gt Options from the mm menu selecting a Source or Destination and then selecting the Filters edit link Press the green plus Actions C Use Original Attributes Sequence button located under the Change Case Patient s Name gt Upper Lower Filters list This will u ef create a new Filter with the name New Filter where is the next available number I TESS starting at 0 Filter names are customizable and can be modified at any time by clicking on the name The list of Filters may be reordered by selecting a Filter and then pressing the up or down arrows Filters are applied m order top to bottom so ordering is important Another way to create a new Filter is to copy from another Source or Destination Pressing the Copy From link in the upper right section
33. d be correct The named instance should be SQLExpress Allow it to install in the default location which should be C Program Files Microsoft SQL Server 8 On the Server Configuration screen the defaults should be fine for the Service Accounts tab and the Collation tab defaults 9 On the Database Engine Configuration screen on the Account Provisioning tab select Windows Authentication Mode The Current user who must have Administrative Privileges should be in the list under Specify SQL Server Administrators If it is not click the button to Add Current User Leave the defaults on the other two tabs a You must also add the NI AUTHORITY SYSTEM user Click the Add button and type System into the text box then click the Check Names button to add to the list and click OK You should now see NT AUTHORITY S YSTEM SYSTEM in the list of SQL Administrators Click the Next gt button 10 Installation should complete in several minutes A Sg 2 6 Installing SQL Server 2014 Express x64 with Tools These are instructions for installing SQL Server Express in its most basic configuration for use by Compass These instructions are valid for Windows 7 Windows 8 1 Windows Server 2008 R2 and Windows Server 2012 The installation procedure may differ if an older version of SQL Server is installed if the full version of SQL Server is preferred or if SQL Server authentication mode must be enabled 11 Log in to Windows as a use
34. e if one of the headers of the mapping file is R PATIENT_ID the PATIENT_ID can be used in the HL7 template When a row is matched in the Mapping DB the value of the PATIENT_ID column for that row will be returned Mapping DB The mapping DB contains matching values and replacement values that can be interpolated into the HL7 template message The mapping DB is created from a Tab delimited mapping file The first row of the file is the header Column names will determine whether a column is a matching column or a replacement column Matching columns shall be prefixed with M and shall have a value of a DICOM element with format gggg eeee Replacement columns shall be prefixed R The name of a replacement column is the variable name that shall be used in the HL7 message template For example here is a two line mapping file M 0010 0020 M 0008 0050 R PATIENI NAME PID1234 ACC5678 DOEXJOHN In this case the first column 1s Patient ID the second column is Accession Number Those are the match columns In order to have a match on the first row the incoming DICOM job must have a Patient ID of PID1234 and an Accession Number of ACC5678 The third column is the replacement column If the first two columns had a match then DOE JOHN would replace PATIENT_NAME in the HL7 template message No match action If there is no match in the Mapping DB for a given job e Continue Send the DICOM images even though no HL7 message will be
35. e Agreement Please take a moment to read the license agreement now IF you accept the terns below click 1 Agee then Mest Othenwise click Cancel READ THE FOLLOWING TERMS AND CONDITIONS CAREFULLY BEFORE INSTALLING OR OPENING THIS A PACKAGE INSTALLING OR OPENING THIS PACKAGE INDICATES YOUR ACCEPTANCE OF THESE TERMS EI AND CONDITIONS IF YOU DO NOT AGREE WITH THESE TERMS AND CONDITIONS PROMPTLY RETURN THIS PACKAGE UNOPENED TO YOUR SUPPLIER AND YOUR MONEY WILL BE REFUNDED 1 License In this license agreement License Agreement or Agreement you the purchaser of the license rights granted by this Agreement are referred to as Licensee or You In accordance with the terms and conditions of this License Agreement Laurel Bridge Software Inc Licensor grants Licensee the non exclusive license to use the accompanying software Software and documentation Documentation only in the country where acquired from an LBS supplier Supplier authorized to distribute Software to that country In this License A re eee thm Trafa rm A Tea zen rra menetet 1 ae ml Fst EFSER H FEI ELE wee Fi E ma i FLEP se eeteecereed Fri CI Do Mat Agree Agree Select the I Agree radio button and then press the Next gt button The user is then greeted with the Installation Location screen Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 vd Laurel Brid
36. e DICOM dataset s header data The current options and their descriptions are as follows e Do Nothing Leave the private tags as they are By default this option is selected e Remove All Remove all private tags from the DICOM dataset s header data This does not include any private tags added during the de identification process This removal is unidirectional and cannot be undone even during re identification e Encrypt All Remove all private tags from the DICOM dataset s header data This does not include any private tags added during the de identification process This option can only be enabled if Enable Re Identification is selected and a valid public certificate is provided Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 97 i 8 5 Re Identify Filter Action Re Identify Filte M Original SOP Instance UID Handling e Restore Original UID Create a New UID and Reference Original Create a New UID and Do Not Reference Original C Enable Logging The Re Identify Filter Action allows restoration of previously anonymized patient demographic information and pixel data for a given DICOM dataset The patient demographic information and pixel data restoration are only available as long as a valid private certificate and password is available This private certificate must pair with the public certificate used to de identify the original DICOM dataset
37. e an element s value and combine the parts into new elements 1 Swap two tags Swap the Patient s Name and the Patient ID to be in each other s place you would specify the following inputs Tag Input Pattern 0010 0010 0010 0020 The regexes shown here mean that the entire value should be one capturing group Then the outputs would look like this Tag Output Pattern 0010 0010 2 1 0010 0020 1 1 This results in the first pattern 1 1 from the first input tag 1 1 being put into the second output tag 0010 0020 and the first pattern 2 1 from the second input tag 2 1 being put into the first output tag 0010 0010 In this case the first pattern is also the entire value So if you started with John Doe and 1 2 3 4 5 in Name and ID respectively your result would be a Patient ID of John Doe and a Patient s Name of 1 2 3 4 5 2 Split one tag into two tags To take the Accession Number 0008 0050 and keep only the first 10 characters in it and put the rest of it into the Requested Procedure ID 0040 1001 In this case the regex for the input pattern has to specify how to split the Accession Number Tag Input Pattern 0008 0050 4 10 This regex means the first 10 characters will be the first capturing group and everything else will be the second capturing group Then the outputs would look like this Tag Output Pattern 0080 0050 1 1 0040 1001 1 2 Compass U
38. e for a non routed image this 1s indicated by selecting the checkbox Report errors for non routed images By deselecting this checkbox Compass will always report back to the Source that it received the image successfully This behavior is desirable in a situation when Compass should not forward all of the images sent to it by this particular Source For example if all Ultrasound images with a particular Referring Physician need to be sent from a PACS to another Destination but the PACS can only send all of its Ultrasound images and not simply a subset of them then by leaving the Report errors for non routed images checkbox unchecked and defining a Rule to match the Referring Physician only the desired images will be sent to the Destination Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 Under the Transfer Syntaxes heading the list of transfer syntaxes that Compass will accept for the specified DICOM Source can be configured Add the desired Transfer Syntaxes to the list of accepted Transfer Syntaxes by selecting the desired Transfer Syntax in the combo box and adding it by pressing the provided button After building up the l st with the desired Transfer Syntaxes place them in the desired order by selecting each one and moving it up and down in the list by pressing the up and down arrows The supported Transfer Syntax list 15 evaluated top to bottom when a Source presents its requested presentation context lis
39. e the Compass Service and monitor the jobs that Compass is aware of The Compass GUI does not need to be running in order for the Compass service to run accept process and send jobs Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 2 Installation 2 1 Upgrading to 2 2 x from a 2 1 x Version Compass 2 2 x s a 64 bit application It must be installed on a 64 bit version of a Windows operating system If you are upgrading from a 2 1 x version you must stop the Compass Service and uninstall Compass 2 1 x before running the 2 2 x Compass ms Your configuration files Compass DB and DICOM image files on disk will not be removed Upon installing Compass 2 2 x your Compass DB and configuration files will be upgraded automatically If you attempt to install Compass 2 2 x without uninstalling 2 1 x first the 2 2 x installer will fail You will have to remove 2 1 x before continuing If you currently have a support contract with Laurel Bridge Software then Compass can automatically upgrade your Compass license over the internet If you do not have internet access from your Compass server you will have to manually activate Compass from a different internet enabled computer See the section on Installing a License for more details IIS Express 7 5 had previously been installed by the Compass installer and will be uninstalled when Compass 2 1 x is uninstalled The IIS Express 8 0 x64 installer is included i
40. ection 8 4 3 Pixel Regions to Anonymize e Private Group The Private Group box specifies which group will be used during the de identification process In particular after De Identification this private group will hold the Encrypted Attribute Sequence containing the original data e Enable Logging Checking this option will enable logging for the de identification process 8 4 3 Pixel Regions to Anonymize This grid specifies which rectangles to anonymize in a DICOM dataset s pixel data 7FEO 0010 Each rectangle is defined by indicating the location of each side of the rectangle in relation to the original image specified in terms of a percentage For instance the example form shows two rectangles covering the entire top and bottom 10 percent of an image Clicking Configure allows the user to define an appropriate replacement pixel value for each type of supported photometric interpretation via the following dialog box Replacement Pixel Color MONOCHROME 1 128 MONOCHROME 2 0 R G B o p fp RGB The supported photometric interpretations for de identification are as follows e MONOCHROME 1 e MONOCHROME 2 e RGB All other photometric interpretations will cause an error unless Skip Unsupported Images 1s enabled Note that multi frame images are not supported for pixel data anonymization Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 36 8 4 4 One Way Anonymization
41. eges should be in the list under Specify SQL Server Administrators If it is not click the button to Add Current User Leave the defaults on the other two tabs On the Error Reporting screen click the Next gt button 10 Installation should complete in several minutes Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 2 5 Installing SOL Server 2012 Express x64 with Tools These are instructions for installing SQL Server Express in its most basic configuration for use by Compass These instructions are valid for Windows 7 Windows 8 1 Windows Server 2008 R2 and Windows Server 2012 The installation procedure may differ if an older version of SQL Server is installed if the full version of SQL Server is preferred or if SQL Server authentication mode must be enabled Log in to Windows as a user with administrative privileges Run the SQL Server 2012Express x64 with tools SQLEXPRWT_x64_ENU exe installer On the Setup screen select New installation or add features to an existing installation On the License Terms screen Accept the license click the Next gt button On the Product Updates screen choose whether to check for updates based on your corporate policy On the Feature Selection screen make sure all of the checkboxes are checked for all of the Instance Features Make sure that the Management Tools checkboxes are checked click the Next gt Button 7 On the Instance Configuration screen the defaults shoul
42. ely re architected to provide a highly productive programming experience based on the NET Framework ASP NET provides a robust infrastructure for building web applications Instali v2 2 3 69 Figure 7 Click the Next gt button to continue On the Confirm installation selections screen click the Install button to continue DESTINATION SERVER Confirm installation selections een Before You Begin To install the following roles role services or features on selected server click Install Installation Type _ Restart the destination server automatically if required rver Selection Optional features such as administration tools might be displayed on this page because they have been selected automatically If you do not want to install these optional features click Previous to clear their check boxes T rver Koles m mg ra eatures Web Server Role IIS NET Framework 4 5 Features ASP NET 4 5 Web Server IIS Management Tools Role Services IS Management Console Web Server Application Development ASP NET 3 5 ISAPI Extensions ISAPI Filters ma m l sz ll mi oe an ep Export configuration settings Specify an alternate source path Click the Close button after installation has completed Now you should be able to enable and access the Compass user interface You may need to adjust your firewall setting to allow HTTP access to the web port Compass User Manual 2015 Laurel Bridge
43. er that Compass will continually monitor for DICOM files ingesting and filtering them after reaching a configurable stability time Selecting Hot Folder Source will create a new Source with the name New Hotfolder Source where is the next available number starting at 0 Source names are customizable and can be modified at any time by clicking on the name Compass will delete the instances from the hot folder after they have been copied to Compass local instance repository Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 Please note that due to the nature of Immediate Mode Destinations and their requirement that all possible inbound presentation contexts be known at the start of ingest images ingested via a hot folder cannot be routed to an Immediate Mode Destination Any Immediate Mode Destinations that were matched via the rules will be skipped over and an error message will be written to Compass application log file Once a Hot Folder Source has been created the next step is to configure its settings 4 2 1 Settings Under the Compass heading the AE Title that Compass will Compass apply to images ingested from the specified hot folder 1s listed AE Title COMPASS Even though the instances aren t coming from an association Source kel Source Enabled Compass provides the ability to specify the AE titles on the hot Des AE Title HOTFOLDER folder for later use such
44. ew gt Source Destination Status Displays the status of each Source and Destination View gt Active Associations Displays a table containing the current inbound and outbound associations Help gt User Manual Opens the Compass user manual Help gt About Laurel Bridge Compass Displays an About dialog containing program and license information SS Laurel Bridge Compass 12 2 Tool Bar The Incoming components are available in the toolbar Pressing the Play button allows Compass to process incoming associations while pressing the Pause button will cause Compass to no longer listen for File Edit View He new incoming associations Pressing the Pause button does not affect currently connected associations as they are allowed to run to completion q Compass DICOM Rou Input Stopped The Outgoing components are available in the toolbar Pressing the Play button allows Compass to process outgoing jobs while Output Running pressing the Pause button will cause Compass to not start any new outgoing jobs Pressing the Pause button does not affect currently running outgoing jobs as they are allowed to run to completion Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 47 12 3 Jobs The jobs table provides a filterable view of all the jobs in Compass Each column is sortable and optionally displayed Any column header can be left clicked m order to sort by that co
45. ext description You must restart the Compass Service after creating or modifying your private dictionary Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 41 9 System Settings System settings can be configured by selecting Edit gt Options from the menu and then selecting the System pane Application Logs 91 Application Logs Directory C Documents and Settings jasc Browse Filename compass log X log Compass provides the ability to log a varying level of ge Wm e ae e ber of Files 10 information to its application log file The location name and wae D og verbosity Verbose r size of the log file are configurable The application log file is also implemented as a rolling log file meaning that when the log file reaches the specified maximum file size a new application log file with a new name will be created become the new application log The rolling log file name has an incrementing number in the filename which increments each time the log file rolls over to the new file It is also possible to configure how many of these rolling log files should be kept as well as the verbosity of the log data This is helpful for a variety of reasons such as being able to see in detail what is being communicated between Compass and other devices 9 2 Dicom Incoming Compass will begin listening for incoming associations at paar cor ETA
46. g to either upper case or lower case Gi change Case Patient s Name D Upper 2 Lower The Composer action supports the merging and splitting of elements It can also be used to manipulate DICOM sequence elements with ease It uses regular expressions to parse values from DICOM tags and combine the values into other DICOM tags For example it can take parts from two different tags and combine them to make a new value in a third tag Regular expressions are specified to parse each input tag and substitution patterns determine how the output tags are constructed Composer Input Elements Input Patterns Output Elements Output Patterns In the Input Elements table specify the tags and how the regular expressions should parse each value into groups the regular expressions go into the Input Patterns column The groups that are produced are specified in the Output Patterns column of the Output Elements table The first match in the first input element is referred to as 1 1 the second match in the first input element is 1 2 and the third match in the second input element would be 2 3 and so on The Output Elements specify what parts of the input elements to combine and how to combine them note that the parts can be used multiple times and also combine them with plain text The Copy action copies the tag specified in the From field to the tag specified in the To field
47. ge Compass 2 Select Installation Folder The installer will install Laurel Bridge Compass 2 to the following folder To install in this folder click Net To install to a different folder enter it below or click Browse Folder E S Program Files 86 Laurel Bridge Software Compasses Specify an installation location the default location is typically the best choice and then press the Next gt button The user is then greeted with an installation progress screen Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 is Laurel Bridge Compass 2 Installing Laurel Bridge Compass 2 Laurel Bridge Compass 2 Iz being installed Please walt After installation completes the user is then greeted with the Installation Complete screen Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 is Laurel Bridge Compass 2 Installation Complete Laurel Bridge Compass 2 has been successtully installed Click Close to esik Please use windows Update to check for any critical updates to the NET Framework Press Close to complete the installation The computer should be rebooted after installation Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 3 Getting Started 3 1 Overview In order to route DICOM images Compass must have at least one Source one Destination and one Rule defined A Source describes
48. gt Options from the menu and then selecting the Sources pane Press the green plus button located under the Sources list This will pop up a context menu with two choices DICOM Source and Hot Folder Source The list of Sources may be reordered by selecting a Source and then pressing the up or down arrows next to the green plus and red minus buttons Compass UserManual 2015 Laurel Bridge Software Inc All Rights Reseved 13 DICOM Source Hot Folder Source CO 4 1 DICOM Source A DICOM Source is any device that will C STORE DICOM instances to Compass via an association Selecting DICOM Source will create a new Source with the name New Source where s the next available number starting at 0 Source names are customizable and can be modified at any time by clicking on the name When an SCU requests an association with Compass the Sources list is processed from top to bottom and the first match found is used excluding Hot Folder Sources therefore the ordering of the Sources may be important if potentially more than one could match Once a DICOM Source has been created the next step is to configure its settings 4 1 1 Settings Under the Compass heading the AE Title that Compass will accept is listed The Allow Any checkbox can be selected to allow any value for that field For installations with a Compass Basic license the AE Title must be specified Under the Source heading settings include configurati
49. i nation RE 18 5 1 att 18 5 2 DESEINSL ION SELEINBS EE 19 5 3 Trans er Syntax EEE ee 19 5 4 JOBS EI E 20 3 Advanced EE dei 21 6 re 1 0 2202 Rule een ee 22 6 1 BON LION iets arisen eine ee een ee ee E 22 6 2 REIS AL de 23 6 3 RUE Eege CN 23 Ja EE EE EIERE 24 7 1 ar EE 24 6 DIESE AU ION E 24 7 3 EE 24 Compass User Manual 02015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 eo Cu EEN 28 8 1 Seite E 28 8 2 ACON CR 29 8 3 Beta geing seguen et EE 32 8 4 Bee dh FILA CTION EE ER 8 5 R ldentify Filter ACTION EE 37 8 6 Composer ACTION ent 38 GE d ug ge E 41 9 1 leet ele 41 9 2 DICOM IG ORIEN EE 41 9 3 DICOM Outgalne een eet arr aren se ee ee 42 9 4 REI Re TEE 42 9 5 Destination Heartbeat SENSING ageet eu 43 9 6 Eegen 43 10 ere 44 dk ebe EIERE 45 12 Userinterlsce BETA S series 46 E ENEE RTE 46 Zee TEE 46 UE EE 47 PAs ACUVSASSOCIA N Szav t a LK EOK A E 48 IS EBB s E E 49 IS e e E lee ACE E 49 13 een Bee une WE 52 14 C stom R le Condition Exam ple EE 53 15 Custom Job Ree ug E le 54 APDDENUDCA Compass FAL ME 55 1 How can a SOP class be added to the default list eessssssssssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 55 2 How do I configure Windows Server 2012 for Compass cccsssssecccceessecceceeeccecceeueececsuuasecessauaeeeessaaasess 55 Appendix B Enabling ASP NET Components on Windows Server 2012 5
50. ick the Check Names button to add to the list and click OK You should now see NT AUTHORITY SYSTEM SYSTEM in the list of SQL Administrators Click the Next gt button 20 Installation should complete in several minutes 2 7 Main Install After installing the prerequisites the Compass installer Compass msi can be run For machines with an older version installed this installer will upgrade any previous installation while maintaining any current configuration settings You must have Administrator privileges in order to install Compass correctly After launching the Compass installer by double clicking Compass msi the user is greeted with the Welcome screen Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 sl Laurel Bridge Compass 2 Welcome to the Laurel Bridge Compass 2 Setup Wizard The installer will guide you through the steps required to install Laurel Bridge Compass 2 on your computer WARNING This computer program i protected by copyright law and international treaties Unauthorized duplication or distribution of this program or any portion of it may result in severe civil or criminal penalties and will be prosecuted to the masimum extent possible under the law Press the Next gt button The user is then greeted with the License Agreement screen Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 ie Laurel Bridge Compass 2 Licens
51. ified that either all the conditions must apply to the image or that only one condition must apply to the image in order for the Rule to match Another option is that the Rule always matches effectively declaring it to have no Conditions Selecting one of three radio buttons If ALL Conditions Match If ANY Conditions Match and Always will implement one of these three scenarios Send to Selected Destinations e IF ALL Conditions Match C IF ANY Conditions Match C Always The Dicom Tag condition allows incoming images to be selected for this Rule based upon their Dicom Element Tags Dicom Tag x Patient s Name Equals DOE J The Association condition allows incoming images to be selected for this Rule based upon their incoming Dicom Association information a E Association CallingAE Equals StoreSCU The Execute condition allows incoming images to be selected for this Rule based upon a custom user defined rule condition See the example towards the end of this user manual for an example of a custom rule condition implementation ea 6 Code File Crcode PatNameLetterCountIsEven cs ES Configure the condition based upon the desired test Conditions may be added or removed by pressing the green plus sign or the red minus s gn located to the left of each condition Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 SE 6 2 Rule Actions If all
52. ing copy of Compass one should select the Enable TLS option under the DICOM Incoming section of the DICOM System pane additionally one must configure the TLS options on this pane as described n Section 5 5 Advanced Settings of this manual 2 Communication Overview Each DICOM server that Compass connects to called a Destination in Compass terminology may be optionally configured to require TLS When TLS is enabled on a Destination Compass will use the TLS mechanisms to request the server s certificate when it makes a connection to the Destination and then authenticate and encrypt communications accordingly Compass may be optionally configured to accept self signed certificates from the Destination or to ignore certain certificate name mismatch errors normally for maximum security we recommend that these be left unchecked Compass may also be configured to support incoming encrypted connections from a client a Compass Source To properly configure incoming TLS connections on the DICOM System pane the Listen Port TLS Certificate path and certificate Password must be set The Listen Port default is port 2762 as recommended by the standard it 1s the port on which Compass will receive TLS encrypted communications e g DICOM associations The TLS Certificate path should be set to the file system location of the certificate that Compass should present for identification to clients It is suggested that the certificate be a standard PKCS 12
53. kbox allows Compass to treat a job as successfully _ sent even if one of the Dimse response statuses specified a E warning instead of success Checking the Allow Skip Instances COC EN a ooo checkbox will cause Compass to skip over images for which there e was no accepted presentation context d and still send the wor Cancel remaining images Checking the Continue On Error checkbox will cause Compass to continue sending the remaining images in a job even 1f an error status is received for an image If either the Allow Skip Instances or Continue on Error setting is checked a job that completes with at least one successfully sent image will have its job state set to Sent with a description of the image errors in the jobs table Message column More detailed information is available in the Job Report Checking the Heartbeat Sensing Enabled checkbox will cause Compass to verify that the Destination is available prior to attempting to send jobs to it If the Destination is unavailable Compass will queue up the jobs for the Destination without attempting to send them If and when the Destination becomes available Compass will begin sending the queued jobs Compass issues a DICOM Verification request and inspects the reply or lack thereof to determine 1f the Destination s available EA Edit Schedule Default 12am 4am 8am 12pm 4pm 8pm 12am 1 1 H H I 1 UH HS EEREN EBBE DE 5 5 Advanced Settings
54. l 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 50 The Jobs page provides a view of the current list of Compass jobs The table supports both filtering and sorting Log Off Laurel Bridge Compass Jobs Destination State Created Name Patient Id Accession Study Date Modalities Images Hold Queue 05 03 2012 09 05 3CTOPCON FA 126 050906 126 08 05 2005 XC Hold Queue 05 03 2012 09 05 3CTOPCON COLOR3 135 050906 135 0712612005 XC 05 03 2012 09 05 3 TOPCON COLOR 124 050906 124 09 24 2002 XC 05 03 2012 09 05 4 CCari Zeiss Meditec S 123456 05 03 2012 09 05 37Carl Zeiss Meditec v 12345 05 03 2012 09 05 31Canon Medical Syste000 18 6101 GMRC 77 05 03 2012 09 05 4CCarl Zeiss Meditec S 123456 05 03 2012 09 05 42CARL ZEISS MEDITI5150 ACCES 001 05 16 2003 OT 05 03 2012 09 05 37Carl Zeiss Meditec v 12345 11 22 2004 XC 05 03 2012 09 05 22 Digital Healthcare iP000 10 3663 GMRC 79 09 08 2005 FS VLIOT 05 03 2012 09 05 37Carl Zeiss Meditec v 12345 08 05 2005 XC 05 03 2012 09 05 42CARL ZEISS MEDITE5150 ACCES 02 05 16 2003 OT 05 03 2012 09 05 3CTOPCON SLIT 123 050906 123 08 11 2005 XC 05 03 2012 09 05 4CCarl Zeiss Meditec 123456 08 08 2005 OT 05 03 2012 09 05 22Digital Healthcare iP GMRC 109 09 08 2005 FS OP 05 03 2012 09 05 3CTOPCON COLOR2 130 050906 130 07 29 2005 XC 05 03 2012 09 05 3CTOPCON FA3 147 050906 147 06 28 2005 XC 05 03 2012 09 45 1CBALLER ca8210cb A43830309670 06 12 2007 CT 05 03 2012 09 05 3 Carl Zeiss Meditec v
55. l Billl201305081047IIIIIIIII STAFFID LASTNAME FIRSTNAME IIH 44420 130508 104744RII11433 10 Carotid artery stenosis Variables that can be interpolated TIMESTAMP yyyyMMddHHmmss A timestamp that can be inserted into the outbound HL7 message GUIDO A unique identifier that can be used as the Message Id in an HL7 message DCM 0010 0010 A DICOM element taken from the first DICOM image in the job In this case 0010 0010 the Patient s Name will be returned REGEX 0010 0010 ZC Su A C style regular expression that will be applied to the specified DICOM element from the first image in the job Note that there is a space after the tag number 0010 0010 in this example and the actual regular expression This space must be present Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 26 This example will return the first name from the Patients Name 0010 0010 DICOM element USERDAT A user data key Every job maintains a set of key value pairs As a job is processed by job actions and filters custom code can add to and access these key value pairs For example an Execute job action may add a key accession number with a value of ACC1234 via custom code A subsequent HL7 Send action may use USERDATA accession number to interpolate the value ACC1234 in its place Any column header from the HL7 Mapping file used to create the Mapping DB can be used For exampl
56. lumn Additionally any column header can be r ght view All Jobs clicked on in order to confi gure which columns Patient Name Patient Id Accession Study Date Modalities Images Destination State smith Joe 73ch3c50 ABAEIAFAS1 6446 1E of23 2007 US 6 Cardia PACS Oueued are displayed The View H r Carlson Sally fFdd 7cde 9855970278078608 anofeoo7 CT 200 Hold Queue Hold control allows the user to DOE JOHN 13992c5f Ab344 S4BC 799544 DZ 2002 MR 1 Hold Queue Hold display only jobs matching the defined criteria For example the Jobs table can be configured to only display patient names that contain Carl and have study dates before Apr l 14 SES EES o LE 2009 see pictur e Any configur ed filter CarlsonSalky f d 7cde 9856970C78078608 9 10 2007 CT 200 can be saved via the Save Current Filter button and assigned a name for easy retrieval at a later time View All Jobs where Patient Name contains Carl and Study Date 7 15 2009 The jobs table also provides the ability to perform certain actions on selected jobs A single job can be selected simply by left clicking on the particular job row To select a contiguous group of jobs the user can left click a particular job and then left click another job while holding down the Shift key To select individual jobs the user can left click the desired jobs while holding down the Ctrl key After selecting the desired jobs the user can right click to display the list of releva
57. mple tag value and clicking the green arrow processes the test data o SS ee The Remove action removes the specified tag If the Only if empty checkbox is checked the tag will be removed only if the specified tag s value is empty Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 32 eS Pixel Representation el Only IF Empty The Trim action removes the specified characters from the left right or both sides of the specified tag s value ete D Lat O Ri 8 3 Original Attribute Sequence The original tag value of a filtered tag can optionally be stored in the original attribute sequence by checking the Create Original Attribute Sequence checkbox If left unchecked the original values modified by the filter will not be recorded in the original attribute sequence kl Create Original Attribute Sequence Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 33 8 4 De Identify Filter Action F Dicom Attribute Tags To Anonymize IV Anonymize Pixel Data JW Enable Re Identification Retain Date and Time Information Skip Unsupported Images The De Identify Filter Action provides a mechanism to remove and replace certain attributes within a DICOM dataset that may lead to patient identification 8 4 1 DICOM Attribute Tags to Anonymize By default this list is populated with attributes suggested in PS 3 15 Annex E Attribute Confidentiali
58. n the status of the license including when it expires can be found on this dialog available at any time by clicking Help gt About Laurel Bridge Compass Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 LAUREL BRIDGE Compass Compass vw 2 149 Compass is up to date 2008 2014 Laurel Bridge Software Inc Powered by LBS DICOM Connectivity Framework DCF v 3 3 48c 2000 2014 Laurel Bridge Software Inc License Info Activate License Install License 3 2 1 Installing a license file Clicking the Install License button will open a file searcher dialog allowing you to browse to a fully activated license file You will use this button to install a license if a fully activated license was provided to you via email for example a MAC based license or you downloaded from www laurelbridge com or you performed a web activation 3 2 2 Activating a license over the internet Clicking the Activate License button will open the License Activation form You will need to provide a 16 digit Product Serial Number to activate your license if you are upgrading from a Compass 2 1 x version and please see below for instructions on how to obtain your Product Serial Number All fields on the form must be filled out If the Compass server does not have internet access you will need the 16 digit Activation Request Code ARC from the License Activation Form You can proceed to https www lau
59. n your Compass download zip file See the Prerequisites section below 2 2 Recommended System Specification Intel 15 4GB RAM 500GB HD 7200 RPM Windows 7 Windows 8 1 Windows Server 2008 R2 or Windows Server 2012 R2 SQL Server 2008 R2 x64 SQL Server 2012 x64 or SQL Server 2014 x64 Express edition may be used in most installations The full version must be used for failover cluster configurations 2 3 Prerequisites Laurel Bridge Compass utilizes several components known as prerequisites that must be installed for the application to work The following prerequisites must be installed prior to installing Compass Microsoft NET Framework 3 5 SP1 Microsoft NET Framework 4 0 Microsoft SQL Server Microsoft SQL Management Studio IIS Express 8 0 x64 is an optional prerequisite and can be installed before or after Compass installation The IIS Express installer is included in the Compass zip file You must install IIS Express 8 0 x64 in order to use Compass web features See Annex B for additional information on configuring Windows to use Compass web features Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 If Compass s being installed as part of a Windows cluster the Windows Server 2008 R2 operating system must be installed and the following prerequisites must be installed prior to installing Compass Microsoft NET Framework 3 5 SP1 Microsoft NET Framework 4 0 Microsoft SQL Server
60. ne this file is located at C ProgramData Laurel Bridge Software Compass2 www App_ Data It is also recommended that the interface only be accessible on your LAN or VPN This will be controlled by your internal firewall IP routing mechanisms and is beyond the scope of this document The user interface can display patient health information when accessed Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 44 10 Notifications Job Notifications Reports can be configured by selecting Edit gt Options from the menu and then selecting the Notifications pane Failed Jobs Frequency minutes E ei Long Running Jobs Threshold minutes E 0 Heartbeat fails and reconnects Notifications can be sent for job failures long running jobs Enak chien jobs that take too long to send and or low disk space If the Failed Jobs Frequency checkbox is checked Compass will send an email detailing the failed jobs to the Notification Recipients at the specified frequency The job information contained in the emails can be configured with the Email Columns chooser Low Disk Space Notifications Enabled If the Long Running Jobs Threshold checkbox is checked Compass will send an email detailing the long running jobs to the notification recipients Only jobs that have been n the Running state longer than the specified threshold fall into th s status If
61. nt actions Possible choices are Details Keep and Send To Remove and Send To Retry Retry To Hold Send Cancel Set Priority Copy Job Images To View Job Report and MINER STEP Date 9 26 1997 Instance List Tag Name Value 0222 2028 Group Length 162 02002 0801 File Meta Information VM 2 Length 2 99002 0002 Media Storage SOP Cla 1 2 840 10008 5 1 4 1 1 4 0222 0883 Media Storage SOP Ins 5 6 7 1 2 3 0282 0218 Transfer Syntax UID 1 2 848 10008 1 2 09002 0812 Implementation Class UID 1 2 848 114889 1 0 0 3 3 24 90002 0013 Implementation Versio DCF 3 3 24c 90002 0016 Source Application En DCF 09003 0000 Group Length 396 2008 2828 Image Type ORIGINAL PRIMARY 9993 8016 SOP Class UID 1 2 348 10883 5 1 4 1 1 4 9993 8818 SOP Instance UID 5 6 7 1 2 3 9993 8028 Study Date 19978926 e028 2021 Series Date 19978926 Window 799 Level 432 0828 8823 Content Date 19978926 File Details 9993 88328 Study Time 154322 0 Transfer Syntax Implicit VR Little Endian Size 130 10 KB Show In Explorer 09203 0831 Series Time 155107 0 0888 8833 Content Time 155712 0 Details View Remove Note that if Retry or Retry To are selected it will not cause the Failover Destination Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 48 mechanism to kick n for the specified Destination since the number of attempts for the job has exceeded the Ma
62. of the Filter Editor allows you to copy individual Filters defined in the other Sources and Destinations There is also an option to copy all the Filters from a specific Source or Destination by selecting the menu item named All listed below the defined Filters If a Filter already exists with the same name when copying a Filter the new Filter will have an asterisk appended to its name Once a Filter has been created the next step is to configure its Conditions and Actions 1 Conditions A Filter s Conditions determine whether or not its Actions will be applied to the image being processed A Filter may have multiple conditions therefore an option is provided that all Conditions must match or any Conditions can match in order for the Filter to be applied Another configuration is to have no Conditions thereby always matching Conditions Ge Match All CH Match Amy For each Condition select the Dicom Tag condition type additional types may be added in the future Configure the rest of the Condition based upon the desired test Conditions may be removed by pressing the red minus sign located to the left of each condition and sorted via the up and down arrow buttons Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 29 8 2 Actions If the Conditions testing was satisfied then any defined Actions will be applied to the image The Change Case action changes the case of the selected ta
63. ombined with plain text 8 6 1 Working with DICOM sequences A sequence may be entered as a tag by appending it to a numeric tag the traditional group element pair with a period You may also indicate an item in the sequence with and the sequence item ID followed by the tag indicating the sequence There may be multiple sequences and sequence IDs as part of one tag Examples are shown below e Simple tag 0010 0010 e Tag within sequence 0080 0100 0008 0060 e Tag within specific sequence item 0080 0100 0 0008 0060 e Tag within nested sequence with sequence items 0080 0100 1 0080 0100 0 0008 0060 If no item number is specified the first item 0 is assumed Specify the last element in a sequence by HL upper case is important if the number of sequence items is unknown Specify the next item in Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 40 the sequence via HN again case is important to append to the sequence For example 0080 0100 L 0010 0010 N 0008 0060 Please notice that e The sequence IDs e g 1 and the tag value pairs for the sequences are all separated by periods e The tags for the sequences are simple group element pairs themselves 8 6 2 Modifying private tags Private DICOM elements can be modified using the Composer Filter Action But first you must add a private data dictionary to Compass so Compass can know
64. on options for the remote AE Title AE title of the client the game e SE remote Host IP the Enabled status of the Source an option to SE limit the number of concurrent associations and the type of fal Source Enabled responses that are sent back to the Source for non routed AE Title H Allow Any images The Allow Any checkbox following the AE Title and ger Ca Max Simultaneous 1 Host IP can be selected to allow any value for that field For installations with a Compass Basic license the AE Title must be specified Select the Source Enabled checkbox to enable wi Report errors for non routed images Send email for accepted associations the specified Source deselect it to temporarily refuse any Transfer Syntaxes SE l es nabled i connections from the specified Source To limit the number i hg of concurrent associations allowed by this Source check the ege e e P F Max Simultaneous checkbox and specify the desired number se zen TT JPEG Lossless Non Hierarchical Process D JPEG Baseline Process 1 JPEG Extended Process 2 amp 4 The type of response from Compass that will be sent to the miafe Lossy Near Lossless i Source for non routed images can also be configured Images en e fail to get routed to a Destination 1f they don t match any of 7 Favor Source s Transfer Syntax the defined Rules Compass default behavior is to report an error back to the Sourc
65. ons Cardio PACS Long Term Storage 5 Creating a Destination A new Destination can be created by selecting Edit gt Options from the menu and then selecting the Destinations pane Press the green plus button located under the Destinations list This will create a new Destination with the name New Destination where is the next available number starting at 0 Destination names are customizable and can be modified at any time by clicking on the name The list of Destinations may be reordered by selecting a Destination and then pressing the up or down arrows directly below the Destinations list Unlike Sources there is no priority associated with Destination ordering it is merely provided as a convenience 9091 Once a Destination has been created the next step is to configure its settings 5 1 Compass Settings Under the Compass heading settings include configuration options for the AE Title Application Entity and Hosi IP Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 5 2 Destination Settings Under the Destination heading settings include options for the AE Title the Host IP the Port number a Test button for testing the connection an Is on LAN checkbox and the enabled status of the Destination Selecting the Destination Enabled checkbox will allow jobs to be sent to the specified Destination deselect it to temporarily stop sending jobs to the specified Destination
66. put the protocol portion of the address e g http in the Hostnames list There are three types of accounts for the web interface Admin accounts User accounts and ViewOnly accounts Admin and User accounts are allowed to affect existing jobs Only Admin accounts can create and remove users The default Admin username for the web interface is Administrator and the password is LaurelBridge It is recommended that you change the default password after successfully logging in Since the Admin role allows modification of any user account it is recommended that you only give access to your users as either User or ViewOnly accounts The default ViewOnly username for the web interface is compass and the password is password It is recommended that you change the default password after successfully logging in You should create ViewOnly users for anyone that is allowed to view compass jobs and any associated patient health information but not modify them There are no default User accounts It 1s recommended that you create User level accounts for anyone authorized to affect changes on Compass jobs and view patient health information Users who are running Compass in a clustered environment will currently need to make any account changes on both nodes in the cluster This can be done by copying the Compass sdf file between nodes On a typical machi
67. r such as a temporary network failure The Enable TLS checkbox specifies whether the Destination requires TLS Use the Ignore Certificate Name Mismatch Errors and Allow Self Signed Certificates checkboxes to relax the Compass certificate validation of the Destination Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 29 6 Creating a Rule A new Rule can be created by selecting Edit gt Options from the menu and then we selecting the Rules pane Press the green plus button located under the Rules ien 78 list This will create a new Rule with the name New Rule where is the next available number starting at 0 Rule names are customizable and can be Deut o modified at any time by clicking on the name The list of Rules may be reordered by selecting a Rule and then pressing the up or down arrows directly to the right of the Rules list When Compass processes the list of Rules for each received image the Rules list 15 processed from top to bottom and the first match found is used therefore the ordering of the Rules may be important f potentially more than one could match Once a Rule has been created the next step is to configure its Conditions Selected Destinations and Rule Options 6 1 Conditions A Rule s Conditions determine whether or not its Actions will be applied to an image being processed A Rule may have multiple conditions in which case it may be spec
68. r with administrative privileges 12 Run the SQL Server 2014Express x64 with tools SQLEXPRWT_x64_ENU exe installer 13 On the Setup screen select New installation or add features to an existing installation 14 On the License Terms screen Accept the license click the Next gt button Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 15 On the Microsoft Update screen choose whether to check for updates based on your corporate policy 16 On the Feature Selection screen make sure all of the checkboxes are checked for all of the Instance Features Make sure that the Management Tools checkboxes are checked click the Next gt Button 17 On the Instance Configuration screen the defaults should be correct The named instance should be SQLExpress Allow it to install in the default location which should be C Program Files Microsoft SQL Server 18 On the Server Configuration screen the defaults should be fine for the Service Accounts tab and the Collation tab defaults 19 On the Database Engine Configuration screen on the Account Provisioning tab select Windows Authentication Mode The Current user who must have Administrative Privileges should be in the list under Specify SQL Server Administrators If it 15 not click the button to Add Current User Leave the defaults on the other two tabs a You must also add the NT AUTHORITY SYSTEM user Click the Add button and type System into the text box then cl
69. relbridge com product_activation php and enter your 16 digit Product Serial Number and the 16 digit Activation Request Code ARC After completing the steps on the web activation form you can download a fully activated Compass license You can then use the Instal License button on the About Compass dialog to install your activated license Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 License Activation Product amp Name Compass Ver 221 1 Product S N 1234 ABCD 1234 ABCD ARC AC8 898C 6371 7237 S i MAC 100 05 94 3C 7A 00 User i Site MySite z i Email support laurelbridge com 24 Host Name Compass Server Maintenance Contact IT Manager tt amp Email ltmanager myhospitalcom S i Phone Lookup Activate i If you are upgrading from Compass 2 1 x version and you previously had a MAC based license Compass will attempt to connect to the Laurel Bridge license server and find your 16 digit Product Serial Number If t cannot reach the server you will be presented with an error message describing which fields need to be entered on the https www laurelbridge com product_activation php to activate your license If you only have a MAC address you will need a valid login to www laurelbridge com to proceed If you need assistance please email support laurelbridge com Sources 4 Creating a Source A new Source can be created by selecting Edit
70. rivate key Finally the Password must be set to the password for the private key in the certificate Using a certificate format that does not password protect the private key allows this setting to be ignored Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 42 The Store SOP classes accepted by WL Eis Supporten SOP Classes b p SOP Class UID Name Compass are configurable via the Su pported SOP Classes table To add 1 2 840 10008 5 1 4 1 1 1 1 Digital X Ray Image Storage For Presentation S 1 2 840 10008 5 1 4 1 1 1 1 1 Digital X Ray Image Storage For Processing supp ort for a new S OP clas s enter its UID 1 2 840 10008 5 1 4 1 1 1 2 Digital Mammography X Ray Image Storage For Presenta 1 2 840 10008 5 1 4 1 1 1 2 1 Digital Mammography X Ray Image Storage For Processing In the U D text field Its name In the Nam e 1 2 840 10008 5 1 4 1 1 1 3 Digital Intra oral X Ray Image Storage For Presentation text field and pres S the green plus button 1 2 840 10008 5 1 4 1 1 1 3 1 Digital Intra oral X Ray Image Storage For Processing UID Name To remove support for a particular SOP class simply select the desired SOP class right click for the context menu and choose the Remove Selected menu item Itis also possible to press the Delete key to remove the selected SOP class es To select a contiguous group of SOP classes for removal select a SOP clas
71. s by left clicking t w th the mouse and then select another SOP class while holding down the Shift key To select a non contiguous group of SOP classes for removal select each individual SOP class while holding down the Ctrl key Alternately typing Ctrl A will select all of the SOP classes in the table Cancel 9 3 Dicom Outgoing The maximum number of concurrent i Dicom Outgoing associations that Compass will use to connect Y Enabled at Startup to Destinations can be specified using the Max Max Connections Connections chooser This is the absolute maximum number of outgoing concurrent connections if a Destination has its individual maximum connections specified higher than this number then this number takes precedence Compass will enable outgoing jobs at launch if the Enabled at Startup checkbox is selected 9 4 Data Storage Compass provides the ability to specify the storage location for images A different path may be specified from the default by typing in a new location or selecting it from the folder browser Note that the newly specified directory must already exist and Input and Output must be EE p Path C ProgramData Laurel Bridge Software Co Browse stopped in order to change the location Compass Bei ge wl Sent Job Purge Delay 72 Hour will copy any existing images from the old storage ais CT Failed Job Purge Delay El Hours location to the new location ES 3 e Cl Hold Job
72. sent e Fail The job will have a status of Failed and not send the images e Retry This will check the Mapping DB again in case it was updated e Change Destination Target the job to a different destination which may have a different job action with a different Mapping DB associated with it Reuse HL7 Connection If true hold open the HL7 connection after the first HL7 message is sent The connection will remain open until the job action is reconfigured the DICOM Output is stopped on the Compass Client or the remote host receiving HL7 closes the connection Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 27 HL7 ACK Wait For ACK If checked the job action will wat for an HL7 ACK message Failon AR or AE This only applies if waiting for ACK messages If checked then receiving an AR or AE acknowledgment code will be considered a failure ACK Timeout s Number of seconds to wait for the receipt of an ACK On HL7 Message Send Success Skip Resending HL7 Message on DICOM Job Retry If checked if the HL7 message is successfully sent it will not be retried if the job is retried due to failures sending the DICOM images in the job DICOM Delay s The number of seconds to wait before sending the DICOM job after sending the HL7 message Mark Job Including DICOM images as Sent If checked mark the entire job as Sent on successfully sending the configured HL7 message No DICOM images will
73. ser Manual 02015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 39 This means that the first capturing group the first 10 characters will go into the Accession Number everything else from the Accession Number will go into the Requested Procedure ID If the initial Accession Number was ABCDEF1234567890 then you would have ABCDEF1234 as the Accession Number and 567890 as the Requested Procedure ID Note that the output tag does not necessarily have to be parsed as an input 3 Combine two tags To take parts of the Accession Number and parts of the Requested Procedure ID and mix and match them Tag Input Pattern 0008 0050 10 0040 1001 lot 4 These regular expressions mean to split the first tag into two capturing groups the first one having 10 characters and the second one having whatever is left and to split the second tag into two capturing groups one of the first 6 characters and the second of the following 4 characters Then the outputs might look like this Tag Output Pattern 0080 0050 1 1 2 2 2 1 0040 1001 2 1 1 2 If the initial Accession Number was ABCDEF 1234567890 and the initial Requested Procedure ID was 1 2 3 4 5 6 7 8 9 0 then the resulting Accession Number would be ABCDEF1234 4 5 1 2 3 the resulting Requested Procedure ID would be 1 2 3 567890 Note that the patterns can be used multiple times and also c
74. ser specified stable time specified in seconds has been reached If unchecked outgoing jobs will only contain images from the same study that were received in the same association The Max Simultaneous checkbox allows the number of concurrent associations to the specified Destination to be limited to the specified value The Initial Delay setting will delay jobs to this Destination by the specified number of minutes The Max Attempts checkbox defines the maximum number of send attempts If unchecked the job will retry indefinitely The Retry Delay will cause an unsuccessful job to be retried after the specified number of minutes The Failover Destination setting allows a copy of the original job to be sent to the specified failover destination if specified once the original job has reached its Max Attempts without succeeding Note that it 15 possible to configure an infinite loop of failover jobs as Compass does not attempt to restrict the failover configuration Checking the Ignore Association Teardown Errors checkbox will result in the job being successfully sent if Compass receives all successful DIMSE responses from the Destination even if the association is not properly released This functionality 1s occasionally necessary Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 21 because some store servers do not properly respond to an association release reguest Checking the Treat Warnings as Success chec
75. stances that were successfully ingested The Settings dialog specifies the configuration of the Source s Activity Threshold which affects the Status column on the Source Destination Status dialog When sending an outbound job the IP address Compass will use can be specified by the Source via the Outbound IP combo box if and only if the Destination that the job is targeted for has its Host IP combo box set to Default There is also a checkbox labeled Send email on ingest failure If this 1s checked an email will be sent to the notification recipients listed on the Notifications tab if a file fails to be ingested successfully Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 4 3 Filters for Sourc Filters can be created for any Source The list of Filter names may be reordered by selecting a Filter and then pressing the up or down arrows Filters in the list will be applied in order from top to bottom so ordering is important See the top level chapter on Filters for a more in depth 17 es 4 Edit Filters Default Conditions Match ll Match Any UpperCasePatientJoe Dicom Tag Patient s Name 4 T change Case Patient s Name a description of filtering capabilities Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved Upper Lower v2 2 3 Destinati
76. t If the Favor Source s Transfer Syntax checkbox is checked then the Transfer Syntax list ordering proposed by the Source will be given priority otherwise the list as specified in Compass will be given priority Under the Storage Commit heading a Source can Sere optionally enable Storage Commitment If the Enabled I Enabled checkbox is checked Compass will accept all store commit requests for the given Compass Source Compass will E SE re respond with an accept response to the specified Host IP and Port using the specified Compass AE Title and Remote GE Port 104 Es Compass AE Title COMPASSSC AE Title Ea Under the Advanced heading a user can give more in depth CE control over how a Source communicates with Compass Data Geer handling options DIMSE settings PDU settings and socket E reso settings are all areas which can be configured in finer detail Eu when editing the Settings options Verbose DICOM logging Ka rae Fa can be turned on or off on a per Source basis by selecting On Zeien u E or Off in the Logging combo box When sending an outbound ee ton tis sores Afees be job the IP address Compass will use can be specified by the aja Source via the Outbound IP combo box 1f and only 1f the Destination that the job is targeted for has its Host IP combo box set to Default 4 2 Hot Folder Source A Hot Folder Source is a Windows filesystem fold
77. the VR Value Representation and VM Value Multiplicity of the private tags In the C ProgramData Laurel Bridge Software Compass2 directory create a new directory called dicom In that directory create a file called ext_data_dictionary The ext_data_dictionary file must not have an extension Its full pathname should be C ProgramData Laurel Bridge Software Compass2 dicom ext_data_dictionary The contents of the file shall look like this ge The following is an example extended data dictionary file If this file is named ext data dictionary elements 0029 1020 CS 1 Example Private Attribute 1 0039 1020 US 1 Another Example Private Attribute 2 0049 1001 DS 1 Private DS attribute 3 0049 1002 UL 1 Private UL attribute 4 0049 1003 SL 1 Private SL attribute 5 0049 1004 UI 1 Private Ul attribute 6 A line beginning with a pound sign is a comment The line elements must be present and can exist only once in the file All other lines define private DICOM elements and should be specified in the format gggg eeee where gggg is the group number and eeee is the element number followed by an equals sign followed by three comma delimited fields VR VM and the long text description For example to add private tag 0029 1020 to the data dictionary with a VR of CS and a VM of 1 the ext_data_dictionary file should have the following line added under the elements line 0029 1020 CS 1 Example private attribute t
78. the left hand column of the Add Roles and Features Wizard called Web Server Role IIS Select the Role Services sub menu Scroll down until you reach a check box for Application Development Check the box next to Application Development Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 59 Under Application Development check the box next to ASP NET 3 5 E LE DESTINATION SERVER WIN FJI9T883P364 Select role services Before You Beain Select the role services to install for Web Server IIS Installation Type Role services Description Server Selection ASP NET provides a server side object oriented programming environment for building Web sites and Web applications using C Windows Authentication A Application Development Features NET Extensibility 3 5 Server Roles Web Server Role 115 Confirmation C NET Extensibility 4 5 C Application Initialization C ASP managed code ASP NET is not simply a new version of ASP Having been entirely re architected to provide a highly productive programming experience based on the NET Framework ASP NET L ASP NET 4 5 provides a robust infrastructure for L cal building web applications ISAPI Extensions ISAPI Filters C Server Side Includes L WebSocket Protocol a FTP Server TH mmm Install Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 60 Add fea
79. tures that are reguired for ASP NET 3 5 You cannot install ASP NET 3 5 unless the following role services or features are also installed 4 NEI Framework 4 5 Features ASP NET 4 5 4 Web Server IIS 4 Web Server 4 Application Development ISAPI Filters ISAPI Extensions NET Extensibility 3 5 Include management tools if applicable Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved Figure 5 This will present a dialog box showing the newly select features v2 2 3 61 Figure 6 Click the Add Features button to continue and return to the Select role services Screen Select role services Before You Begin Installation Type Server Selection Server Roles Features Web Server Role 115 Confirmation Compass User Manual Select the role services to install for Web Server IIS Role services C Windows Authentication A Application Development NET Extensibility 3 5 C NET Extensibility 4 5 C Application Initialization ASP _ ASP NET 4 5 C CGI ISAPI Extensions ISAPI Filters _ Server Side Includes L WebSocket Protocol a FTP Server TT 2015 Laurel Bridge Software Inc All Rights Reserved DESTINATION SERVER WIN FJI9T883P364 Description ASP NET provides a server side object oriented programming environment for building Web sites and Web applications using managed code ASP NET is not simply a new version of ASP Having been entir
80. ty Profile in the 2011 DICOM specification Attribute Tags not in the default data dictionary cannot be added This includes specific private tags The following options are specified for each attribute in the data grid shown above under DICOM Attribute Tags to Anonymize e Attribute Tag Name Specifies the name of the attribute tag to be anonymized if present in a given DICOM dataset s header data Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 34 e VR Indicates the attr bute s Value Representation This becomes useful when determining an appropriate replacement value for de identification when AutoFill is selected e Tag Indicates the attribute tag of the attribute to be anonymized e Action Specifies the replacement action to use for a given attribute when determining the replacement value The available replacement actions are determined based on the attribute s VR The following list contains all available replacement actions o Hash SH LO PN elements For SH LO and PN elements the replacement value will be a trimmed hash string using SHA256 of the original value o GenerateUID For a given UI element a new UID will be generated for the replacement value o TransformUID For a UI element the existing UID will be transformed in a consistent manner to allow for repeatability For instance this option is typically selected for SOP Instance UIDs to allow
81. x Attempts Job Uid Started Stopped Elapsed State Association Called Title Calling Title Local Address Remote Address Contexts Id Abstract Syntax Instances Sop Instance Uid e0f1 f81a c682 471 8 8772 b3cb1 885ce2a 03 07 2012 15 15 04 03 07 2012 15 15 10 00 00 06 3396339 Sent Destination Compass 127 0 0 1 49478 localhost 105 Status Accepted Syntax 1 CT Image Storage 1 2 840 10008 5 1 4 1 1 2 Accepted Explicit VR Little Endian 1 2 840 10008 1 2 1 1 2 840 114089 1 0 1 3229814289 1330445227 6864 1023 1 2 840 114089 1 0 1 3229814289 1330445227 6864 1024 Requested Syntaxes Explicit VR Little Endian 1 2 840 10008 1 2 1 Context Id Dimse Status 0x0000 0x0000 Job Report View 12 4 Active Associations c Pcl X Save as XML Save as HTML A table containing the list of currently open inbound and outbound associations can be displayed by selecting the Active Associations menu item under the View menu This table displays information and statistics about each open association as well as an Abort button which allows the user to forcibly close the association Direction Calling AE Abort Inbound US CART Abort Outbound CLIENT Abort Outbound CLIENT Called AE Local Address Remote Address Start Time Images COMPASS 127 0 0 1 11112 127 0 0 1 49386 12 29 32 PM 1614 US PACS 127 0 0 1 49388 127 0 0 1 105 12 29 34 PM 489 Cardio PACS 127 0
82. y button con on the Input toolbar To disable Compass from accepting any new Incoming association requests press the Pause button icon on the Input toolbar Pressing the Pause button icon on the Input toolbar does not affect any currently open associations To allow Compass to submit outgoing store jobs to Destinations press the Play button icon on the Output toolbar To disable Compass from submitting any new outgoing store Jobs press the Pause button icon on the Output toolbar Pressing the Pause button icon on the Output toolbar does not affect any currently running jobs Compass User Manual 2015 Laurel Bridge Software Inc All Rights Reserved v2 2 3 46 12 User Interface Details 12 1 Menu Bar A menu bar is available at the top of the main window File gt Import Configuration Imports an existing configuration file Both Input and Output must be stopped in order to enable this menu item File Edit View Help File gt Export Configuration Exports the current configuration to a chosen location File gt Exit Exits the program after completing any incoming and outgoing associations Edit gt Options Opens the main options dialog View gt Current Application Log Opens the application log file View gt Application Log Directory Opens Windows Explorer to view the Compass log file directory View gt Inbound Association History Displays information regarding specific inbound associations Vi

Compass User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents