tMicrosoftCrmOutput – Docs for ESB 5.x

Component family

Business / Microsoft CRM

Function

This component writes data in an entity of a Microsoft CRM
database.

Purpose

This component allows to write data into a Microsoft CRM
database.

Basic settings

Authentication Type

Select the authentication type that corresponds to specific CRM
deployment model.

Microsoft WebService URL

Type in the webservice URL of an on-premise Microsoft CRM
server.

This field appears only when ON_PREMISE is selected from the Authentication Type drop-down list. In
this case, the Microsoft CRM API version supported is v2007 and this field can be filled with
the URL like this: http://ServerAddress/MSCrmServices/2007/CrmService.asmx.

API Version

Select a Microsoft CRM API version from the drop-down list. The
version may be v2007 or v2011.

This field appears only when ONLINE is selected from the Authentication Type drop-down list.

OrganizeName

Enter the name of the organization that needs to access the
Microsoft CRM database.

Username and
Password

Type in the webservice user authentication data.

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

Domain

Type in the domain name of the server on which the Microsoft CRM
is hosted.

This field appears only when ON_PREMISE is selected from the Authentication Type list.

Host

Type in the IP address of the Microsoft CRM database
server.

This field appears only when ON_PREMISE is selected from the Authentication Type list.

Port

Type in the listening port number of the Microsoft CRM database
server.

This field appears only when ONLINE is selected from the Authentication Type drop-down list.

Discovery service endpoint

Specify the CRM online discovery service endpoint.

This field appears only when ONLINE is selected from the Authentication Type drop-down list.

Action

Select in the list the action you want to do on the CRM data.
Available actions are: insert,
update, and delete.

Time out (second)

Specify the number of seconds to wait for a reply message from the
CRM server before closing the connection with it.

Entity

Select the relevant entity from the list.

If needed, select CustomEntity
from the list, then specify an entity name in the Custom Entity Name field and define the
schema for the custom entity.

Custom Entity Name

Specify the name of the custom entity.

This field appears only when CustomEntity is selected from the Entity drop-down list.

Schema and Edit
schema

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

Since version 5.6, both the Built-In mode and the Repository mode are
available in any of the Talend solutions.

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

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

Lookup Type Mapping

Advanced settings

Reuse Http Client

Select this check box to retain the current connection or clear it
to release the connection.

tStatCatcher Statistics

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

Global Variables

NB_LINE: the number of rows read by an input component or
transferred to an output component. 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. This
variable functions only if the Die on error check box is
cleared, if the component has this check box.

A Flow variable functions during the execution of a component while an After variable
functions after the execution of the component.

To fill up a field or expression with a variable, press Ctrl +
Space to access the variable list and choose the variable to use from it.

For further information about variables, see Talend Studio
User Guide.

Usage

This component is usually used as an output component and it
requires an input component.

Limitation

This component supports Microsoft CRM 4.0 (2007) for the
On-Premise authentication type and Microsoft CRM 4.0 (2007) and 2011
for the Online authentication type.