---
schema_version: "1"
id: 65ce7f68cdc1617430f2a658b30fc2bb66bbf8f52ecc862d497f837ae7db8aad
title: Salesforce Einstein Analytics Connector 3.20 Reference
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/salesforce-analytics-cloud-connector/3.20/salesforce-analytics-connector-reference.md
canonical_url: https://docs.mulesoft.com/salesforce-analytics-cloud-connector/3.20/salesforce-analytics-connector-reference
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 3a4b37c88966ec4f274d8aa56e54f191ae5b5741dda584a47a258c1f6a9ae4ea
description: MuleSoft Documentation Site
release: "3.20"
latest: false
---
---
product: Salesforce Einstein Analytics Connector
version: 3.20
---

# Salesforce Einstein Analytics Connector 3.20 Reference

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

## Default Configuration

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Name</p></td><td><p>String</p></td><td><p>The name for this configuration. Connectors reference the configuration with this name.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Connection</p></td><td><div><div><ul><li><p>Basic Username and Password</p></li><li><p>OAuth v2.0</p></li><li><p>OAuth JWT</p></li><li><p>OAuth 2.0 SAML Bearer</p></li></ul></div></div></td><td><p>The connection types to provide to this configuration. Note that the <code>Username Password</code> connection type is only supported for Salesforce API v64.0 and earlier versions.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Expiration Policy</p></td><td><div><div><p><a href="#ExpirationPolicy">Expiration Policy</a></p></div></div></td><td><p>Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the instance expires at the exact moment that it becomes eligible. Mule purges the instances as appropriate.</p></td><td></td><td></td></tr></tbody></table>

## Connection Types

### Basic Username and Password

> [!NOTE] The `Username Password` connection type is only supported for Salesforce API v64.0 and
> earlier versions.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>TLS configuration</p></td><td><div><div><p><a href="#Tls">Tls</a></p></div></div></td><td><p>If the protocol is configured as HTTPS, then you must also configure the keystore configuration.</p></td><td></td><td></td></tr><tr><td><p>Username</p></td><td><div><div><p>String</p></div></div></td><td><p>Username used to initialize the session.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Password</p></td><td><div><div><p>String</p></div></div></td><td><p>Password used to authenticate the user.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Security Token</p></td><td><div><div><p>String</p></div></div></td><td><p>User’s security token. It can be omitted if your IP has been added to the allow list on Salesforce.</p></td><td></td><td></td></tr><tr><td><p>Authorization URL</p></td><td><div><div><p>String</p></div></div></td><td><p>Web service URL responsible for user authentication. This is the URL for the endpoint that is configured to handle SOAP authentication requests.</p></td><td><p>There is no default value, but if left empty the connector uses the latest API version</p></td><td></td></tr><tr><td><p>Reconnection</p></td><td><div><div><p><a href="#Reconnection">Reconnection</a></p></div></div></td><td><p>When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.</p></td><td></td><td></td></tr><tr><td><p>Read Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>Specifies the amount of time, in milliseconds, that the consumer waits for a response before it times out. Default value is 0, which means infinite.</p></td><td><p>0</p></td><td></td></tr><tr><td><p>Read Timeout Time Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>Time unit that qualifies the Read Timeout.</p></td><td><p>MILLISECONDS</p></td><td></td></tr><tr><td><p>Connection Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>Specifies the amount of time, in milliseconds, that the consumer attempts to establish a connection before it times out. Default value is 0, which means infinite.</p></td><td><p>0</p></td><td></td></tr><tr><td><p>Connection Timeout Time Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>Time unit that qualifies the Connection Timeout.</p></td><td><p>MILLISECONDS</p></td><td></td></tr><tr><td><p>Host</p></td><td><div><div><p>String</p></div></div></td><td><p>Host name of the proxy. If this property is not set then no proxy is used, otherwise a proxy is used, but a proxy host must be specified.</p></td><td></td><td></td></tr><tr><td><p>Port</p></td><td><div><div><p>Number</p></div></div></td><td><p>Port of the proxy. If host is set then this property must be set and cannot be a negative number.</p></td><td></td><td></td></tr><tr><td><p>Username</p></td><td><div><div><p>String</p></div></div></td><td><p>Username used to authenticate against the proxy. If this property is not set then no authentication is used against the proxy, otherwise this value must be specified.</p></td><td></td><td></td></tr><tr><td><p>Password</p></td><td><div><div><p>String</p></div></div></td><td><p>Password used to authenticate against the proxy.</p></td><td></td><td></td></tr></tbody></table>

