Skip to main content Skip to complementary content

Installing a custom component

This example installs a custom component called tFileOutputPDF. You can also create your own component and import it into your Talend Studio.

Before you begin

Before installing the custom component tFileOutputPDF, you need to download it. For more information about tFileOutputPDF, see Talend Exchange EOL and Custom Components.

After you have downloaded the component or exported your own component as a ZIP file, you can install it into your Talend Studio by taking the following steps.

Information noteNote: To install a mediation component, you need to edit <component>_java.xml in the component ZIP file by adding TYPE="CAMEL" to HEADER before proceeding with the following steps. For example,
<HEADER
    PLATEFORM="ALL"    SERIAL=""
    VERSION="0.102"    STATUS="ALPHA"    
    COMPATIBILITY="ALL"    AUTHOR="Talend"    RELEASE_DATE="20100401A"    STARTABLE="false"    SCHEMA_AUTO_PROPAGATE="false"    DATA_AUTO_PROPAGATE="false"    TYPE="CAMEL"  > 

Procedure

  1. Unzip the archive file and copy the "tFileOutputPDF".component folder to the Clipboard.

    Note the following directory structure, and make sure you copy the right folder.

    tFileoutputPDF // copy this folder

    --- iText-2.0.8.jar

    --- tFileOutputPDF_begin.javajet

    --- tFileOutputPDF_end.javajet

    --- other component's files

  2. Paste the component folder to a dedicated directory where you will store all custom components, for example D:\custom_component\.
  3. In Talend Studio, click Window in the toolbar, then Preferences > Talend > Component.
  4. Browse to the dedicated component directory where you store all your custom components.
  5. Click OK. Talend Studio will reload all the components including the custom components.

    This configuration is stored in the metadata of the workspace. If the workspace of Talend Studio changes, you need to reset this configuration again.

  6. Check that you have successfully installed the component by searching the component name tFileOutputPDF in the Palette.

    If the component does not appear in the Palette, there are several possible causes:

    1. The XML file of component is not well configured. For example: tFileOutputPDF_java.xml for the component presented in the previous example. Open the XML file of component and make sure of the following:
      • The XML file should be well-formed.
      • The Family element should not be missing as this element specifies the component group in the Palette where the custom component is filed under. For example: <FAMILY>File/Management</FAMILY>.
      • The right elements are used in the XML file. To check this, simply compare your custom component XML file with the XML file of an official Talend component. All official components are located in <Talend Studio installation dir>\plugins\org.talend.designer.components.localprovider_x.x.x.rxxxxx\components\.
    2. The component folder pasted into your dedicated custom component directory was wrong. In this case, carry out the installation procedure again.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!