Upsert Entity (Salesforce) activity

Display Name

Function:

Specifies the activity name that shows in your process.

Accepted Values:

One line of text that can have spaces.

Default Value:

None

Accepts Process Data Variables:

No

Description

Function:

Specifies an optional description for your activity.

Accepted Values:

More than one line of text.

Default Value:

None

Accepts Process Data Variables:

No

Connection Timeout (Seconds)

Function:

Specifies the number of seconds permitted to complete an action before the connection stops.

Accepted Values:

An integer that represents a number of seconds.

Default Value:

600

Accepts Process Data Variables:

No

Salesforce

Function:

Specifies the access token that connects to your Salesforce application.

Accepted Values:

A list of access tokens configured for your environment.

Default Value:

None

Accepts Process Data Variables:

No

Add Token

Opens this Screen:

New Salesforce Access Token

Function of this Screen:

Configures a new access token for Salesforce.

Entity Name

Function:

Specifies the name for your entity.

Accepted Values:

One line of text that can have spaces.

Default Value:

None

When you select the Salesforce access token, the name of the entity shows in the Entity Name field.

Accepts Process Data Variables:

No

External Field

Function:

Specifies an external field value connected to a record. The activity creates a check to find any records that have this external field value.

• If the external field does not agree with any records, create a new record.
• If the external field agrees with one record, change the record.
• If the external field agrees with more than one record, give an error. No record is added or changed.

Accepted Values:

A valid external field value.

Default Value:

None

When you select the name of entity, the external field value shows in this field.

Accepts Process Data Variables:

No

Request Mapping

Function:

Connects the Salesforce API request parameter to your process schema. This is mandatory only if the request passes data from the process schema to parameters in the Salesforce API.

To Open this Field:

1. On the Upsert Entity Configuration screen, click the Request tab.

Accepted Values:

Click the Ellipses button to open the Schema Mapper screen.

Use this screen to connect the request to the data model for your process.

Default Value:

None

Map Response to AgilePoint Schema

Function:

Specifies the connection from the Salesforce API response parameter to your process schema.

To Open this Field:

1. On the Upsert Entity Configuration screen, click the Response tab.

Accepted Values:

Click the Ellipses button to open the Schema Mapper screen.

Use this screen to connect the response to the data model for your process.

Default Value:

None

Store the Response in Custom Attribute

Function:

Specifies the variable that contains the response to a method call. The method must call a web service.

To Open this Field:

1. On the Upsert Entity Configuration screen, click the Response tab.

Accepted Values:

A process data variable.

Default Value:

None

Accepts Process Data Variables:

Yes