data/Relationships/EmailAddressRelationship.php

   1 <?php
   2 if(!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');
   3 /*********************************************************************************
   4  * SugarCRM Community Edition is a customer relationship management program developed by
   5  * SugarCRM, Inc. Copyright (C) 2004-2012 SugarCRM Inc.
   6  *
   7  * This program is free software; you can redistribute it and/or modify it under
   8  * the terms of the GNU Affero General Public License version 3 as published by the
   9  * Free Software Foundation with the addition of the following permission added
  10  * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
  11  * IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
  12  * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
  13  *
  14  * This program is distributed in the hope that it will be useful, but WITHOUT
  15  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  16  * FOR A PARTICULAR PURPOSE.  See the GNU Affero General Public License for more
  17  * details.
  18  *
  19  * You should have received a copy of the GNU Affero General Public License along with
  20  * this program; if not, see http://www.gnu.org/licenses or write to the Free
  21  * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  22  * 02110-1301 USA.
  23  *
  24  * You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
  25  * SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
  26  *
  27  * The interactive user interfaces in modified source and object code versions
  28  * of this program must display Appropriate Legal Notices, as required under
  29  * Section 5 of the GNU Affero General Public License version 3.
  30  *
  31  * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
  32  * these Appropriate Legal Notices must retain the display of the "Powered by
  33  * SugarCRM" logo. If the display of the logo is not reasonably feasible for
  34  * technical reasons, the Appropriate Legal Notices must display the words
  35  * "Powered by SugarCRM".
  36  ********************************************************************************/
  37
  38
  39 require_once("data/Relationships/M2MRelationship.php");
  40
  41 /**
  42  * Represents a many to many relationship that is table based.
  43  * @api
  44  */
  45 class EmailAddressRelationship extends M2MRelationship
  46 {
  47     /**
  48      * For Email Addresses, there is only a link from the left side, so we need a new add function that ignores rhs
  49      * @param  $lhs SugarBean left side bean to add to the relationship.
  50      * @param  $rhs SugarBean right side bean to add to the relationship.
  51      * @param  $additionalFields key=>value pairs of fields to save on the relationship
  52      * @return boolean true if successful
  53      */
  54     public function add($lhs, $rhs, $additionalFields = array())
  55     {
  56         $lhsLinkName = $this->lhsLink;
  57
  58         if (empty($lhs->$lhsLinkName) && !$lhs->load_relationship($lhsLinkName))
  59         {
  60             $lhsClass = get_class($lhs);
  61             $GLOBALS['log']->fatal("could not load LHS $lhsLinkName in $lhsClass");
  62             return false;
  63         }
  64
  65             if ($lhs->$lhsLinkName->beansAreLoaded())
  66                 $lhs->$lhsLinkName->addBean($rhs);
  67
  68             $this->callBeforeAdd($lhs, $rhs, $lhsLinkName);
  69
  70         //Many to many has no additional logic, so just add a new row to the table and notify the beans.
  71         $dataToInsert = $this->getRowToInsert($lhs, $rhs, $additionalFields);
  72
  73         $this->addRow($dataToInsert);
  74
  75         if ($this->self_referencing)
  76             $this->addSelfReferencing($lhs, $rhs, $additionalFields);
  77
  78             if ($lhs->$lhsLinkName->beansAreLoaded())
  79                 $lhs->$lhsLinkName->addBean($rhs);
  80
  81             $this->callAfterAdd($lhs, $rhs, $lhsLinkName);
  82
  83         return true;
  84     }
  85
  86     public function remove($lhs, $rhs)
  87     {
  88         $lhsLinkName = $this->lhsLink;
  89
  90         if (!($lhs instanceof SugarBean)) {
  91             $GLOBALS['log']->fatal("LHS is not a SugarBean object");
  92             return false;
  93         }
  94         if (!($rhs instanceof SugarBean)) {
  95             $GLOBALS['log']->fatal("RHS is not a SugarBean object");
  96             return false;
  97         }
  98         if (empty($lhs->$lhsLinkName) && !$lhs->load_relationship($lhsLinkName))
  99         {
 100             $GLOBALS['log']->fatal("could not load LHS $lhsLinkName");
 101             return false;
 102         }
 103
 104         if (empty($_SESSION['disable_workflow']) || $_SESSION['disable_workflow'] != "Yes")
 105         {
 106             if (!empty($lhs->$lhsLinkName))
 107             {
 108                 $lhs->$lhsLinkName->load();
 109                 $this->callBeforeDelete($lhs, $rhs, $lhsLinkName);
 110             }
 111         }
 112
 113         $dataToRemove = array(
 114             $this->def['join_key_lhs'] => $lhs->id,
 115             $this->def['join_key_rhs'] => $rhs->id
 116         );
 117
 118         $this->removeRow($dataToRemove);
 119
 120         if ($this->self_referencing)
 121             $this->removeSelfReferencing($lhs, $rhs);
 122
 123         if (empty($_SESSION['disable_workflow']) || $_SESSION['disable_workflow'] != "Yes")
 124         {
 125             if (!empty($lhs->$lhsLinkName))
 126             {
 127                 $lhs->$lhsLinkName->load();
 128                 $this->callAfterDelete($lhs, $rhs, $lhsLinkName);
 129             }
 130         }
 131
 132         return true;
 133     }
 134 }