LaboViewer User Manual
Contents
1. sssssss HH hene 42 Windows Command Eine o cde PER I e a as pig Re hes bio 42 Mac OSX Terminal ie id do tada 42 User Manual for LaboViewer Application 12 19 05 Version 1 3 Introduction About this manual This manual is a guidebook for users of the LaboViewer The introduction discusses the purpose and organization of the manual Reading it first will help you decide which of the other chapters you should read most carefully depending on your degree of experience with the application Introduction About this Manual 6 User Manual for LaboViewer Application 12 19 05 Version 1 3 Purpose of this Manual This manual is a user manual for the LaboViewer application This manual is intended as well for new as for advanced users Depending on your degree of experience you may skip certain chapters Organization of this Manual The following is a brief summary of the chapters and appendices in this manual Please note that the opening page of each chapter also gives a summary of the contents of that chapter Chapter 1 Project Overview Gives a general overview of the Labo project as such Page 8 Chapter 2 Features of the LaboViewer Application Describes the principal features and functions of the application Page 12 Chapter 3 Getting started Explains how to get and install the LaboViewer application Page 15 Chapter 4 Working with LaboViewer Gives you step by step instructions on how to configure and use t2. verbose physician Name of Physician Please note Windows users should use the Java Virtual Machine that came with the LaboViewer application Please substitute java with jre bin java in command line Arguments in brackets are optional Available arguments are download initiate result download password specifies the master password required to unlock physician profiles verbose tells the application to output additional information during program execution This is particularly useful while setting up or debugging installations physician specifies one particular physician to download results for If omitted results for all physicians will be downloaded help display usage message Please note f you want the downloaded results to be decrypted and verified automatically please make sure to check the Automatic Decryption checkbox in the physician profiles see Figure 4 11 page 29 and that the physician s private key passwords are set in their respective keychains see Figure 4 11 page 29 Chapter 4 Working with LaboViewer 438
3. Policy Files Except for the Windows installer shipping with a pre configured JRE every other installation requires the installation of an additional package the Unlimited Strength Jurisdiction Policy Files Due to import control restrictions standard JRE distributions allow only strong but limited cryptography to be used The new set of policy files provide unlimited strength cryptography a feature required by the LaboViewer application The Unlimited Strength Policy Files are included in the download Installing the Policy Files The Unlimited Strength Jurisdiction Folder contains four files README txt COPYRIGHT html local policy jar US export policy jar To use the encryption decryption functionality without any limitation you will have to replace the original policy files with the ones provided in the Unlimited Strength Jurisdiction Folder It s a good a idea to make a copy of the original files first in case you decide to switch back to the original configuration Chapter 3 Getting started 17 User Manual for LaboViewer Application 12 19 05 Version 1 3 The original policy files can be found in lt java home gt lib security lt java home gt stands for the directory where the JRE was installed The location of that directory depends on the installation platform On a MacOSX computer the java home folder is located at System Library Frameworks JavaVM framework Home On a typical linux system Copy the US
4. aiseria anana eias on TUE cons bad seas T LA EDU EE A pO aldea REOR ME a eats 14 Multizplatforma ira dato v Ea ex eo ne nacen ex ER Ee EE eei oe eR ER o eet anao eve da tenis Lado xe da Enea hdd 14 Batch Mode indo Ai DOG MERE Hia es 14 CHA DUCE 3 c aannaaien 15 Getting Started iiaae ndeman id 15 Getting Started ecrit e t d eee aid 16 Downloading LaboViewer eeeeesesseesseeeeenneenne nennen nnne nnn nnne nnn nente nnt ens ennt nnns 16 Windows Installer iue eet me eiecti mde uer hess des 16 MacOSX Installek o odo 16 Linux Installer it naui eut eant uu 16 Preredquisites e nieto ec eH C ga Lee Ex une dien co uod beri C ER Kee M Y CARERE EXE ees 17 Java Runtime Environment eee eese eee ee eeeee sese se tese te tete seseseseseseee sees etes stesse stes terere rese en e 17 Unlimited Strength Jurisdiction Policy Files essssseeeeeeeee nemen eene 17 Working Environment ree etn tee lili ita Doe ea lug 18 Single computer installation ect tee it bete tp ah rete Etpe Pe E ERR E Pe E TR UPPER SS 18 Multiple computer installation cesses mene hme hee hee nemen me nennen 18 Security Considerations te or Ob eR D RARI HD pip olini 19 p ecl e M 20 Working with LabOVIGWOE a uice ensis cicsaci rin sa ia nca a va Cha cisco d rV dE idw EV dua da 20 Launching the LaboViewer Application sseeese
5. in different formats The Template Chooser gives the physician the possibility to choose the display format that suits him best Fetch Results The Fetch Results function establishes a server connection L4 using the current physicians username and password and initiates the download of new results available on the server Refresh Results The Refresh Results function refreshes the content of the Result List Use this function if you want to make sure the Result List displays the results effectively in your download folder Chapter 4 Working with LaboViewer 23 User Manual for LaboViewer Application 12 19 05 Version 1 3 Delete Results Results currently selected in the Result list can be deleted with the Delete Results function Save Result Saves the currently displayed result as a PDF file A file E chooser dialog allows the user to specify where to store the file Please note that the Save Result function only works for PDF templates Print Result F Prints the currently displayed result Please note that the Print Result function only works for PDF templates Result Details The Result Details zone displays a summary of important information about the currently selected result This gives the physician quick access to important result information without having to display the result first Result Details Examination Status Final Laboratory Labor Example Reference Number 8
6. in the Results menu Results Fetch Resuts Delete Results Save As PDF Print Figure 4 24 Print menu item Clicking on the Print Result button or selecting the Print menu item will open your systems print dialog Print Printer kanji tudor lu B Presets Standard F4 Copies amp Pages ES Copies 1 Collated Pages All f9 From 1 to 1 Fax Cancel E Print 0 Preview Save As PDF Figure 4 25 Mac OSX Print Dialog Note You can only print results displayed using a PDF template Saving Results as PDF You can save the currently displayed result using the Save Result function either by clicking on the Save Result button in the Toolbar or by selecting the Save As PDF menu item in the Results menu Em Fetch Resuts Delete Results Save As PDF Figure 4 26 Print Save As PDF menu item Chapter 4 Working with LaboViewer 39 User Manual for LaboViewer Application 12 19 05 Version 1 3 Clicking on the Save Result button or selecting the Save As PDF menu item will open a file chooser dialog Select a filename and the folder where you want to save the result Note You can only save results displayed using a PDF template Deleting Results Results that you no longer have any need for or that you have already archived can be deleted Click on the Delete Result button in the Toolbar or select the Delete Results menu item in the Results menu to do
7. mee 21 User Manual for LaboViewer Application 12 19 05 Version 1 3 The Main WinidOW c red cee ceded aia 22 The Toolbar ERO 22 Result Details e Ret ur a a lean a aos ea eb ee EP ch ea ak EN LV EE DN QE LA UE ENS 24 Result Vie Wear 25 Page BYOWS T Ad gE a Ee TERR NOE RR MR ANUS 25 Creating a Physician Profile ecu cotto ten teta ret he Ere e Toren tom e Pd e eee PR Pee god deatdeeremat ne 25 Managing PhysiCiaris AT 31 New Physician Profecias dirias ee e Uer RE 31 Edit Physici n ee e m eo e e ctn T rii Hein 31 Switch di Teig A A dd ATER EE 32 Delete Physiciatz i p e OX EG TERRE M E ER TERRENO DUCERE EU UE Oe va A EUER 32 Downloading Results arnein tee Dette act ene rendo Dx et td dein eon odd 33 EOS ri ieradies H S 34 Status COLUMN A A A ETS xw Ne RSE 34 Laboratory Column i datan ee e teni Sb e bd canta PELE bdo SOKOR E deidad da EARE ETERA Y 3 P tient Columnyw e etie He oc HQ ee nee mp 35 Created Column a dx enne ee ease e Yes 35 AULA TH M M 35 Displaying R sS nlS iieu isani cd inen e a e ved pin epi evs A ed ae ev PETE eu 37 Printing Results zusenden A ys od 39 saving Resultsvas PDF etae Rl e e Gane he hie ee ae 39 Deleting RESUS econ oa a eee aa eee e ee aa A ceca eens rre AANE aa reee 40 Changing the Master Password occcooooococccccnonccononenonnncnnnonononennnnnnnnnnnonnnnnnnnrncnnnnnnonnnnnreranacnnnns 41 Using LaboViewer in Batch Mode
8. so Results Help Fetch Resuts Delete Results Fi Save As PDF igure 4 27 l Print Delete Results menu item A confirmation dialog will show up telling you that the operation can NOT be undone You better think twice deleted results are gone for good eoc Delete Results Confirmation Are you sure you want to delete the selected results This operation can t be undone e Figure 4 28 Delete Results Confirmation Dialog Click the Okay button to confirm that you really want to delete the selected results Chapter 4 Working with LaboViewer 40 User Manual for LaboViewer Application 12 19 05 Version 1 3 Changing the Master Password You can change the Master Password required to unlock application settings To change the master password selected the Change Password menu item in the Physicians menu New Physician Manage Physicians Change Password Figure 4 29 Exit Change Password menu item The Master Password dialog will show up prompting you to enter the new password e o Master Password id Please specify the master password required to access program settings Password MUST be at least 8 characters long Password Repeat Password Apply Cancel Figure 4 30 Master Password Dialog Chapter 4 Working with LaboViewer 41 User Manual for LaboViewer Application 12 19 05 Version 1 3 Using LaboViewer in Batch Mode As already mentioned earlier as of version 1 3 th
9. 4353 91 45 45 45 Mobile 353 91 45 34 34 343 34 Email INFOGHEALTHNET LU Results Reference Number 878 787 877 Description LOINC Value Unit Reference Previous Value Alarm Hematologie H 134 g dl 12 18 114 13 7 2000 4 5 56 7 2000 Comment The value is out of range Thrombocytes 3 m 150 0 13 10 Chimie 45344 Uree 55 mg dl 0 45 23234 Proteines totates 3 g dl 9 9 4 13 7 2000 a Bacteriologie Page 1 of 1 Figure 4 23 Displaying a Result Results will be displayed in Result View zone of the main window The format used to display the result is preset using the Template Chooser in the Toolbar Available templates are Detailed HTML Detailed PDF e Compact HTML e Compact PDF Detailed templates display all the information contained in the result Detailed views are the most complete form of result display Compact templates however display most essential information for quick lookup of relevant data These are the two major display formats affecting the way results are presented Chapter 4 Working with LaboViewer 37 User Manual for LaboViewer Application 12 19 05 Version 1 3 The difference between HTML and PDF templates resides in the technology used to render the results HTML templates display results as web pages Results displayed using HTML templates enable the physician to copy paste portions of the displayed data Unfortunately results displayed using HTML templates can t b
10. 78 787 877 Patient MUSTERMANN Peter SSN 19480225 238 4 4 Result Details Zone Result List All downloaded results will appear in the Result List zone Results are displayed simply by double clicking them Chapter 4 Working with LaboViewer 24 User Manual for LaboViewer Application 12 19 05 Version 1 3 Result View All Results are displayed in the Result View zone The Scale Display function controls the magnification ratio of the view Page Browser The Result View always displays a single page of a result In case a result is more than one page long the page browser allows thumbing through the individual pages Page of 0 Figure 4 5 Page Browser Creating a Physician Profile The first thing to do after an installation from scratch is to create your physician profile As already mentioned earlier all your personal configurations such as language preferences location of keys and passwords are stored in your profile Please make sure you have your Labo Welcome letter at hand when creating your profile The letter contains all the personal account details and passwords required to create your profile To create a new physician profile you have to use the New Physician function You may either use the New Physician button from the Toolbar or the New Physician menu item from the Physicians menu Physicians EU Physician Manage Physicians Change Password Exit Figure 4 6 Physician Menu Click on
11. These zones are Toolbar Result Details Result List Result View Page Browser e onm The Toolbar The toolbar is located at the top of the main window The toolbar groups commonly used functions and make them instantly available The same functions are also available via the menu bar At this point of the manual we re only going to have a look at the different functions without too much detail The different functions will be described in more detail later on Chapter 4 Working with LaboViewer 22 User Manual for LaboViewer Application 12 19 05 Version 1 3 SS miele Detailed HTML mI GS it Figure 4 3 Toolbar New Physician The LaboViewer application incorporates a Physician Mw Manager storing the profiles of different physicians A physician profile consists of all the settings regarding that particular physician e location of keys download directories server accounts etc The New Physician function allows the creation of a new physician profile Physician Manager possibility to manage already created physician profiles Managing profiles consists in editing switching and deleting profiles The Physician Manager function gives the user the Display Scale 100 a The Display Scale function lets the user choose the magnification or zoom factor of the currently displayed result Scale is expressed in percent Template Chooser Detailed HTML Hj Results can be viewed
12. User Manual for LaboViewer Application 12 19 05 Version 1 3 LaboViewer User Manual Before using the LaboViewer application please read this manual thoroughly and retain it for future reference 2005 CRP Henri Tudor Santec User Manual for LaboViewer Application 12 19 05 Version 1 3 Table of Content LAD OVIC WEI PT M 3 User Manaus 3 Table of COn Eutanasia 4 ItoducioN iii 6 ABDOUP TRIS Mina lua ii aida 6 Purpose of this Manual ssssessesseeee mme nne n nnne nn AKACIA EITT rre ener 7 Organization of this Manuala i innean edain aa aiaa aA ES ee neni aea A akaka 7 Chapter 1 Project Overview ee oer rer rl pepe Fern e aE VERTU Pe PESA ES KOBE A NE EOE rA 7 Chapter 2 Features of the LaboViewer Application cesses eene 7 Chapter 3 Getting STATED aoo E 7 CO Mec 8 Prolect OVBIVIGM insistas EE an En Ene ERR 8 C rrent Status regen e YT et Ner a T va ands cit Eget de resa Ted ne t a edo Wag ann dU va da T Rie 11 A TP 12 Features of the LaboViewer application eee ree 12 Download of Results eesseseesssssesssesseeeseeeene nennen PAT KARER A LSAS KAEA EAUS RATER 13 Integrated Keychialh ote Lente erae RE edle eoe ade eatin ea 13 Automatic Laboratory Update ieee eeee cnet terete tree eae eem eem ne nennen 13 Template ChOOSer sisi sensei sais evens eed Wee deans eod a a ees P odie ean eens 13 Physician Manager
13. W Dr Musterfrau 020569 23 amp Dr Musterhaus 270143 41 a Figure 4 15 Close Physician Manager Dialog The Physician Manager dialog displays a list containing all the physician profiles that you have created The physician highlighted in green is the one whose profile is currently active The physician manager offers all the functions required to manage physician profiles These functions are New Physician Profile l ye Creates a new physician profile Edit Physician o Modify an already existing physician profile Select the physician to edit first then click on the Edit Physician button The Physician Dialog will show up Alternatively you can access the Edit Physician function by double clicking the physician to edit Chapter 4 Working with LaboViewer 31 User Manual for LaboViewer Application 12 19 05 Version 1 3 Switch Physicians green is the physician whose profile is currently active The Switch Physicians functions activates another physicians profile To do so select the physician whose profile you would like to activate then click the Switch Physician button The newly selected physician now becomes the active physician signalized by the green highlight 9 As already mentioned earlier the physician highlighted in Note Switching physicians can also be achieved by selecting a different physician in the Physician Chooser located in the Toolbar of the main window Delete Physician
14. bout the current state of the result The Status column holds one of three possible icons i E Encrypted The corresponding result is still encrypted Results will be in that state if you downloaded results with the Automatic Decrypt option off or if automatic decryption failed Double clicking an encrypted result will start decryption process Non trusted The corresponding result was successfully decrypted but verification of signature failed Under normal circumstances you should never encounter such a result In the unlikely event you should encounter a result in the non trusted state please inform us right away Trusted Upon successful decryption and verification results will be in the trusted state Double clicking a trusted result will display it The session is the time spent using the application until you quit Chapter 4 Working with LaboViewer 34 User Manual for LaboViewer Application 12 19 05 Version 1 3 Laboratory Column Depending on the state the result is in i e encrypted or trusted the laboratory column will either display the laboratories UCM code respectively the name of the laboratory Patient Column Depending on the state the result is in i e encrypted or trusted the patient column will either display the results running number respectively the name of the patient Created Column Depending on the state the result is in i e encrypted or trusted the created column will eith
15. e 1 2 illustrates the typical exchange of laboratory results Upon completion of the analysis the laboratory signs result data with its private key This way the laboratory makes sure that the physician is able to verify that the result is genuine and trustworthy Next the laboratory encrypts the signed result with the public key of the prescribing physician By doing so the laboratory ensures that only the prescribing physician is able to decrypt it The encrypted data is then transferred to the Labo server The prescribing physician retrieves the encrypted result from the server and decrypts it with his private key Next step for the physician consists in verifying the result signature using the laboratory s public key If the signature matches then the authenticity of the result is guaranteed Chapter 1 Project Overview 10 User Manual for LaboViewer Application 12 19 05 Version 1 3 Current Status At the time this document was written only the transmission of results had been implemented i e prescriptions were still paper based This two phase process was required by the fact that it was not yet possible to standardize the prescription format Chapter 1 Project Overview 11 User Manual for LaboViewer Application 12 19 05 Version 1 3 Chapter 2 Features of the LaboViewer application This chapter describes the principal features and functions of the LaboViewer application Chapter 2 Features of the LaboViewe
16. e LaboViewer application can be used in batch mode by providing command line arguments upon call However batch execution assumes that physician profiles do exist see Creating a physician profile page 25 It goes without saying that you ll need a text console to launch LaboViewer in batch mode Depending on the platform you re running LaboViewer on getting access to a text console is achieved in different ways Windows Command Line Using the Start menu launch Run The Run Dialog will show up Type cmd and click Ok Type the name of a program Folder document or i Internet resource and Windows will open it For you Open Cancel Browse Mac OSX Terminal On Mac OSX use the Terminal application gt The Terminal application should normally be in your dock If not you can find itin the Applications Utilities folder Chapter 4 Working with LaboViewer 42 User Manual for LaboViewer Application 12 19 05 Version 1 3 After opening your text console you ll have to navigate into the folder where the LaboViewer application has been installed Under Windows it will probably be C Program Files LaboViewer on Mac OSX it will normally be Applications LaboViewer Please note t is important to launch the LaboViewer application from its installation folder The command line to use LaboViewer in batch mode is as follows java jar LaboViewer jar download password Master Password
17. e cryptography section defines all the settings regarding your keys and passwords The Certificate Folder field specifies the location of your public certificate crt file Use the Browse button on the right to locate file on your computer Assuming you ve created your working environment as explained in Chapter 3 page 18 your public certificate should be located in your home directory containing a labo folder with a keys folder inside The keys folder should contain a file whose name matches your physician code with a crt extension In the case of our example physician Dr Mustermann the certificate file would be 141067 55A crt Note The letter A behind your physician code is used to differentiate multiple certificates Every certificate has a limited time of validity usually two years Your A certificate will expire in two years time Before the certificate expires you will receive a new certificate with the letter B During a short period of time the time needed for all the laboratories to switch to your new certificate you ll receive result encrypted using either the old A certificate or the new B certificate During this transition period both certificates must be active simultaneously thus the extra letter to distinguish them The same naming schema also applies for private keys Chapter 4 Working with LaboViewer 27 User Manual for LaboViewer Application 12 19 05 Version 1 3 Select the keys folder The Key Folder fie
18. e matching private key from the key chain Automatic Laboratory Update Public keys of laboratories also do expire after a period of two years Furthermore especially during the startup phase of the Labo project new laboratories may decide to join the project As all the public keys of laboratories are available on the Labo server the application automatically synchronizes its local public key repository with the one on the server This synchronization occurs every time a physician connects to the server to download results Template Chooser File Transfer Protocol Certification Authority Chapter 2 Features of the LaboViewer 13 User Manual for LaboViewer Application 12 19 05 Version 1 3 The LaboViewer application comes with a set of predefined templates presenting laboratory data in different formats A template chooser allows the physician to easily toggle between predefined templates Physician Manager Every piece of information relative to a physician such as location of private keys where to store downloaded results username and password of Labo server account and so on is stored in a physician profile The LaboViewer application comes with an integrated physician manager allowing to switch between multiple physician profiles This feature is of interest for medical offices with more than one physician and where the secretaries have to get access to laboratory data Multi platform The LaboViewer applicat
19. e scaled using the Display Scale chooser neither can they be saved or printed PDF templates offer better control of how results are rendered The Display Scale Chooser allows changing magnification of displayed results Furthermore results displayed using PDF type templates can be printed and saved as files that can be opened using Acrobat Reader Unfortunately copy paste does not work for PDF templates Note Use HTML templates whenever you wish to copy paste portions of displayed date Use PDF templates in any other case Note Display will not be refreshed automatically when switching templates After you have chosen the template format of your liking please display the result again by double clicking it If the displayed result has more than one page you may use the Page Browser underneath the Result View to thumb through the different pages Tip You can resize the area occupied by the Result List and the Result View simply by dragging the separator between both zones The two little arrows in the separator allow displaying either side full size 5 HyperText Markup Language Portable Document Format a k a Acrobat Reader format Chapter 4 Working with LaboViewer 38 User Manual for LaboViewer Application 12 19 05 Version 1 3 Printing Results You can print the currently displayed result using the Print Result function either by clicking on the Print Result button in the Toolbar or by selecting the Print menu item
20. er 4 Working with LaboViewer 28 User Manual for LaboViewer Application 12 19 05 Version 1 3 e098 Settings f Languages Cryptography File Transfer Certficate Folder keys Browse Key Folder keys Browse Y Automatic Decryption Private Key Chain Key Name Password 141067 55A 7 Apply Cancel Figure 4 11 Specifying private key password for automatic decryption Next click on the File Transfer tab The File Transfer settings will appear eS Settings f Languages Cryptography File Transfer FTP Server Name User Name User Password Local Download Folder Browse Apply Cancel Figure 4 12 File Transfer settings Chapter 4 Working with LaboViewer 29 User Manual for LaboViewer Application 12 19 05 Version 1 3 The FTP Server Name field specifies the name of the Labo Result server to get your results from Unless stated otherwise on the Labo Welcome letter the name of the server normally is labo admin healthnet lu Enter the user name and password specified in your Labo Welcome letter in the User Name field respectively the User Password field The Local Download Folder field specifies the location to download results to Assuming you ve created your working environment as explained in Chapter 3 page 18 your download folder should be located in your home directory containing a labo folder with a results folder i
21. er display the creation date of the result file respectively the examination date Summary The following table gives a summary of the columns content in function of the result status UCM code of Result Number Creation date of Laboratory result file UCM code of Result Number Creation date of Laboratory result file e Mame ai Name of Patient Date of Examination Laboratory Tip Moving the mouse pointer over the status icon will display a tooltip describing the meaning of the icon Moving the mouse pointer over every other column of a result will display the result filename Status Laboratory Patient Created O Labor Example MUSTERMANN Peter 7 March 2005 O Labor Example h MUSTERKIND Alexa 7 March 2005 e Musterlabor i 5 AA PERA A h 20 141067 55A701008 86B0000000172 xml Figure 4 21 Tooltip showing result filename Chapter 4 Working with LaboViewer 35 User Manual for LaboViewer Application 12 19 05 Version 1 3 Selecting a result in the result list updates the Result Details zone of the main window Result selection is achieved by clicking on the result Result Details Examination Status Final Laboratory Labor Example Reference Number 878 787 877 Patient MUSTERMANN Peter SSN 19480225 238 B Status Laboratory Patient Created e Labor Example h MUSTERMANN Peter 7 March 2005 O Labor Example MUSTERKIND Alexa 7 March 2005 o Musterlabor MUSTERFRAU Erika 5 March 2005 Figure 4 22 Result Se
22. export policy jar and local policy jar file from the Unlimited Strength Jurisdiction Folder into the java home lib security folder Working Environment By working environment we mean a location on your hard disk that will be used to store downloaded results and where your keys are kept Depending on whether you install the LaboViewer application on a single computer often the case if you re the only practitioner in your medical office or on multiple computers we generally recommend the following scheme Single computer installation As already mention earlier a single computer installation is typical for a small medical office where you are the only practitioner and you re downloading and viewing results on only one computer For a single computer installation we recommend you to create a folder named 1abo inside your home directory Go into the newly created labo folder and create two additional folders named results respectively keys The last step consists in copying your keys crt and key files from your keys CD into the newly created keys folder Multiple computer installation A multiple computer installation is typical for larger medical offices shared by two or more practitioners In that configuration fellow practitioners or secretaries may need to have access to your laboratory data Chapter 3 Getting started 18 User Manual for LaboViewer Application 12 19 05 Version 1 3 For a multiple computer ins
23. ge scheme requires a sound security infrastructure First of all it must be guaranteed that only the addressee can read the transmitted information Secondly the receiver must be sure that the received information really originated from the sender This can be achieved by setting up a Public Key Infrastructure PKI In general this means that the sender digitally signs the information to make sure it is genuine and encrypts it so that only the receiver can read it Chapter 1 Project Overview 9 User Manual for LaboViewer Application 12 19 05 Version 1 3 Digital signature and encryption is done using pairs of digital keys A pair of keys consists of exactly one public key and one private key A digital key is a special file issued by a Certification Authority CA In a nutshell signing or encrypting data with a private respectively a public key can only be reversed with the matching public respectively private key The public key as the name already suggests is intended to be available publicly In the scope of the Labo project all the public keys of both Physicians and Laboratories are stored on the Labo server The private key however is kept by the owner and MUST be kept in a safe place ratoi vao i Result Server Certification Authority v 3 lt d 9 e 5 A o lt o S 2 Laboratories Public Keys ed UNS A Physicians Fublic Keys I HeoLennet Figure 1 2 Labo PKI Infrastructure Figur
24. he LaboViewer application Page 20 Introduction About this Manual 7 User Manual for LaboViewer Application 12 19 05 Version 1 3 Chapter 1 Project Overview Gives a general overview of the Labo project This chapter is intended for people who are not yet familiar with the Labo project Chapter 1 Project Overview 8 User Manual for LaboViewer Application 12 19 05 Version 1 3 Project Overview The aim of the Labo project consists in the creation of a communication platform within the Healthnet project for the exchange of laboratory data The platform addresses the data exchange needs of the participating partners i e physicians and laboratories the integration of heterogeneous IT solutions and the hosting of a central archiving system meeting the requirements of the different structures and the set criteria in terms of adaptability scalability and economy m He9Lenner Labo Server Figure 1 1 Labo Project Data Exchange The basic idea consists in getting away from the currently employed paper based model and moving towards a fully digital one The physician posts an analysis prescription for a specific laboratory Upon arrival of the patient the specified laboratory retrieves the prescription from the Labo server and performs the prescribed exams Results from the analysis are then stored on the Labo server for later retrieval by the prescribing physician It goes without saying that the above mentioned exchan
25. ion was written using the Java programming language By doing so it was guaranteed that the application could be used on a variety of platforms Pre packaged installers are available for Windows MacOSX and Linux Batch Mode As of Version 1 3 the LaboViewer application can be used in batch mode i e certain operations can be initiated by providing command line arguments Chapter 2 Features of the LaboViewer 14 User Manual for LaboViewer Application 12 19 05 Version 1 3 Chapter 3 Getting started This chapter covers how to get and install the LaboViewer application Chapter 3 Getting started 15 User Manual for LaboViewer Application 12 19 05 Version 1 3 Getting Started The LaboViewer application is a free multi platform viewer developed using the Java programming language Installers are currently available for Windows MacOSX and Linux Installation on other platforms is also possible but may not be as straight forward as using the provided installers Downloading LaboViewer The LaboViewer application can be downloaded for free from the following address http santec tudor lu projects labo laboviewer The page gives you some information about the latest release of the LaboViewer application as well as some instructions on how to install the application Scroll down to the bottom of the page and click on the installer package for your platform Doing so will start the download process Depending on the insta
26. ld specifies the location of your private key key file Assuming you ve created your working environment as explained in Chapter 3 page 18 your private key is located in the same folder as your certificate file In the case of our example physician Dr Mustermann the key file would be 141067 55A key Select the keys folder After doing so the Private Key Chain at the bottom of the dialog will display the private keys available in the selected folder 606 Settings Languages Cryptography File Transfer Certficate Folder keys Browse Key Folder keys Browse Automatic Decryption Key Name Password Apply Cancel Figure 4 10 Cryptography Settings with set Key Folder The Automatic Decryption checkbox enables the function carrying the same name If automatic decryption is enabled the program automatically decrypts every downloaded result Ticking the Automatic Decryption checkbox will allow you to edit the password column of your private key chain Double click the password column behind the key to edit the password of the respective key Make sure to hit the enter key when you re done editing the password Note By specifying the password in the key chain the application will automatically use the specified password whenever required If you don t want this behavior just leave the field blank By doing so the program will prompt you to enter the password when needed Chapt
27. lection Once a result is selected you may select the next or previous result using the cursor up respectively the cursor down key on your keyboard Chapter 4 Working with LaboViewer 36 User Manual for LaboViewer Application Displaying Results 12 19 05 Version 1 3 To display a result double click the result in the result list In case the result is still encrypted it will be decrypted first eoe Physicians Results Help LaboViewer 1 2b1 Dr Mustermann Detailed HTML mea SS Bleee Result Details Examination Status Final Laboratory Labor Example Reference Number 878 787 877 Patient MUSTERMANN Peter SSN 19480225 238 Status Laboratory Patient Created e Labor Example k MUSTERMANN Peter 7 March 2005 o Labor Example MUSTERKIND Alexa 7 March 2005 o Musterlabor MUSTERFRAU Erika 5 March 2005 Labor Example xampleLabor healthnet lu PATIENT Mustermann Peter SSN 19480225 238 External Reference 3344556677 13 rue de Castel L 4711 Luxembourg Phone 352 34 34 34 34 Examination Date 7 3 2005 Specimen Date 7 3 2005 Prescription Date 5 3 2005 Comments This is a very strange result Please verify all values to do everything for that Patient Contact Muster Peter director irecto Mobile 352 0 23 23 23 23 54 RECEIVER Dr Follonier HansChef de Personnel Junction of Health 6 rue Coudenhove L 3434Luxembourg Phone
28. ller package that you downloaded install the application as follows Windows Installer After downloading double click setup exe This will start the installation wizard guiding you through the required installation steps MacOSx Installer After downloading double click the LaboViewer disk image file dmg After a short while a LaboViewer disk icon will appear on your desktop Open the LaboViewer disk and double click the LaboViewer package pkg inside This will start the MacOSX installer program guiding you through the steps necessary to install the software Linux Installer After downloading double click setup bin This will start the installation wizard guiding you through the required installation steps Chapter 3 Getting started 16 User Manual for LaboViewer Application 12 19 05 Version 1 3 You may skip the Prerequisites section and continue with the Working Environment section if you re planning to install the LaboViewer application on a Windows computer Prerequisites Java Runtime Environment The LaboViewer application requires a Java Runtime Environment JRE not older than version 1 4 1 to work properly In the case of the Windows installation a pre configured JRE is already included in the installer package so you don t have to worry about it For every other Platform including MacOSX and Linux It is assumed that your computer already has a JRE installed Unlimited Strength Jurisdiction
29. nside Selected the results folder as your local download folder Clicking the Apply button will bring you back to the physician dialog Click the Apply button again to save your changes If you re having a look at the Toolbar you ll notice that your name appeared in the previously empty select box at the left This select box is called the Physician Chooser With the physician chooser you can easily switch between multiple physician profiles provided you defined more than one profile This feature is of interest for medical offices with more than one physician where a secretary needs access to the results of practicing physicians The physician selected in the Physician Chooser is the physician whose profile is currently active SSS Dr Mustermann H4 ye oe Figure 4 13 Physician Chooser Chapter 4 Working with LaboViewer 30 User Manual for LaboViewer Application 12 19 05 Version 1 3 Managing Physicians When you have created more than one physician profile you may manage them via the Physician Manager The Physician Manager can be accessed either by clicking on the Physician Manager button or by selecting the Manage Physicians menu item in the Physicians menu Physicians New Physician Manage Physicians Change Password Figure 4 14 Exit Manage Physicians menu item The Physician Manager dialog will show up ODO Physician Manager Active Name Physician Code ge v Dr Mustermann 141067 55
30. oad operation may take a minute or two Depending on whether you checked the Automatic Decrypt option in your cryptography settings the program will start decrypting the downloaded results once the download is done In case you preferred not to store your private key password in your key chain the program will prompt you to enter the private key password O O Private Kay Password id Please provide the password for your private key 141067 55A Password v Remember Password Apply Cancel Figure 4 19 Private Key Password Dialog Chapter 4 Working with LaboViewer 33 User Manual for LaboViewer Application 12 19 05 Version 1 3 Enter the password when prompted The Remember Password option checked by default tells the program to remember the password throughout your current session Doing so avoids the program to prompt the same password over and over again when decrypting multiple files Result List Upon successful download and decryption of results the Result List zone of the main window will display the downloaded results Status Laboratory Patient Created e Labor Example MUSTERMANN Peter 7 March 2005 e Labor Example MUSTERKIND Alexander 7 March 2005 Musterlabor MUSTERFRAU Erika 5 March 2005 Figure 4 20 Result List displaying downloaded and decrypted results The Result list contains four columns named Status Laboratory Patient and Created Status Column The status column gives information a
31. platform you ve installed the LaboViewer on starting the LaboViewer application is done by selecting LaboViewer in the Start menu Windows only or by double clicking the LaboViewer icon When starting the LaboViewer for the first time you will be prompted to provide a new Master Password This password will be used to encrypt the settings of the LaboViewer application Encryption is necessary because as we re going to see later on application settings will contain server and private key passwords eoe Master Password D Please specify the master password required to access program settings i3 Password MUST be at least 8 characters long Password Repeat Password Apply Cancel Figure 4 1 New Master Password Dialog Provide a password that is at least eight characters long Repeat the password to make sure the provided password does not contain any typos When you re done click the Apply button Note You will be asked to enter the password every time you launch the application so please remember it well Chapter 4 Working with LaboViewer 21 User Manual for LaboViewer Application 12 19 05 Version 1 3 The Main Window eoe LaboViewer 1 2b1 Physicians Results Help Result Details Examination Status Laboratory Reference Number Patient SSN Laboratory Patient Created Figure 4 2 Zones of Main Window The main window of the LaboViewer application is divided into five different zones
32. r 12 User Manual for LaboViewer Application 12 19 05 Version 1 3 Features of the LaboViewer Application The LaboViewer application is a free multi platform viewer for laboratory results transmitted in the scope of the Labo project The viewer was developed by Santec a department of the CRP Henri Tudor dedicated to health care technologies The following gives you an overview of the features of the application Download of Results The LaboViewer application has an integrated FTP client allowing an automatic connection to the Labo result server and downloading all available results The username and password of the physicians account on the server needs to be configured only once Login information will be stored in a physician profile Integrated Keychain Key pairs have a limited period of validity usually two years Once an old key pair expires a new pair will be issued by the CA and send to the physician During a short overlap period a physician may receive results still encrypted with his old public key and some already encrypted with his new key To make this transitional phase transparent for the physician a key chain has been integrated into the LaboViewer application Upon reception of the new key pair all the physician has to do is to add his new private key to the key chain of his profile When decrypting a result the application detects which key has been used to encrypt the result file and automatically retrieves th
33. tallation we recommend keeping laboratory related data on a central server Doing so ensures that the totality of downloaded results will be readily available no matter which computer was used to download them Setting up the working environment for this kind of installation boils down to repeating the steps of a single computer installation on the server for every physician in the medical office Security Considerations Independently from the kind of installation you choose make sure that your laboratory data is kept in a safe place Give your results and especially your keys the same security considerations you would give your credit card number Security begins with controlled physical access to the computer Make sure to secure your computer from access by non authorized persons Never share your private key Your private key is comparable to your signature You don t want anybody else to use it Chapter 3 Getting started 19 User Manual for LaboViewer Application 12 19 05 Version 1 3 Chapter 4 Working with LaboViewer This chapter gives you step by step instructions on how to configure and use the LaboViewer application Chapter 4 Working with LaboViewer 20 User Manual for LaboViewer Application 12 19 05 Version 1 3 Working with LaboViewer This chapter gives you step by step instructions on how to configure and use the LaboViewer application Launching the LaboViewer Application Depending on the
34. the New Physician button or select the New Physician menu item from the Physicians menu to open the Physician Dialog Chapter 4 Working with LaboViewer 25 User Manual for LaboViewer Application 12 19 05 Version 1 3 606 Physician Name Dr Mustermann Physician Code 141067 55 Settings f Apply Cancel Figure 4 7 Physician Dialog Enter your name and your physician code UCM code Next click on the Settings button The Settings dialog will show up 006 Settings f Languages Cryptography File Transfer User Language English HA Result Language English Hd Apply Cancel Figure 4 8 Settings Dialog The Settings dialog is divided into three sections each one accessible via a dedicated tab The first section allows the specification of your language preferences User Language defines the language to be used for the menus labels and messages of the LaboViewer application whereas Result Language defines the language to be used for displaying results 3 Union des caisses de maladie Chapter 4 Working with LaboViewer 26 User Manual for LaboViewer Application 12 19 05 Version 1 3 Click on the Cryptography tab to access your cryptography settings 606 Settings Languages Cryptography File Transfer Certficate Folder Browse Key Folder Browse Automatic Decryption Key Name Password Apply Cancel Figure 4 9 Cryptography Settings Th
35. using the Delete Physician function Select the physician to delete and click the Delete Physician button A confirmation dialog will show up cx A physician profile you no longer need can be discarded Delete Phyisicians Confirmation Are you sure you want to delete the selected physicians This operation can t be undone Figure 4 16 Physician Manager Dialog Click the Okay button if you re absolutely sure you really want to delete the selected profile This operation can NOT be undone Note Deleting a physician can also be achieved by selecting the physician to delete and hitting the Backspace key on your keyboard Chapter 4 Working with LaboViewer 32 User Manual for LaboViewer Application 12 19 05 Version 1 3 Downloading Results Result download is initiated with the Fetch Results function either by clicking on the Fetch Results button in the Toolbar or by selecting the Fetch Results menu item in the Results menu Results Fetch Resuts Delete Results Save As PDF Figure 4 17 Print g Fetch Results Menu Item A progress dialog monitoring connection and download progress will show up 606 Progress This operation may take a while Please be patient Connect to FTP server E re Ore SS ieee are CC X es sr A A Abort Figure 4 18 Download Progress Dialog Depending on the speed of your Internet connection and the number of results available for download the downl
Download Pdf Manuals
Related Search