Let the platform do the work

before_relationship_delete

Overview

The before_relationship_delete logic hook executes before a relationship between two records is deleted.

Definition

function before_relationship_delete($bean, $event, $arguments){}

Arguments

Name Type Description
bean Object The bean object
event String The current event
arguments Array Additional information related to the event
arguments.id String Module id
arguments.module String Module name
arguments.related_id String Related module id
arguments.related_module String Related module name
arguments.link String Link field name
arguments.relationship String Relationship name

Considerations

  • This hook will be executed for each side of the relationship. For example, if you delete an association between an account and a contact, the hook will run for both records.
  • The arguments parameter will have additional information regarding the records being modified. The $bean variable will not contain this information.

Change Log

Version Note
6.4.5 Added before_relationship_delete hook.

Examples

Creating a Logic Hook using the Extension Framework

./custom/Extension/modules/<module>/Ext/LogicHooks/<file>.php

<?php

    $hook_array['before_relationship_delete'][] = Array(
        //Processing index. For sorting the array.
        1,

        //Label. A string value to identify the hook.
        'before_relationship_delete example',

        //The PHP file where your class is located.
        'custom/modules/<module>/before_relationship_delete_class.php',

        //The class the method is in.
        'before_relationship_delete_class',

        //The method to call.
        'before_relationship_delete_method'
    );

?>

./custom/modules/<module>/before_relationship_delete_class.php

<?php

    if (!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');

    class before_relationship_delete_class
    {
        function before_relationship_delete_method($bean, $event, $arguments)
        {
            //logic
        }
    }

?>