Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

Overview

Provide a procedure to install and configure

Overview

This guide provides an overview on configuring the Medical-Objects Download Client (Capricorn) and Genie Practice software Software to import electronic results.
This process is based on the Microsoft Windows environment.

If you require any assistance with the installation or configuration, or if you have any questions, please contact the Medical-Objects Helpdesk on (07) 5456 6000.

If you have not Installed the Medical-Objects Download client, Please see the guide for Installing Capricorn on Windows.

Genie Auto import Pre-Configuration Check

Prior to installing the Medical-Objects Capricorn, the following must be checked and the installation performed accordingly to allow Genie to automatically import the results received via Medical-Objects.

 


  1. Log into Genie and click on File,  and select Practice Preferences.



  2. Select the Practice whose configuration you want to check.

    Message Box
    iconnone
    titleImportant:
    typegeneric
    Multiple clinics can be listed in the Practice Preference screen. Ensure you select the correct clinic.




  3. On the Practice configuration Configuration window, Find the practice that you want to check the auto-import settings for in the clinic name column and double click the entry.

  4. In the Edit Practice Preferences window, click on the Clinical tab.
    Note the checkboxes named Allow Pathology Import on Server and Import Pathology Automatically on Client.

 


Message Box
iconnone
titleImportant
typegeneric

Only one option may be selected so genie Genie can only automatically import from EITHER the Server or the workstation. It is strongly recommended that the Capricorn be installed, or setup to save results to, either the workstation or the server depending on which checkbox is currently selected in the clinical tab of the Practice Preferences. It is NOT recommended that the settings be changed inside Genie as this could affect other download clients which may installed and working on the sites computersNetwork


Example: As we can see in the screenshot below Genie is set to import results on the Server, If you are required to install the Medical-Objects Capricorn on a Genie client workstation then it must be set to download the results across the network to the Genie server to allow Genie to automatically import the downloaded results.

If Genie is set to import from the server and results are downloaded to a workstation, then a manual import must be run from the Genie client installed on the workstation where the results are downloaded and vise vice versa.
 

Capricorn Configuration

Double click the HL7 tray icon.
Image Removed


Accessing the Capricorn Configuration Window

The Log window is displayed.
Image Removed
Click the Edit Server Properties icon.
Image Removed
Click on Integration Options.
 
Image Removed
Message Box
iconnone
titleNote:
typegeneric

If the Capricorn HL7 tray icon is not visible, Open the Capricorn from Start menu > All Programs > Medical-Objects > Medical-Objects Capricorn or from C:\MO\Capricorn\Capricorn.exe.

In some cases, the Capricorn may be configured as a service. See this guide for instructions on how to launch the Capricorn if it is set up as a service. 


Excerpt Include
How to access Capricorn Configuration
How to access Capricorn Configuration
nopaneltrue

Capricorn Configuration Settings

  1. Click on Ack Management.
     
    Image Added
     
  2. Set the ACK Management path as below:

    No Format
    (Capricorn installed on a Genie Server Machine) --> C:\Genie\Labrslts\Hl7 ACKS

    
    (Capricorn installed on a Genie Client Machine) --> \\server\Genie\Labrslts\Hl7 ACKS\


    Message Box
    iconnone
    titleNote:
    typegeneric

    If the folders do folder does not exist, You must create them.

  3. Check that the Incoming Modifier is set to Genie REF.
     
    Image Removed
     
  4. Select

    it.


  5. Click on Integration Options.
  6. You will now need to set the incoming modifier. There are a few options to choose from depending on what the practices preferences are and the version of Genie in use.

    Genie V8: Puts all incoming correspondence into Pathology and Radiology. For Genie versions 8 and above.

    Genie REF V8: Splits incoming correspondence between Pathology and Radiology and Incoming Letters as appropriate. For Genie versions 8 and above.

    Genie: Puts all incoming correspondence into Pathology and Radiology. For Genie versions before 8.

    Genie REF: Splits incoming correspondence between Pathology and Radiology and Incoming Letters as appropriate. For Genie versions before 8

    Image Added
  7.  Select Server Parameters from the left panel.
     

     
  8. The paths above are set as follows:

    (Capricorn installed on a Genie Server Machine) -->

    Code Blocknoformat
    i.	 Message Output Directory: --> C:\Genie\Labrslts\
    ii.	 Save Pathology:           --> C:\Genie\Labrslts\
    iii. Save Radiology:           --> C:\Genie\Labrslts\


    (Capricorn installed on a Genie Client Machine) -->

    Code Blocknoformat
    i.	 Message Output Directory: --> \\server\Genie\Labrslts\
    ii.Save Pathology          Save Pathology:--> \\server\Genie\Labrslts\
    iii. Save Radiology:           --> \\server\Genie\Labrslts\

    Make Sure that “Save Save all ORU in Pathology Path” is Path is UNTICKED

  9. The Medical-Objects configuration is complete. Click Apply and OK.

