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-2011 SugarCRM Inc.
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.
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
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
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.
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.
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 ********************************************************************************/
39 require_once("data/Relationships/M2MRelationship.php");
42 * Represents a one to many relationship that is table based.
44 class One2MRelationship extends M2MRelationship
47 public function __construct($def)
52 $this->name = $def['name'];
54 $this->selfReferencing = $def['lhs_module'] == $def['rhs_module'];
55 $lhsModule = $def['lhs_module'];
56 $rhsModule = $def['rhs_module'];
58 if ($this->selfReferencing)
60 $links = VardefManager::getLinkFieldForRelationship(
61 $lhsModule, BeanFactory::getBeanName($lhsModule), $this->name
65 $GLOBALS['log']->fatal("No Links found for relationship {$this->name}");
67 if (!isset($links[0])) //Only one link for a self referencing relationship, this is BAAAD
68 $this->lhsLinkDef = $this->rhsLinkDef = $links;
71 if ((!empty($links[0]['side']) && $links[0]['side'] == "right")
72 || (!empty($links[0]['link_type']) && $links[0]['link_type'] == "one"))
74 //$links[0] is the RHS
75 $this->lhsLinkDef = $links[1];
76 $this->rhsLinkDef = $links[0];
79 //$links[0] is the LHS
80 $this->lhsLinkDef = $links[0];
81 $this->rhsLinkDef = $links[1];
86 $this->lhsLinkDef = VardefManager::getLinkFieldForRelationship(
87 $lhsModule, BeanFactory::getBeanName($lhsModule), $this->name
89 $this->rhsLinkDef = VardefManager::getLinkFieldForRelationship(
90 $rhsModule, BeanFactory::getBeanName($rhsModule), $this->name
92 if (!isset($this->lhsLinkDef['name']) && isset($this->lhsLinkDef[0]))
94 $this->lhsLinkDef = $this->lhsLinkDef[0];
96 if (!isset($this->rhsLinkDef['name']) && isset($this->rhsLinkDef[0])) {
97 $this->rhsLinkDef = $this->rhsLinkDef[0];
100 $this->lhsLink = $this->lhsLinkDef['name'];
101 $this->rhsLink = $this->rhsLinkDef['name'];
105 * @param $lhs SugarBean left side bean to add to the relationship.
106 * @param $rhs SugarBean right side bean to add to the relationship.
107 * @param $additionalFields key=>value pairs of fields to save on the relationship
108 * @return boolean true if successful
110 public function add($lhs, $rhs, $additionalFields = array())
112 $dataToInsert = $this->getRowToInsert($lhs, $rhs, $additionalFields);
113 //If the current data matches the existing data, don't do anything
114 if (!$this->checkExisting($dataToInsert))
116 $rhsLinkName = $this->rhsLink;
117 //In a one to many, any existing links from the many (right) side must be removed first
118 $rhs->load_relationship($rhsLinkName);
119 $this->removeAll($rhs->$rhsLinkName);
120 parent::add($lhs, $rhs, $additionalFields);
125 * Just overriding the function from M2M to prevent it from occuring
127 protected function addSelfReferencing($lhs, $rhs, $additionalFields = array())
133 * Just overriding the function from M2M to prevent it from occuring
135 protected function removeSelfReferencing($lhs, $rhs, $additionalFields = array())