Documentation/help_files/procedure_provider_help.php

   1 <?php
   2 /**
   3  * Message Center Help.
   4  *
   5  * @package   OpenEMR
   6  * @link      http://www.open-emr.org
   7  * @author Ranganath Pathak <pathak@scrs1.org>
   8  * @copyright Copyright (c) 2018 Ranganath Pathak <pathak@scrs1.org>
   9  * @version 1.0.0
  10  * @license   https://github.com/openemr/openemr/blob/master/LICENSE GNU General Public License 3
  11  */
  12
  13 use OpenEMR\Core\Header;
  14
  15 require_once("../../interface/globals.php");
  16 ?>
  17 <!DOCTYPE HTML>
  18 <html>
  19     <head>
  20     <?php Header::setupHeader();?>
  21     <title><?php echo xlt("Message Center Help");?></title>
  22     </head>
  23     <body>
  24         <div class="container oe-help-container">
  25             <div>
  26                 <center><h2><a name='entire_doc'><?php echo xlt("Procedure Provider Help");?></a></h2></center>
  27             </div>
  28             <div class= "row">
  29                 <div class="col-sm-12">
  30                     <p><?php echo xlt("The Procedures module is used to place and review orders");?>.
  31
  32                     <p><i class="fa fa-exclamation-circle oe-text-orange"  aria-hidden="true"></i> <strong><?php echo xlt("In order to fulfill Meaningful Use requirements for Computerized Provider Order Entry (CPOE) for lab and radiology tests this module needs to be used");?>.</strong>
  33
  34                     <p><?php echo xlt("While it is intuitive to think of this module as the place where lab tests and imaging studies can be ordered and reviewed this module can also be used to track other procedures performed in office");?>.
  35
  36                     <p><?php echo xlt("The Procedure Order page lists the following procedure types"); ?>:
  37                         <ul>
  38                             <li><?php echo xlt("Procedure"); ?></li>
  39                             <li><?php echo xlt("Intervention"); ?></li>
  40                             <li><?php echo xlt("Laboratory Test"); ?></li>
  41                             <li><?php echo xlt("Physical Exam"); ?></li>
  42                             <li><?php echo xlt("Risk Category Assessment"); ?></li>
  43                             <li><?php echo xlt("Patient Characteristics"); ?></li>
  44                             <li><?php echo xlt("Imaging"); ?></li>
  45                             <li><?php echo xlt("Encounter Checkup Procedure"); ?></li>
  46                         </ul>
  47
  48                     <p><?php echo xlt("The procedure request needs to be structured in a hierarchical manner and a unique identifying code assigned to it that will then be used to track and tabulate the result");?>.
  49
  50                     <p><?php echo xlt("It consists of two parts - defining a Provider and configuring the Orders and Results");?>.
  51
  52                     <p><?php echo xlt("While lab tests and radiological tests can be performed in the practice facility they are generally done at an external facility and the provider details for that entity will have to be entered in openEMR before the Procedure module setup can begin");?>.
  53
  54                     <p><?php echo xlt("For procedures performed in the practice, whether it is an office based procedure or a lab or radiological procedure done in the facility, the provider can be defined as Local Lab, Office Based or have any descriptive name");?>.
  55
  56                     <p><?php echo xlt("The setup for lab tests will be described in detail, minor modification to these steps will be needed to setup in-office procedures and other procedure types");?>.
  57
  58                     <p><?php echo xlt("Integrating lab results into a patient's chart in openEMR can be done manually i.e. both ordering tests and uploading the received results or electronically");?>.
  59
  60                     <p><?php echo xlt("Electronic results can be bidirectional - both order tests and receive results electronically or unidirectional - only receive the results electronically");?>.
  61
  62                     <p><?php echo xlt("A third alternative is to scan the results and save it as a document - TIFF, JPEG or PDF in the patient's chart under documents");?>.
  63
  64                     <p><?php echo xlt("The advantage of integrating the results with the patient's chart as structured data is the ability to manipulate it to see trends in one convenient location, to plot graphs with the data and use it in data analysis");?>.
  65
  66                     <p><?php echo xlt("The advantage of scanning the results into the chart is simplicity - no setup is required other than defining a directory/folder in the patient's chart under Documents where the result will be stored. Being unstructured data it does not have the above advantages and will not fulfill Meaningful Use criteria for Computerized Provider Order Entry (CPOE)");?>.
  67
  68                     <p><?php echo xlt("If you choose to integrate lab results with the patient's record then some preliminary setup has to be performed");?>.
  69
  70                     <ul id="top_section">
  71                         <li><a href="#section1"><?php echo xlt("Define lab service locations");?></a></li>
  72                         <li><a href="#section2"><?php echo xlt("Check and adjust the settings in the standard release");?></a></li>
  73                         <li><a href="#section3"><?php echo xlt("Configure the lab test structure");?></a></li>
  74                     </ul>
  75
  76                     <p><?php echo xlt("These three steps are essential before orders can be placed and received results linked to a patient's chart");?>.
  77
  78                     <p><?php echo xlt("This is required for both manual lab result entry and for electronic ordering tests and receiving results");?>.
  79                 </div>
  80             </div>
  81             <div class= "row" id="section1">
  82                 <div class="col-sm-12">
  83                     <h4 class="oe-help-heading"><?php echo xlt("Define lab service locations"); ?><a href="#top_section"><i class="fa fa-arrow-circle-up oe-pull-away oe-help-redirect" aria-hidden="true"></i></a></h4>
  84                     <p><i class="fa fa-exclamation-triangle  oe-text-red" aria-hidden="true"></i> <strong><?php echo xlt("You need administrator privileges to perform this action"); ?>.</strong>
  85
  86                     <p><i class="fa fa-lightbulb-o fa-lg  oe-text-green" aria-hidden="true"></i>&nbsp <?php echo xlt("To use this help file as an instruction manual it is suggested that you reduce the size of the browser to cover half the viewport, resize the help pop-up by clicking and dragging the bottom right corner of the pop-up. Open another instance of the browser and resize it to cover the other half of the viewport, login to openEMR");?>.
  87
  88                     <p><?php echo xlt("Go to Administration > Address Book > Add New");?>.
  89
  90                     <p><?php echo xlt("Select Lab Service in the Type drop-down box and enter a name under organization");?>.
  91
  92                     <p><?php echo xlt("Check the CPOE (Computerized Provider Order Entry) check-box");?>.
  93
  94                     <p><?php echo xlt("For manual lab entry you can give the organization any name  - e.g Local Lab and click Save");?>.
  95                     <button type="button" class="btn btn-default btn-save btn-sm oe-no-float"><?php echo xlt("Save"); ?></button>
  96
  97                     <p><?php echo xlt("If you are using Electronic lab entry then fill in the required details and click Save");?>.
  98                     <button type="button" class="btn btn-default btn-save btn-sm oe-no-float"><?php echo xlt("Save"); ?></button>
  99
 100                     <p><?php echo xlt("If you are using multiple labs enter the details for each one of them");?>.
 101
 102                     <p><?php echo xlt("For this name to show in the drop-down box in the Procedures > Providers setup page select only Lab Service as the Type even if it represents a Radiological facility");?>.
 103
 104                     <p><?php echo xlt("These entries will be used to define the Providers in the Procedures module");?>.
 105
 106                     <p><?php echo xlt("Go to Procedures > Providers and click on the Add New button");?>.
 107                     <button type="button" class="btn btn-default btn-add btn-sm oe-no-float"><?php echo xlt("Add New"); ?></button>
 108
 109                     <p><?php echo xlt("The Enter Provider Details pop-up will be visible");?>.
 110
 111                     <p><?php echo xlt('Additional help to fill out this form is available by hovering over labels of each box and clicking on the dark blue help ? icon that is revealed'); ?>.
 112
 113                     <p><?php echo xlt('On mobile devices tap once on the label to reveal the help icon and tap on the icon to show the help section'); ?>.
 114
 115                     <p><?php echo xlt("Select the name of the entity from the Name drop-down box");?>.
 116
 117                     <p><?php echo xlt("Fill in the required details especially for the external facilities and click Save");?>.
 118                     <button type="button" class="btn btn-default btn-sm oe-no-float"><?php echo xlt("Save"); ?></button>
 119
 120                     <p><?php echo xlt("Add all needed providers in a similar manner");?>.
 121                 </div>
 122             </div>
 123             <div class= "row" id="section2">
 124                 <div class="col-sm-12">
 125                     <h4 class="oe-help-heading"><?php echo xlt("Check and adjust the settings in the standard release"); ?><a href="#top_section"><i class="fa fa-arrow-circle-up oe-pull-away oe-help-redirect" aria-hidden="true"></i></a></h4>
 126                     <p><?php echo xlt("Before proceeding to configuring the tests themselves you would need to review the values included in the standard release and make changes according to need");?>.
 127
 128                     <p><?php echo xlt("The values listed here will show up in the drop-down boxes that will be used to process orders");?>.
 129
 130                      <p><?php echo xlt("There are 10 settings that are related to procedures included in the standard release of openEMR"); ?>.&nbsp <i id="show_hide" class="fa fa-eye fa-lg small" title="<?php echo xla('Click to Show'); ?>"></i>
 131
 132                     <div id="proc_list" class='hideaway' style='display: none;'>
 133                         <ul>
 134                             <li><?php echo xlt('Procedure Body Sites');?></li>
 135                             <li><?php echo xlt('Procedure Boolean Results');?></li>
 136                             <li><?php echo xlt('Procedure Lateralities');?></li>
 137                             <li><?php echo xlt('Procedure Report Statuses');?></li>
 138                             <li><?php echo xlt('Procedure Report Abnormal');?></li>
 139                             <li><?php echo xlt('Procedure Result Statuses');?></li>
 140                             <li><?php echo xlt('Procedure Routes');?></li>
 141                             <li><?php echo xlt('Procedure Specimen Types');?></li>
 142                             <li><?php echo xlt('Procedure Types');?></li>
 143                             <li><?php echo xlt('Procedure Units');?></li>
 144                         </ul>
 145                     </div>
 146
 147                     <p><i class="fa fa-exclamation-triangle  oe-text-red" aria-hidden="true"></i> <strong><?php echo xlt("You need administrator privileges to perform this action"); ?>.</strong>
 148
 149                     <p><?php echo xlt("Go to Administration > Lists, select each one of the above lists from the drop-down box and make changes as needed");?>.
 150
 151                     <p><?php echo xlt("Upon selecting a list to edit the edit page with the list values will be displayed");?>.
 152
 153                     <p><?php echo xlt("For editing the values under Procedures you would need to modify");?>:
 154
 155                         <ul>
 156                             <li><?php echo xlt("ID - select a unique three letter id, all in lower case"); ?></li>
 157                             <li><?php echo xlt("Title - The value that will be displayed - Each word to begin with an uppercase letter"); ?></li>
 158                             <li><?php echo xlt("Order - The order in which the item will be displayed - incrementing by 10 will allow for up to 9 values to be inserted in between if so desired at a later date"); ?></li>
 159                             <li><?php echo xlt("Default - Check any check box and this value will show up in the displayed drop-down box as the default value"); ?></li>
 160                             <li><?php echo xlt("Active - By default any value added here will be set to Active, to prevent/remove an item from showing up in the drop-down list just uncheck and deactivate"); ?></li>
 161                             <li><?php echo xlt("Notes - A short description that will show up as a tooltip"); ?></li>
 162                             <li><?php echo xlt("Codes - Leave blank"); ?></li>
 163                         </ul>
 164
 165                     <p><?php echo xlt("Procedure Body Sites - Arm, Buttock and Other - used for immunization - modify as needed");?>.
 166
 167                     <p><?php echo xlt("Procedure Boolean Results - No and Yes");?>.
 168
 169                     <p><?php echo xlt("Procedure Lateralities - Left, Right and Bilateral");?>.
 170
 171                     <p><?php echo xlt("Procedure Report Statuses - Final, Reviewed, Preliminary, Canceled, Error and Corrected");?>.
 172
 173                     <p><?php echo xlt("Procedure Report Abnormal - No, Yes, High, Low Above upper panic limit and Below lower panic limit");?>.
 174
 175                     <p><?php echo xlt("Procedure Result Statuses - Final, Preliminary, Canceled, Error, Corrected and Incomplete");?>.
 176
 177                     <p><?php echo xlt("Procedure Routes - Injection, Oral and Other");?>.
 178
 179                     <p><?php echo xlt("Procedure Specimen Types - Blood, Saliva, Urine and Other");?>.
 180
 181                     <p><i class="fa fa-exclamation-circle  oe-text-orange" aria-hidden="true"></i>&nbsp<?php echo xlt("Procedure Types - Group, Procedure Order, Discrete Result, Recommendation, Custom Favorite Group and Custom Favorite Item. Used in the next step - Configure the lab test structure");?>.
 182
 183                     <p><?php echo xlt("Custom Favorite Group and Custom Favorite Item is used to create customized groups of orders");?>. <i class="fa fa-exclamation-circle oe-text-orange" aria-hidden="true"></i>&nbsp;<strong><?php echo xlt("New in openEMR ver 5.0.2 "); ?></strong></li>
 184
 185                     <p><?php echo xlt("Procedure Units - various units needed to define result values - may need to add to this list depending on the tests that are included, will vary according to need");?>.
 186
 187                     <p><?php echo xlt("Once this step is completed you can proceed to next step - to configure the tests that can be ordered from the system");?>.
 188                 </div>
 189             </div>
 190             <div class= "row" id="section3">
 191                 <div class="col-sm-12">
 192                     <h4 class="oe-help-heading"><?php echo xlt("Configure the lab test structure"); ?><a href="#top_section"><i class="fa fa-arrow-circle-up oe-pull-away oe-help-redirect" aria-hidden="true"></i></a></h4>
 193                     <p><?php echo xlt("To configure the lab test go to Procedures > Configuration");?>.
 194
 195                     <p><?php echo xlt("The help file there will guide you on further steps in setting up the lab tests");?>.
 196                 </div>
 197             </div>
 198         </div><!--end of container div-->
 199         <script>
 200            $('#show_hide').click(function() {
 201                 var elementTitle = $('#show_hide').prop('title');
 202                 var hideTitle = '<?php echo xla('Click to Hide'); ?>';
 203                 var showTitle = '<?php echo xla('Click to Show'); ?>';
 204                 $('.hideaway').toggle('1000');
 205                 $(this).toggleClass('fa-eye-slash fa-eye');
 206                 if (elementTitle == hideTitle) {
 207                     elementTitle = showTitle;
 208                 } else if (elementTitle == showTitle) {
 209                     elementTitle = hideTitle;
 210                 }
 211                 $('#show_hide').prop('title', elementTitle);
 212             });
 213         </script>
 214     </body>
 215 </html>