Configuring TORCH

Created by Tim Cook
Keywords:

'Logging in and the ZMI'

The first thing you should do is login to your server using the torch_admin userid. You do this by pointing a browser to http://:9080/manage where is of course the network name of your TORCH server. You should get an HTTP login box. Enter ‘torch_admin’ fo rthe userid and ‘abc123’ as the password. If successful you should see a screen like this:

This is the Zope Management Interface. Your screen will look like this image when you click on the acl_users text in the left frame.

Taking a quick tour of the ZMI we see the Zope logo in the blue band on the left side. Across from the logo is the user name you are logged in as. The pulldown and Go button can be ignored for now.

The left frame (called the manage_menu frame) shows the Root Folder and the next level down of container type objects.
As you saw when you clicked on acl_users, the contents of that object opened up in the right hand frame (manage_main).

In the acl_users folder you should now see the three userids; admin, op_tech, torch_admin.

The admin user was created during installation and you may have written down the password for that user then. Either way, you may change the password for this user by clicking on the user name. This is basically an emergency user and it cannot own any objects. You may wish to write the userid and password down and store it away in a safe place in a sealed envelope in case your other Manager id’s get messed up.

The op_tech user was created by Open Paradigms,LLC as a Manager so that if you request us to login to your system we have a userid and password to use. If you choose to you may change the password to this user as well so even we do not know what it is. Just be certain to write it down in case it is needed in the future.

The torch_admin user comes with a very simple and basic password. Every copy of TORCH has this same userid and password. You MUST change this user’s password immediately. Click on the userid and fill in the two password fields. Click the Change button. Close your browser and then relogin using the torch_admin userid and new password. DO NOT delete this user. This user owns all of your TORCH objects. You will trash your installation if you delete it.

'Primary Clinic Properties'

The second thing that should be setup in a TORCH installation is the primary properties. The clinic name, address, phone numbers etc. As well as some of the filesystem path information and system preferences are located here.

The two images below show the primary properties page. You navigate to this page by logging in as your torch_admin user. In the manage_menu click the plus sign next to ‘intranet’ tehn scroll down and click on the folder (or text) labeled ‘torch’.

Note the row of tabs along the top of the manage_main frame. Click on the Properties tab and you should see a screen like the first image below.

All of the properties down to practice_email are pretty self explanatory. They are used throughout the system and need to be accurately completed for your clinic. I explain the others below the next image.

Scroll to the bottom and you will see an screen like this one.

body_background_color – changes the background color of every screen in TORCH (not in the intranet portion, just the EHR). You may enter valid hex codes as seen or you may enter color words such as blue, green, purple etc.

text_color – changes almost all text in TORCH. There are a few places where text color is set within the programming and it will not be affected by this value.

link_color – changes the color of the textual links throughout TORCH.

vlink_color – changes the color of the Visited links throughout TORCH.

is_demo – used to limit some functionality when running on the website. It should always be unchecked in your installation.

lab_refresh_rate – in the lab orders section the screen is refreshed automatically to check for new lab orders. This number is in seconds.

rad_refresh_rate – same as for the lab.

'THE INFORMATION BELOW IS OLD, BUT IS MOSTLY VALID'

Some configurable options do not have a custom TORCH interface. They must be edited via the Zope Managment Interface (ZMI). Most of the folder objects in TORCH have configurable properties. Also in the root TORCH folder there are several DTML Document objects with configurable properties.

If you need help locating any of this information you can get free support via the TORCH mailing list.
We also offer commercial paid support. For more information please contact us via email.

Practice Information

Configure the practice name, address and telephone information. Background, text and link colors.

Validation Lists

The selection box contents of:

Address Types

Blood Types

Gender

Generation

Honorifics

Insurance Status Codes

Job Titles

Phone Types

Prescription Types

Universal Resource Indicators

ID Number Types

----Note ----
This section is in need of being redone. There have been several more selection lists added and this edit screen does not take those into account. These additional selection lists may be edited from the ZMI in the TORCH folder. The lists are DTML Document properties. The documents all have ID's that begin with 'valid_' and a descriptive name for the function.

Also the Past Medical History list is not used now.

-------------

Standard Notes

The Encounter screen has four checkboxes where you can insert a default statement into the patient encounter note. These statements for Review of Systems(ROS), Past Medical History(PMH), Family History(Family) and Social History(Social) may be edited from this link.

Templates

The heart and brain of TORCH is the template system.
There is a Help screen in the Template Generator and other documentation in this guide to help get you started building templates.