Sending Configuration

  1. Click on Manage Queues in the left hand side panel.

    Image Added

  2. Click Add.

    Enter HL7 Outgoing for the Queue name.

    Enter C:\Genie\Medical Objects\Outgoing\ for the Base Directory.

    Image Added

    Warning
    Please make sure any duplicate Medical Objects Outgoing folders are removed across the network. These will affect document delivery.


  3. Click on HL7 OUTGOING in the Queues to watch for messages pane and then click on Setup.

    Image Added

  4. Click on Add in the window that appears and choose the following decorator from the menu that appears.

    Image Added


    No Format
    Specify File Mask


    Image Added

    Message Box
    iconnone
    titleNote:
    typegeneric

    For this particular decorator, When you are returned to the queue building screen you will have to set *.HL7 (HL7 Messages) from the drop down for that Decorator.


  5. Repeat Step 4 for the following decorators.

    Message Box
    iconnone
    titleNote:
    typegeneric
    You must do them in sequence.


    No Format
    Strip Illegal Characters
    Move ACKs to Application ACK Folder
    Fix REF Message
    Use MSH-6 MO Routing ID to readdress REF message
    Route with Capricorn


    No Format
    If you are on an older Capricorn use "Modify Message with HL7 Script" instead of "Use MSH-6 MO Routing ID to readdress REF message"
    Use the following for the HL7 Script decorator you just added.
    //Genie currently doesn't populate MO IDs in the correct fields.   
    program GenieMOIDs;
    var
      i: Integer;
      recipient: string;
    begin
      for i := 0 to HL7Data.SegmentCount - 1 do
      begin                                       
         if SameText(HL7Data.SegmentName[i], 'MSH') then           
         begin
             recipient := HL7Data.GetFieldValue(i, 5, 0, 0, 0);
             break;
         end; 
      end;
      if ValidateMedicalObjectsID(recipient, false) then  
      begin
          for i := 0 to HL7Data.SegmentCount - 1 do
          begin
              if SameText(HL7Data.SegmentName[i], 'PRD') and SameText(HL7Data.GetFieldValue(i, 1, 0, 0, 0), 'RT') then
              begin                                                 
                  HL7Data.SetFieldValue(recipient, i, 7, 0, 0, 0);          
              end;
              if SameText(HL7Data.SegmentName[i], 'PV1') then          
              begin
                  HL7Data.SetFieldValue(recipient, i, 9, 0, 0, 0);
              end;
          end;                        
      end;
    end.
    
    


    Warning
    Historically Convert REF message to ORU format was part of the queue before Route with Capricorn but is no longer needed for new configurations.


    Message Box
    iconnone
    titleNote:
    typegeneric

    If you need to change the order of the decorators, you can click on the decorator in the queue and use the arrow buttons on the right hand side of the screen to change their priority.


    If you get an error at anytime sending from Genie that looks similar to the following: EFTInvalidFormatCode:Invalid escape sequence format code ".RTF"' then you will have to add the following decorator after the Strip Illegal Characters Decorator.

    No Format
    Modify Message with HL7 Script


    Once you have added the Decorator, add to it the following code in its main settings box just under the Edit button.


    No Format
    Program Test;
    var i:Integer;
     s : String;
     OBXStart: Integer;
    begin
     //HL7 Data is a precreated object with the HL7Data loaded
     OBXStart := HL7Data.IndexofSegment('OBX');
     writeln('OBX Index is '+ inttostr(OBXStart));
     for i := OBXStart + 1 to HL7Data.segmentCount-1 do
     begin
     if HL7data[inttostr(i) + '.3.1.1'] = 'RTF' then
     begin
     HL7Data.DeleteSegment(i);
     break;
     end;
     end;
    end.


  6. Go to the Server Parameters option on the left hand menu. Here you need to Enter the Server File Prefix. Enter a 3 letter acronym for the practice. This prefix will be used when naming outgoing messages.

    Image Added

Table of Contents
outlinetrue
stylenone