Contact Us 1-800-596-4880

Salesforce Einstein Analytics Connector 3.4 Reference - Mule 4

Default Configuration

Parameters

Name Type Description Default Value Required

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x

Connection

  • Basic Username and Password

  • OAuth v2.0

  • OAuth JWT

  • OAuth 2.0 SAML Bearer

The connection types to provide to this configuration.

x

Expiration Policy

ExpirationPolicy

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.

Connection Types

Basic Username and Password

Parameters

Name Type Description Default Value Required

TLS configuration

Tls

If the protocol is configured as HTTPS, then you must also configure the keystore configuration.

Username

String

Username used to initialize the session.

x

Password

String

Password used to authenticate the user.

x

Security Token

String

User’s security token. It can be omitted if your IP has been allowlisted on Salesforce.

Authorization URL

String

Web service URL responsible for user authentication. This is the URL for the endpoint that is configured to handle SOAP authentication requests.

There is no default value, but if left empty the connector uses the latest API version

Reconnection

Reconnection

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.

Read Timeout

Number

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.

0

Connection Timeout

Number

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.

0

Host

String

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.

Port

Number

Port of the proxy. If host is set then this property must be set and cannot be a negative number.

Username

String

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.

Password

String

Password used to authenticate against the proxy.

OAuth v2.0

Parameters

Name Type Description Default Value Required

Display

Enumeration, one of:

  • PAGE

  • POPUP

  • TOUCH

Immediate

Enumeration, one of:

  • TRUE

  • FALSE

FALSE

Prompt

Enumeration, one of:

  • LOGIN

  • CONSENT

LOGIN

Reconnection

Reconnection

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.

Read Timeout

Number

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.

0

Connection Timeout

Number

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.

0

Host

String

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.

Port

Number

Port of the proxy. If host is set, then this property must be set and cannot be a negative number.

Username

String

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.

Password

String

Password used to authenticate against the proxy.

Consumer Key

String

The OAuth consumerKey as registered with the service provider.

x

Consumer Secret

String

The OAuth consumerSecret as registered with the service provider.

x

Authorization Url

String

The service provider’s authorization endpoint URL.

https://login.salesforce.com/services/oauth2/authorize

Access Token Url

String

The service provider’s accessToken endpoint URL.

https://login.salesforce.com/services/oauth2/token

Scopes

String

The OAuth scopes to request during the dance. If not provided, it defaults to those in the annotation.

Resource Owner Id

String

The resourceOwnerId that each component should use if it doesn’t reference otherwise.

Before

String

The name of a flow to execute immediately before starting the OAuth dance.

After

String

The name of a flow to execute immediately after an accessToken is received.

Listener Config

String

A reference to a <http:listener-config /> to use to create the listener that catches the access token callback endpoint.

x

Callback Path

String

The path of the access token callback endpoint.

x

Authorize Path

String

The path of the local HTTP endpoint that triggers the OAuth dance.

x

External Callback Url

String

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.

Object Store

String

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.

OAuth JWT

Parameters

Name Type Description Default Value Required

TLS configuration

Tls

If the protocol is configured as HTTPS, then you must also configure the keystore configuration.

Consumer Key

String

Consumer key for Salesforce connected app.

x

Key Store

String

Path to keystore used to sign data during authentication.

x

Store Password

String

Password of keystore.

x

Principal

String

Username of the Salesforce user to take action on behalf of.

x

Token Endpoint

String

URL pointing to the server responsible for providing the authentication token. According to Salesforce it must be https://login.salesforce.com/services/oauth2/token, or, if implementing for a community, https://acme.force.com/customers/services/oauth2/token (where acme.force.com/customers is your community URL).

https://login.salesforce.com/services/oauth2/token

Reconnection

Reconnection

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.

Read Timeout

Number

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.

0

Connection Timeout

Number

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.

0

Host

String

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.

Port

Number

Port of the proxy. If host is set then this property must be set and cannot be a negative number.

Username

String

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.

Password

String

Password used to authenticate against the proxy.

OAuth 2.0 SAML Bearer

Parameters

Name Type Description Default Value Required

TLS configuration

Tls

If the protocol is configured as HTTPS, then you must also configure the keystore configuration.

