Salesforce Data 360 Connector > Mapping and mapping tasks with Salesforce Data 360 Connector > Salesforce Data 360 targets in mappings
  

Salesforce Data 360 targets in mappings

To write data to Salesforce Data 360, configure a Salesforce Data 360 object as a target in a mapping.
The following table describes the target properties that you can configure for a Salesforce Data 360 target
Property
Description
Connection
Name of the Salesforce Data 360 source connection.
You can select an existing connection or create a new connection. You can also click New Parameter to define a parameter for the target connection.
Target Type
Type of the target object.
Select one of the following options:
  • - Single Object
  • - Parameter
Object
Name of the target object. You can select an existing object or create a new target at run time.
To write data to an existing object, select an object from the Ingestion API connectors.
Operation
Type of the target operation.
Select from one of the following operations:
  • - Insert
  • - Upsert
  • - Delete
Note: In Salesforce Data 360, the insert operation performs the same function as the upsert operation.
The following table describes the Salesforce Data 360 advanced target properties:
Property
Description
Ingestion Mode
The ingestion mode to write data into Salesforce Data 360.
Select one of the following modes based on the data volume, processing speed, and near real-time requirements:
  • - Streaming API. Select to process near-real-time micro-batch datasets.
  • - Bulk API. Select to load large datasets.
    • Before you use the Bulk API ingestion mode, you need to enable a property for the Secure Agent. For more information, see Enabling Bulk API ingestion mode.
Ingestion API Connector Name
Required when you don't choose an object from Ingestion API connectors.
The name of the Ingestion API connector used for data ingestion into Salesforce Data 360. This API specifies the structure and format of the payload data to ensure compatibility and efficient processing.
For example, in the URL, https://{instance_url}/api/v1/ingest/sources/EmpOrder/Order, the ingestion API connector name is EmpOrder.
Object Name
Required when you don't choose an object from Ingestion API connectors.
Name of the Salesforce data lake object where you want to write the data.
For example, in the URL, https://{instance_url}/api/v1/ingest/sources/EmpOrder/Order, the object name is Order.
Note: When you configure an incorrect object name, the Salesforce Data 360 streaming API returns a success response, but you cannot read the data. This is a Salesforce Data 360 limitation.

Create a target at runtime

You can use an existing target or create a target to hold the results of a mapping. If you choose to create the target, the agent creates the target if it does not exist already when you run the task.
Before you create a target at runtime, ensure that the fields from the source or upstream transformations meet the necessary schema file requirements. For more information, see Requirements for Ingestion API Schema File.
To specify the target properties, perform the following tasks:
  1. 1Select the Target transformation in the mapping.
  2. 2To specify the target, click the Target tab.
  3. 3Select the target connection.
  4. 4For the target type, choose Single Object or Parameter.
  5. 5Specify the target object or parameter.
  6. 6To specify a target object, perform the following tasks:
    1. aClick Select and choose a target object. You can select an existing target object or create a new target object at runtime.
    2. bTo create a target object at runtime, select Create New at Runtime.
    3. cConfigure the following target properties:
    Property
    Description
    Object Name
    The name of the target object.
    Data Space
    The name of the data space to organize your data.
    If left empty, the default data space of your organization is considered.
    Primary Key
    The primary key or unique identifier of your source object that is required to create a data stream in Salesforce Data 360.
    If the source object does not have a primary key, specify a field that uniquely identifies each record.
    Category
    The type of data used in the data stream. You can define the following types of data:
    • - Engagement. Select this if your dataset is time-series oriented. You must specify the event time using the Event Time Field.
    • - Profile. Select this if your dataset consists of entities, such as individuals, businesses, employees, or devices with unique identifiers that you want to segment, unify, or enrich.
    • - Other. Select this if your dataset serves as reference data with descriptive attributes for profile or engagement records.
    Record Modified Field
    This field applies to Profile and Other categories.
    The name of the field that captures the date or timestamp when the record was last modified.
    serves as a reference point for when the incoming record was last modified.
    Event Time Field
    This field is required if you select the Engagement category.
    The name of the field that captures when an event occurred.
    Path
    Required. The folder path of the target object.
    Specify the path in the following format:
    /Ingestion API Connectors/<name of the ingestion API connector>
  7. 7Click OK.