src/RestControllers/PractitionerRestController.php

   1 <?php
   2
   3 /**
   4  * PractitionerRestController
   5  *
   6  * @package   OpenEMR
   7  * @link      http://www.open-emr.org
   8  * @author    Matthew Vita <matthewvita48@gmail.com>
   9  * @author    Yash Bothra <yashrajbothra786gmail.com>
  10  * @copyright Copyright (c) 2018 Matthew Vita <matthewvita48@gmail.com>
  11  * @license   https://github.com/openemr/openemr/blob/master/LICENSE GNU General Public License 3
  12  */
  13
  14 namespace OpenEMR\RestControllers;
  15
  16 use OpenEMR\Services\PractitionerService;
  17 use OpenEMR\RestControllers\RestControllerHelper;
  18
  19 class PractitionerRestController
  20 {
  21     private $practitionerService;
  22
  23     /**
  24      * White list of practitioner search fields
  25      */
  26     private const WHITELISTED_FIELDS = array(
  27         "title",
  28         "fname",
  29         "lname",
  30         "mname",
  31         "federaltaxid",
  32         "federaldrugid",
  33         "upin",
  34         "facility_id",
  35         "facility",
  36         "npi",
  37         "email",
  38         "specialty",
  39         "billname",
  40         "url",
  41         "assistant",
  42         "organization",
  43         "valedictory",
  44         "street",
  45         "streetb",
  46         "city",
  47         "state",
  48         "zip",
  49         "phone",
  50         "fax",
  51         "phonew1",
  52         "phonecell",
  53         "notes",
  54         "state_license_number",
  55         "username"
  56     );
  57
  58     public function __construct()
  59     {
  60         $this->practitionerService = new PractitionerService();
  61     }
  62
  63     /**
  64      * Fetches a single practitioner resource by id.
  65      * @param $uuid- The practitioner uuid identifier in string format.
  66      */
  67     public function getOne($uuid)
  68     {
  69         $processingResult = $this->practitionerService->getOne($uuid);
  70
  71         if (!$processingResult->hasErrors() && count($processingResult->getData()) == 0) {
  72             return RestControllerHelper::handleProcessingResult($processingResult, 404);
  73         }
  74
  75         return RestControllerHelper::handleProcessingResult($processingResult, 200);
  76     }
  77
  78     /**
  79      * Returns practitioner resources which match an optional search criteria.
  80      */
  81     public function getAll($search = array())
  82     {
  83         $validSearchFields = $this->practitionerService->filterData($search, self::WHITELISTED_FIELDS);
  84         $processingResult = $this->practitionerService->getAll($validSearchFields);
  85         return RestControllerHelper::handleProcessingResult($processingResult, 200, true);
  86     }
  87
  88     /**
  89      * Process a HTTP POST request used to create a practitioner record.
  90      * @param $data - array of practitioner fields.
  91      * @return a 201/Created status code and the practitioner identifier if successful.
  92      */
  93     public function post($data)
  94     {
  95         $filteredData = $this->practitionerService->filterData($data, self::WHITELISTED_FIELDS);
  96         $processingResult = $this->practitionerService->insert($filteredData);
  97         return RestControllerHelper::handleProcessingResult($processingResult, 201);
  98     }
  99
 100     /**
 101      * Processes a HTTP PATCH request used to update an existing practitioner record.
 102      * @param $uuid - The practitioner uuid identifier in string format.
 103      * @param $data - array of practitioner fields (full resource).
 104      * @return a 200/Ok status code and the practitioner resource.
 105      */
 106     public function patch($uuid, $data)
 107     {
 108         $filteredData = $this->practitionerService->filterData($data, self::WHITELISTED_FIELDS);
 109         $processingResult = $this->practitionerService->update($uuid, $filteredData);
 110         return RestControllerHelper::handleProcessingResult($processingResult, 200);
 111     }
 112 }