tMarketoOutput Standard properties - 6.4

Marketo

author
Talend Documentation Team
EnrichVersion
6.4
EnrichProdName
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for ESB
Talend Open Studio for MDM
Talend Real-Time Big Data Platform
task
Data Governance > Third-party systems > Business applications > Marketo components
Data Quality and Preparation > Third-party systems > Business applications > Marketo components
Design and Development > Third-party systems > Business applications > Marketo components
EnrichPlatform
Talend Studio

These properties are used to configure tMarketoOutput running in the Standard Job framework.

The Standard tMarketoOutput component belongs to two families: Business and Cloud.

The component in this framework is available in all Talend products.

Basic settings

Property Type

Select the way the connection details will be set.

  • Built-In: The connection details will be set locally for this component. You need to specify the values for all related connection properties manually.

  • Repository: The connection details stored centrally in Repository > Metadata will be reused by this component. You need to click the [...] button next to it and in the pop-up Repository Content dialog box, select the connection details to be reused, and all related connection properties will be automatically filled in.

This property is not available when other connection component is selected from the Connection Component drop-down list.

Connection component

Select the component whose connection details will be used to set up the connection to Marketo from the drop-down list.

Endpoint address

Enter the API Endpoint URL of the Marketo Web Service. The API Endpoint URL can be found on the Marketo Admin > Web Services panel.

Client access ID

Enter the client Id for the access to the Marketo Web Service.

The client Id and client secret can be found on the Marketo Admin > LaunchPoint panel, by clicking View Details for the service to be accessed. You can also contact Marketo Support via support@marketo.com for further information.

Secret key

Enter the client secret for the access to the Marketo Web Service.

To enter the secret key, click the [...] button next to the secret key field, and then in the pop-up dialog box enter the password between double quotes and click OK to save the settings.

Schema and Edit schema

A schema is a row description. It defines the number of fields (columns) to be processed and passed on to the next component. The schema is either Built-In or stored remotely in the Repository.

  • Built-In: You create and store the schema locally for this component only. Related topic: see Talend Studio User Guide.

  • Repository: You have already created the schema and stored it in the Repository. You can reuse it in various projects and Job designs. Related topic: see Talend Studio User Guide.

The schema of this component is predefined and it will be different according to the API mode selected, the operation chosen or the custom object specified.

Note that when the API mode is changed, you need to refresh the schema columns manually by switching back and forth the components in the Connection Component drop-down list (only when reusing the connection created by a tMarketoConnection component) and changing the operation to be performed in the Operation drop-down list.

Click Edit schema to make changes to the schema. If the current schema is of the Repository type, three options are available:

  • View schema: choose this option to view the schema only.

  • Change to built-in property: choose this option to change the schema to Built-in for local changes.

  • Update repository connection: choose this option to change the schema stored in the repository and decide whether to propagate the changes to all the Jobs upon completion. If you just want to propagate the changes to the current Job, you can select No upon completion and choose this schema metadata again in the [Repository Content] window.

Click Sync columns to retrieve the schema from the previous component connected in the Job.

This component offers the advantage of the dynamic schema feature. This allows you to retrieve unknown columns from source files or to copy batches of columns from a source without mapping each column individually. For further information about dynamic schemas, see Talend Studio User Guide.

This dynamic schema feature is designed for the purpose of retrieving unknown columns of a table and is recommended to be used for this purpose only; it is not recommended for the use of creating tables.

Note that the dynamic schema feature for this component is only supported in the REST API mode.

Operation

Select an operation that allows you to synchronize data between Marketo and another external system.

  • syncLead: Insert or update (upsert) a single lead record.

  • syncMultipleLeads: Insert or update (upsert) multiple lead records.

  • deleteLeads (for REST only): Delete a list of leads.

  • syncCustomObjects (for REST only): Insert, update, or upsert custom object records to the target instance.

  • deleteCustomObjects (for REST only): Delete a set of custom object records.

Operation type

Select a type of sync operation to be performed from the drop-down list.

  • createOnly: creates new leads.

  • updateOnly: updates existing leads.

  • createOrUpdate: creates new leads, or updates the leads if they already exist.

  • createDuplicate: creates new leads. If they already exist, then creates duplicated leads.

This list is available only in the REST API mode when syncLead or syncMultipleLeads is selected from the Operation list.

Lookup field

Select the lookup field that will be used to find the duplicate.

This list is available only in the REST API mode when syncLead or syncMultipleLeads is selected from the Operation list.

Mappings

Complete this table to map the column names of the component schema with the column names in Marketo. By default, the column names in Column name fields are the same as what they are in the schema.

Note that because some column names in Marketo may contain blank space, which is not allowed in the component schema, you need to specify the corresponding column fields in the Marketo column name column. If the defined column names in schema are the same as column names in Marketo, it is not necessary to set the columns mapping.

This table is available only in the SOAP API mode.

Dedupe prospects record using the email address

Select this check box to de-duplicate records using email address.

Clear this check box to create another record which contains the same email address.

Delete leads in batch

Select this check box to delete the leads in batch.

This check box is available only when deleteLeads is selected from the Operation list.

Batch Size

Specify the number of records to be processed in each batch.

This field is available when:

  • syncMultipleLeads is selected from the Operation list, or
  • deleteLeads is selected from the Operation list and the Delete leads in batch check box is selected.
Sync method

Select a type of sync operation to be performed from the drop-down list.

This list is available only when syncCustomObjects is selected from the Operation list.

Dedupe by

Specify the field on which the records will be deduplicated.

This field is available only when syncCustomObjects is selected from the Operation list.

Delete by

Select the field by which the delete operation will be performed.

This list is available only when deleteCustomObjects is selected from the Operation list.

Custom object name

Specify the name of the custom object.

This field is available only when syncCustomObjects or deleteCustomObjects is selected from the Operation list.

Die on error

Select this check box to stop the execution of the Job when an error occurs.

Clear the check box to skip any rows on error and complete the process for error-free rows.

When errors are skipped, you can collect the rows on error using a Row > Reject connection. But note that no error rows can be collected when syncing or deleting leads in batch.

Advanced settings

API Mode

Select the Marketo API mode, either REST API (default) or SOAP API.

For more information about the Marketo REST API, see http://developers.marketo.com/documentation/rest/.

For more information about the Marketo SOAP API, see http://developers.marketo.com/documentation/soap/.

Timeout

Enter the timeout value (in milliseconds) for the connection to the Marketo Web Service before terminating the attempt.

Max reconnection attemps

Enter the maximum number of reconnect attempts to the Marketo Web Service before giving up.

Attempt interval time

Enter the time period (in milliseconds) between subsequent reconnection attempts.

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at the Job level as well as at each component level.

Global Variables

NUMBER_CALL

The number of calls. This is an After variable and it returns an integer.

ERROR_MESSAGE

The error message generated by the component when an error occurs. This is an After variable and it returns a string.

Usage

Usage rule

This component is usually used as an end component of a Job or Subjob and it always needs an input link.