Skip to main content
Gainsight Inc.

Bionic Rules Task Creation

This tutorial provides guidelines on how Admins can fetch data from multiple sources such as SFDC, MDA, and Data Spaces. This tutorial will guide you to perform actions using the Bionic Rule type (in Rules Engine) which has the capability to transform fetched data in various ways and execute actions with a single Bionic Rule. Users can perform Historical Rule Executions faster using Bionic Rules because of the data volume. 

Before you start exploring how to create tasks in Bionic Rules, be sure to read the Getting Started with Bionic Rules article.

Folders in Rules

Rules Engine allows you to create folders and organize your rules in folders. By default, Gainsight provides you a folder known as Uncategorized. You cannot delete this folder. By default, all the rules are part of this folder. If you do not specify a folder while creating a new rule, the rule becomes part of Uncategorized folder. All the folders are displayed in the left pane on the Rules List page. The folder to which a Rule belongs to is displayed against the Rule Name. 


All the folders including the Uncategorized folder are part of the Home folder. Home is the master folder that contains all the folders. You cannot store a rule under the Home folder directly. You can only create folders under the Home folder. You cannot nest folders under the Uncategorized folder. 


You can create new folders and move the existing rules into the new folder. You can nest a folder in another folder; up to a single level of nesting is allowed. You can perform the following tasks with folders.

  1. Create Folder

    To create a new folder:

    1. Click the + icon.

    2. (Optional) Select the folder under which you want to nest this folder.

    3. In the Folder Name field, enter a name for the folder.

    4. Click ADD.

29. Create folder.gif

A folder nested under another folder (and not directly under the Home folder), can have the same name as its parent folder. However, two custom folders that exist at the same level under the Home folder cannot have the same name. In the above scenario, you can nest a folder called Scorecard Rules under the existing Scorecard Rules folder. However, two folders which exist at the same level (under the Home folder) cannot have the same name. You cannot create another subfolder under the nested Scorecard Rules folder since only two levels of nesting are allowed under the Home folder.


  1. Move Rules to Folder

    Once you create a folder, you can move the Rules into the newly created folder. A rule cannot be part of multiple folders. To move the rules to a folder:

    1. Select the checkbox for the required rule(s).

    2. From the MOVE TO folder, select the required folder.

    3. Click OK.

31. Move rule.gif

  1. Delete Folders

    You can delete a folder if it has no other subfolders under it or does not hold any Rules. You cannot delete the Uncategorized folder. To delete a folder, select the required folder and click the delete icon.

Delete Scorecards.gif

  1. Folder for new Rules

    The New Rule page has the Folder field. You can select a folder for the new rule. If no folder is selected, the Rule is moved to the Uncategorized folder.

33. New rule folder.gif

Fetch Data

To fetch data from multiple sources such as SFDC, MDA, Data Spaces, and Gainsight PX Custom Events.

Fetch from SFDC, MDA, or Data Spaces

To fetch data from various sources:

  1. Navigate to Rules Engine > RULES LIST tab > +RULE. The Create Rule screen is displayed.

Rule list.png

  1. Provide the following in the Create Rule screen:

    1. Select Account checkbox as Rule For.
    2. Enter Rule Name.
    3. Select a folder for the rule.
    4. Enter Description [Optional].

Create rule page.gif

  1. Click NEXT. You are navigated to the Setup Rule screen.
  2. Click DATASET.

Dataset select.png

  1. Enter the Task Name, Task Description, and Output Dataset Name. If you do not provide a value in the Task Name field, it is auto-populated as per the format Fetch from <Object Name>; if you have used the Account object, the task name is auto-populated as Fetch from Account (if you do not provide a Task name). 

    Note: Output Dataset Name auto-populates from Task Name and it can be changed to a different name. 

In this use case, the following details are used:

  • Task Name: Fetch from usage data [Maximum 80 characters and should be Alphanumeric; _ and space are supported]
  • Task Description: Usage data fetch [ Maximum 200 characters]
  • Output Dataset Name: Usage Data [Maximum 60 characters and should be Alphanumeric; _ and space are supported]. This gets pre-populated with the task name by default.


  1. Select Salesforce as a data source from the drop-down list to fetch from SFDC (for example in this article). You can also select from Matrix Data, or Data Spaces available in the drop-down list to fetch from MDA (All data sources), or Data Spaces respectively.

Use our Gainsight Object Glossary to better understand the main MDA and SFDC objects and fields used in Gainsight.


  1. Select Usage Data as the source object from Salesforce. The objects available in the data source selected in the previous step are displayed in this drop-down list.


  1. Drag and drop the following fields from Usage Data in the Show section:


  1. Drag and drop fields in the Filters section and apply logic as required. Advanced logic AND is applied to the selected filters automatically in the Advanced Logic section. You can modify the logical operator to OR. Advanced Logic is not case-sensitive in Setup Rule.


  1. Click SAVE to create the task as configured. This task is now available for you to proceed further. You can also click PREVIEW to view the task results in a new window.

Note: If the rich text fields are added in the Show me section of a rule task, the Don’t include HTML tags checkbox is enabled. Admins can select this option if they want to remove the HTML tags from Rules Engine.

Rich Text.png

  1. Field labels can be edited by clicking on the settings icon.


The following are the limitations for Bionic Rule task creation:

Parameters Max. Limit Comments
Max # of tasks allowed 15  
Max # of Show fields in each task 50 In Pivot task, we can pivot on a field using 200 cases
Max # of Group by fields in transformation tasks 10  
Max # of filters allowed in each task 26 This limit is in filters of every task.
Max # of results displayed in Preview Results 100  

Fetch Data from Gainsight PX Custom Events 

Admins can fetch custom event data including Account/User and Global context attributes for custom events from Gainsight  PX custom events and perform any actions in Rules Engine. In the Setup Rule screen, admins can select the PX Connection and Product Name, for which all the configured events are displayed for selection. Like any other source/object, admins can add show fields/filters based on the selected event properties and also perform merge/transform tasks.

To fetch PX usage data, admins must configure the PX Connector in the Gainsight CS application. For more information, refer to the Gainsight PX Connector article.

Limitations: Following are some of the limitations in using PX usage data:

  • The Date field is mandatory and it must be bounded such that you need to have a start date and end date.
  • Only the data from the past 180 days is considered.
  • Event level data is not supported. Gainsight always aggregates EventID to Count (EventID) when dropped in the Show section.
  • Only 100K records are fetched per rule.


Scan Rules

You can scan Bionic rules by using Gainsight Analyzer tool. This tool gives you important insights into the rule. For more information, refer to the Gainsight Analyzer Overview article. To scan a rule, click the scan icon on the RULES LIST page, for the required rule. When you click the scan icon, the Gainsight Analyzer page opens in a new tab.



  • Fetch tasks support data sources from SFDC, MDA (All data sources), Data Spaces, and Gainsight PX Custom Events.
  • It is mandatory to have only one output task to execute actions. Ensure to use the Merge Task, if there is more than one output task.

  • Each field in every task can have a field label input by the user which will be used as a field alias while querying and as an output header in the csv result. While querying from usage data, if any of these field aliases contains a reserved keyword, you must modify the Output Field Label name before clicking SAVE, otherwise, it displays the following error message.


The Date is a reserved keyword and you need to change it. You can simply click the gear icon available for this field to rename the Output Field label within the context of this Bionic Rule, as shown in the following image. The Output Header name will be modified based on whatever name you give to Output Field Label (space will be replaced with ‘_’).