Consumer Key

String

Consumer key for Salesforce connected app.

x

Key Store

String

Path to keystore used to sign data during authentication.

x

Store Password

String

Password of keystore.

x

Principal

String

Salesforce username

x

Token Endpoint

String

URL pointing to the server responsible for providing the authentication token. According to Salesforce, it must be https://login.salesforce.com/services/oauth2/token, or, if implementing for a community, https://acme.force.com/customers/services/oauth2/token (where acme.force.com/customers is your community URL).

https://login.salesforce.com/services/oauth2/token

Reconnection

Reconnection

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.

Read Timeout

Number

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.

0

Connection Timeout

Number

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.

0

Host

String

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.

Port

Number

Port of the proxy. If host is set then this property must be set and cannot be a negative number.

Username

String

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.

Password

String

Password used to authenticate against the proxy.

Associated Operations

  • createDataSet

  • deleteDataSet

  • startDataProcessing

  • unauthorize

  • uploadExternalData

  • uploadExternalDataIntoNewDataSetAndStartProcessing

Operations

Create Data Set

<salesforce-analytics:create-data-set>

Creates a new dataset in the Salesforce Analytics Cloud system and returns the identifier of the created data set within the Salesforce Analytics Cloud system.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Type

String

Represents the type of the dataset to be created

x

Operation

Enumeration, one of:

  • APPEND

  • OVERWRITE

  • UPSERT

  • DELETE

x

Description

String

x

Label

String

x

Data Set Name

String

x

Edgemart Container

String

Notification Sent

Enumeration, one of:

  • ALWAYS

  • FAILURES

  • NEVER

  • WARNINGS

Notification Email

String

Target Variable

String

The variable name where to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output. The outcome of that expression is stored in the target variable.

#[payload]

Reconnection Strategy

  • reconnect

  • reconnect-forever

A retry strategy in case of connectivity errors.

Output

Type String

For Configurations

  • salesforce-analytics

Throws

  • SALESFORCE-ANALYTICS:CONNECTIVITY

  • SALESFORCE-ANALYTICS:CONNECTIVITY

  • SALESFORCE-ANALYTICS:INVALID_SESSION

  • SALESFORCE-ANALYTICS:RETRY_EXHAUSTED

  • SALESFORCE-ANALYTICS:TRANSACTION

  • SALESFORCE-ANALYTICS:UNKNOWN

Delete Data Set

<salesforce-analytics:delete-data-set>

Deletes the specified dataset from the Salesforce Analytics Cloud system.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use

x

Data Set Id

String

Identifier of dataset to delete

x

Reconnection Strategy

  • reconnect

  • reconnect-forever

A retry strategy in case of connectivity errors

For Configurations

  • salesforce-analytics

Throws

  • SALESFORCE-ANALYTICS:CONNECTIVITY

  • SALESFORCE-ANALYTICS:CONNECTIVITY

  • SALESFORCE-ANALYTICS:INVALID_SESSION

  • 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

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use

x

Data Set Id

String

Identifier of dataset to be processed

x

Reconnection Strategy

  • reconnect

  • reconnect-forever

A retry strategy in case of connectivity errors

For Configurations

  • salesforce-analytics

Throws

  • SALESFORCE-ANALYTICS:CONNECTIVITY

  • SALESFORCE-ANALYTICS:CONNECTIVITY

  • SALESFORCE-ANALYTICS:INVALID_SESSION

  • 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

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use

x

Resource Owner Id

String

The ID of the resource owner for whom to invalidate access

For Configurations

  • salesforce-analytics

Upload External Data

<salesforce-analytics:upload-external-data>

Inserts records into a dataset at an ID obtained from the Salesforce Analytics Cloud system.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Data Set Id

String

Identifier of a dataset within the Salesforce Analytics Cloud system.

x

Records

Array of Object

List of records to be inserted.

#[payload]

Target Variable

String

The variable name where to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output. The outcome of that expression is stored in the target variable.

#[payload]

Reconnection Strategy

  • reconnect

  • reconnect-forever

A retry strategy in case of connectivity errors.

Output

Type BulkOperationResult

For Configurations

  • salesforce-analytics

