tDotNETInstantiate - 6.3

Talend Open Studio for Big Data Components Reference Guide

EnrichVersion
6.3
EnrichProdName
Talend Open Studio for Big Data
task
Data Governance
Data Quality and Preparation
Design and Development
EnrichPlatform
Talend Studio

Function

tDotNETInstantiate instantiates an object in the .NET for later reuse.

Purpose

tDotNETInstantiate invokes the constructor of a .NET object that is intended for later reuse.

tDotNETInstantiate properties

Component family

DotNET

 

Basic settings

Dll to load

Type in the path, or browse to the DLL library containing the classe(es) of interest or enter the assembly's name to be used. For example, System.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089 for an OleDb assembly.

 

 Fully qualified class name(i.e. ClassLibrary1.NameSpace2.Class1)

Enter a fully qualified name for the class of interest.

 

 Value(s) to pass to the constructor

Click the plus button to add one or more values to be passed to the constructor for the object. Or, leave this table empty to call a default constructor for the object.

The valid value(s) should be the parameters required by the class to be used.

 Advanced settings

tStatCatcher Statistics

Select this check box to collect log data at the component level.

Global Variables

INSTANCE: the instance of a .NET object. This is an After variable and it returns an object.

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 can be used as a start component in a flow or an independent subjob

To use this component, you must first install the runtime DLLs, for example janet-win32.dll for Windows 32-bit version and janet-win64.dll for Windows 64-bit version, from the corresponding Microsoft Visual C++ Redistributable Package. This allows you to avoid errors like the UnsatisfiedLinkError on dependent DLL.

So ensure that the runtime and all of the other DLLs which the DLL to be called depends on are installed and their versions are consistent among one another.

Note

The required DLLs can be installed in the System32 folder or in the bin folder of the Java runtime to be used.

If you need to export a Job using this component to run it outside the Studio, you have to specify the runtime container of interest by setting the -Djava.library.path argument accordingly.

For users of Talend solutions with ESB, to run a Job using this component in ESB Runtime, you need to copy the runtime DLLs to the %KARAF_HOME%/lib/wrapper/ directory.

Related scenario

For a related scenario, see Scenario: Utilizing .NET in Talend.