interface/forms/CAMOS/help.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2
   3
   4
   5 <html>
   6 <head>
   7   <title>CAMOS Help</title>
   8   <link rel="stylesheet" type="text/css"
   9         href="CAMOS.css"
  10         >
  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       <a href="#troubleshooting">Trouble Shooting</a>
  23       <a href="#admin">Import/Export [<i>Very</i> experimental]</a>
  24 </div>
  25 <a name='intro'>
  26 <hr/>
  27 <h1>Introduction</h1>
  28 <p><a href='#top'>Top</a></p>
  29 <p>
  30 CAMOS (Computer Aided Medical Ordering System) is, on the surface,
  31 just a fancy interface for organizing and choosing pieces of text
  32 to insert into a patient's chart.  It is designed to be intuitive
  33 and easy to use.
  34 </p>
  35 <p>
  36 <b>
  37 WARNING: The CAMOS form has been tested, but there is the possibility that bugs exist which may corrupt your data.
  38 It is also possible that the use of this form may lead to the incorrect entry of data.
  39 The data provided in the three columns upon initial installation of CAMOS is for demonstration purposes only.
  40 It is recommended that you delete all of it and start over with your own, carefully planned, structure of categories, subcategories
  41  and items.  The included data may be incorrect and should not be used and the author of this software assumes no liability for any
  42 damage that occurs as a result of the data or as a result of the use of the CAMOS form in general.
  43 </b>
  44 </p>
  45 <a name='basic'>
  46 <hr/>
  47 <h1>Basic Use</h1>
  48 <p><a href='#top'>Top</a></p>
  49 <p>
  50 <b>add</b> button - Type something in the text box above the button and it will be added to the column above.
  51 </p>
  52 <p>
  53 <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.
  54 </p>
  55 <p>
  56 <b>del</b> button - Select text in the column above and press the button to delete it.  In the 'Item' column, you can use your 'Ctrl' key (PC) or Apple key (Mac) and click multiple items for deletion.
  57 </p>
  58 <p>
  59 <b>submit all content</b> button - Submit text in content box to patient's chart.
  60 </p>
  61 <p>
  62 <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>
  63 </p>
  64 <p>
  65 <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.
  66 </p>
  67 <p>
  68 <b>lock</b> button - Inserts text: '/*lock::*/' which prevents accidental deletion.  Admittedly a dumb way to do it, but maybe helpful.
  69 </p>
  70 <p>
  71 <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.
  72 </p>
  73 <p>
  74 <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).
  75 </p>
  76 <p>
  77 <b>search selected</b> button -  Like the search button described above, but searches are limited by what is selected in the columns.
  78 </p>
  79 <p>
  80 <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.
  81 </p>
  82 <h3>Top Row of Buttons:</h3>
  83 <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).
  84 </p>
  85 <p>
  86 <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.
  87 </p>
  88 <p>
  89 <b>Leave The Form</b> link - Leave the CAMOS form without saving data to patient's chart.
  90 </p>
  91 <p>
  92 <b>help</b> link - Access this help page.
  93 </p>
  94
  95 </a>
  96 <a name='rx'>
  97 <hr/>
  98 <h1>Prescription and Progress note Printing</h1>
  99 <p><a href='#top'>Top</a></p>
 100 <p>
 101 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.
 102
 103 <a name='advanced'>
 104 <hr/>
 105 <h1>Advanced Use</h1>
 106 <p><a href='#top'>Top</a></p>
 107 <p>
 108 For the advanced user
 109 </p>
 110 <p>
 111 <b>Accessing CAMOS from outside of an encounter.</b><br>
 112 </p>
 113 <p>
 114 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:
 115 <br/><br/>
 116 http://webroot/interface/forms/CAMOS/new.php?mode=external
 117 <br/><br/>
 118 This will hide buttons which should not be used if you are not in an encounter.
 119 </p>
 120 <p>
 121 <b>Comments</b><br>
 122 </p>
 123 <p>
 124 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.
 125
 126 </p>
 127
 128 <div class='box'>
 129 <div class='code'>
 130 <pre>
 131 /* Accepts BC/BS */   ok
 132 /* rx list follows */ ok
 133 /* /*     */ */       not right
 134 </pre>
 135 </div>
 136 </div>
 137 <p>
 138 <b>Special Double Clicking</b><br>
 139 </p>
 140 <p>
 141 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.
 142 </p>
 143 <p>
 144 <b>Embedded functions</b><br>
 145 </p>
 146 <p>
 147 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 '::'.
 148 </p>
 149 <p>
 150 The <b>billing</b> function<br><br>
 151 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:
 152 </p>
 153 <b>billing function signature</b>
 154 <div class='box'>
 155 <div class='code'>
 156 <pre>
 157 /*billing::code_type::code::code_text::modifier::units::fee::justify1::justify2*/
 158 </pre>
 159 </div>
 160 </div>
 161 <b>Examples</b>
 162 <div class='box'>
 163 <div class='code'>
 164 <pre>
 165 /*billing::CPT4::80054::CMP:: :: ::50.00*/ /*add a cmp for $50*/
 166 /*billing::CPT4::85024::CBC:: :: ::25.00*/ /*add a cbc*/
 167 /*billing::CPT4::80061::Lipid Panel:: :: ::50.00*/
 168 /*billing::ICD9::V70.0::physical:: :: ::0.00*/ /*this is a diagnosis, not a procedure*/
 169 </pre>
 170 </div>
 171 </div>
 172
 173 <p>
 174 The <b>camos</b> function, CAMOS calling CAMOS:
 175 </p>
 176 <p>
 177 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.
 178 </p>
 179 <!-- start new function description -->
 180 <p>
 181 The <b>replace</b> function.  Used as follows:
 182 </p>
 183 <div class='box'>
 184 <div class='code'>
 185 <pre>
 186 Atenolol 50mg
 187 /*replace::30 tablets qd*/
 188 </pre>
 189 </div>
 190 </div>
 191 <p>
 192 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.
 193 </p>
 194 <!-- end new function description -->
 195
 196 <!-- start new function description -->
 197 <p>
 198 The <b>vitals</b> function.  Used as follows:
 199 </p>
 200 <div class='box'>
 201 <div class='code'>
 202 <pre>
 203 /*vitals::wt::ht::bps::bpd::pulse::temp*/
 204 </pre>
 205 </div>
 206 </div>
 207 <p>
 208 This function submits vital sign data to the vitals table.
 209 </p>
 210 <!-- end new function description -->
 211
 212 <!-- start new function description -->
 213 <p>
 214 The <b>date_add</b> function.  Used as follows:
 215 </p>
 216 <div class='box'>
 217 <div class='code'>
 218 <pre>
 219 /*date_add::x*/
 220 </pre>
 221 </div>
 222 </div>
 223 <p>
 224 This function call is replaced by the day of the week and date x days from the encounter date.
 225 </p>
 226 <!-- end new function description -->
 227
 228 <!-- start new function description -->
 229 <p>
 230 The <b>date_sub</b> function.  Used as follows:
 231 </p>
 232 <div class='box'>
 233 <div class='code'>
 234 <pre>
 235 /*date_sub::x*/
 236 </pre>
 237 </div>
 238 </div>
 239 <p>
 240 Same as date_add but it subtracts x days from the encounter date.
 241 </p>
 242 <!-- end new function description -->
 243
 244 <!-- start new function description -->
 245 <p>
 246 The <b>appt</b> function.  Used as follows:
 247 </p>
 248 <div class='box'>
 249 <div class='code'>
 250 <pre>
 251 /*appt::x::time*/
 252 </pre>
 253 </div>
 254 </div>
 255 <p>
 256 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.
 257 </p>
 258 <!-- end new function description -->
 259
 260 <!-- start new function description -->
 261 <p>
 262 <b>patientname, patientage, patientgender, doctorname</b>.  Used as follows:
 263 </p>
 264 <div class='box'>
 265 <div class='code'>
 266 <pre>
 267 patientname is a patientage year-old patientgender patient of doctorname.
 268 </pre>
 269 </div>
 270 </div>
 271 <p>
 272 These keywords are substituted with the appropriate information from the patient's demographic data.
 273 </p>
 274 <!-- end new function description -->
 275 <a name='troubleshooting'>
 276 <hr/>
 277 <h1>Trouble Shooting</h1>
 278 <p><a href='#top'>Top</a></p>
 279 <p>
 280 <b>Data in the 'category', 'subcategory' and 'item' columns and the 'content' box disappear and the form becomes non-functional (none of the buttons do anything).</b> - This is caused by bugs that corrupt the Javascript code as it is generated by PHP.  We hope that these bugs have been eliminated, but there is the possibility of unforseen use that may cause it to happen again.  First, exit the form and re-enter it.  If everything comes back as normal, remove the most recently entered data into the form.  If not, you will have to go into the database to correct the problem.  Be careful to back up your data first.
 281 If your most recent entry before the problem was to the 'category' column, remove the last entry to the form_CAMOS_category table.
 282 If your most recent entry before the problem was to the 'subcategory' column, remove the last entry to the form_CAMOS_subcategory table.
 283 If your most recent entry before the problem was to the 'item' column, remove the last entry to the form_CAMOS_item table.
 284 If your most recent entry before the problem was to the 'content' box, remove the last entry to the form_CAMOS_item table.
 285 Please make a note of the offending data which caused the problem and report it on the <a href='http://sourceforge.net/forum/forum.php?forum_id=202506'>developer's forum</a>.
 286 </p>
 287 <p>
 288 <b>Other bugs or unusual behavior</b> - please report to the forum at the above link.
 289 </p>
 290 <a name='admin'>
 291 <hr/>
 292 <h1>Import/Export</h1>
 293 <p><a href='#top'>Top</a></p>
 294 <p>
 295 NOT FOR PRODUCTION USE YET!  Try on test servers only where lost data will not be important.  <a href="./admin.php" target=_new>admin page</a>
 296 </p>
 297 </body>
 298 </html>