Managing project references - 6.3

Talend Administration Center User Guide

EnrichVersion
6.3
EnrichProdName
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend Real-Time Big Data Platform
task
Administration and Monitoring
Deployment
EnrichPlatform
Talend Administration Center

Warning

Only users that have the Administrator role and rights can have a read-write access to this page. Other users, depending on their roles, can have either a read-only access or no access to this page. For further information on access rights, see User roles/rights in the Administration Center. When any user of the Administration Center opens this page, he/she will have access only to the items for which the user has been granted the right authorization by the Administrator.

A project reference is a property that you can set for a project in Talend Administration Center so that all or some of the project items can be referenced by another project.

  • When one project references another, the items (Jobs, Metadata, Business Modeler and so on) in the referenced project are available for reuse.

  • When one project is stored on SVN or GIT, its items are structured in trunk or master and branches so that the reference can be established at either levels to provide more flexibility in project usability.

For more details on how to create branches for a project on Talend Administration Center, see To create a Git or SVN branch.

Accessing the project references page

To display the reference list for the projects created in Talend Studio or directly on Talend Administration Center:

In the Menu tree view, click Project references to access the Reference projects page.

Note

You need to define some projects as reference from the Project page in order to have reference projects listed on this page. For more information on how to define a reference project, see Adding/removing a reference project.

The main page is divided into two parts:

  • the Project Reference panel lists projects you have defined as reference on the Project page.

  • the Project panel shows the references established between projects.

Note that, by default, the list is ordered by reference projects (with the icon). If you click the Project references button on top of the panels, the list will be ordered by projects to set as a reference.

The Reference dependencies button on the top toolbar allows you to visualize the dependencies that exist on a given project.

On the Project Reference view, you can see information related to the reference projects as follows:

Column

Description

Reference

The icon shows when the corresponding project has been defined as reference.

Label

The name of the project created in Talend Studio

Branch

The name of the trunk and the branches established for each reference project.

Reference

Different icons show you whether you can set references between the selected projects:

: you can set a reference between the selected projects.

: a reference already exists between the selected projects.

: you cannot set a reference between the selected projects.

Establishing a reference between two projects

If your repository is stored on Subversion or GIT, you can create a reference from the trunk/master or one branch of one project to the trunk/master or one branch of another project. Once you created the reference, the user of Talend Studio can access the trunk/master or the branch items and resources of Project1 directly from the trunk/master or the branch of Project2 to which it is referenced.

Prerequisites:

  • You can establish references between projects only if:

    • you have read-write authorization for them,

    • the type of the project to be used as a reference is subordinate to the type of the referencing project. For example, a Data Quality project can be used as a reference for a Master Data Management project and not vice versa. For more information about project types, see What domains can you work in depending on your user type and license.

  • You can not:

    • define TWO branches of a project as reference to the branch of another project.

    • create a cycle of references.

    • have project items with the same name (Jobs, Contexts, Metadata, etc.) in both a project and its reference.

  1. In the Menu tree-view, select Project references to open the project references page.

  2. From the Project Reference panel, select the project, or its trunk/master or branch, you want to be used as a reference.

  3. From the Project panel, select the different projects and add references to them.

    The number of references on the referenced projects is updated in the Project Reference panel.

    Note that you can also add project referencesvia the MetaServlet application, using the createProjectReference command. For more information on MetaServlet, see Non-GUI operation in metaServlet.

Deleting a project reference

To delete a reference from the selected project:

  1. In the Menu tree-view, select Project references to open the project references page.

  2. In the Project panel, select the project and click the reference icon.

    The reference is removed and the icon changes from to to .

    Note that you can also delete a project reference via the MetaServlet application, using the deleteProjectReference command. For more information on MetaServlet, see Non-GUI operation in metaServlet.