Importing items - Cloud - 8.0

Talend Data Fabric Studio User Guide

Version
Cloud
8.0
Language
English (United States)
EnrichDitaval
Data Fabric
Product
Talend Data Fabric
Module
Talend Studio
Content
Design and Development

You can import items from previous versions of Talend Studio or from a different project of your current version.

The items you can possibly import are multiple:

  • Jobs Designs

  • Routes

  • Services

  • Routines

  • Documentation

  • Metadata

Note:

From Talend 7.0 onward, a digital signature is added to each project item when it is saved in Talend Studio. When importing a project or project items, Talend Studio validates the signatures and rejects items with an invalid signature. This is a security measure to prevent accidental or malicious modification of project items.

However, you can import a project or project items exported from an earlier version of Talend Studio before the expiration date of a 90-day grace period from the first installation of Talend Studio or before the date set in the migration token, whichever comes later. Upon successful import, all imported items are signed.

For more information on setting a migration token, see Talend Data Fabric Installation Guide.

Talend Studio allows any authorized user to import any project item from a local repository into the remote repository and share them with other users.

To import items, right-click any entry such as Job Designs , Routes, Services, in the Repository tree view and select Import Items from the contextual menu or directly click the icon on the toolbar to open the Import items dialog box and then select an import option.

The Find features needed for the import check box is selected by default to detect all features needed for importing a full project. This operation may be time consuming and you can clear the check box to ignore the operation.

With the Find features needed for the import check box selected, if any required features for importing a full project are not installed, a dialog box will pop up and display those missing features. You can click Install and restart in the dialog box to install the features and restart your Studio or click Cancel to import only the items based on the features already activated in your project.

To import items stored in a local directory, do the following:

  1. Click the Select root directory option in the Import items dialog box.

  2. Click Browse to browse down to the relevant project folder within the workspace directory. It should correspond to the project name you picked up.

  3. If you only want to import very specific items such as some Job Designs, you can select the specific folder, such as Process where all the Job Designs for the project are stored.

    But if your project gathers various types of items (Jobs Designs, Routes, Services, Metadata, Routines...), we recommend you to select the project folder to import all items in one go, and click OK.

  4. If needed, select the overwrite existing items check box to overwrite existing items with those having the same names to be imported. This will refresh the Items List.
    Note: You cannot overwrite the existing items, if:
    • the item is identical but the path is different, or
    • the name is identical but the item is different.
  5. From the Items List which displays all valid items that can be imported, select the items that you want to import by selecting the corresponding check boxes.

  6. Click Finish to validate the import.

To import items from an archive file (including source files and scripts), do the following:

  1. Click the Select archive file option in the Import items dialog box.

  2. Browse to the desired archive file and click Open.

  3. If needed, select the overwrite existing items check box to overwrite existing items with those having the same names to be imported. This will refresh the Items List.

    Note: You cannot overwrite the existing items, if:
    • the item is identical but the path is different, or
    • the name is identical but the item is different.
  4. From the Items List which displays all valid items that can be imported, select the items that you want to import by selecting the corresponding check boxes.

  5. Click Finish to validate the import.

To import items from Talend Exchange , do the following:

  1. Click the Select archive file option in the Import items dialog box. Then, click BrowseTalendExchange to open the Select an item from Talend Exchange dialog box.

  2. Select the desired category from the Category list, and select the desired version from the TOS_VERSION_FILTER list.

    A progress bar appears to indicate that the extensions are being downloaded. At last, the extensions for the selected category and version will be shown in the dialog box.

  3. Select the extension that you want to import from the list.

    Click Finish to close the dialog box.

  4. If needed, select the overwrite existing items check box to overwrite existing items with those having the same names to be imported. This will refresh the Items List.

    Note: You cannot overwrite the existing items, if:
    • the item is identical but the path is different, or
    • the name is identical but the item is different.
  5. From the Items List which displays all valid items that can be imported, select the items that you want to import by selecting the corresponding check boxes.

  6. Click Finish to validate the import.

Note: If there are several versions of the same items, they are all imported into the Project you are running, unless you already have identical items.

If you import items from previous versions of Talend Studio, those items will be migrated to the current version when being imported.

When the migration completes, a CSV report file <timestamp>_<project-name>_Migration_Report.csv that lists all migrated items is generated under the directory <Talend-Studio>\workspace\report\migrationReport_<timestamp>, where <timestamp> designates when the report is generated and <project-name> designates the name of your project, and you will see a dialog box with a link to the report file.

  • Click Run analysis to run the project analysis tool to analyze your migrated project. For more information, see Analyzing projects.
  • Click Not now to close the dialog box.

The table below describes the information presented in the report file.

Column Description
Task name the name of the migration task
Task description the description of the migration task
Item type the type of the migrated item
Path to migrated item the path to the migrated item
Migration details the details of the migration

You can now use and share your Jobs, Routes, Services, and all related items in your collaborative work. For more information about how to collaborate on a project, see Working collaboratively on project items.