Académique Documents
Professionnel Documents
Culture Documents
0
Q306 Edition
Each set of capabilities has been painstakingly researched and devised with usability experts to
make it quick to learn and powerful to use. Great functionality is around every corner. ClearHealth
includes additional modules for document storage, customizable reporting and extensions, lab results,
and prescription management. ClearHealth includes modules for Scheduling, Billing, EMR, HIPAA
Compliant Security, Accounts Receivable, Document Management and much more. Because of the
flexibility of the system it is possible to use only the modules that are relevant for each individual
practice.
ClearHealth is different because it is powered by Open Source Software. Open Source Software
is a philosophy that gives all users access to the source code, giving them the power to change and
adapt the software to their unique needs. Open Source gives you ownership of the system and the right
to control when and how it is upgraded. It also gives you the ability to cost effectively customize the
software for your practice's individual needs and specialties. There are no obligatory recurring license
fees, no forced upgrades, and no vendor lock-in. Uversa guarantees a life cycle of three to seven years
and offers all levels of support with its ClearHealth Advantage Edition.
There are several resources available to you as a ClearHealth user. The first resource, is the
OP/EN website: http://www.op-en.org/ . Here you will find vast resources for dealing with any
issues you may encounter while using ClearHealth.
The OP/EN
website has
links to
multiple
tools and
resources.
From this
website you
can talk
with other
ClearHealth
users,
contact
Uversa Inc.,
Report
Issues
(requests
for
http://www.ope-en.org/ ClearHealth
features/improvements and any specific problem you may encounter). While at the OP/EN
website you can also look at other great products being offered that my enhance your overall
business experience.
The ClearHealth Forums
From the OP/EN website you may access the Forums and talk with other ClearHealth users from
around the world. To access the Forums, simply click on the link entitled Forums on the left hand
side of the OP/EN website. You will need to register in order to achieve the full benefit of the
Forums. In order to register, click on the register link located in the top right hand corner of the
Forums Page. Once you have registered you are now free to post concerns or comments on the
boards and to reply to other user's posts. The Forums are full of useful information. You can ask
questions and find useful information on making the most of your ClearHealth installation.
Experts from Uversa Inc. frequently check the board to answer questions and talk about concerns.
Reporting an issue
If you have a specific issue you may use Mantis, our issue tracking system, to submit a report to
Uversa Inc. To request a feature or suggest an improvement, or to report a specific problem you
are having, such an error message (what we call a "bug") just click on the Bug Reporting link
located on the left hand side of the OP/EN website. If you don't already have a login, you'll need
to get one. To get a new login, select the Sign up for new account link and follow the instructions.
Once you have a login and a password you will be able to report an issue.
Submitting an issue report is easy. Once you login to Mantis click Report Issues, located at the top
of the screen. This takes you to a new page that will allow you to choose ClearHealth from a drop-
down menu. After selecting ClearHealth from the drop-down menu and pressing the Select
Project button you will be taken to the Issue Reporting Page where you will be asked to enter
a subject title and a description of the issue.
Mantis Bug Report
If you are requesting a feature or enhancement please choose "feature" from the Severity: drop-
down menu. When reporting an issue, generally, the more information you can provide the better.
Be specific about what the issues is and what you were doing leading up to encountering the issue.
The goal in bug reporting is to allow a programmer to reproduce the issue so that they can solve
the problem. Don't forget to include the url of the page you encountered the problem on. Once you
have filled out all the appropriate information, all you need to do is click the Submit Report
button at the bottom of the screen. From here the report will become part of a queue and will be
looked at by a team of programmers to help rectify the situation.
Throughout this guide there will appear grey boxes just like this one! They contain helpful tips and
shortcuts or a little extra information. They are meant to make learning to use ClearHealth easy
and quick.
Navigating ClearHealth
Below is a general overview of ClearHealth's layout and how to use some of the features in
ClearHealth, including a description of pop-up calendars, information grids, and general usability
tools found throughout ClearHealth.
It is not recommended that you use your browser's back or reload buttons. Using these features
could result in lost data. It is also not recommended that you bookmark pages within ClearHealth.
For best results use the navigation provided within ClearHealth itself.
By clicking
any of the
top level
section
labels you can can access the corresponding section. Each section has its own individual set of
menus. Generally, these menus are comprised of the corresponding functions that can be performed
in that section of ClearHealth. Only the menus for the section you are currently in will be displayed.
The sections are always displayed at the top of the page, this allows you to navigate from one
section to another easily. You can recognize which section of ClearHealth you are currently in by
looking to see which of the section titles appear in bold. You can switch sections by simply clicking
on the name of the section you wish to access.
Each section contains menus that allow you to access specific pages within ClearHealth. Many
pages within ClearHealth will display a multitude of information and areas where data can be
entered to be stored, this is especially true for pages found in the Patient section of ClearHealth. To
make navigating pages that display or have access to a large amount of information easier, the page
will be divided into frames. These frames are titled appropriately and contain only the information
connected to that frame.
Section Descriptions
There are four top-level sections (Calendar, Patient, Billing, and Admin) found in ClearHealth.
Below is a brief description of these sections, along with the basic contents of their subsequent
menus and pages.
Calendar
The Calendar section handles all aspects of patient appointments. From this section you will be
able to create, edit, and delete appointments. It is also possible to check in patients and create
encounters from this section of ClearHealth. You can also access the New Patient Page and add a
patient from this section of ClearHealth. There are several different views on the Main Calendar
Page. There are also filters to limit what appointments/schedules are displayed at once.
Patient
The Patient section is the access to the ClearHealth EMR system. It allows users to create and
edit patients, and essential patient information. From the Patient section it is possible to manage
encounters and access patient account information. It also has functions that allow for the easy
search for a patient's record.
Billing
This section gives access to the billing system in ClearHealth. It allows for the sending and
tracking of claims. This is the section where you will enter and track payment information for
individual claims. You may also add and edit insurance companies in this section of ClearHealth.
Admin
The Admin section will often not be displayed for security reasons. There are many configuration
options for ClearHealth, and the Admin section allows you to customize ClearHealth to your
needs. If you wish to add or edit users, change user rights, attach extensions or reports, or add a
new facility or room to your practice, you can do so in the Admin section of ClearHealth.
Not all sections are displayed to all users. The contents displayed depend on your access rights. If
something is missing from your display that you need to access, discuss this with your ClearHealth
administrator.
ClearHealth Site Map
Below is a site map of the ClearHealth menus. Not all menus are available to all users. When a
user is created in ClearHealth, they are assigned a security role. Those security roles dictate what
sections/menus a user will have access too. Below is a map of all the default menus accessible by
a ClearHealth Administrator.
Common Tools and Features in ClearHealth
Throughout ClearHealth there are tools and features that appear in multiple sections. Below you will
find instructions and helpful tips on using these tools/features to help make using ClearHealth
efficient and simple.
You may select the desired month in one of two ways: either by (1) clicking on the single arrows
(< & >) located on the upper left and right hand corners of the calendar, or (2) by clicking and
holding on the single arrow, in which case, a list of months will appear and you may select the
desired month from the list, similar to the way you selected the appropriate year.
Once you have selected desired year and month, click on the desired date. The selected date is
placed within that date with a black box. Once you have selected the desired date hit either the
enter key on your keyboard or the Select Date button located on the bottom of the
calendar.
It is possible to change the order of the days of the week on the pop-up calendar by clicking on the
name of the day, this will move that day to the beginning of the week. By clicking on the Today
button at the top of the calendar the calendar will jump to the current date.
To close the calendar click on the X in the upper right hand corner, the selected date will appear in
the date box.
You may also enter dates by hand in the text box provided, using the format MM/DD/YYYY.
Throughout ClearHealth you will see lists of information (such as appointments and encounters on
the Patient Dashboard Page) displayed in a grid. The following section will guide you through
the various features associated with the grids.
There
are
arrows
placed at
the head
of the
list for your navigating convenience. Often there will be enough data to cover multiple pages, you
can jump to a specific page number by entering that page number into the text box located at the
top of the list. You may also navigate page by page by clicking the single arrows listed directly on
either side of the text box. By clicking the outside arrows you will jump directly to the first or last
page of the list, respectively.
Each grid is equipped with a sort option to help you find the information you are looking for
quickly. You may sort by one category, or by multiple categories. Each category is equipped with
three sort option settings: ascending, descending, and off. You can
change the sort option setting by clicking on the name of the
category you wish to sort. Which sort option setting the category
is currently on will be indicated by a small arrow located to
the right of the category heading. The arrow pointing up indicates ascending order. The arrow
pointing down indicates descending order. The absence of the arrow indicates that category is not
being filtered to a specific order.
You will also notice that on either side of the category headings are arrows pointing right and left.
These allow you to shift the category left and right. It is important to
note that the order the categories appear in does affect the order the
information in the grid is displayed in. Reading left to right, the first
category with an active sort option will be first sorting priority, then the next category to the right,
and so on.
Moving the categories ranks their sorting priority. The first priority always being the first active
category on the left. Moving a category to the right will decrease its priority.
Validation
Often when working with a patient you may find it necessary to switch between sections in
ClearHealth, or functions within a specific section. ClearHealth stores the last patient you were
working with and displays it at the top of the Main Patient Page. Each time you return to the
Main Patient Page the patient's name will appear as a link at the top. By clicking on the patient's
name you will be taken to the Patient Dashboard Page for that patient.
Section 1
Using ClearHealth
This section introduces a user with some knowledge of how a practice is run
to use ClearHealth to track patients, schedule appointments, create claims and post
remittance.
Unit 1
ClearHealth Patient Records
The following unit will teach you how to navigate through the patient portion
of ClearHealth. Here you will find instruction on creating patients, editing patient
information, searching for patients, as well as detailed accounts of what each frame
in the patient dashboard does.
Creating Patient Records
Creating patients is a very simple process. It is possible to add patients through two different
interfaces.
You may add a patient automatically when
scheduling their first appointment from the
calendar Main Page in the Calendar
section. Select the desired appointment time
for the new patient's initial appointment and
select the new link from the appointment
pop-up.
The new patient pop-up will appear. Fill out
the basic patient information: first name,
last name, date of birth, gender, default
provider, and a contact phone number
(these fields are required). Click the Add
button. Within the new window you will be
redirected to the Patient Edit Screen. You
may continue to add information, or you
may close the window and continue
scheduling the appointment.
The second method for adding a new patient
New Patient Link on Add Appointment Pop-up is from the Patient section of ClearHealth.
Here you will find a menu labeled Actions. To create a patient, click on the Actions menu. A list of
menu items will appear. Click on Add Patient. A new page will load, taking you to the Add
Patient Page.
Creating a patient is a two-step process. The first step is to enter the basic patient demographic
information: name (first and last), date of birth, Id#, gender, default provider, home telephone
number, and marital status, along with the registration location and record number, if there is
one. If there is no predetermined registration number to enter manually, ClearHealth will
automatically enter one for you. They will be sequential and will be formated to your specifications
during the installation of ClearHealth.
After entering this basic information click the Add button at the bottom of the screen, you will be
taken to the Edit Patient Page, where you may then add additional patient information, including
addresses and insurance information.
Record Locking
Record Locking
Interrupted Registration
Often when registering a patient for the first time it is necessary to navigate away from the
new patient screen before registration is complete. ClearHealth has an interrupted registration
feature that allows a user to retrieve the information they had previously entered on the add patient
page, even when they did not save the information. Being by adding a new patient, by going to the
Patient section of ClearHealth and selecting Add Patient from the Actions menu. Enter in several
pieces of information pertaining to a new patient (ire first/last name and date of birth). Go to the
Calendar section of ClearHealth without clicking on the Add button. Complete a task in the
Calendar section (such as making an appointment for an existing patient) then return to the Patient
section of ClearHealth. You will receive
a yellow alert box that will give you the
option of restoring the information that
you had previously entered. To restore
said data, click the Click here to restore
that information link in the yellow alert
box. The information you had previously
entered will appear in the text boxes and
you may now continue with registration.
Interrupted Registration
Entering Patient Data
The Edit
Patient
Page is where
you may
enter or edit
all
infor mation
It is
possible to mark a patient record as inactive to allow for easier use of your database. To mark a
patient as inactive, visit that patient's Patient Dashboard. Select edit from the Patient frame on the
Patient Dashboard. To render a patient inactive, select no beside the Active field. When a patient
is selected as inactive they will not appear under normal patient searches. It will be necessary to
select the search inactive check box below the search text box.
Patient Phone Numbers
Located below the Patient Details frame is the Phone Numbers Frame. The home telephone number
that was entered on the Add Patient
Page should now appear in the Phone
Numbers frame, above the text fields.
To edit existing telephone numbers,
first click on the phone number link
you wish to edit. The telephone number
will appear in the text boxes. You may
now change the telephone number by
editing it in the Number field. Phone
number must be in the format of
2223334444. Include the area code, but
do not include parenthesis, dashes, or a
spaces. You may also assign the
number to different category by
Patient Phone Numbers Frame on the Edit Patient Page selecting the desired type of number:
home, work, mobile, emergency, or fax
from the drop-down menu. You may also add any notation about the phone number in the Notes
field. You may select the box marked DNC to indicate do not call. To save changes, click the
Update button.
To add additional phone numbers, enter a telephone number in the Number field. Remember, phone
numbers must be in the format of 2223334444. Include the area code, but do not include parenthesis,
dashes, or a spaces. Select the type of phone number: home, work, mobile, emergency, or fax from
the drop-down menu. Add any desired notations in the Notes: field. Select the Add as New button
to add the additional phone number.
By clicking on the Update button you will change the information saved in the category selected
under type instead of adding a new and additional number, therefore it is important to select Add
as New not Update.
Patient Addresses
Located below the Phone Numbers frame
is the Patient Addresses frame. Here you
may enter the patient's various addresses
by filling out their information in the text
boxes provided.
The Name field is provided for the name of
the addressee.
In the Type field you may select the type
of address: Home, Billing, Other, Main, or
Secondary, you are entering from the drop-
down menu.
The Address field is where you enter the
postal address of the category you are
entering.
The City field should contain the city of
the address.
Select the desired State from the drop- Patient Address Frame
down menu provided.
Enter the zip code in the Zip: field.
ClearHealth has an auto-complete City/State generator for addresses. It is not necessary to type in
the city and state when entering addresses. Simply, type in the zip code and ClearHealth will fill in
the appropriate City/State.
In the Notes: field you may enter any additional information about the address.
If mail has been returned you may mark that address as a bad address by clicking the Return to
Sender! Bad Address check box. This will alert other staff members to obtain and update the
patient's address.
Click on the Add button to save the initial address. The address will now appear above the text
boxes.
You may enter additional addresses by following the procedures outlined above and clicking Add
as New when finished.
To edit existing addresses, click on the name of the address you wish to edit. You may make
changes to the existing addresses by editing them in the text boxes. When you are finished editing
click Update to save the changes.
Add Addresses From Related People
When a patient has a relationship with other patients in the system, you may look up those patient's
addresses by click the Add Address From Related Person check box. A list of related people and
their addresses will appear. Click the check box to the right of the address and select Save to use
that address for the current patient.
You must enter address for a patient, the system will not allow you to continue without one.
However, in the case that a patient does not have an address you may type 'No Address' in the Name
field and click Save to indicate that this person is without an address.
Patient Payer Information
Located in the upper right hand corner of the Edit Patient Screen is the Payers frame. You may enter
a patient's insurance information in this section.
Select the patient's insurance program from the drop-down menu (adding insurance programs is
covered later in this guide). If the insurance program you need is not in the drop-down menu, you
will need to contact your ClearHealth administrator or biller to add the insurance program.
In the Group Name: field enter the group name of the patient's insurance company. You must enter a
group name.
In the Group Number: field enter the group number/policy number of the patient's insurance. You
must enter a group number to add a payer.
In the Effective Date Range: field enter the beginning and ending dates of coverage. To navigate
within the calendar simply click on the icon, a calendar will appear. Select the year of birth either
clicking on the double arrow located on the upper left and right of the calendar, or by clicking and
holding on the double arrow, in which case, a list of years will appear and you may select the
desired year from the list. To view dates that go farther back than on the list, select the last date on
the list and repeat the above steps until you see desired date. Select the month of birth either clicking
on the single arrow located on the upper left and right hand corners of the calendar, or by clicking
and holding on the single arrow, in which case, a list of months will appear and you may select the
desired month from the list. Once you have selected the desired year and month, click on desired
date and hit enter or the select date button located on the bottom of the calendar.
In the Assigning: field you may designate specific coverage of the payer by choosing the appropriate
category from the drop-down menu. This is where you designate a person's level of coverage. If, for
instance, an insurance plan covers labs only, you can designate that here.
In the Co-Pay: field enter the patient's co-pay amount.
Check the Active box to indicate an active payer.
The Subscriber: field is to designate who is the primary insurance policy holder. Select Self, Parent,
Spouse, or Other from the drop-down menu. If subscriber is anyone other than self, a subscriber
frame will appear. From here you may search the patient database for an existing patient or you may
add a new subscriber. To select a patient that is already in the patient database, select Search Current
Patients and begin typing the patient's name in
the Search field. ClearHealth's auto-complete
function with pull up a list of matching patient
names. Select the correct patient from the list,
the rest of the required information will be
filled in automatically upon selection. To add
a new subscriber, select New Subscriber and
fill in all of the following text fields.
Patient Statistics
In the Patient Statistics frame it is possible to list specific demographic information pertaining to a
patient, such as: ethnicity, language, income, family size, race, migrant status, and monthly income,
registration location, and sign in date.
Most of this information can be selected from the drop-down menus provided. Once finished
entering the data, click the Save button. You may come back and change this information by
editing the information provided and clicking Save.
Pay particular attention to family size and monthly income if your practice has discount fee
schedules set up. The information you enter in these two fields is what will determine which
discount the patient qualifies for.
Patient
Located in the Patient Frame is all the basic information pertaining to the patient. Their name,
address, phone number, default provider, registration location, date of birth, marital status, record
number, and identification number can be seen here. To make changes to any of this information
click the edit link at the bottom of the frame, this will take you to the Edit Patient Page where you
can follow the instructions listed under working with patients in this guide.
Patient Notes
In the notes frame you may enter any notations specific to the currently viewed patient and assign
them a priority 1-5. To add a note, type the information in the text box provided, assign the note a
priority by selecting number 1-5 from the drop-down menu. Once finished, click Add Note. The
note will appear above the text box, with the priority, date, time, user, and note listed.
At the top of the the list there are arrows for your navigating convenience. You can jump to a
specific page number by entering that page number into the text box located at the top of the list.
You may also navigate page by page by clicking the single arrows listed directly on either side of
the text box. By clicking the outside arrows you will jump directly to the first or last page of the list,
respectively.
Insurers
Located below the Notes Frame is the Insurers Frame. Here you will
find the patient's insurance information. The Insurance Company
Name, Program, Group Name, Group Number, Co-Pay, Subscriber,
Effective dates, and Active status are all listed for your convenience.
To edit insurance information you must go to the Edit Patient Page,
which can be accessed by clicking the edit link located in the patient
frame of this page.
Encounters
Below the insurance frame is located the encounters frame. Here you will find a list of all
encounters for the patient. The list contains the following information: date of treatment, reason for
visit, building, treated by, and status of the encounter.
The encounter frame is equipped with the same sort option as the insurance frame to help you find
the encounter you are looking for quickly. You may sort by one category, or by multiple categories.
Each category is equipped with three sort option settings: ascending, descending, and off. You can
change the sort option setting by clicking on the name of the category you wish to sort. What sort
option setting the category is currently on will be indicated by a small arrow located to the right of
the category heading. The arrow pointing up indicates ascending
order. The arrow pointing down indicates descending order. The
absence of the arrow indicates that category is not being filtered
to a specific order.
You will also notice that on either side of the category headings are arrows pointing right and left.
These allow you to shift the category left and right. It is important to note
that the order the categories appear in does affect the order. Reading left
to right, the first category with an active sort option will be first, then the
next category to the right, and so on.
The display shown on the left sorts the list by date of
treatment in ascending order, then treated by in
ascending order. Therefore, the encounters will be
sorted by date with the very first encounter at the top
of the list in order to the most recent encounter at the
bottom of the list. Because the treated by category is
also being sorted, any encounters with the same date
will be then ordered according to the names in the
treated by category.
Moving the categories ranks their sorting priority. The
first priority always being the first active category on
the left. Moving a category to the right will decrease
its priority.
There are arrows placed at the head of the list for your navigating convenience. You can jump to a
specific page number by entering that page number into the text box located at the top of the list.
You may also navigate page by page by clicking the single arrows listed directly on either side of
the text box. By clicking the outside arrows you will jump directly to the first or last page of the list,
respectively.
You may also add an encounter from this screen by selecting the Add Encounter link. This link will
take you to the Encounter Page where you can follow the add encounter instructions located in the
encounter section of this guide.
Appointments
Below the Encounters Frame is located the Appointments Frame. Here you will find a list of all
appointments for the patient, both past and future. The list contains the following information: start
(date and start time), time (duration), title, reason, provider, and location.
Appointments Frame
Like the encounter frame, the appointments frame is equipped with
a sort option to help you find the encounter you are looking for quickly. You may sort by one
category, or by multiple categories. Each category is equipped with three sort option settings:
ascending, descending, and off. You can change the sort option setting by clicking on the name of
the category you wish to sort. What sort option setting the category is currently on will be indicated
by a small arrow located to the right of the category heading (circled right). The arrow pointing up
indicates ascending order. The arrow pointing down indicates descending order. The absence of the
arrow indicates that particular category is not being filtered to a specific order.
You will also notice that on either side of the category headings are arrows pointing right and left
(circled left). These allow you to shift the category left and right. It is
important to note that the order the categories appear in does affect the
order. Reading left to right, the first category with an active sort option
will be first, then the next category to the right, and so on.
The display shown on the left sorts the list by
start in ascending order (arrow up), then
reason in ascending order (arrow up), and
finally provider also in ascending order (arrow
up). Therefore, the appointments will be
sorted by start with the very first appointment
at the top of the list, ordered to the most
recent appointment at the bottom of the list.
Because the reason category is also being
sorted, any appointments with the same date
will then be ordered according to the reasons
in the reason by category. And finally by
provider if the first two categories have
matching data.
Moving the categories ranks their sorting priority. The first priority always being the first active
category on the left. Moving a category to the right will decrease its priority.
There are arrows placed at the head of the list for your navigating convenience. You can jump to a
specific page number by entering that page number into the text box located at the top of the list.
You may also navigate page by page by clicking the single arrows listed directly on either side of
the text box. By clicking the outside arrows you will jump directly to the first or last page of the list,
respectively.
Account information
The Account Information Frame is located on the right hand side of the Patient Dashboard Page. It
is an abbreviated record of all monetary transactions that have taken place for the account. It shows
Total Billed, Total Paid, Total Write off, and the Balance. To view a transaction by transaction
record of the account, click the Account History link located at the top of the frame. This will take
you to a new page where all transactions for that account will be listed.
The Account History Page is a detailed view of all financial
transactions in a patient's history. Details include: claim id,
payer name, amount billed, amount paid, any amount written
off, the balance, the facility of service, and the provider. For
easy viewing click Select located on the far right hand side of
the page, to highlight a claim.
Calendar Navigation
There are two different views in the Calendar section: Day and Print view. To navigate between
these different views there are two small icons in the upper right hand corner of the calendar located
next to the date (shown above). These buttons are viewing options that filter the way the calendar is
displayed. To access a particular view, click on the small icon indicating the desired view, at the top
right of the calendar and the calendar view will change.
The calendar only displays one day at a time, defaulting to today's date. To navigate to an alternate
date, you may click the arrows located on either side of the date. The right arrow moves you forward
in time, the left arrow moves you back. To jump to a specific date you may utilize the pop-up date
selector.
Click on the Calendar icon located directly to the right of the currently displayed date and before the
forward navigation arrow. The pop-up calendar will appear. You may select a year in one of two
ways: (1) click on the double arrows (<< or >>) located on the upper left and right of the pop-up
calendar. This will shift the calendar one year in either direction. The second (2) way to select a year
is by clicking and holding on the double arrow (<< or >>). In this case, a list of years will appear
and you may select the desired year from the list. To view dates that go further back than are
currently listed, select the last date on the list and repeat the above steps until you see the desired
date.
You may select the desired month in one of two ways: either by (1) clicking on the single arrows (<
& >) located on the upper left and right hand corners of the calendar, or (2) by clicking and holding
on the single arrow, in which case, a list of months will appear and you may select the desired
month from the list, similar to the way you selected the appropriate year.
Once you have selected desired year and month, click on the desired date. The selected date will be
represented by surrounding that date with a black box. Once you have selected the desired date hit
either the enter key on your keyboard or the Select Date button located on the bottom of the
calendar.
It is possible to change the order of the days of the week on the pop-up calendar by clicking on the
name of the day, this will move that day to the beginning of the week. By clicking on the Today
button at the top of the calendar the calendar will jump to the current date.
The current date will be highlighted in red.
To close the calendar click on the X in the upper right hand corner.
The Calendar only displays the
appointments and resource scheduled for a
particular day. Each resource/provider
should be assigned a different color,
allowing for easy differentiation between
one another. Overlayed on each provider
will be all appointments scheduled for them.
Filters pop-up
Calendar Search
You may search for existing appointments within the calendar for date range, provider, patient,
facility, reason, or schedule codes. The Calendar Search Page can be accessed from the Calendar
section. It is located in the actions menu.
To search, simply enter in the information you wish to search for and click the Search button at
the bottom of the screen.
Below the search boxes will appear a list matching all criteria. Click the view link below the desired
appointment/schedule to be taken to that appointment/schedule on the calendar.
The Find First check box allows
you to find the first available
time slot matching your search
criteria. This is very useful for
finding an open slot to schedule a
patient. After clicking Search, the
first available appointment
slot will be listed as a link. Click on
the link to be taken to the Main
Calendar Page with an appointment
pop-up. Your search criteria will
already be filled in.
Find First
Editing and
Moving
Appointments
You can edit existing
appointments from the calendar.
Once you have found the desired
appointment you may edit it by
clicking on the edit link in the
appointment display. The current
appointment information will appear in an
appointment pop-up . You may now change any
information related to the appointment here. To
move the appointment to a different day or time,
simply change the date or time to the new day
and time. Once finished, click the Update
Appointment button located at the bottom of
the Appointment pop-up. Your changes will
appear on the schedule.
Deleting Appointments
You can delete an appointment from the calendar by clicking the Del link in the appointment
display. Once you have clicked the Del link the appointment will be deleted.
Canceling Appointments
You can cancel an appointment from the calendar by clicking the Can link in the appointment
display. Once you have clicked the Can link the appointment will be canceled and moved to the No
Show Schedule.
Recording No Shows
You can record a No Show for an appointment from the calendar view by clicking ns link on the
appointment display.
When a ClearHealth user is booking an appointment for a patient who has a family relationship with
a patient who already has an appointment on the same day, ClearHealth will notify the user of the
first appointment before confirming the new appointment. For example, if Mrs. Smith has a
daughter Jenny who has an appointment at 10:00 a.m. and calls for an appointment on the same day
for her son John, when the user creates Johns appointment, it will notify the user that Jenny had an
appointment on the same day.
This system
will respect
the
confidentially flag by creating a red border for notices regarding appointments that are confidential.
So if Jenny had an appointment that was confidential it would still appear to the user outlined in red
with a label that say "confidential appointment".
Visit Queuing
When a procedure or treatment course requires multiple appointments you can create a visit queue
for a patient to ensure that each of those appointments is created. The first step in creating a visit
queue is creating a template for a particular course of treatment. To create a template go to Admin:
Calendar: Visit Queuing. Click Add Template to create a template. Name the template and set the
number of appointments required for treatment. You must then assign each appointment a reason,
length, and then order the appointments. Select Submit when you have finished.
Select which template you wish to use, the treating provider, and the correct patient and click the
Submit button. You will be taken back to the Patient's Dashboard. In the Visit Queue frame there
will be a list of appointments required for their course of treatment. You may schedule the
appointments by choosing a date and time.
Printing the calendar
You may print a calendar by first using the filtering tools to select the calendar view you wish to
print. Once you have the desired calendar in view, select the printer icon located in the upper
right hand corner of the calendar. This will launch a new window with a printer friendly view of the
calendar page. To print this page follow your browser's printing instructions. You may print by
selecting print from the file menu of the browser.
From Appointments
You can create an encounter from the calendar in
ClearHealth. Use the calendar navigation to find the
appointment. You can then create an encounter by
clicking the Enc. link from the appointment display.
This will create the encounter, taking you to the
Patient Encounter Page.
Scheduled Appointment
Manually Creating
Encounters
You can manually create an encounter
from the Patient Dashboard. Once at the
Patient Dashboard click the Add
Encounter link from the Encounters
Frame, located about half way down the
page on the left hand side. This will
create an encounter, taking you to the
Patient Encounter Page.
Dental Encounters
Fill out a Dental Encounter the same way you would fill out a medical encounter, as outlined
above. The exception is there will be a different set of ICD codes. ClearHealth also provides an
interactive tooth chooser located in the Edit Claim Line Frame. To access the tooth chooser, click
on the link next to the CPT code field.
Tooth Chooser
Encounter Forms
Select the desired form from the drop-down menu. You will be directed to a new page containing
that form . Fill out the information and click Update. A box will appear in the upper left hand
corner of the screen that will read: form updated.
Extra People in Encounters
Located in the upper right hand corner is the Encounter People Frame. Here you may add any
additional people associated with the encounter such as an attending nurse or referring provider.
Type the name of the associated person in the text box, a list will appear of all the matching names.
Select the desired person and choose their tittle from the drop-down menu. Select Add Person at
the bottom of the frame to save the information. You may add additional people by following the
above procedures and then selecting New Person. You may edit and change the people associated
with the encounter by clicking on the name link of the person you wish to edit. Make appropriate
changes and click Update Person.
Closing an Encounter
Once an encounter has been recorded with all of the information needed to build a claim, click the
Close Encounter button located in the Details Frame of the Patient Encounter Page. Once a
claim has been closed, three new links will appear: Make a Payment, View Claim, and Re-open
claim. By clicking on any of these three links you will be able to make payments, view the claim,
and re-open the claim.
Things you should have learned:
Claim Status
All claims appear in a color coded grid format. To view the status legend, mouse over the words
View Status Legend located in the top left hand corner of the List Frame. Green: New, Yellow:
Pending: Blue: Sent, and Purple: Archived.
Filters
By default the Main Billing Page contains a list of all the outgoing claims. Once this list becomes
unmanageable it is possible to use the filters to deal with only a small subset of claims at once. The
filters are listed at the top of the main billing interface. Possibly the most useful of the filters is the
status filter. Using this
filter it is possible to
view all of the claims
that are not ready to be
billed. This filter works
the same way all other
filters in ClearHealth
work. Select the desired
filter parameters from
the drop-down menu
and/or by typing the
desired information into
the text boxes and click
on Filter button. To
view a claim click on the
Identifier link of the
claim you wish to view.
This will take you to the
Claim Data Page.
Processing Queues
ClearHealth uses a batch processing tool to make sending claims quick and easy.
Select All
Processing Queues
To process claims, begin by filtering the claim list to the claims you wish to process. Filtering is
especially important when you have a large number of claims waiting to be processed. You must
then select the claims to be processed by checking the select box on the left hand side of the screen.
You can select all the boxes by clicking the select all check box located on the upper left hand
corner of the claims grid. Once you have selected the appropriate claims to be processed click the
Add Selected link located next to the queue you wish to add the selected claims to. Under the
column heading of Items, you should now see a count of how many claims you have added to the
queue. Keep in mind that if there were already claims in the queue, this number will reflect all the
items in the queue, not just what you have added.
Once you have added the appropriate claims to their
respective queues, click the process link located at the top of
the Processing Queues Frame. You will be redirected to the
Claims Processing Page. Here you must select which queue
you wish to process by clicking Select. You must also
choose what format you wish to process the queue in, each
payer has a different format requirement and you will want
to choose accordingly. Also select where you wish to view
the file - either in web page format, or saved to your
computer or shared file on a server for electronic submittal
to payers or for printing. These options will vary based on
payer preferences and are customizable during installation
Claims Processing Page and configuration. Once you have completed this process
the claims are ready for payment posting.
Things you should have learned:
✔ How to create a claim from an encounter
Claims List
ClearHealth provides a way to keep track of payments made towards an individual claim. Posting
payments one claim at a time is only recommended for special cases with a multitude of
adjustments.
Once a claim has been processed, an EOB (explanation of benefits) link will appear below the name
of the payer. Search for claims that are described in the EOB using the claims filter system. Usually
the important values to filter on are
Insurance company, Date of Service,
and Patient. This will generally
narrow the results to only a few items.
Since these items are all closed, there
should be an EOB link.
The EOB link will direct you to the
EOB Page, where a payment can be
entered. Here you will see payment
history for the claim as well as a ways
to make additional payments. Add the
amount of the payment in the
Payment Amount field and any
write-offs in the Payment Write
off field. The Cary field shows the
remaining balance after the write off
EOB Page amount or payment. Make sure to
select the proper Payer from the
drop-down menu provided. Once you have entered in the proper amounts and selected a payer
choose the Record Payment button. If there is a non-zero balance and other insurers, the
secondary payers will automatically be billed. If no more money is owed on this account zeros will
appear in all three fields.
Adjustments
Adjustments
It is possible to add multiple adjustments to the payment screen of a claim. Select the appropriate
area for the adjustment to be applied to (i.e. specific claim line or payment) from the drop-down
menu. Then select the adjustment type from the drop-down menu.
Click the Adjustment Link located just above the Applied To: field to see a full list of all the
Adjustment Types available. Click the link again to hide the list.
If needed enter a value for the adjustment and then click the Add Adjustment button. It is
possible to add multiple Adjustment for a given claim.
When a patient is responsible for all or a portion of the bill it may be necessary to create a patient
payment plan in order to record that patient's payments. To create a plan, click on the New Patient
Payment Plan link located below the Payer drop-down menu. Fill out the Patient Payment Plan
Once the file is successfully uploaded, you must process it. To process the file, click the list link
located at the top left of the page. You will see a list of unprocessed files. Choose the file you
wish to process and click the Process 835 button. Once the file has been processed, you will
be directed to a confirmation screen. Here you may apply the transactions by clicking on the
Apply Transactions link. You will be taken to the Batch EOB Screen where you can verify that
the payment amounts are correct. The system will auto-fill the payment amounts. You may edit
anything that needs adjusting or simply verify that the amounts are correct and quickly page
through the batch.
Automatic Payment
Selecting the Automatically apply claims within __ of complete payment check box will apply
a payment to any claim that has a billed and payed amount within the range you set. You will not
have to view and manually accept the payment amount for these claims. This is especially helpful
when you are processing a very large number of claims from a payer that is generally reliable,
with few adjustments or denials. For example: if you billed a payer for $95 and they sent you a
payment for $86 and you had selected the automatic payment option, when you went to the Batch
EOB Screen that claim would not appear. The payment of $86 would be automatically applied and
the $9 difference in payment will automatically be written off. When you go to the Batch EOB
Screen you will only be viewing claims with discrepancies larger than the amount you have
chosen.
Patient Account Access
To view a patient's account status and his account history, not just a
particular claims history, you must go to that patient's dashboard.
The Account Information frame is the sum of all outstanding claims
and bills, not just one. In the Account Information Frame on the
Patient Dashboard you will find an Account History link in the
Account Information frame. In order to view a patient's account
history you must click on this link.
By clicking this link you will be redirected to the Account History Page. Here you can view all claims
made for that patient as well as their payment breakdowns.
claim
This section is designed to take you through the installation and configuration
process for ClearHealth. It will guide you from a blank install to entering in the
important information pertaining to your practice or practices.
Unit 1
ClearHealth Installation
This section introduces you to the ClearHealth installation process, including a step-by-step
guide walking you through the installation wizard.
ClearHealth Installation Guide
ClearHealth installation is a simple and straightforward process. However, if you do need support
there are a few ways to receive help. The first way is by clicking the support link located in the
upper left hand corner of the installer. The second is by visiting us on the web at
www.uversainc.com.
Either set up an apache virtual host to run ClearHealth out of, or create a new directory inside a
current domain. This is how you will be accessing ClearHealth so make sure to pick a suitable name.
You are now ready to download ClearHealth. Go to www.op-en.org, click on ClearHealth, and
select Snapshot to download.
Once you have downloaded
ClearHealth you must extract it to the
web root on your server or wherever
you want ClearHealth to be installed.
Practice Setup
Entering your practice information can be done from the Admin section of ClearHealth. In order to
enter a new practice select Facilities from the Setup menu. This will load a new page. To add a
practice click the Add a Practice link located at the top of the page. Here you may enter the
information pertaining to your practice.
In the Name field enter the name of your
practice.
In the Address, City, State, and Zip Code field
enter the mailing address of the facility. This
is also the address that will appear on all claims as
well as patient statements.
A Secondary Address filed is provided to
enter a street address (if different from
mailing address) or another secondary
address.
In the Website field enter your practice's
website address
In the Main Phone field enter the primary
phone number for the practice.
In the Secondary Phone field enter any
secondary phone number for the practice.
Add a Practice Screen
In the Fax field enter the fax number for the
practice.
In the Identifier field enter your practice's identification number.
Click the Save button to add a new practice.
Per Practice Configuration
Once you have filled out the initial practice information it is possible to change your facility type
(such as dental) for ICD code purposes. It is also possible to tailor the appointment time increments
on the Calendar Page.
Once you have created a practice following the instructions outlined above, go to the Admin section
and select Facilities from the Setup menu.
Select your newly created practice to edit from the list. If you do not see a list of facilities, select the
List link located at the top of the page.
The Per Practice Configuration fields should now appear at the bottom of the page. You may now
select the desired settings from the drop-down menus. Changing the Calendar Interval value with
alter the time increments displayed on the Calendar Page. Select Update when you are finished.
Practice List
Building Setup
Once you have entered in your practice information you may enter different buildings into the
ClearHealth system. Entering building information can be done from the Admin section of
ClearHealth. In order to enter a new practice select the Add New Building link on the Add/Edit
Facilities Page. You may access this page by choosing Facilities from the Setup menu. This will
load a new page. Here you may enter the information pertaining to your practice. If your practice
does not have multiple buildings it is possible that the information entered in this section will be
identical to the information entered on the facility page.
In the Name field enter the name of the building.
In the Description/Location field enter a brief description of either the building, location, or both
of the building.
In the Address, City, State, and Zip Code field enter the mailing address of the facility.
Select the name of the Practice from the drop-down menu.
In the Identifier field enter the building's identification number.
Select a Facility Code from the drop-down menu.
Click the Save button to add a new building.
To edit an existing building, click on the name of the building you wish to edit. You can find all
entered buildings by clicking on Facilities from the Setup menu in the Admin section of
ClearHealth. You may delete a building by clicking on the D link located next to the practice's
name.
Once you have altered the appropriate information click Update and the changes will be saved.
After you have added a Fee Schedule you must assign it values. To set all codes in the Fee Schedule
to the same value, type the value you wish to set in the Default Value: field and select the Set
Default Value for all procedures in Fee Schedule button. We recommend
setting this value to the most commonly used value and manually altering all other values. To update
the Fee Schedule by code, click on the Update Fee Schedule link at the bottom of the page. You will
be redirect to a new page. Here you may search for the code you wish to set a specific value for.
Once a Fee Schedule has been created it can be accessed under Fee Schedule on the Billing menu in
the Admin section of ClearHealth. This menu will bring up a list of the available Fee Schedules. To
edit a Fee Schedule click on its name. This will bring up a screen identical to the one in Add Fee
Schedule.
The Fee Schedule also allows you to input
individualized codes that corresponds to
standardized codes. The interface also allows
code mapping. So that the EMR can record one
code for a procedure, but a Fee Schedule will be
capable of automatically billing a different
code. To enter a mapped code, click on the
Update Fee Schedule link located on the Edit
Fee Schedule Page. You may enter an alternate
code in the Mapped Code column.
code mapping
Discount Tables
To access the Discount Tables select Discount Tables from the Billing menu in the Admin section of
ClearHealth. You will be redirected to the Discount Tables Page. Either add a new discount table by
selecting your practice from the drop down menu, or edit an existing schedule by selection your
practice from the list of current discount tables.
Once on the Edit Discount Table Page you can enter a discount schedule based on your
individual practice's needs. You can change the number of discount levels (columns) or the number of
codes (rows) per discount level by changing the
numbers in the Editor Options frame.
To create a discount table enter the discount
level in the column heads and then you may enter
either CPT codes or income level that each
discount will be applied to in the subsequent
rows. The example at the left shows a series of 10
CPT codes that will be given a 25% discount.
You may set a default discount schedule
applied to all patients, or you may set discount
tables based on insurance programs. To change
this option, click on the Default or Program check
box.
Appointment Templates appear in the Add Appointment sidebar and pop-up on the ClearHealth
Calendar. Based on the Appointment Template settings, different types and number of people will
appear for scheduling an appointment. In our example, a root canal (the reason on the add appointment
box) requires not only a dentist but an assistant. Because we have set up the above Appointment
Template, the Calender now has drop down menus to allow you to schedule both an assistant and a
dentist when scheduling a root canal for a patient.
Example: if you set cleaning reason to use the cleaning
appointment template and the cleaning template has three
slots you will now have drop downs for three different
people. You should now be able to add appointments. If
you switch to a different practice you should see its list of
appointment reasons and only have a selection for one
provider, unless that clinic also has appointment templates
set up.
Claim Templates
Often a medical facility will perform the same set of procedures on many different patients over and
over. A good example might be teeth cleaning procedures at a dental clinic, or annuals at a medical
clinic. As a result when coding an encounter there will often be the same set of ICD and CPT codes
used very frequently. It is possible to link a set of ICD and CPT codes to an encounter reason (such
as physical). When that encounter reason is selected, the preselected ICD and CPT codes will auto-
populate, saving the user time.
To setup an encounter template go to Admin: Billing: Claim Templates. You may edit an existing
Claim Template by clicking on that templates name or you may add a new template by selecting add
template.
Title the template appropriately, select the practice the template will be used for and select an
encounter reason to apply the template to. Add CPT and ICD codes the same way you would in an
encounter.
Now, when you encounter a patient, select an encounter reason with a claim template. ICD and CPT
codes will now auto-populate.
Appointment Acceptability Rules Engine
It is possible to add rules regarding what
types of appointments can be scheduled
during specific times. Go to Admin:
Calendar: Appointment Rules Engine.
Click on the Add a New Rule link. You
will be taken to the rule editor. On the
Summary tab, you must name the rule
and provide the error message users will
receive when they attempt to schedule an
appointment that conflicts with the rule.
You may define a rule using the date,
procedure, patient, provider, and location.
You may use any combination of these to
define a rule. You will always have an
enforcer (what is not allowed) and then
will use the other categories to limit or
define when this rule is applied.
Summary Tab Rules are applied when making
appointments, if a rule matches dialogue
showing the details of the match is shown. If the user has permission you can check the box to
override the rule and schedule the appointment or you may choose to reschedule the appointment at
an appropriate time slot.
appointment dialogue
Practical Example of Appointment Rules
On the
Procedure tab
Description of Rule select
Disallowed to
not allow the procedure. Choose
which procedure you wish to disallow from
the drop down menu. Make sure to Label
the Procedure appropriately.
Enforcing Rule
Located below the Programs Frame is the Phone Number Frame. To add numbers, enter a
telephone number in the Number field. Remember, phone number must be in the format of
2223334444. Include the area code, but do not include parenthesis, dashes, or a spaces. Select the
type of phone number: primary, or fax from the drop-down menu. Add any desired notations in
the Notes field. Select the Add as New button to add the additional phone number.
To edit existing telephone numbers, first click on the phone number you wish to edit. The
telephone number will appear in the text boxes. You may now change the telephone number by
editing it in the Number field. You may also assign the number to different category by selecting
the desired type of number from the drop-down menu. You may also add any notation about the
phone number in the Notes field. To save changes, click the Update button. By clicking on the
Update button you will change the information saved in the category selected under type instead
of adding a new and additional number, therefore it is important to select Add as New not
Update.
Located below the Phone Numbers Frame is the Addresses Frame. Here you may enter the
patients various addresses by filling out their information in the text boxes provided.
In the Type field you may select the type of address: Home, Billing. Other, Main, or Secondary,
you are entering from the drop-down menu.
The Address field is where you enter the postal address of the category you are entering. The
City field should contain the city of the address.
In the Notes field you may enter any additional information about the address.
Click on the Add button to save the initial address. The address will now appear above the text
boxes.
You may enter additional addresses by following the procedures outlined above and clicking Add
as New when finished.
To edit existing addresses, click on the name of the address you wish to edit. You may make
changes to the existing addresses by editing them in the text boxes. When you are finished editing
click Update to save the changes.
Configuration of Users
The default user for a fresh ClearHealth installation is Admin:Admin. It is important to follow the
steps to edit a user and change the Admin user's information to reflect your practice. The default
Admin user is not a real user, it is only meant to give your ClearHealth administrator initial access to
the system. Do not use this user as a regular user.
Adding Users
Before a person can begin using ClearHealth they will need to be added as a user. This is done from
the Admin Section of ClearHealth. To access the Add User Page select Users from the Setup
menu. Click the Add link to be taken to the Add User Page. Here you will enter basic information
for the user.
The First Name field is where you enter the user's first name.
The Last Name field is where you enter the user's last name.
The Identifier field is where you enter the user's social security number or another identification
number.
The Nickname field is where you enter the users initials. These are what is displayed on the
Calendar Page when viewing a person's schedule. We recommend using initials to keep the
Calendar Page tidy and manageable.
Mouse over Type, Default Location, and Nickname for a reminder of what each of these fields are
for.
The Color field is where you assign a color for the user. This color will be the color assigned to
that person's schedule on the calendar Page. It is important to pick a color that will be easy to work
with. To select a color click on the Pick link located next to the text box. You may then choose a
color from the pop-up box of colors that will appear. We recommend using soft colors for easiest
use.
The Salutation field is where you enter Dr., Mr., Ms. Mrs., etc.
The Middle Initial field is where you enter a user's middle initial which can help separate users
with similar names.
Select Type of user being entered from the drop-down menu provided. User type does not dictate
what access the user will have to the system. Type is a designation for what other information will
be required by ClearHealth for this particular user. It also dictates where in the system the user will
appear (i.e. staff members are not give a provider schedule).
Enter a user's Default Location in the text box provided.
The Email field is where you enter a users email address.
The Notes field has been provided for any additional information you wish to add.
On this page it will also be necessary to select a user name and password.
It is also important to select the security roles of the user. It is not recommend that you assign users
more than one type of role. There are certain features in ClearHealth that are restricted based on the
security role chosen, assigning a person to more than one security role could inadvertently give a
person permission to perform certain operations that they should otherwise not have access to.
Once you have finished entering in all the necessary information select the Add button located at the
bottom of the screen.
A confirmation box will appear in the upper left hand corner of the screen confirming the creation of
the user. The Add button will now be an Update button and several more frames will appear,
depending on what type of user has been added.
For all types of users Phone Number and Address Frames will appear.
To add a phone number, enter a telephone number in the Number field. Phone number must be in
the format of 2223334444. Include the area code, but do not include parenthesis, dashes, or a spaces.
Select the type of phone number: home, work, mobile, emergency, or fax from the drop-down
menu. Add any desired notations in the Notes field. Select the Add as New button to add the
phone number.
To edit existing telephone numbers, first click on the phone number you wish to edit. The telephone
number will appear in the text boxes. You may now change the telephone number by editing it in the
Number field. Remember, phone numbers must be in the format of 2223334444. Include the area
code, but do not include parenthesis, dashes, or a spaces. You may also assign the number to
different category by selecting the desired type of number: home, work, mobile, emergency, or fax
from the drop-down menu. You may also add any notation about the phone number in the Notes
field. To save changes, click the Update button. By clicking on the Update button you will
change the information saved in the category selected under type instead of adding a new and
additional number. Therefore, if you wish to add an additional number instead of saving changes it
is important to select Add as New not Update.
Too add an address enter the patient's various addresses by filling out their information in the text
boxes provided.
The Name field is provided for the name of the addressee.
In the Type field you may select the type of address: Home, Billing. Other, Main, or Secondary,
you are entering from the drop-down menu.
The Address field is where you enter the postal address of the category you are entering.
The City field should contain the city of the address.
Select the desired State from the drop-down menu provided.
Enter the zip code in the Zip field.
In the Notes field you may enter any additional information about the address.
Click on the Add button to save the initial address. The address will now appear above the text
boxes.
You may enter additional addresses by following the procedures outlined above and clicking Add
as New when finished.
To edit existing addresses, click on the name of the address you wish to edit. You may make
changes to the existing addresses by editing them in the text boxes. When you are finished editing
click Update to save the changes.
Information Specific to Setting Up Providers
Adding a provider is a two stage process. First you must create a user using the same methods
documented under add user. Be sure to choose the provider option under user type. Once you have
added this user, the form will extend to include the provider specific information. Here you will
be able to enter the various provider Id numbers, address and phone information, as well as
linking the provider to the various payer programs. When adding a provider to ClearHealth two
additional frames will appear asking for information pertenant to treating providers. These frames
are the Provider Details Frame and the Insurance Programs Frame.
Wizard Step 1
First you must choose which type of schedule you wish to create. A Provider Schedule blocks off
time only for the provider you choose. An Administrative Schedule will block off time for everyone.
You may use the Administrative Schedule to
create meetings. Title the meeting
appropriately, setting the date and time. The
time (Schedule runs from) is in 24 hour format,
so a meeting from 2 p.m. lasting until 4:30 p.m.
would be entered as 14:00 to 16:30. Choose the
Room you wish to block the time for and select the
Next button to schedule the time.
Schedule
scheduled time. To delete scheduled time
check the box located next to the
designated time and click the Update
button. The time will be deleted.
Things you should have learned:
✔ How to set up a practice
✔ About superbills
Section 3
Extending ClearHealth
This section is designed to teach a user who is comfortable administering
ClearHealth to expand its capabilities, using ClearHealth formats, EMR Extensions
and Dynamic Reports.
Unit 1
ClearHealth Reporting
This section will guide you through the process of creating a report and attaching it to the
appropriate area of ClearHealth. You will learn about queries, using the default template, and
creating your own unique template.
Reports
Reports are one of the many helpful ways that you can customize ClearHealth to fit your practice's
individual needs. Reports take data from your database and displays it in a useful format. Address
labels are a common use of the ClearHealth reports system. By default, ClearHealth will display
reports in a standard table format, however, you can upload custom templates to fit your individual
needs. .
Managing Reports
You can manage reports from the Reports menu in the Admin section of ClearHealth. To view or
edit a specific report select List Reports from the Reports menu. You will be taken to the List
Reports Page.
To view a report, select the template you wish to use to view the report with from the drop-down
menu on the right hand side of the report rows. Once you have selected a template you will be
redirected to the View Report Page. Here, you will see the chosen report, displayed according to the
template you chose.
To edit a specific report click on the name of the report you wish to view/edit. You will be taken to
the Edit Reports Page. From here it is possible to change the title and description of the report. It is
also possible to change whether or not a sequence id is displayed on the report or if a snapshot of the
report is taken. You may edit the Query from this section as well, and this is also the screen where
templates can be uploaded.
Creating/Adding a Report
Creating a report in ClearHealth is simple, but it does require basic knowledge of SQL.
You can add a new report
by clicking on Add Report
in the Report menu of the
Admin Section and
completing the Add
Report Page.
In the Title text field enter
the title of the report you
will be adding.
In the Description field
enter a brief description of
the report and its function.
If you wish each report to
show a unique sequence id
number check the Show
Sequence ID box.
Checking the Show Add Report Page
Sequence ID box will
cause a box in the upper right hand corner of the report to appear with a unique report id number.
This is helpful if you will be numerically ordering reports.
Select Never, Always, or Manual from the
Snapshot Report drop-down menu to indicate
whether you wish ClearHealth to make a copy of
the report after is is run.
Select desired report type from the System Report
drop-down menu. Leaving the System Report on
Sequence ID Normal Report will take data only from your
Query.
Enter the desired SQL query in the Query text field.
Select Add Report to save and add the report.
Connecting a report to an area of ClearHealth
To connect a specific report to a specific area of ClearHealth you would use the Connect option
located on the Reports menu in the Admin section.
To link a report to an area of ClearHealth, select that area on the list provided.
Once you select an area
of ClearHealth to
connect a report to, an
Add New Report Frame
will appear at the bottom
of the screen where you
can select the appropriate
report from the drop-
down menu.
Select the desired report
from the drop-down
menu and the template
you wish to use from the
second drop-down menu.
The report
is now
connected
to the area
of
ClearHealth that was selected. If you go to that area of ClearHealth you will be able to verify that
the report is now available on that screen.
Queries
To create reports, a basic knowledge of SQL is required. Below is a brief description of some basic
Queries and their possible uses. You should begin each query by naming it. Use the following
format to name each individual query:
---[name of query]---
Select/From
Select tells you which fields in the table or tables to display. After select list the fields you
wish to display. You must then choose the tables you want to select from. The from clause is based
on pulling information from a primary table and then joining other tables to it.
To create a report that lists all the people in the system you would enter:
select * from person
In this example, you are telling the database to select every field (*) and to pull from the table
person.
Persons in ClearHealth
(graphic left) shows a report
using the default
ClearHealth template with
the example query listed
above
Types of Tokens
[name_of_token]
This will give you a text box in the filters section of the report with the label of "Name of token".
[im_a_date_t
oken:date]
This will give you
a date box in the
filter section of the
report with the
label "I'm a Date Token".
[im_an_enum_
token:enum:g
ender]
This will give you
a drop-down built
from a system enumeration in the filter section of the report with the label "I'm an Enum Token". In
our example it is gender. It is possible to create an enumeration specifically for using in reports.
[im_a_que
ry_token:q
uery:selec
t distinct
person_id,
first_name
from
person]
This will give you a drop-down built from the query inside. It will appear in the filters section of the
report with the label "I'm a query token". The query has to have two fields. The first field is used as
the value in the main query. The second field is the display in the drop-down.
Example Query with Token
To create a report displaying persons in ClearHealth with a last name user filter, you would type the
following in the Query text field:
The following shows the report created using the above Query entry. The current displayed report
has been user filtered to display all persons in ClearHealth with the letter P in their name.
Practical Example: Patient Address Labels
A very useful report would be Patient Address Labels. Using the ClearHealth reports section it
would be possible to call up a list of all the patients in your practice and their home addresses.
In the Query Section on the Add New Report Page you would begin by naming the query:
---[people]---
Then you would choose the fields you wish to display. In our case we wish to display only the
information pertinent to home mailing address labels (first/last name, address type (we do not wish
to display address that are not home addresses), line 1 and 2 of the address, city, state, and postal
code):
select
first_name,
last_name,
address_type,
line1,
line2,
city,
state,
postal_code
Then you need to choose where to get the information from and also any joins that need to take
place:
from
person
join person_address using (person_id)
join address using (address_id)
In our example we only want home address, therefore we only want addresses with type 2 (home in
our enumeration scheme). We also want the ability to filter the report by last initial so we have
inserted a token:
where
address_type = 2 and
last_name like'[last_initial:string]%'
Finally we want the field of address type to appear as text, not as the assigned enumeration number:
/*** dsFilters-address_type|enumLookup&ds|address_type
dsFilters-state|enumLookup&ds|state ***/
Templates
The first step in using a custom template in ClearHealth is to create one using a static HTML layout.
This is important to help you know what information you will need to pull from ClearHealth and
how you want this information displayed. A little bit of planning up front will really help make
creating a template much easier. After making a basic HTML mock up of what you want, you then
can make the template dynamic using Smarty (http://smarty.php.net/). We recommend using
Wordpad, and not Notepad as your plain text editor.
Once you
create a
template in
a plain text
editor you
must upload
the template
to ClearHealth. In order to add a template, click the Add a New Template button located below
the Query frame of the Add/Edit Report Page. Title the Template and be as specific as possible.
Select the Browse button and choose the template you wish to upload. Once you have selected the
appropriate file and named it accordingly select Update Template.
When creating a template, often times you may wish to see what you have created so far. An easy
way to make this process quicker is to open two tabs or windows in your web browser when
creating or altering a template. In the first tab display the Add New Report screen where you are
uploading templates. In the second tab, display the report you are creating/editing with the template
you wish to view. Each time you update the template you can simply switch to the second tab and
click your browser's reload button. Using this method it will not be necessary to navigate between
the editing screen and the view report screen, saving you time.
Practical Example: Printable Address Labels
A common use of reports in ClearHealth is patient address labels. From this report you can create a
custom template to match the formating of a specific printable address label sheet.
First, create an individual label:
<html>
<head>
{literal}
<style>
td {width: 350px;}
</style>
{/literal}
</head>
<body>
<table border=1>
<tr>
<td>
One Label
<br>
<br>
<br>
</td>
</tr>
</table>
</body>
</html>
Second, retrieve the desired information from the report:
{assign
var=addresses
value=$people_ds-
>to array()}
{assign
var=address
value=$addresses[
0]}
<html>
<head>
{literal}
<style>
td {width: 350px;}
</style>
{/literal}
</head>
<body>
<table border=1>
<tr>
<td>
{$address.first_name} {$address.last_name}<br />
{$address.line1}<br />
{$address.line2}<br />
{$address.city},{$address.state} {$address.postal_code}
</td>
</tr>
</table>
</body>
</html>
Third, format template to match your exact specifications, including number of rows and columns.
Make sure to account for any margins or blank space at the bottom of the page:
{assign
var=addres
ses
value=$people_ds->toArray()}
<html>
<head>
{literal}
<style>
td {width: 350px;}
</style>
{/literal}
</head>
<body>
<table border=1>
{* Loop over our addresses put each row into the address variable
*}
{foreach name=labels from=$addresses item=address}
</table>
</body>
</html>
Finally, tie all the steps together, creating a printable address label sheet with patient home
addresses:
{assign
var=addresse
s
value=$people_ds->toArray()}
<html>
<head>
{literal}
<style>
td {width: 350px;}
</style>
{/literal}
</head>
<body>
<table border=1>
<td>
{$address.first_name} {$address.last_name}<br />
{$address.line1}<br />
{$address.line2}<br />
{$address.city},{$address.state} {$address.postal_code}
</td>
{if $smarty.foreach.labels.iteration%20 eq 0}<tr
colspan=4><td><br /><br /><br /><br /></td>{/if}
{if $smarty.foreach.labels.iteration%4 eq 0}
</tr><tr>
{/if}
{if $smarty.foreach.labels.last}
</tr>{/if}
{/foreach}
</table>
</body>
</html>
What you should have learned:
Creating a extension
A ClearHealth extension is much like a standard html form, only the form elements are replaced
with ClearHealth specific tags. The first step in creating an extension for ClearHealth is to create a
mock up of what you wish that extension to look like in HTML. You will then go through and
replace the generic HTML tags with ClearHealth specific ones. Note that extensions are actually
smarty template engine files allowing all normal smarty plug ins and modifiers to be used. This also
means that any use of the “{“ or the “}” characters must be enclosed inside the {literal}{/literal}
tags.
Notice that instead of using an html <form > element you use the {clni_form } tag and instead of a
text area element you use an input tag with a type of text. The same replacement also happens with
the submit tag. The input tag is the main element used in your extensions; its options are described
in the tag reference below.
Plain HTML can be used for your formatting needs, just be aware that ClearHealth's style rules will
be in effect inside your extension so some tags may display differently than they would outside of
ClearHealth. You can include your own CSS directly into a extension , just make sure to enclose it
in a {literal}{/literal} tag.
ClearHealth Extension Tags Reference
Tags allow you to add functionality to your extensions. Their most common use is to add input
elements that will be stored, and some other basic from elements.
Tags look a lot like a normal html elements, but are bracketed by { and } instead of < and >. Tags
take attribute lists to specify how they work, and example tag is shown below:
{tagName attribute=”value” attribute2=”value”}
This tag starts the html extension , any other tags that submit data must be enclosed between it and
the </form > html element. No options need to be supplied to this tag.
Example Usage:
{clni_form }
Example Usage:
{submit}
A standard submit button
Integer:
This type creates a text input box with the results stored as an integer. By default a number
validation rule is also added.
{input name=”fieldname” type=”integer”}
Some common extension formatting attributes are size and max length
{input name="integer" type="integer" size="4" maxlength="6"}
check box:
The check box type produces a single check box. This tag is useful for storing yes/no type answers
since its value is always a 1 or a 0.
For check boxes you’ll commonly want to set a custom id attribute in order to tie it to a label. By
doing this a user can click on either on the check box or the label to select/deselect.
{input name="check box" type="check box" id="checkbox1"}<label
for="checkbox1">Checkbox Label</label>
String:
The string type produces an input box that can store up to 255 characters of text.
Some common extension formatting attributes are size and max length
{input name="string" type="string" size="40" max length="255"}
Text:
Date:
Select:
The select type produces a drop-down. Select is most commonly used with a system enumeration.
Either the enumeration attribute or the options attribute must be set.
{input name="select" type="select" enumeration="payer_type"}
Radio:
The radio type follows the same rules as select except it produces a list of radio buttons.
The display attribute may also be set to produce a horizontal list
{input name="radio" type="radio" enumeration="payer_type"
display=”horizontal”}
Multi select:
The multi select type follows the same rules as select except it produces a list of check boxes. Since
were storing multiple answers you’ll see multiple rows for this element in results view.
The display attribute may also be set to produce a horizontal list
{input name="multi select" type="multi select"
enumeration="payer_type"}
Validation Rules:
Validation is specified by adding a validation=”rule” attribute to the input tag. If the data in the
field does not match the rule it will be highlighted in red and the extension will not be submitted.
You can also add a message that will be shown at the top of the extension when validation rule is
triggered. This message is specified with the message attribute. The following rules are available.
{input name="validation" type="string" validation="required"
message="The Validation field is required"}
required
number
ssn
date
email
alphanum
alphastart
greaterthanzero
Example Extension with ClearHealth specific tags:
{literal}
<style type="text/css">
h3 {
margin: 0px;
padding: 0px;
padding-top: 2px;
}
</style>
{/literal}
{clni_form }
<h3>integer</h3>
{input name="integer" type="integer" size="4" max length="6"}
<h3>check box</h3>
{input name="check box" type="check box" id="checkbox1"}<label
for="checkbox1">Checkbox Label</label>
<h3>string</h3>
{input name="string" type="string" size="40" max length="255"}
<h3>text</h3>
{input name="text" type="text" rows="2" cols="40"}
<h3>date</h3>
{input name="date" type="date"}
<h3>select</h3>
{input name="select" type="select" enumeration="payer_type"}
<h3>radio</h3>
{input name="radio" type="radio" enumeration="payer_type"
display="horizontal"}
<h3>multi select</h3>
{input name="multi select" type="multi select"
enumeration="payer_type"}
<h3>Validation</h3>
{input name="validation" type="string" validation="required"
message="The Validation field is required"}
<h3>Submit Buttons</h3>
{submit}
{submit label="Update form "}
{submit label="Send Data" style="font-size:300%"}
</form >
Extension Example:
Managing Extensions
You can manage extensions from the Extensions menu in the Admin section of ClearHealth. To
view a specific extension click List Extensions and click on the name of the extension you wish
to view/edit.
Adding a extension
You can add a new extension by clicking on Add New extension and completing the Add New
Extension Page.
In the Name text field enter the title of the extension you will be adding.
You may view the data entered into an existing extension by selecting the View Extension Data
link at the bottom of the edit extension page. This will display a time stamp list of all the times
the extension has been filled out. You may view a specific extension by selecting the date/time
the extension was filled out.
Connecting a Extension to an Area of ClearHealth
To connect a specific extension to a specific area of ClearHealth you would use the Connect
option located on the Extensions menu in the Admin section.
To link a extension to an
area of ClearHealth,
select that area on the list
provided.
The new extension will appear in the Update Menu Entry Frame. You may delete a extension
connection simply by selecting the Delete button located directly to the right of the extension
title.
The extension is now connected to the area of ClearHealth that was selected. If you go to that
area of ClearHealth you will be able to verify that the extension is now available on that screen.
In this example
we will create a
Patient Vitals
Extension with
fields for height,
weight, blood
pressure, pulse,
eye tests, and
state selection.
General
formatting:
<html>
<head>
</head>
<body>
{clni_form}
<table>
<tr>
Height:
<td>height</td>
<td>{input type="string" name="height" size="5"}</td>
<td> </td>
Weight:
<td>weight</td>
<td>{input type="string" name="weight" size="3"}</td>
</tr>
Blood Pressure, represented by bp:
<tr>
<td>bp</td>
<td>{input type="string" name="bp" size="6" validation="number"
message="You must input a number"}</td>
Pulse:
<td> </td>
<td>pulse</td>
<td>{input type="string" name="pulse" size="3"}</td>
</tr>
Eye L and R:
<tr>
<td>eyes L</td>
<td>{input type="string" name="eyes_left" size="3"}</td>
<td> </td>
<td>R</td>
<td>{input type="string" name="eyes_right" size="3"}</td>
</tr>
State drop-down:
<tr><td>state</td><td>{input type="select" name="state"
enumeration="state"}
Submit button:
<tr><td>{submit}</td></tr>
</table>
</form>
</body>
</html>
After creating this file in a plain text editor (such as Wordpad) go to the Extensions menu found in
the Admin section of ClearHealth.
Select Add Extension from the Extensions menu.
tags