Skip to main content Skip to complementary content

Working with referenced projects

You can add referenced projects that will be referenced by another project.

Accessing data quality items in a referenced project

After the connection between main and reference projects has been established, you can see and share all items from the reference project upon opening the main project in Talend Studio.

You can show them either as part of the Job Design folder or as a separate folder, Referenced Project, that has its own hierarchical tree.

Location of the Referenced project node in the DQ Repository tree view.

You can share any item from the reference project including connections, patterns, indicators, and rules.

Suppose that you have created in Talend Studio a dq_project where you want to use some patterns you created in another project ref_dq_project.

Information noteNote: The Indicator Selection window do not show items from referenced projects.

Before you begin

You need to have read-write access to the projects only for migration purposes upon migrating to a new version or applying a patch.

Procedure

  1. Launch Talend Studio using a remote connection and the URL of Talend Administration Center or Talend Management Console.
  2. Open the main project.
    All items in the reference project show by default in the repository tree view as a separate reference project preceded by the @ sign and are read-only.
  3. Click Merge project icon on the toolbar to merge both projects in the tree view.
    Names of the items in the referenced projects look unavailable and are followed by the referenced project name they are part of to distinguish them from items in the main project.

Using data quality items from the referenced project

When one project references another, all items in the referenced project are available for reuse from the main project.

For example, you can drop a business rule or a pattern defined in a reference project directly to an analysis you create in the current project without going into the process of creating the item from scratch.
Information noteTip: From the main project, before selecting new columns from a reference project in the Column Selection dialog box, expand those new columns in the reference project.

When you import analyses from a reference project into a local project or a remote project which does not connect to the same reference project, you will have problems opening the analyses and running them. This is because only analyses are imported without their items. You must first create the connection to the same reference project before being able to correctly use the analyses in the current project.

Before you begin

  • You have read-writing authorization for the main and referenced projects. For further information, see Managing project authorizations.
  • You have opened the main project in Talend Studio.

Procedure

  1. From the main project, open the analysis on which you want to use an item from the reference project.
    In this example, you want to use a business rule age_18 defined in the reference project on a table analysis from the main project.
    Overview of the Age_Analysis analysis and the SQL rule to be used.
  2. Drop age_18 from the reference project to the selected table in the analysis editor.
    Items and resources in the referenced projects are always up-to-date since the refresh option in Talend Studio will refresh EVERY item in Talend Studio. However, the refresh operation could be quite long if you have too many references and items in each of your projects. It is therefor preferable not to use very big referenced projects, especially if you use the database repository.
  3. Run the analysis.

Results

The table is analyzed against the business rule from the reference project and results are displayed in the editor.
Tables and graphics for the Where Rule indicator.

Detecting changes made in the referenced project

The main project detects any changes made in the referenced project, except for adding a context variable.

When your changes have effects on the analyses and reports, open them to accept or cancel the changes. Clicking Cancel cancels the changes for the current operation. You will be asked to accept or cancel the changes each time you open the analysis and report.

When you rename or delete a context, the analyses and reports keep a copy of the context. Its variable values are replaced by the variable values of the Default context.

As a copy of the renamed context is kept, you see one additional context in your analyses and reports.

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!