Throws

  • SALESFORCE-ANALYTICS:CONNECTIVITY

  • SALESFORCE-ANALYTICS:CONNECTIVITY

  • SALESFORCE-ANALYTICS:INVALID_SESSION

  • 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, uploads data into it, and tells the Salesforce Analytics Cloud system to start processing the uploaded data.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Type

String

Type of the records to insert. This automatically computes based on metadata extracted from the provided file that contains the configuration element.

x

Records

Array of Object

List of records to insert.

#[payload]

Operation

Enumeration, one of:

  • APPEND

  • DELETE

  • OVERWRITE

  • UPSERT

x

Description

String

x

Label

String

x

Data Set Name

String

x

Edgemart Container

String

Notification Sent

Enumeration, one of:

  • ALWAYS

  • FAILURES

  • NEVER

  • WARNINGS

Notification Email

String

Target Variable

String

The variable name where to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output. The outcome of that expression is stored in the target variable.

#[payload]

Reconnection Strategy

  • reconnect

  • reconnect-forever

A retry strategy in case of connectivity errors.

Output

Type String

For Configurations

  • salesforce-analytics

Throws

  • SALESFORCE-ANALYTICS:CONNECTIVITY

  • SALESFORCE-ANALYTICS:CONNECTIVITY

  • SALESFORCE-ANALYTICS:INVALID_SESSION

  • SALESFORCE-ANALYTICS:RETRY_EXHAUSTED

  • SALESFORCE-ANALYTICS:TRANSACTION

  • SALESFORCE-ANALYTICS:UNKNOWN

Types

Tls

Field Type Description Default Value Required

Enabled Protocols

String

A comma-separated list of protocols enabled for this context.

Enabled Cipher Suites

String

A comma-separated list of cipher suites enabled for this context.

Trust Store

Key Store

Revocation Check

Trust Store

Field Type Description Default Value Required

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the trust store.

Password

String

The password used to protect the trust store.

Type

String

The type of store used.

Algorithm

String

The algorithm used by the trust store.

Insecure

Boolean

If true, no certificate validations will be performed, rendering connections vulnerable to attacks. Use at your own risk.

Key Store

Field Type Description Default Value Required

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the key store.

Type

String

The type of store used.

Alias

String

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.

Key Password

String

The password used to protect the private key.

Password

String

The password used to protect the keystore.

Algorithm

String

The algorithm used by the keystore.

Standard Revocation Check

Field Type Description Default Value Required

Only End Entities

Boolean

Only verify the last element of the certificate chain.

Prefer Crls

Boolean

Try CRL instead of OCSP first.

No Fallback

Boolean

Do not use the secondary checking method (the one not selected before).

Soft Fail

Boolean

Avoid verification failure when the revocation server can not be reached or is busy.

Custom Ocsp Responder

Field Type Description Default Value Required

Url

String

The URL of the OCSP responder.

Cert Alias

String

Alias of the signing certificate for the OCSP response (must be in the trust store), if present.

Crl File

Field Type Description Default Value Required

Path

String

The path to the CRL file.

Reconnection

Field Type Description Default Value Required

Fails Deployment

Boolean

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.

Reconnection Strategy

  • reconnect

  • reconnect-forever

The reconnection strategy to use

Reconnect

Field Type Description Default Value Required

Frequency

Number

How often to reconnect (in milliseconds)

Count

Number

The number of reconnection attempts to make

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread

true

Reconnect Forever

Field Type Description Default Value Required

Frequency

Number

How often in milliseconds to reconnect

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread

true

Expiration Policy

Field Type Description Default Value Required

Max Idle Time

Number

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.

Time Unit

Enumeration, one of:

  • DAYS

  • HOURS

  • MICROSECONDS

  • MILLISECONDS

  • MINUTES

  • NANOSECONDS

  • SECONDS

A time unit that qualifies the maxIdleTime attribute.

Bulk Operation Result

Field Type Description Default Value Required

Id

Any

Items

Array of BulkItem

Successful

Boolean

Bulk Item

Field Type Description Default Value Required

Exception

Any

Id

Any

Message

String

Payload

Object

Status Code

String

Successful

Boolean

View on GitHub