This article explains the options to Load to SFDC Object or MDA Subject Area which can be used to load data using Rules Engine.

Overview

The option to Load to SFDC Object or MDA Subject Area can be used to load data using the rules engine.

This feature might be used to do the following (and much more):

  1. Create a case when CTA is created with a particular reason / severity
  2. Create an opportunity when Usage has crossed certain threshold or exceeded the licensed amount.
  3. Update account object with # of CTA’s opened for that account in last week
  4. Load data that is generated by Gainsight into a custom object. This gives the opportunity for the users who don’t have Gainsight license but want to see the data and report on it.

IMPORTANT: When executing the Load To SFDC action, the default batch size is 100 records per call. Most of the time, this works and actions succeed. We have seen that some of our customers have complex workflows/triggers on target objects and processing 100 records at a time ends up hitting SFDC's platform limits for CPU and memory. The solution is to reduce the batch size. You can contact support@gainsight.com to have the batch size fine-tuned. 

Permissions

The option to Load to SFDC Object or MDA Subject Area is sensitive and falls outside of Gainsight and into Salesforce admin areas. Only Salesforce Admins will have access to determine what objects the rules engine can load data to.

A Salesforce admin can assign permission to one or more Gainsight admins for this page, preferably the one who authorized MDA in Gainsight. This does not alter what permissions Gainsight admins have on the SFDC objects or fields. If the user who is running the rule or scheduled the rule does not have permission to a particular object but tries to load data into it, the rule will fail.

RED4.png

Object and Field Selection

In the permission set in salesforce setup, you will find the new permission set with the name “Gainsight Special”. Assign this permission set to one or more active users and those users will have access to the Rules Config page. To access the page, a user will:

Navigate to Administration > Rules Engine > Rules Settings > Permission - Rules Load Actions.

RED5.png

Once on this page choose:

  • Native (SF) or Matrix Data
  • Find an Object and click the + sign to add it to the list of available objects
  • Highlight the object and pick the fields available for use within the object
  • Click Save
    Notes:
  • Pick as many objects and matrix data subject areas as needed.
  • For Matrix Data, you cannot add fields to Email Raw Events and Unsubscribed Emails objects and will no longer be available in the drop-down box.

Load to SFDC Object

  1. Navigate to to Administration > Rules Engine.
  2. Click Create Rule.
  3. Select Rule Type as Bionic.
  4. Select Rule For either Account or Relationship.
  5. Enter Rule Name and Description (optional).
  6. Click NEXT.

Action Type: Load to Gainsight Object

Load To Gainsight Object action of Rules Engine is useful to load data into Gainsight objects. Perform the following steps to use Rules Engine Load To Gainsight Object feature.

  1. Create a Rule, select the source object and select the fields by dropping them into Show field area.
    Note: You can create a dataset from the columns of a csv file in the S3 bucket.

  1. Select Load to Gainsight Object from the Action Type drop-down list.
  2. Choose the destination object.
  3. Select the Operation (insert/upsert/update).
    Notes:
  • If it is upsert/update, you need to select the Include in identifiers check box.
  • When an Admin wants to take data outside of the Gainsight system, modify the data and reupload the data into a Gainsight Object, they can use GS ID as an identifier to update the fields that are modified from the source to target fields, through the Load to Gainsight Action type.

Setup Rule

In the Setup Rule step, click to create a Data Fetch Task, and enter the Task Name. Select a source object (example: Call to Action) and then drag fields that will be mapped in Setup Action into the Show Section. Set applicable filters, click Save, and then click Setup Action. For more information about how to set up a Rule, refer to the Bionic Rules Task Creation article.

Setup Action

To setup action:

  1. Click +ACTION and select the name of the task you created in the previous step.
  2. Select Action Type of Load to SFDC Object or Load to MDA Subject Area (In this example the Load to SFDC Object option is selected)
  3. Select Object Name (Zendesk Support Tickets in this example)
  4. Select Operation from the following:
  • Insert: Create the record if it does not exist. If it exists then duplicate record would be created.
  • Update: Only update existing record, do nothing if it does not exist.
  • Upsert: Update the record if it exists. If it does not exist, create a new record and set the values.

image.png

For Update and Upsert action, identifiers must be defined, you can do that by checking the option “Include in identifiers” Example: if you want to update a case, then you could choose case ID. If it is not available then you can choose account ID, reason, priority and date as identifiers.

Define mapping for each field and default value to be set if the value is not available in the source.

In addition, you can add a custom field mapping to set one of the fields in the destination object to a constant value.

Limitations

  • If the user does not have permission on the destination object to which the data needs to be written into, then the rule will fail.
  • If there is a validation rule that fails on the destination object, then the operation for that record will fail and reason for failure will be listed in the Rule Results Email attachment.