data/Relationships/SugarRelationship.php

Show:

inherited

Constants
Functions
Classes
- \SugarRelationship

Table of Contents

Constants

 
                REL_LHS
                = 'LHS'

 
                REL_RHS
                = 'RHS'

 
                REL_BOTH
                = 'BOTH_SIDES'

 
                REL_MANY_MANY
                = 'many-to-many'

 
                REL_ONE_MANY
                = 'one-to-many'

 
                REL_ONE_ONE
                = 'one-to-one'

\SugarRelationship
jump to top

Package: SugarCRM

A relationship is between two modules.

It contains at least two links. Each link represents a connection from one record to the records linked in this relationship. Links have a context(focus) bean while relationships do not.

Children: \M2MRelationship
Api

Properties


                 $beansToResave= 'array()'

static

Default valuearray()Details

Type: n/a


                 $def= ''

Details

Type: n/a


                 $ignore_role_filter= 'false'

Default valuefalseDetails

Type: n/a


                 $lhsLink= ''

Details

Type: n/a


                 $rhsLink= ''

Details

Type: n/a


                 $self_referencing= 'false'

Default valuefalseDetails

Type: n/a

Methods

__get(
           $name
          )
        
        :
          void

Parameters

Name	Type	Description
$name

add(
           $lhs,  $rhs,  $additionalFields
              =
              array()
          )
        
        :
          void

abstract

Parameters

Name	Type	Description
$lhs
$rhs
$additionalFields

addRow(
          array $row
          )
        
        :
          bool | void

Parameters

Name	Type	Description
$row	array	values to be inserted into the relationship

Returns

Type	Description
bool \| void	null if new row was inserted and true if an exesting row was updated

addToResaveList(
          \SugarBean $bean
          )
        
        :
          void

static

Adds a realted Bean to the list to be resaved along with the current bean.

Parameters

Name	Type	Description
$bean	\SugarBean

Details

Static

callAfterAdd(
          \SugarBean $focus, \SugarBean $related, string $link_name
              =
              ""
          )
        
        :
          void

Call the after add logic hook for a given link

Parameters

Name	Type	Description
$focus	\SugarBean	base bean the hooks is triggered from
$related	\SugarBean	bean being added/removed/updated from relationship
$link_name	string	name of link being triggerd

callAfterDelete(
          \SugarBean $focus, \SugarBean $related, string $link_name
              =
              ""
          )
        
        :
          void

Parameters

Name	Type	Description
$focus	\SugarBean
$related	\SugarBean
$link_name	string

callBeforeAdd(
          \SugarBean $focus, \SugarBean $related, string $link_name
              =
              ""
          )
        
        :
          void

Call the before add logic hook for a given link

Parameters

Name	Type	Description
$focus	\SugarBean	base bean the hooks is triggered from
$related	\SugarBean	bean being added/removed/updated from relationship
$link_name	string	name of link being triggerd

callBeforeDelete(
          \SugarBean $focus, \SugarBean $related, string $link_name
              =
              ""
          )
        
        :
          void

Parameters

Name	Type	Description
$focus	\SugarBean
$related	\SugarBean
$link_name	string

checkExisting(
           $row
          )
        
        :
          array | bool

Checks for an existing row who's keys match the one passed in.

Parameters

Name	Type	Description
$row

Returns

Type	Description
array \| bool	returns false if now row is found, otherwise the row is returned

getCustomLogicArguments(
          \SugarBean $focus, \SugarBean $related, string $link_name
          )
        
        :
          array

Parameters

Name	Type	Description
$focus	\SugarBean	base bean the hooks is triggered from
$related	\SugarBean	bean being added/removed/updated from relationship
$link_name	string	name of link being triggerd

Returns

Type	Description
array	base arguments to pass to relationship logic hooks

getFields(
          
          )
        
        :
          array

Returns

Type	Description
array	names of fields stored on the relationship

getJoin(
          \Link2 $link
          )
        
        :
          string | array

abstract

Parameters

Name	Type	Description
$link	\Link2

Returns

Type	Description
string \| array	the query to join against the related modules table for the given link.

Details

Abstract

getLHSLink(
          
          )
        
        :
          String

Returns

Type	Description
String	left link in relationship.

getLHSModule(
          
          )
        
        :
          string

Returns

Type	Description
string	name of left hand side module.

getOptionalWhereClause(
          \$optional_array $optional_array
          )
        
        :
          string

Parameters

Name	Type	Description
$optional_array	\$optional_array	clause to add to the where query when populating this relationship. It should be in the

Returns

Type	Description
string

getQuery(
          \$link $link,  $params
              =
              array()
          )
        
        :
          string | array

abstract

Gets the query to load a link.

This is currently public, but should prob be made protected later. See Link2->getQuery

Parameters

Name	Type	Description
$link	\$link	Link Object to get query for.
$params

Returns

Type	Description
string \| array	query used to load this relationship

Details

Abstract

getRHSLink(
          
          )
        
        :
          String

Returns

Type	Description
String	right link in relationship.

getRHSModule(
          
          )
        
        :
          string

Returns

Type	Description
string	name of right hand side module.

getRelationshipTable(
          
          )
        
        :
          string

abstract

Returns

Type	Description
string	name of the table for this relationship

Details

Abstract

getRoleWhere(
          string $table
              =
              "",  $ignore_role_filter
              =
              false
          )
        
        :
          string

Gets the relationship role column check for the where clause

Parameters

Name	Type	Description
$table	string
$ignore_role_filter

Returns

Type	Description
string

isParentRelationship(
          
          )
        
        :
          bool

Returns

Type	Description
bool	true if the relationship is a flex / parent relationship

load(
          \$link $link,  $params
              =
              array()
          )
        
        :
          void

abstract

Parameters

Name	Type	Description
$link	\$link	Link2 loads the rows for this relationship that match the given link
$params

Details

Abstract

relationship_exists(
          \SugarBean $lhs, \SugarBean $rhs
          )
        
        :
          bool

abstract

Parameters

Name	Type	Description
$lhs	\SugarBean
$rhs	\SugarBean

Returns

Type	Description
bool

Details

Abstract

remove(
          \$lhs $lhs, \$rhs $rhs
          )
        
        :
          void

abstract

Parameters

Name	Type	Description
$lhs	\$lhs	SugarBean
$rhs	\$rhs	SugarBean

Details

Abstract

removeAll(
          \$link $link
          )
        
        :
          void

Parameters

Name	Type	Description
$link	\$link	Link2 removes all the beans associated with this link from the relationship

removeById(
          \$rowID $rowID
          )
        
        :
          void

Parameters

Name	Type	Description
$rowID	\$rowID	id of SugarBean to remove from the relationship

removeRow(
          \$where $where
          )
        
        :
          bool | resource

Removes one or more rows from the relationship table

Parameters

Name	Type	Description
$where	\$where	array of field=>value pairs to match

Returns

Type	Description
bool \| resource

resaveRelatedBeans(
          
          )
        
        :
          void

static

Details

Static

updateRow(
          \$id $id, \$values $values
          )
        
        :
          resource

Parameters

Name	Type	Description
$id	\$id	id of row to update
$values	\$values	values to insert into row

Returns

Type	Description
resource	result of update satatement

data/Relationships/SugarRelationship.php

Constants

\SugarRelationshipjump to top

Properties

Methods

\SugarRelationship
jump to top