### OAuth v2.0

Use OAuth 2.0 to delegate user authentication to the service hosting the user account. For more
information, refer to
[Configuring OAuth 2.0 for Connectors](https://docs.mulesoft.com/connectors/introduction/intro-config-oauth2),
[Configuring OAuth 2.0 for Connectors on CloudHub](https://docs.mulesoft.com/connectors/introduction/intro-config-oauth2-cloudhub),
or [OAuth Support in the SDK](https://docs.mulesoft.com/mule-sdk/latest/oauth).

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Display</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>PAGE</p></li><li><p>POPUP</p></li><li><p>TOUCH</p></li></ul></div></div></td><td></td><td><p>PAGE</p></td><td></td></tr><tr><td><p>Immediate</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>TRUE</p></li><li><p>FALSE</p></li></ul></div></div></td><td></td><td><p>FALSE</p></td><td></td></tr><tr><td><p>Prompt</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>LOGIN</p></li><li><p>CONSENT</p></li></ul></div></div></td><td></td><td><p>LOGIN</p></td><td></td></tr><tr><td><p>Reconnection</p></td><td><div><div><p><a href="#Reconnection">Reconnection</a></p></div></div></td><td><p>When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.</p></td><td></td><td></td></tr><tr><td><p>Read Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>Specifies the amount of time, in milliseconds, that the consumer waits for a response before it times out. Default value is 0, which means infinite.</p></td><td><p>0</p></td><td></td></tr><tr><td><p>Read Timeout Time Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>Time unit that qualifies the Read Timeout.</p></td><td><p>MILLISECONDS</p></td><td></td></tr><tr><td><p>Connection Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>Specifies the amount of time, in milliseconds, that the consumer attempts to establish a connection before it times out. Default value is 0, which means infinite.</p></td><td><p>0</p></td><td></td></tr><tr><td><p>Connection Timeout Time Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>Time unit that qualifies the Connection Timeout.</p></td><td><p>MILLISECONDS</p></td><td></td></tr><tr><td><p>Host</p></td><td><div><div><p>String</p></div></div></td><td><p>Host name of the proxy. If this property is not set, then no proxy is used, otherwise a proxy is used, and a proxy host must be specified.</p></td><td></td><td></td></tr><tr><td><p>Port</p></td><td><div><div><p>Number</p></div></div></td><td><p>Port of the proxy. If host is set, then this property must be set and cannot be a negative number.</p></td><td></td><td></td></tr><tr><td><p>Username</p></td><td><div><div><p>String</p></div></div></td><td><p>Username used to authenticate against the proxy. If this property is not set, then no authentication is used against the proxy, otherwise this value must be specified.</p></td><td></td><td></td></tr><tr><td><p>Password</p></td><td><div><div><p>String</p></div></div></td><td><p>Password used to authenticate against the proxy.</p></td><td></td><td></td></tr><tr><td><p>Consumer Key</p></td><td><div><div><p>String</p></div></div></td><td><p>The OAuth consumerKey as registered with the service provider.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Consumer Secret</p></td><td><div><div><p>String</p></div></div></td><td><p>The OAuth consumerSecret as registered with the service provider.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Authorization Url</p></td><td><div><div><p>String</p></div></div></td><td><p>The service provider’s authorization endpoint URL.</p></td><td><p><code>https://login.salesforce.com/services/oauth2/authorize</code></p></td><td></td></tr><tr><td><p>Access Token Url</p></td><td><div><div><p>String</p></div></div></td><td><p>The service provider’s accessToken endpoint URL.</p></td><td><p><code>https://login.salesforce.com/services/oauth2/token</code></p></td><td></td></tr><tr><td><p>Scopes</p></td><td><div><div><p>String</p></div></div></td><td><p>The OAuth scopes to request during the dance. If not provided, it defaults to those in the annotation.</p></td><td></td><td></td></tr><tr><td><p>Resource Owner Id</p></td><td><div><div><p>String</p></div></div></td><td><p>The resourceOwnerId that each component should use if it doesn’t reference otherwise.</p></td><td></td><td></td></tr><tr><td><p>Before</p></td><td><div><div><p>String</p></div></div></td><td><p>The name of a flow to execute immediately before starting the OAuth dance.</p></td><td></td><td></td></tr><tr><td><p>After</p></td><td><div><div><p>String</p></div></div></td><td><p>The name of a flow to execute immediately after an accessToken is received.</p></td><td></td><td></td></tr><tr><td><p>Listener Config</p></td><td><div><div><p>String</p></div></div></td><td><p>A reference to a <code>&lt;http:listener-config /&gt;</code> to use to create the listener that catches the access token callback endpoint.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Callback Path</p></td><td><div><div><p>String</p></div></div></td><td><p>The path of the access token callback endpoint.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Authorize Path</p></td><td><div><div><p>String</p></div></div></td><td><p>The path of the local HTTP endpoint that triggers the OAuth dance.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>External Callback Url</p></td><td><div><div><p>String</p></div></div></td><td><p>Specify the URL the OAuth provider should use to access the callback if the callback endpoint is behind a proxy or will be accessed through a non-direct URL.</p></td><td></td><td></td></tr><tr><td><p>Object Store</p></td><td><div><div><p>String</p></div></div></td><td><p>A reference to the object store to use to store each resource owner ID’s data. If not specified, the Mule automatically provisions the default object store.</p></td><td></td><td></td></tr></tbody></table>

### OAuth JWT

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>TLS configuration</p></td><td><div><div><p><a href="#Tls">Tls</a></p></div></div></td><td><p>If the protocol is configured as HTTPS, then you must also configure the keystore configuration.</p></td><td></td><td></td></tr><tr><td><p>Read Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>Specifies the amount of time, in milliseconds, that the consumer waits for a response before it times out. The default value is <code>0</code>, which means infinite.</p></td><td><p>0</p></td><td></td></tr><tr><td><p>Read Timeout Time Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>Time unit that qualifies the Read Timeout.</p></td><td><p>MILLISECONDS</p></td><td></td></tr><tr><td><p>Connection Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>Specifies the amount of time, in milliseconds, that the consumer attempts to establish a connection before it times out. The default value is <code>0</code>, which means infinite.</p></td><td><p>0</p></td><td></td></tr><tr><td><p>Connection Timeout Time Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>Time Unit that qualifies the Connection Timeout.</p></td><td><p>MILLISECONDS</p></td><td></td></tr><tr><td><p>Host</p></td><td><div><div><p>String</p></div></div></td><td><p>Host name of the proxy. Required if a proxy is used. If this property is not set, then no proxy is used.</p></td><td></td><td></td></tr><tr><td><p>Port</p></td><td><div><div><p>Number</p></div></div></td><td><p>Port of the proxy. If a Host is set, this property must also be set, and cannot be a negative number.</p></td><td></td><td></td></tr><tr><td><p>Username</p></td><td><div><div><p>String</p></div></div></td><td><p>Username used to authenticate against the proxy. Required if using authentication against the proxy. If this property is not set, then no authentication is used against the proxy.</p></td><td></td><td></td></tr><tr><td><p>Password</p></td><td><div><div><p>String</p></div></div></td><td><p>Password used to authenticate against the proxy.</p></td><td></td><td></td></tr><tr><td><p>Consumer Key</p></td><td><div><div><p>String</p></div></div></td><td><p>Consumer key for the Salesforce-connected app.</p></td><td></td><td><p><strong>x</strong></p></td></tr><tr><td><p>Key Store</p></td><td><div><div><p>String</p></div></div></td><td><p>Path to the keystore used to sign data during authentication.</p></td><td></td><td><p><strong>x</strong></p></td></tr><tr><td><p>Store Password</p></td><td><div><div><p>String</p></div></div></td><td><p>Password of the keystore.</p></td><td></td><td><p><strong>x</strong></p></td></tr><tr><td><p>Principal</p></td><td><div><div><p>String</p></div></div></td><td><p>Username of the Salesforce user on whose behalf to take action.</p></td><td></td><td><p><strong>x</strong></p></td></tr><tr><td><p>Token Endpoint</p></td><td><div><div><p>String</p></div></div></td><td><p>URL pointing to the server responsible for providing the authentication token. According to Salesforce, this URL is <code>https://login.salesforce.com/services/oauth2/token</code>. If implementing for a community, the URL is <code>https://acme.force.com/customers/services/oauth2/token</code>, where <code>acme.force.com/customers</code> is your own community URL.</p></td><td><p><code>https://login.salesforce.com/services/oauth2/token</code></p></td><td></td></tr><tr><td><p>Audience Url</p></td><td><div><div><p>String</p></div></div></td><td><p>Identifies the authorization server as an intended audience. The authorization server must verify that it is an intended audience for the token.</p><p>Use the authorization server’s URL for the audience value, for example: <code>https://login.salesforce.com</code>, <code>https://test.salesforce.com</code>, or <code>+https://community.force.com/customers=</code> if implementing for a community.</p></td><td></td><td></td></tr><tr><td><p>Reconnection</p></td><td><div><div><p><a href="#Reconnection">Reconnection</a></p></div></div></td><td><p>When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.</p></td><td></td><td></td></tr></tbody></table>

### OAuth 2.0 SAML Bearer

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>TLS configuration</p></td><td><div><div><p><a href="#Tls">Tls</a></p></div></div></td><td><p>If the protocol is configured as HTTPS, then you must also configure the keystore configuration.</p></td><td></td><td></td></tr><tr><td><p>Read Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>Specifies the amount of time, in milliseconds, that the consumer waits for a response before it times out. The default value is <code>0</code>, which means infinite.</p></td><td><p>0</p></td><td></td></tr><tr><td><p>Read Timeout Time Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>Time Unit that qualifies the Read Timeout.</p></td><td><p>MILLISECONDS</p></td><td></td></tr><tr><td><p>Connection Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>Specifies the amount of time, in milliseconds, that the consumer attempts to establish a connection before it times out. The default value is <code>0</code>, which means infinite.</p></td><td><p>0</p></td><td></td></tr><tr><td><p>Connection Timeout Time Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>Time Unit that qualifies the Connection Timeout.</p></td><td><p>MILLISECONDS</p></td><td></td></tr><tr><td><p>Host</p></td><td><div><div><p>String</p></div></div></td><td><p>Host name of the proxy. Required if a proxy is used. If this property is not set, then no proxy is used.</p></td><td></td><td></td></tr><tr><td><p>Port</p></td><td><div><div><p>Number</p></div></div></td><td><p>Port of the proxy. If a Host is set, this property must also be set, and cannot be a negative number.</p></td><td></td><td></td></tr><tr><td><p>Username</p></td><td><div><div><p>String</p></div></div></td><td><p>Username used to authenticate against the proxy. If this property is not set then no authentication is used against the proxy, otherwise this value must be specified.</p></td><td></td><td></td></tr><tr><td><p>Password</p></td><td><div><div><p>String</p></div></div></td><td><p>Password used to authenticate against the proxy.</p></td><td></td><td></td></tr><tr><td><p>Consumer Key</p></td><td><div><div><p>String</p></div></div></td><td><p>Consumer key for Salesforce-connected app.</p></td><td></td><td><p><strong>x</strong></p></td></tr><tr><td><p>Key Store</p></td><td><div><div><p>String</p></div></div></td><td><p>Path to the keystore used to sign data during authentication.</p></td><td></td><td><p><strong>x</strong></p></td></tr><tr><td><p>Store Password</p></td><td><div><div><p>String</p></div></div></td><td><p>Password of the keystore.</p></td><td></td><td><p><strong>x</strong></p></td></tr><tr><td><p>Principal</p></td><td><div><div><p>String</p></div></div></td><td><p>Username of the Salesforce user on whose behalf to take action.</p></td><td></td><td><p><strong>x</strong></p></td></tr><tr><td><p>Token Endpoint</p></td><td><div><div><p>String</p></div></div></td><td><p>URL pointing to the server responsible for providing the authentication token. According to Salesforce, this URL is <code>https://login.salesforce.com/services/oauth2/token</code>. If implementing for a community, the URL is <code>https://acme.force.com/customers/services/oauth2/token</code>, where <code>acme.force.com/customers</code> is your own community URL.</p></td><td><p><code>https://login.salesforce.com/services/oauth2/token</code></p></td><td></td></tr><tr><td><p>Reconnection</p></td><td><div><div><p><a href="#Reconnection">Reconnection</a></p></div></div></td><td><p>When the application is deployed, a connectivity test is performed on all connectors. If set to <code>true</code>, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.</p></td><td></td><td></td></tr></tbody></table>

#### List of Operations

- [Create Data Set](#createDataSet)

- [Delete Data Set](#deleteDataSet)

- [Start Data Processing](#startDataProcessing)

- [Unauthorize](#unauthorize)

- [Upload External Data](#uploadExternalData)

- [Upload External Data Into New Dataset And Start Processing](#uploadExternalDataIntoNewDataSetAndStartProcessing)

## Operations

### Create Data Set

`<salesforce-analytics:create-data-set>`

Creates a new dataset (InsightsExternalData record) in the Salesforce Analytics Cloud system and
returns the identifier (InsightsExternalData ID) of the created dataset within the Salesforce
Analytics Cloud system.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Type</p></td><td><div><div><p>String</p></div></div></td><td><p>Represents the type of the dataset to be created</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Operation</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>APPEND</p></li><li><p>OVERWRITE</p></li><li><p>UPSERT</p></li><li><p>DELETE</p></li></ul></div></div></td><td></td><td></td><td><p>x</p></td></tr><tr><td><p>Description</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td><p>x</p></td></tr><tr><td><p>Label</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td><p>x</p></td></tr><tr><td><p>Data Set Name</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td><p>x</p></td></tr><tr><td><p>Edgemart Container</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Notification Sent</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>ALWAYS</p></li><li><p>FAILURES</p></li><li><p>NEVER</p></li><li><p>WARNINGS</p></li></ul></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Notification Email</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Mode</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>INCREMENTAL</p></li><li><p>NONE</p></li></ul></div></div></td><td><p>Mode.</p></td><td><p><code>NONE</code></p></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>The variable name where to store the operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output. The outcome of that expression is stored in the target variable.</p></td><td><p><code>#[payload]</code></p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#reconnect">Reconnect</a></p></li><li><p><a href="#reconnect-forever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors.</p></td><td></td><td></td></tr></tbody></table>

#### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><div><div><p>String</p></div></div></td></tr></tbody></table>

#### For Configurations

- [Default Configuration](#salesforce-analytics)

#### Throws

- SALESFORCE-ANALYTICS:CONNECTIVITY

- SALESFORCE-ANALYTICS:ERROR\_RESPONSE

- SALESFORCE-ANALYTICS:INVALID\_SESSION

- SALESFORCE-ANALYTICS:INVALID\_REQUEST\_DATA

- SALESFORCE-ANALYTICS:RETRY\_EXHAUSTED

- SALESFORCE-ANALYTICS:TRANSACTION

- SALESFORCE-ANALYTICS:UNKNOWN

### Delete Data Set

`<salesforce-analytics:delete-data-set>`

Deletes the specified dataset (InsightsExternalData record) from the Salesforce Analytics Cloud
system. For more information about limitations, refer to
[The InsightsExternalData Object](https://developer.salesforce.com/docs/atlas.en-us.bi_dev_guide_ext_data.meta/bi_dev_guide_ext_data/bi_ext_data_object_externaldata.htm).

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Data Set Id</p></td><td><div><div><p>String</p></div></div></td><td><p>Identifier of the dataset (InsightsExternalData ID) to delete.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#reconnect">Reconnect</a></p></li><li><p><a href="#reconnect-forever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations

- [Default Configuration](#salesforce-analytics)

#### Throws

- SALESFORCE-ANALYTICS:CONNECTIVITY

- SALESFORCE-ANALYTICS:ERROR\_RESPONSE

- SALESFORCE-ANALYTICS:INVALID\_SESSION

- SALESFORCE-ANALYTICS:INVALID\_REQUEST\_DATA

- SALESFORCE-ANALYTICS:RETRY\_EXHAUSTED

- SALESFORCE-ANALYTICS:TRANSACTION

- SALESFORCE-ANALYTICS:UNKNOWN

### Start Data Processing

`<salesforce-analytics:start-data-processing>`

Tells the Salesforce Analytics Cloud system to start processing the records uploaded at this point
into a dataset.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Data Set Id</p></td><td><div><div><p>String</p></div></div></td><td><p>Identifier of the dataset (InsightsExternalData ID) to process.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#reconnect">Reconnect</a></p></li><li><p><a href="#reconnect-forever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations

- [Default Configuration](#salesforce-analytics)

#### Throws

- SALESFORCE-ANALYTICS:CONNECTIVITY

- SALESFORCE-ANALYTICS:ERROR\_RESPONSE

- SALESFORCE-ANALYTICS:INVALID\_SESSION

- SALESFORCE-ANALYTICS:INVALID\_REQUEST\_DATA

- SALESFORCE-ANALYTICS:RETRY\_EXHAUSTED

- SALESFORCE-ANALYTICS:TRANSACTION

- SALESFORCE-ANALYTICS:UNKNOWN

### Unauthorize

`<salesforce-analytics:unauthorize>`

Deletes all the access token information of a given resource owner ID so that it’s impossible to
execute any operation for the user without repeating the authorization dance.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Resource Owner Id</p></td><td><div><div><p>String</p></div></div></td><td><p>The ID of the resource owner for whom to invalidate access</p></td><td></td><td></td></tr></tbody></table>

#### For Configurations

- [Default Configuration](#salesforce-analytics)

### Upload External Data

`<salesforce-analytics:upload-external-data>`

Creates an InsightsExternalDataPart record. The InsightsExternalDataPart object works with the
InsightsExternalData ID. After you insert a row into the InsightsExternalData object, you can create
part objects to split up your data into parts.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Data Set Id</p></td><td><div><div><p>String</p></div></div></td><td><p>Identifier of a dataset (InsightsExternalData ID) within the Salesforce Analytics Cloud system.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Records</p></td><td><div><div><p>Array of Object</p></div></div></td><td><p>List of records to insert.</p></td><td><p><code>#[payload]</code></p></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>The variable name where to store the operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output. The outcome of that expression is stored in the target variable.</p></td><td><p><code>#[payload]</code></p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#reconnect">Reconnect</a></p></li><li><p><a href="#reconnect-forever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors.</p></td><td></td><td></td></tr></tbody></table>

#### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><div><div><p><a href="#BulkOperationResult">Bulk Operation Result</a></p></div></div></td></tr></tbody></table>

#### For Configurations

- [Default Configuration](#salesforce-analytics)

#### Throws

- SALESFORCE-ANALYTICS:CONNECTIVITY

- SALESFORCE-ANALYTICS:ERROR\_RESPONSE

- SALESFORCE-ANALYTICS:INVALID\_SESSION

- SALESFORCE-ANALYTICS:INVALID\_REQUEST\_DATA

- SALESFORCE-ANALYTICS:RETRY\_EXHAUSTED

- SALESFORCE-ANALYTICS:TRANSACTION

- SALESFORCE-ANALYTICS:UNKNOWN

### Upload External Data Into New Dataset And Start Processing

`<salesforce-analytics:upload-external-data-into-new-data-set-and-start-processing>`

Creates a dataset (InsightsExternalData), uploads data into InsightsExternalDataPart records, and
tells the Salesforce Analytics Cloud system to start processing the uploaded data to create the
Salesforce dataset.

#### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Type</p></td><td><div><div><p>String</p></div></div></td><td><p>Type of the records to insert. This automatically computes based on metadata extracted from the provided file that contains the configuration element.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Records</p></td><td><div><div><p>Array of Object</p></div></div></td><td><p>List of records to insert.</p></td><td><p><code>#[payload]</code></p></td><td></td></tr><tr><td><p>Operation</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>APPEND</p></li><li><p>DELETE</p></li><li><p>OVERWRITE</p></li><li><p>UPSERT</p></li></ul></div></div></td><td></td><td></td><td><p>x</p></td></tr><tr><td><p>Description</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td><p>x</p></td></tr><tr><td><p>Label</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td><p>x</p></td></tr><tr><td><p>Data Set Name</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td><p>x</p></td></tr><tr><td><p>Edgemart Container</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Notification Sent</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>ALWAYS</p></li><li><p>FAILURES</p></li><li><p>NEVER</p></li><li><p>WARNINGS</p></li></ul></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Notification Email</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Mode</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>INCREMENTAL</p></li><li><p>NONE</p></li></ul></div></div></td><td><p>Mode.</p></td><td><p><code>NONE</code></p></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>The variable name where to store the operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output. The outcome of that expression is stored in the target variable.</p></td><td><p><code>#[payload]</code></p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#reconnect">Reconnect</a></p></li><li><p><a href="#reconnect-forever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors.</p></td><td></td><td></td></tr></tbody></table>

#### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><div><div><p>String</p></div></div></td></tr></tbody></table>

#### For Configurations

- [Default Configuration](#salesforce-analytics)

#### Throws

- SALESFORCE-ANALYTICS:CONNECTIVITY

- SALESFORCE-ANALYTICS:ERROR\_RESPONSE

- SALESFORCE-ANALYTICS:INVALID\_SESSION

- SALESFORCE-ANALYTICS:INVALID\_REQUEST\_DATA

- SALESFORCE-ANALYTICS:RETRY\_EXHAUSTED

- SALESFORCE-ANALYTICS:TRANSACTION

- SALESFORCE-ANALYTICS:UNKNOWN

## Types

### Tls

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Enabled Protocols</p></td><td><div><div><p>String</p></div></div></td><td><p>A comma-separated list of protocols enabled for this context.</p></td><td></td><td></td></tr><tr><td><p>Enabled Cipher Suites</p></td><td><div><div><p>String</p></div></div></td><td><p>A comma-separated list of cipher suites enabled for this context.</p></td><td></td><td></td></tr><tr><td><p>Trust Store</p></td><td><div><div><p><a href="#TrustStore">Trust Store</a></p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Key Store</p></td><td><div><div><p><a href="#KeyStore">Key Store</a></p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Revocation Check</p></td><td><div><div><ul><li><p><a href="#standard-revocation-check">Standard Revocation Check</a></p></li><li><p><a href="#custom-ocsp-responder">Custom OCSP Responder</a></p></li><li><p><a href="#crl-file">CRL File</a></p></li></ul></div></div></td><td></td><td></td><td></td></tr></tbody></table>

### Trust Store

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Path</p></td><td><div><div><p>String</p></div></div></td><td><p>The location of the trust store, which will be resolved relative to the current classpath and file system, if possible.</p></td><td></td><td></td></tr><tr><td><p>Password</p></td><td><div><div><p>String</p></div></div></td><td><p>The password used to protect the trust store.</p></td><td></td><td></td></tr><tr><td><p>Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The type of store used.</p></td><td></td><td></td></tr><tr><td><p>Algorithm</p></td><td><div><div><p>String</p></div></div></td><td><p>The algorithm used by the trust store.</p></td><td></td><td></td></tr><tr><td><p>Insecure</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>If true, no certificate validations will be performed, rendering connections vulnerable to attacks. Use at your own risk.</p></td><td></td><td></td></tr></tbody></table>

### Key Store

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Path</p></td><td><div><div><p>String</p></div></div></td><td><p>The location of the trust store, which will be resolved relative to the current classpath and file system, if possible.</p></td><td></td><td></td></tr><tr><td><p>Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The type of store used.</p></td><td></td><td></td></tr><tr><td><p>Alias</p></td><td><div><div><p>String</p></div></div></td><td><p>When the keystore contains many private keys, this attribute indicates the alias of the key to use. If not defined, the first key in the file is used by default.</p></td><td></td><td></td></tr><tr><td><p>Key Password</p></td><td><div><div><p>String</p></div></div></td><td><p>The password used to protect the private key.</p></td><td></td><td></td></tr><tr><td><p>Password</p></td><td><div><div><p>String</p></div></div></td><td><p>The password used to protect the keystore.</p></td><td></td><td></td></tr><tr><td><p>Algorithm</p></td><td><div><div><p>String</p></div></div></td><td><p>The algorithm used by the keystore.</p></td><td></td><td></td></tr></tbody></table>

### Standard Revocation Check

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Only End Entities</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Only verify the last element of the certificate chain.</p></td><td></td><td></td></tr><tr><td><p>Prefer Crls</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Try CRL instead of OCSP first.</p></td><td></td><td></td></tr><tr><td><p>No Fallback</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Do not use the secondary checking method (the one not selected before).</p></td><td></td><td></td></tr><tr><td><p>Soft Fail</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Avoid verification failure when the revocation server can not be reached or is busy.</p></td><td></td><td></td></tr></tbody></table>

### Custom OCSP Responder

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Url</p></td><td><div><div><p>String</p></div></div></td><td><p>The URL of the OCSP responder.</p></td><td></td><td></td></tr><tr><td><p>Cert Alias</p></td><td><div><div><p>String</p></div></div></td><td><p>Alias of the signing certificate for the OCSP response (must be in the trust store), if present.</p></td><td></td><td></td></tr></tbody></table>

### CRL File

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Path</p></td><td><div><div><p>String</p></div></div></td><td><p>The path to the CRL file.</p></td><td></td><td></td></tr></tbody></table>

### Reconnection

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Fails Deployment</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.</p></td><td></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#reconnect">Reconnect</a></p></li><li><p><a href="#reconnect-forever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>The reconnection strategy to use</p></td><td></td><td></td></tr></tbody></table>

### Reconnect

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Frequency</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>How often to reconnect (in milliseconds)</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Count</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>The number of reconnection attempts to make</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Reconnect Forever

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Frequency</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>How often in milliseconds to reconnect</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Expiration Policy

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Max Idle Time</p></td><td><div><div><p>Number</p></div></div></td><td><p>A scalar time value for the maximum amount of time a dynamic configuration instance is allowed to be idle before it’s considered eligible for expiration.</p></td><td></td><td></td></tr><tr><td><p>Time Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the maxIdleTime attribute.</p></td><td></td><td></td></tr></tbody></table>

### Bulk Operation Result

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Id</p></td><td><div><div><p>Any</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Items</p></td><td><div><div><p>Array of <a href="#BulkItem">Bulk Item</a></p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Successful</p></td><td><div><div><p>Boolean</p></div></div></td><td></td><td></td><td></td></tr></tbody></table>

### Bulk Item

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Exception</p></td><td><div><div><p>Any</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Id</p></td><td><div><div><p>Any</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Message</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Payload</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Status Code</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Successful</p></td><td><div><div><p>Boolean</p></div></div></td><td></td><td></td><td></td></tr></tbody></table>

## See Also

[Salesforce Help](https://help.salesforce.com)