Use synchronization tasks for publications and subscriptions where the publication or subscription process requires only mapping and filtering. For example, to read data from a CRM application and publish the data as is.
For publications and subscriptions that require additional data processing and for compound publications, use mapping tasks.
Creating a synchronization task for a publication
To create a synchronization task for a publication, perform the following tasks:
•Define task details.
•Select the publication source. The source is the cloud application from which you want to publish data.
•Select the publication target. The target is the topic table in the Cloud Integration Hub publication repository, into which the cloud application publishes the data. The topic must exist in Cloud Integration Hub before you create the task.
•Optionally, define data filters. Cloud Integration Hub does not support the use of advanced filters in synchronization tasks.
•Configure field mapping. Map source fields to topic fields.
•Save and close the task.
Step 1. Define task details
Define task details in the Definition page of the Synchronization Task Wizard.
1Click Task Wizards > Data Synchronization.
The Synchronization Task Wizard appears.
2Specify the following details:
Task Name
Enter a name for the task.
The name of the task must be unique within the organization. The task name is not case sensitive.
The task name can contain alphanumeric characters, spaces, and the following special characters: _ . + -
Tip: Indicate the type of the task in the task name. This will ensure that when you select a task to use in a Cloud Integration Hub publication workflow, you select a publication task. For example, name the task Pub_<TaskName>.
Description
Optionally, enter a description for the task. The description can contain up to 255 characters.
Task Operation
Choose Insert.
3Click Next
The Source page appears.
Step 2. Select publication source
Select the publication source in the Source page of the Synchronization Task Wizard.
Specify the following details and then click Next:
Connection
Select a source connection that connects to the source from which you want to publish data.
Source Type
The source type depends on the number of tables that you want to publish:
▪ To publish a single table, select Single.
▪ To publish multiple tables, select Multiple and then create a relationship between the tables.
Source Object
Select the source from which you want to publish data.
The Target page appears.
Step 3. Select publication target
Select the publication target in the Target page of the Synchronization Task Wizard. The publication target is the topic table in the Cloud Integration Hub publication repository to which you want to publish data.
1Specify the following details:
Connection
Select the Cloud Integration Hub connection.
Target Object
Select the topic table to which you want to publish data. The format of the target object is TopicName/tableName.
2Click Next.
The Data Filters page appears.
3Optionally, configure data filters. You configure data filters for Cloud Integration Hub publications in the same way that you configure data filters for other Data Integration tasks.
4Click Next.
The Field Mapping page appears.
Step 4. Configure field mapping
Map source fields to topic fields in the Field Mapping page of the Synchronization Task Wizard.
1Map fields in the Source column to fields in the Target column and then click Next.
The Schedule page appears.
2Verify that the option Do not run this task on a schedule is selected. The task runs according to the schedule of the publication that uses the task.
3Select Save > Save and Close to save the task.
Creating a synchronization task for a subscription
To create a synchronization task for a subscriptionin Data Integration, perform the following tasks:
•Define task details.
•Select the subscription source. The source is the topic table in the Cloud Integration Hub publication repository, from which you want to consume data. The topic must exist in Cloud Integration Hub before you create the task.
•Select the subscription target. The target is the cloud application that you want to consume the data.
•Optionally, define data filters. Cloud Integration Hub does not support the use of advanced filters in synchronization tasks.
•Configure field mapping. Map topic fields to target fields.
Define task properties in the Definition page of the Synchronization Task Wizard.
1Click Task Wizards > Data Synchronization.
The Synchronization Task Wizard appears.
2Specify the following details and then click Next:
Task Name
Enter a name for the synchronization task.
The name of the task must be unique within the organization. The task name is not case sensitive.
The task name can contain alphanumeric characters, spaces, and the following special characters: _ . + -
Tip: Indicate the type of the task in the task name. This will ensure that when you select a task to use in a Cloud Integration Hub subscription workflow, you select a subscription task. For example, name the task Sub_<TaskName>.
Description
Optionally, enter a description for the task. The description can contain up to 255 characters.
Task Operation
Choose Insert.
The Source page appears.
Step 2. Select subscription source
Select the subscription source in the Source page of the Synchronization Task Wizard. The subscription source is the topic table in the Cloud Integration Hub publication repository from which you want to consume data.
Specify the following details and then click Next:
Connection
Select the Cloud Integration Hub connection.
Source Type
The source type depends on the number of tables that you want to consume and on the subscription type:
▪ To consume a single table, select Single.
▪ To consume multiple tables, or when the subscription is a compound subscription, select Multiple and then create a relationship between the tables.
Source Object
Select the topic table from which you want to consume data. The format of the object is TopicName/tableName.
The Target page appears.
Step 3. Select subscription target
Select the subscription target in the Target page of the Synchronization Task Wizard.
1Specify the following details:
Connection
Select a target connection that connects to the target into which you want to consume data.
Target Object
Select the target into which you want to consume the data.
2Click Next.
The Data Filters page appears.
3Optionally, configure data filters. You configure data filters for Cloud Integration Hub subscriptions in the same way that you configure data filters for other Data Integration tasks.
4Click Next.
The Data Filters page appears.
Step 4. Configure Data Filters and Sorting
Define a data filter by selecting an Object and applying filter.
1To define a data filter, click New. Select an object, a field, an operator, and enter a filter value.
2Click OK.
3To add a data sorting, click New. Select an object, and enter a sort value. You can sort data based on one or more fields. When you select more than one source field, the task sorts the fields in the listed order. You can sort the data in ascending or descending order.
4Click Next. The Field Mapping page appears.
Step 5. Configure Field Mapping
Map topic fields to target fields in the Field Mapping page of the Synchronization Task Wizard.
1Map fields in the Source column to fields in the Target column and then click Next.
The Schedule page appears.
2Verify that the option Do not run this task on a schedule is selected. The task runs according to the schedule of the publication that uses the task.
Specify the following details and then click Next: