Add hook_salesforce_pull_entity_save()

Problem/Motivation

I need a way to act immediately after a Drupal entity has been saved as part of a Salesforce Pull operation. In this hook I need access to both the Salesforce object and the saved Drupal entity.

Utilizing hook_entity_insert() and hook_entity_update() isn't a solution here because by that time I've lost access to the Salesforce object.

My use case here is creating/updating a referencing (parent) entity with data from the Salesforce object. This is not a simple relationship that can be mapped in the mapping interface.

Proposed resolution

Add a hook that will allow modules to respond to an entity being saved in a Salesforce pull.

Remaining tasks

Patch needs to be reviewed and tested by the community (RTBC).

Please review salesforce-Add-hook_salesforce_pull_entity_save-2650502-0.patch. It has been rolled off of 7.x-3.x.

The salesforce-Add-hook_salesforce_pull_entity_save-2650502-0-against-stable-3-1.patch patch file is only here for those who want to patch the stable 7.x-3.1 release.

User interface changes

None.

API changes

Addition of hook_salesforce_pull_entity_save() in salesforce.api.php.

/**
 * Allow modules to respond to an entity being saved in a Salesforce pull.
 *
 * @param object $sf_object
 *   The fully-loaded Salesforce object.
 * @param string $entity_type
 *   The Drupal entity type.
 * @param object $entity
 *   The Drupal entity that was just saved.
 */

Data model changes

None.