How to setup Karo in HealthLink
Summary
There are three things that you need to do to get Karo set up in HealthLink:
1. Set up the Karo Folders
2. Set up the Karo Message Type
3. Send a test message so we can check everything is working ok
1. Setting up the Karo folders
Before you can set up the Karo Mailbox/Message Type you need to create the folders where the Karo files will be stored.
These folders will be with all the other HealthLink folders and will be under the HLink\FF_In and HLink\FF_Out folders.
Once they are set up they will look like this - if you already have folders like this then skip straight to Message Type Setup
To set up these folders:
* Log on to a PC where you can access and edit the HealthLink folders
* Go to "Windows Explorer" or "My Computer" - whichever you are most comfortable with
* Click on "Local Disk (c:)" in the left hand side (if your HealthLink is on another drive choose that instead of the C: Drive)
* Locate the HLink Folder and then "double click" on it
(if this folder does not exist you are not on the HealthLink PC or you need to ask your Network Engineer to help you with this)
* Located the FF_In Folder and the "double click" on it
* Go to the File Menu and select New then Folder
* The folder name will be highlighted - type the word KARO to rename the folder. If this doesn't rename the folder then right click on it and select rename then type KARO
* Now we need to repeat those steps to create the archive and rejected folders inside the KARO folder:
- double click on the Karo folder and go the File Menu and select New then Folder
- type in the word archive to rename the folder. If this doesn't rename the folder then right click on it and select rename then type archive
- double click on the Karo folder and go the File Menu and select New then Folder
- type in the word rejected to rename the folder. If this doesn't rename the folder then right click on it and select rename then type rejected
* Now we need a KARO folder in the FF_Out folder so - right click on the folder called KARO and select Copy
* In the left hand side of your screen "double click" on the folder called FF_Out
* "Right click" in a space on the right hand side of the screen and select Paste. This should create a folder called KARO containing the archive and rejected folders.
* A folder called Karo should no be in the FF_Out folder.
2. Setting up the Karo Message Type
* Log on to the PC where you can access the "HealthLink" messaging application (usually the server)
* Open HMS Advanced Options via the Start Menu -> Programs -> Healthlink Six
* Select User Settings via the Configuration Menu
* Now we need to add the KARO message type:
- select Message Types (middle tab)
- click on Add (on right hand side)
- Type KARO and then click on OK
* Karo whould now be in the list
* Click on Directories Tab (NB half way down the page not at the top!)
* Currently they have other as part of the name - this needs to be changed
* So click on Edit/More to change them
* Replace the word "other" with the letters FF in each directory name - just say yes to the warning message you get when you first start!
* Then click on Close
(the picture below shows what it should look like once you have finished)
* Ensure that the Outgoing and Incoming Message Directorys now end with \FF_out\KARO and \FF_In\KARO
* Then click on the Processor Tab
* Make sure that the screen is filled in as below:
- Generic File is checked (do NOT click on Structured File you'll have to start all over again!)
- Single Recipient is the Processor Parameter
- Use the filename as the messageID is checked
- karodata is the recipient
* Lastly you need to Save this changes - click on File then Save and then Exit
3. Send a Test Message
* Log on to a PC where you can access and edit the HealthLink folders
* Go to "Windows Explorer" or "My Computer" - whichever you are most comfortable with
* Click on "Local Disk (C:)" in the left hand side (if your HealthLink is on another drive choose that instead of the C: Drive)
* Click through the folders as follows: HLink - FF_Out - Karo
* Then right click in some empty space and then choose New and Text Document (rename it if you want to) - see below
* Write a short message e.g. Hi Karo - Testing from ABC Service
* Save your file
* Either force HealthLink to run or just wait until next time it runs by itself
* Send us an email (to either patricia@karo.co.nz or pho@karo.co.nz) to let us know that you have sent a test message and then we can check it has arrived
For further assistance don't hesitate to contact us on 04 384-1177