Setting up your first connection
Step 1 – Run Retriever
By default Retriever is installed in C:\Program Files\PSIGEN\PSIsafe, or the (x86) directory on a 64 bit system.
The executable name is PSIGEN.Retriever.exe. Simply double click this executable to run PSIsafe Retriever. A shortcut is also installed on Windows Start.
Step 2 – Provide Login
Enter the PSIsafe username and password to use PSIsafe Retriever.
A new setup must be configured before using Retriever for the first time. In the system tray, right click the Retriever icon and select Setup. Then enter the Administrator password.
Step 3 – Enter a new setup/Edit an Existing setup
Retriever can be used to connect to many different databases and cabinets. A setup name is required for each connection.
Either enter a new setup name or select an existing one from the pull down.
Step 4 – Select the correct PSIsafe settings
PSIsafe Retriever connects a field in another software application to a designated PSIsafe repository, cabinet, and folder index. Data is pulled from the other software application and matched against the data in the folder index.
If there is a match than the folder information is retrieved and the document list is made available to the user.
Select the appropriate repository/cabinet/index combination to connect.
Step 5 – Select the application to connect PSIsafe Retriever to
PSIsafe Retriever connects to another application based on the application executable name. In general these files are stored in the C:\Program Files\<appname> (i.e. c:\program files\ACT). It may take some detective work to determine which executable file is the correct one.
This button will bring up a file browsing screen. Navigate to the correct executable and press the Open button.
Step 6 – Selecting the positioning of the PSIsafe Retriever button.
PSIsafe Retriever attaches a small button to the application selected in Step 5. This button can be placed in one of three locations. This is dependent on where in the connected application is the best place to display the PSIsafe Retriever icon.
Select the top right (most common), bottom left or bottom right. Most application use the top left for their menus, so it is not an option.
Step 7 – Setting the various options
PSIsafe Retriever has a number of options that control how each setup functions. This section goes through each one of the options and explains how it affects the PSIsafe Retriever application.
The Global option makes the setup available to other users using the same repository/cabinet AND the same application. When unchecked, the setup is only available to this user/computer.
When PSIsafe Retriever finds the folder that matches the data in the connected application, it can automatically open the document list if this option is checked. If it is not checked, the user can click the Show Document List button to see the list of documents.
Use capture is the option that connects the folder index data to data from the screen of the connected application. Simply follow the directions on the Select Capture Field screen.
Use matching is one of the more interesting technical parts of Retriever. It is used to take data from the screen and run it through a regular expression parser to extract a piece of data that can be used to match the folder index.
An example would be if an EMR software package could only extract a piece of data like "Patient – John Ferry – 93847” where 93847 is the patient number. If 93847 is in a folder index in PSIsafe then this data could be extracted from the string by using a regular expression.
See http://www.regularexpressions.info for more information/tutorial on regular expressions. For the above string the regular expression to extract 93847 from “Patient – John Ferry – 93847” would be “[0-9]+$”. The “$” matches the end of the string and the “[0-9]+” extracts the client number.
Alternatively, contact PSIGEN Support at firstname.lastname@example.org or visit our WIKI at http://help.psigen.com and submit a ticket to get help with building a regular expression. A list of known regular expressions and the applications they work with are provided in Appendix A.
Step 8 – Save the setup
Save the current setup by clicking the save settings button. Click the exit button to exit setup mode. If the global option is set, the setup becomes available to all other users of PSIsafe Retriever.
PSIsafe Retriever can be connected to more than one application. For instance it could be setup to connect to ACT! for contact management and MAS-90 for the accounting function. PSIsafe Retriever will follow the application that has the mouse focus.