Updated documentation.
[openemr.git] / interface / forms / CAMOS / help.html
blob8ee602bd776be771bd81da497866122ef84e604a
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
5 <html>
6 <head>
7 <title>CAMOS Help</title>
8 <link rel="stylesheet" type="text/css"
9 href="CAMOS.css"
11 </head>
12 <body>
13 <a name='top'>
14 <div id='myheader'>CAMOS Help Page</div>
15 <!-- <div id='mypic'><img src='palm.gif'></div> -->
16 <br/><br/>
17 <div id='mymenu'>
18 <a href="#intro">Introduction</a> |
19 <a href="#basic">Basic Use</a> |
20 <a href="#rx">Prescription and Progress note Printing [New!]</a> |
21 <a href="#advanced">Advanced Use</a>
22 </div>
23 <a name='intro'>
24 <hr/>
25 <h1>Introduction</h1>
26 <p><a href='#top'>Top</a></p>
27 <p>
28 CAMOS (Computer Aided Medical Ordering System) is, on the surface,
29 just a fancy interface for organizing and choosing pieces of text
30 to insert into a patient's chart. It is designed to be intuitive
31 and easy to use.
32 </p>
33 <p>
34 <b>
35 WARNING: The CAMOS form has been tested, but there is the possibility that bugs exist which may corrupt your data.
36 It is also possible that the use of this form may lead to the incorrect entry of data.
37 The data provided in the three columns upon initial installation of CAMOS is for demonstration purposes only.
38 It is recommended that you delete all of it and start over with your own, carefully planned, structure of categories, subcategories
39 and items. The included data may be incorrect and should not be used and the author of this software assumes no liability for any
40 damage that occurs as a result of the data or as a result of the use of the CAMOS form in general.
41 </b>
42 </p>
43 <a name='basic'>
44 <hr/>
45 <h1>Basic Use</h1>
46 <p><a href='#top'>Top</a></p>
47 <p>
48 <b>add</b> button - Type something in the text box above the button and it will be added to the column above.
49 </p>
50 <p>
51 <b>alter</b> button - Select text in the column above and type something in the text box above the button and the column text will be altered.
52 </p>
53 <p>
54 <b>del</b> button - Select text in the column above and press the button to delete it.
55 </p>
56 <p>
57 <b>submit all content</b> button - Submit text in content box to patient's chart.
58 </p>
59 <p>
60 <b>submit selected content</b> button - Submit only selected text in content box to patient's chart. <b><u><i>This does not work in Internet Explorer.</i></u></b>
61 </p>
62 <p>
63 <b>add to</b> button - Like the add button for content but instead of replacing existing content with new, it appends the new text to the existing content.
64 </p>
65 <p>
66 <b>lock</b> button - Inserts text: '/*lock::*/' which prevents accidental deletion. Admittedly a dumb way to do it, but maybe helpful.
67 </p>
68 <p>
69 <b>icd9</b> button - Inserts icd9 codes from billing table for this encounter. You have to remember to enter them first before viewing this form.
70 </p>
71 <p>
72 <b>search</b> button - Searches content from form_CAMOS table based on keywords entered in text box to the left of the button. Starting the keywords with the word 'codes' or 'billing' will search the codes or billing table for matching icd9, cpt4 or other codes. Data is displayed in the content box in camos function format (see advanced section below).
73 </p>
74 <p>
75 <b>search selected</b> button - Like the search button described above, but searches are limited by what is selected in the columns.
76 </p>
77 <p>
78 <b>Additional features of search box</b> - If you entere a colon (':') in the search box, patient data will be displayed with results. If you enter a double colon ('::'), patient data and phone number data will be displayed with results. If you put a first and/or last name in any order before the colon, results for matching names will be displayed. If you put the word 'this' before the colon, the current selected patient's data will be displayed. Words after the colon will be used as search terms. These features work with the 'search' and 'search selected' buttons.
79 </p>
80 <h3>Top Row of Buttons:</h3>
81 <b>clone</b> button - Searches for list of entries in this patient's history under the selected category and returns the most recent of each. Data is displayed in the content box in camos function format (see advanced section below).
82 </p>
83 <p>
84 <b>clone last visit</b> button - Returns all CAMOS submitted items from last encounter plus billing table data. Data is displayed in the content box in camos function format (see advanced section below). By last encounter, we mean the last encounter which has billing entries associated with it.
85 </p>
86 <p>
87 <b>Leave The Form</b> link - Leave the CAMOS form without saving data to patient's chart.
88 </p>
89 <p>
90 <b>help</b> link - Access this help page.
91 </p>
93 </a>
94 <a name='rx'>
95 <hr/>
96 <h1>Prescription and Progress note Printing</h1>
97 <p><a href='#top'>Top</a></p>
98 <p>
99 After leaving the CAMOS form, Your entries will show with a link titled 'rx'. Click on this link, choose which items to print with checkboxes and submit. Make sure to set all margins to zero and print in landscape mode. There are a variety of other links as well. 'sig_rx' generates prescriptions with a signature image. The user must create a signature image and name it sig.jpg in the CAMOS directory for this to work. 'Print This Encounter' and 'Print Any Encounter' allow for printing of progress notes. The vitals table data and CAMOS data are integrated. The format depends on having CAMOS categories 'exam' and 'prescriptions'. For customization, programmers can edit the file notegen.php. Forms other than vitals and CAMOS will not appear in these notes.
101 <a name='advanced'>
102 <hr/>
103 <h1>Advanced Use</h1>
104 <p><a href='#top'>Top</a></p>
106 For the advanced user
107 </p>
109 <b>Accessing CAMOS from outside of an encounter.</b><br>
110 </p>
112 The CAMOS form has uses that are not related to a patient encounter. For example, you may maintain a list of referral sources to submit in a patient's chart if you wish to refer the patient, but you may want to look at referral data in CAMOS without going into the chart. This would be like CAMOS doubling as a phone book. Another use is to build up content data for future use without having to go into a patient's chart. To access CAMOS externally, setup a bookmark or link with the following url:
113 <br/><br/>
114 http://webroot/interface/forms/CAMOS/new.php?mode=external
115 <br/><br/>
116 This will hide buttons which should not be used if you are not in an encounter.
117 </p>
119 <b>Comments</b><br>
120 </p>
122 CAMOS supports C style comments. Here is how they work. A comment opens with /* and closes with */. You cannot nest comments. You cannot overlap comments. Anything in a comment will be seen within CAMOS in the item window, but it will not show when you enter it into the patient's chart. This is useful for making notes on items that are not appropriate to go in the chart. You may want, for example, to document which insurance a particular facility accepts.
124 </p>
126 <div class='box'>
127 <div class='code'>
128 <pre>
129 /* Accepts BC/BS */ ok
130 /* rx list follows */ ok
131 /* /* */ */ not right
132 </pre>
133 </div>
134 </div>
136 <b>Special Double Clicking</b><br>
137 </p>
139 Double clicking between the comment delimiters /* and */ in the content box will select the delimiters and text between them. Double clicking again, will remove surrounding text other than what was selected (crop to selection). Double clicking a third time will return removed text to the content box. This is useful for managing data formatted as embedded functions as described below and with the submit selected content button.
140 </p>
142 <b>Embedded functions</b><br>
143 </p>
145 Embedded functions are contained within comments. The first word is the function name. A '::' follows, and then a list of function arguments, each seperated by '::'.
146 </p>
148 The <b>billing</b> function<br><br>
149 If you want to enter an entry into the billing table to have, for example, a CPT4 or ICD9 code come up after entering a CAMOS form into a patient's chart, do this:
150 </p>
151 <b>billing function signature</b>
152 <div class='box'>
153 <div class='code'>
154 <pre>
155 /*billing::code_type::code::code_text::modifier::units::fee::justify1::justify2*/
156 </pre>
157 </div>
158 </div>
159 <b>Examples</b>
160 <div class='box'>
161 <div class='code'>
162 <pre>
163 /*billing::CPT4::80054::CMP:: :: ::50.00*/ /*add a cmp for $50*/
164 /*billing::CPT4::85024::CBC:: :: ::25.00*/ /*add a cbc*/
165 /*billing::CPT4::80061::Lipid Panel:: :: ::50.00*/
166 /*billing::ICD9::V70.0::physical:: :: ::0.00*/ /*this is a diagnosis, not a procedure*/
167 </pre>
168 </div>
169 </div>
172 The <b>camos</b> function, CAMOS calling CAMOS:
173 </p>
175 This function is used by the cloning features. You may take advantage of it yourself. Obvserve how it is used. Keyword is 'camos' and arguments are category, subcatory, item, content.
176 </p>
177 <!-- start new function description -->
179 The <b>replace</b> function. Used as follows:
180 </p>
181 <div class='box'>
182 <div class='code'>
183 <pre>
184 Atenolol 50mg
185 /*replace::30 tablets qd*/
186 </pre>
187 </div>
188 </div>
190 In this example, the replace function looks for an 'item' entry called '30 tablets qd' and replaces the function call with the text from the associated content box. This replace function works recursively, meaning that if the text which is used in the replacement contains a call to 'replace' itself, this will be called as well. Other function calls will be executed only after all replace calls are completed.
191 </p>
192 <!-- end new function description -->
194 <!-- start new function description -->
196 The <b>vitals</b> function. Used as follows:
197 </p>
198 <div class='box'>
199 <div class='code'>
200 <pre>
201 /*vitals::wt::ht::bps::bpd::pulse::temp*/
202 </pre>
203 </div>
204 </div>
206 This function submits vital sign data to the vitals table.
207 </p>
208 <!-- end new function description -->
210 <!-- start new function description -->
212 The <b>date_add</b> function. Used as follows:
213 </p>
214 <div class='box'>
215 <div class='code'>
216 <pre>
217 /*date_add::x*/
218 </pre>
219 </div>
220 </div>
222 This function call is replaced by the day of the week and date x days from the encounter date.
223 </p>
224 <!-- end new function description -->
226 <!-- start new function description -->
228 The <b>date_sub</b> function. Used as follows:
229 </p>
230 <div class='box'>
231 <div class='code'>
232 <pre>
233 /*date_sub::x*/
234 </pre>
235 </div>
236 </div>
238 Same as date_add but it subtracts x days from the encounter date.
239 </p>
240 <!-- end new function description -->
242 <!-- start new function description -->
244 The <b>appt</b> function. Used as follows:
245 </p>
246 <div class='box'>
247 <div class='code'>
248 <pre>
249 /*appt::x::time*/
250 </pre>
251 </div>
252 </div>
254 This function submits an appointment to the calendar x days from the current date at time. Note: this needs work. The function may not submit all of the data required for the appointment to actually appear in the regular calendar, so it's probably not too useful to anyone at this point.
255 </p>
256 <!-- end new function description -->
258 <!-- start new function description -->
260 <b>patientname, patientage, patientgender, doctorname</b>. Used as follows:
261 </p>
262 <div class='box'>
263 <div class='code'>
264 <pre>
265 patientname is a patientage year-old patientgender patient of doctorname.
266 </pre>
267 </div>
268 </div>
270 These keywords are substituted with the appropriate information from the patient's demographic data.
271 </p>
272 <!-- end new function description -->
273 <h1>Known Bugs</h1>
275 After editing a prescription in view.php, extra spaces appear between lines when printing the prescription.<br/>
276 Search results with 'search' and 'search selected' are in order of form_CAMOS id and not encounter.<br/>
277 </p>
278 </body>
280 </html>