Salesforce

AgenticBI enables data discovery, visualization, data manipulation, warehousing and reporting automation from Salesforce, along with the ability to merge that data with other data stores.

Connecting

  1. Login to AgenticBI and select Settings -> Datasources from the left down menu.

  2. Click on Salesforce. An authentication popup will be shown. Sign in to your Salesforce account to complete the OAuth process, where a secure token is exchanged between Salesforce and AgenticBI.

    Note: To connect to a Salesforce Sandbox environment, select the 'Salesforce Testing' icon.

  3. Save the Connection. Click on the "Configure Queries" link on the success bar.

Queries & Reports

  1. This section outlines how to pull data from Salesforce. AgenticBI provides a Data Discovery tool for interacting with Salesforce and generating SOQL queries. You can also plugin your own SOQL queries and optionally post-process the data with Cloud9QL. Salesforce Query

    Report Name: Specify a name for the report.

    SOQL : Enter SOQL Query, or generate using the Data Discovery/Query Generator section.

    Cloud9QL Query: Optional syntax that can be applied to the results of the Salesforce data to further transform the results. Example:

    Data Discovery

    The optional Query Generator section enables data discovery of Salesforce Objects/fields and generate queries dynamically.

    Objects : List of Salesforce objects on your account. Type of select one.

    Metrics : One or more Metrics that you'd like to track. Click on the metric for aggregation (count/sum/Date truncation) options.

    Dimensions : One or more fields to group/bucket the results by. For Date based fields, click on the field for additional options (Date/Week/Month) options.

    Filters : One or more filters to group by. Select a metric, which will open up a dialog with filter type and value.

    Sort : Sort the results (Ascending/Descending) for a field.

    Limit: Maximum number of records to pull.

    QueryAll: Select this checkbox to use Salesforce's QueryAll endpoint instead of the standard Query endpoint.

  2. Scheduling: Configure how often this should be run. Select 'None' for a one time operation. The results are stored within your warehouse in AgenticBI.

  3. Overwrite Strategy (for scheduled query runs):

    This determines how the data is stored in your warehouse in AgenticBI:

    i. If empty, data will be added on to the existing data for this dataset within AgenticBI. Or,

    ii. "All": Any existing data for this dataset will be replaced by this results.

    iii. One or More Field Names (Example: "A,B,C"): A new record is created where the values of the combination of the field names do not exist, and, updates current records for the field grouping where it exists. For example, if this is set to say "Date, Type", existing data with the same Date and Type values will be updated with the latest data, and new records created when they do not exist.

  4. Click 'Preview' to see the results.

  5. Click on 'Save' to complete setting up the report. This also sets up this data extraction on a schedule, if configured.

  6. Click on 'Dashboards' link on the success bar to access dashboards. You can drag and drop the newly created report from the widget list into to the dashboard.