Installation procedure - 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

To be able to use tAlfrescoOutput in the Integration perspective of Talend Studio, you need first to install the Alfresco server with few relevant resources.

The below sub sections detail the prerequisite and the installation procedure.

Prerequisites

Start with the following operations:

  1. Download the file alfresco-community-tomcat-2.1.0.zip

  2. Unzip the file in an installation folder, for example:

    C:\Program Files\Java\jdk1.6.0_27
  3. Install JDK 1.6.0+

  4. Update the environment variable

    JAVA_HOME (JAVA_HOME= C:\alfresco)
  5. From the installation folder (C:\alfresco), launch the alfresco server using the script alf_start.bat

Warning

Make sure that the Alfresco server is launched correctly before start using the tAlfrescoOutput component.

Installing the Talend Alfresco module

Note that the talendalfresco_20081014.zip is provided with the tAlfrescoOutput component in the Integration perspective of Talend Studio.

To install the talendalfresco module:

  1. From talendalfresco_20081014.zip and in the talendalfresco_20081014\alfresco folder, look for the following jars: stax-api-1.0.1.jar, wstx-lgpl-3.2.7.jar, talendalfresco-client_1.0.jar, and talendalfresco-alfresco_1.0.jar and move them to C:\alfresco\tomcat\webapps\alfresco\WEB-INF\lib

  2. Add the authentification filter of the commands to the web.xml file located in the path

    C:\alfresco\tomcat\webapps\alfresco\WEB-INF
    son WEB-INF/

    following the model of the example provided in talendalfresco_20081014/alfresco folder of the zipped file talendalfresco_20081014.zip

    The following figures show the portion of lines (in blue) to add in the file web.xml alfresco.

Useful information for advanced use

Installing new types for Alfresco:

From the package_jeu_test.zip and in the package_jeu_test/fichiers_conf_alfresco2.1 folder, look for the following files: xml H76ModelCustom.xml (description of the model), web-client-config-custom.xml (web interface of the model), and custom-model-context.xml (registration of the new model) and paste them in the following folder: C:/alfresco/tomcat/shared/classes/alfresco/extension

Dates:

  • The dates must be of the Talend date type java.util.Date.

  • Columns without either mapping or default values, for example of the type Date, are written as empty strings.

  • Solution: delete all columns without mapping or default values. Note that any modification of the type Alfresco will put them back.

Content:

  • Do not mix up between the file path which content you want to create in Alfresco and its target location in Alfresco.

  • Provide a URL! It can target various protocols, among which are file, HTTP and so on.

  • For URLs referring to files on the file system, precede them by "file:" for Windows used locally, and by "file://" for Windows on a network (which accepts as well "file: \ \") or for Linux.

  • Do not double the backslash in the target base path (automatic escape), unless you type in the path in the basic settings of the tAlfrescoOutput component, or doing concatenation in the tMap editor for example.

Multiple properties or associations:

  • It is possible to create only one association by document if it is mapped to a string value, or one or more associations by document if it is mapped to a list value (object).

  • You can empty an association by mapping it to an empty list, which you can create, for example, by using new java.util.ArrayList()in the tMap component.

However, it is impossible to delete an association.

Building List(object)with tAggregate:

  • define the table of the relation n-n in a file, containing a name line for example (included in the input rows), and a category line (that can be defined with its mapping in a third file).

  • group by: input name, output name.

  • operation: output categoryList, function list(object), input category. ATTENTION list (object) and non simple list.

- References (documents and folders):

  • References are created by mapping one or more existing reference nodes (xpath or namepath) using String type or List(object).

  • An error in the association or the property of the reference type does not prevent the creation of the node that holds the reference.

  • Properties of the reference type are created in the Basic Settings view.

  • Associations are created in the Advanced Settings view.