Civi/Api4/Generic/DAOSaveAction.php

   1 <?php
   2
   3 /*
   4  +--------------------------------------------------------------------+
   5  | Copyright CiviCRM LLC. All rights reserved.                        |
   6  |                                                                    |
   7  | This work is published under the GNU AGPLv3 license with some      |
   8  | permitted exceptions and without any warranty. For full license    |
   9  | and copyright information, see https://civicrm.org/licensing       |
  10  +--------------------------------------------------------------------+
  11  */
  12
  13 /**
  14  *
  15  * @package CRM
  16  * @copyright CiviCRM LLC https://civicrm.org/licensing
  17  */
  18
  19
  20 namespace Civi\Api4\Generic;
  21
  22 /**
  23  * Create or update one or more $ENTITIES.
  24  *
  25  * If creating more than one $ENTITY with similar values, use the `defaults` param.
  26  *
  27  * Set `reload` if you need the api to return complete records for each saved $ENTITY.
  28  */
  29 class DAOSaveAction extends AbstractSaveAction {
  30   use Traits\DAOActionTrait;
  31
  32   /**
  33    * @inheritDoc
  34    */
  35   public function _run(Result $result) {
  36     foreach ($this->records as &$record) {
  37       $record += $this->defaults;
  38       $this->formatWriteValues($record);
  39       if (empty($record['id'])) {
  40         $this->fillDefaults($record);
  41       }
  42     }
  43     $this->validateValues();
  44
  45     $resultArray = $this->writeObjects($this->records);
  46
  47     $result->exchangeArray($resultArray);
  48   }
  49
  50 }