modules/ModuleBuilder/parsers/relationships/ActivitiesRelationship.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-2011 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 'modules/ModuleBuilder/parsers/relationships/OneToManyRelationship.php' ;
  40
  41 /*
  42  * Class to manage the metadata for a One-To-Many Relationship
  43  * The One-To-Many relationships created by this class are a combination of a subpanel and a custom relate field
  44  * The LHS (One) module will receive a new subpanel for the RHS module. The subpanel gets its data ('get_subpanel_data') from a link field that references a new Relationship
  45  * The RHS (Many) module will receive a new relate field to point back to the LHS
  46  *
  47  * OOB modules implement One-To-Many relationships as:
  48  *
  49  * On the LHS (One) side:
  50  * A Relationship of type one-to-many in the rhs modules vardefs.php
  51  * A link field in the same vardefs.php with 'relationship'= the relationship name and 'source'='non-db'
  52  * A subpanel which gets its data (get_subpanel_data) from the link field
  53  *
  54  * On the RHS (Many) side:
  55  * A Relate field in the vardefs, formatted as in this example, which references a link field:
  56  * 'name' => 'account_name',
  57  * 'rname' => 'name',
  58  * 'id_name' => 'account_id',
  59  * 'vname' => 'LBL_ACCOUNT_NAME',
  60  * 'join_name'=>'accounts',
  61  * 'type' => 'relate',
  62  * 'link' => 'accounts',
  63  * 'table' => 'accounts',
  64  * 'module' => 'Accounts',
  65  * 'source' => 'non-db'
  66  * A link field which references the shared Relationship
  67  */
  68
  69 class ActivitiesRelationship extends OneToManyRelationship
  70 {
  71
  72         protected static $subpanelsAdded = array();
  73         protected static $labelsAdded = array();
  74
  75         /*
  76      * Constructor
  77      * @param array $definition Parameters passed in as array defined in parent::$definitionKeys
  78      * The lhs_module value is for the One side; the rhs_module value is for the Many
  79      */
  80     function __construct ($definition)
  81     {
  82         parent::__construct ( $definition ) ;
  83     }
  84
  85     /*
  86      * BUILD methods called during the build
  87      */
  88
  89         /*
  90      * Define the labels to be added to the module for the new relationships
  91      * @return array    An array of system value => display value
  92      */
  93     function buildLabels ()
  94     {
  95         $labelDefinitions = array ( ) ;
  96         if (!$this->relationship_only )
  97         {
  98             if (!isset(ActivitiesRelationship::$labelsAdded[$this->lhs_module])) {
  99                         $labelDefinitions [] = array (
 100                         'module' => 'application' ,
 101                         'system_label' => 'parent_type_display',
 102                         'display_label' => array ( $this->lhs_module => ucfirst ( $this->lhs_module ))
 103                     ) ;
 104
 105                     $labelDefinitions [] = array (
 106                         'module' => 'application' ,
 107                         'system_label' => 'record_type_display',
 108                         'display_label' => array ( $this->lhs_module => ucfirst ( $this->lhs_module ))
 109                     ) ;
 110
 111                     $labelDefinitions [] = array (
 112                         'module' => 'application' ,
 113                         'system_label' => 'record_type_display_notes',
 114                         'display_label' => array ( $this->lhs_module => ucfirst ( $this->lhs_module ))
 115                     ) ;
 116             }
 117
 118             $labelDefinitions [] = array (
 119                 'module' => $this->lhs_module ,
 120                 'system_label' => 'LBL_' . strtoupper ( $this->relationship_name . '_FROM_' . $this->getRightModuleSystemLabel() ) . '_TITLE' ,
 121                 'display_label' => /*'*' .*/ ucfirst ( $this->rhs_module )
 122             ) ;
 123             ActivitiesRelationship::$labelsAdded[$this->lhs_module] = true;
 124         }
 125         return $labelDefinitions ;
 126     }
 127
 128
 129         /*
 130      * @return array    An array of field definitions, ready for the vardefs, keyed by module
 131      */
 132     function buildVardefs ( )
 133     {
 134         $vardefs = array ( ) ;
 135
 136         $vardefs [ $this->rhs_module ] [] = $this->getLinkFieldDefinition ( $this->lhs_module, $this->relationship_name ) ;
 137         $vardefs [ $this->lhs_module ] [] = $this->getLinkFieldDefinition ( $this->rhs_module, $this->relationship_name ) ;
 138
 139
 140         return $vardefs ;
 141     }
 142
 143         protected function getLinkFieldDefinition ($sourceModule , $relationshipName)
 144     {
 145         $vardef = array ( ) ;
 146         $vardef [ 'name' ] = $relationshipName;
 147         $vardef [ 'type' ] = 'link' ;
 148         $vardef [ 'relationship' ] = $relationshipName ;
 149         $vardef [ 'source' ] = 'non-db' ;
 150         return $vardef ;
 151     }
 152
 153     /*
 154      * Define what fields to add to which modules layouts
 155      * @return array    An array of module => fieldname
 156      */
 157     function buildFieldsToLayouts ()
 158     {
 159         if ($this->relationship_only)
 160             return array () ;
 161
 162         return array( $this->rhs_module => $this->relationship_name . "_name" ) ; // this must match the name of the relate field from buildVardefs
 163     }
 164
 165         function buildSubpanelDefinitions ()
 166     {
 167         if ($this->relationship_only || isset(ActivitiesRelationship::$subpanelsAdded[$this->lhs_module]))
 168             return array () ;
 169
 170         ActivitiesRelationship::$subpanelsAdded[$this->lhs_module] = true;
 171         $relationshipName = substr($this->relationship_name, 0, strrpos($this->relationship_name, '_'));
 172         return array( $this->lhs_module => array (
 173                                   'activities' => $this->buildActivitiesSubpanelDefinition ( $relationshipName ),
 174                                   'history' => $this->buildHistorySubpanelDefinition ( $relationshipName ) ,
 175                                 ));
 176     }
 177
 178     /*
 179      * @return array    An array of relationship metadata definitions
 180      */
 181     function buildRelationshipMetaData ()
 182     {
 183         $relationshipName = $this->definition [ 'relationship_name' ];
 184         $relMetadata = array ( ) ;
 185         $relMetadata [ 'lhs_module' ] = $this->definition [ 'lhs_module' ] ;
 186         $relMetadata [ 'lhs_table' ] = $this->getTablename($this->definition [ 'lhs_module' ]) ;
 187         $relMetadata [ 'lhs_key' ] = 'id' ;
 188         $relMetadata [ 'rhs_module' ] = $this->definition [ 'rhs_module' ] ;
 189         $relMetadata [ 'rhs_table' ] = $this->getTablename($this->definition [ 'rhs_module' ]) ;
 190         $relMetadata ['rhs_key'] = 'parent_id';
 191         $relMetadata ['relationship_type'] = 'one-to-many';
 192         $relMetadata ['relationship_role_column'] = 'parent_type';
 193         $relMetadata ['relationship_role_column_value'] = $this->definition [ 'lhs_module' ] ;
 194
 195         return array( $this->lhs_module => array(
 196                 'relationships' => array ($relationshipName => $relMetadata),
 197                 'fields' => '', 'indices' => '', 'table' => '')
 198         ) ;
 199     }
 200
 201 /*
 202      * Shortcut to construct an Activities collection subpanel
 203      * @param AbstractRelationship $relationship    Source relationship to Activities module
 204      */
 205     protected function buildActivitiesSubpanelDefinition ( $relationshipName )
 206     {
 207                 return array (
 208             'order' => 10 ,
 209             'sort_order' => 'desc' ,
 210             'sort_by' => 'date_start' ,
 211             'title_key' => 'LBL_ACTIVITIES_SUBPANEL_TITLE' ,
 212             'type' => 'collection' ,
 213             'subpanel_name' => 'activities' , //this value is not associated with a physical file
 214             'module' => 'Activities' ,
 215             'top_buttons' => array (
 216                 array ( 'widget_class' => 'SubPanelTopCreateTaskButton' ) ,
 217                 array ( 'widget_class' => 'SubPanelTopScheduleMeetingButton' ) ,
 218                 array ( 'widget_class' => 'SubPanelTopScheduleCallButton' ) ,
 219                 array ( 'widget_class' => 'SubPanelTopComposeEmailButton' ) ) ,
 220                 'collection_list' => array (
 221                     'meetings' => array (
 222                         'module' => 'Meetings' ,
 223                         'subpanel_name' => 'ForActivities' ,
 224                         'get_subpanel_data' => $relationshipName. '_meetings' ) ,
 225                     'tasks' => array (
 226                         'module' => 'Tasks' ,
 227                         'subpanel_name' => 'ForActivities' ,
 228                         'get_subpanel_data' => $relationshipName. '_tasks' ) ,
 229                     'calls' => array (
 230                         'module' => 'Calls' ,
 231                         'subpanel_name' => 'ForActivities' ,
 232                         'get_subpanel_data' => $relationshipName. '_calls' ) ) ) ;
 233     }
 234
 235     /*
 236      * Shortcut to construct a History collection subpanel
 237      * @param AbstractRelationship $relationship    Source relationship to Activities module
 238      */
 239     protected function buildHistorySubpanelDefinition ( $relationshipName )
 240     {
 241         return array (
 242             'order' => 20 ,
 243             'sort_order' => 'desc' ,
 244             'sort_by' => 'date_modified' ,
 245             'title_key' => 'LBL_HISTORY' ,
 246             'type' => 'collection' ,
 247             'subpanel_name' => 'history' , //this values is not associated with a physical file.
 248             'module' => 'History' ,
 249             'top_buttons' => array (
 250                 array ( 'widget_class' => 'SubPanelTopCreateNoteButton' ) ,
 251                                 array ( 'widget_class' => 'SubPanelTopArchiveEmailButton'),
 252                 array ( 'widget_class' => 'SubPanelTopSummaryButton' ) ) ,
 253                 'collection_list' => array (
 254                     'meetings' => array (
 255                         'module' => 'Meetings' ,
 256                         'subpanel_name' => 'ForHistory' ,
 257                         'get_subpanel_data' => $relationshipName. '_meetings' ) ,
 258                     'tasks' => array (
 259                         'module' => 'Tasks' ,
 260                         'subpanel_name' => 'ForHistory' ,
 261                         'get_subpanel_data' => $relationshipName. '_tasks' ) ,
 262                     'calls' => array (
 263                         'module' => 'Calls' ,
 264                         'subpanel_name' => 'ForHistory' ,
 265                         'get_subpanel_data' => $relationshipName. '_calls' ) ,
 266                     'notes' => array (
 267                         'module' => 'Notes' ,
 268                         'subpanel_name' => 'ForHistory' ,
 269                         'get_subpanel_data' => $relationshipName. '_notes' ) ,
 270                     'emails' => array (
 271                         'module' => 'Emails' ,
 272                         'subpanel_name' => 'ForHistory' ,
 273                         'get_subpanel_data' => $relationshipName. '_emails' ) ) )  ;
 274     }
 275 }
 276 ?>