C3 AI Documentation Home

Salesforce Node

Load data from Salesforce into Visual Notebooks.

Prerequisites

Follow the steps below to add credentials for Salesforce. You must have a valid username, secret key, and password.

  1. Drag a Salesforce node onto the Visual Notebooks workspace
  2. Select the gear icon beside the Credential field Salesforce credential settings
  3. Select the plus sign in the upper right corner Add new Salesforce credential
  4. Enter a name for the credential
  5. Enter the secret key for Salesforce
  6. Enter the username and password you use to access Salesforce Configure Salesforce credentials

Configuration

FieldDescription
Name OptionalA user-specified node name displayed in the canvas
Credential RequiredThe information needed to access Salesforce data Select a saved credential from the dropdown menu. Select the gear icon to add a new credential or delete existing credentials.
Select Table or Define Query RequiredThe data to upload Select the table you want to upload from the auto-populated dropdown menu or enter a SQL query that returns the desired data.
Filter by Value OptionalConfigure filters to be applied to data Use the dropdown fields to filter results. Filter options include is null, is not null, is equal, is not equal, begins with, ends with, in between, is less than, is less than or equal to, is greater than, and is greater than or equal to. Filters can be applied on any column datatype. Add additional filters to create "And" conditional logic treatment.

Node Inputs/Outputs

InputNone
OutputVisual Notebooks returns a table, called a dataframe, that contains all uploaded data. Columns are labeled and include a symbol that specifies the data type of that column.

Example Salesforce node output

Figure 1: Example dataframe output

Examples

  1. Specify the Salesforce table that contains the desired data.
  2. Select Run to create a dataframe.

Example Salesforce configuration

Figure 2: Example Salesforce configuration

Example Salesforce dataframe

Figure 3: Example dataframe created from Salesforce

  1. Optionally, write a query that returns the desired data. In the example below, the query returns all columns for the first 10 rows of the "Account" object.
  2. Select Run to create a dataframe.

Example Salesforce query configuration

Figure 4: Example configuration using a Salesforce query

Example Salesforce query results

Figure 5: Example dataframe created from a Salesforce query

  1. Select the Salesforce table ("Account" in this example) that contains the desired data.
  2. Add a "filter" using the "Filter by Value optional input. The input allows users to easily and visually configure ways to filter--for example by selecting a string column and only selecting rows that begin with a certain letter or selecting a numeric column and only returning results where the value is greater than a user specified input. In this example, a filter is used to select objects where the industry is equal to "Energy."
  3. Select "Run" to create a dataframe.

Example Salesforce filter configuration

Figure 6: Example configuration using a filter

Example Salesforce filtered results

Figure 7: Example dataframe created using a filter

Was this page helpful?