Artifact management

Prev Next

Artifact references

Each artifact has a unique identifier visible at the top left of the card. In the example below, the task has the identifier "407762".

Task details for forging a lock, including beginning and end dates.

Considering the uniqueness of the identifiers, it is possible to find a specific artifact on the platform using the search box Button labeled 'Switch to...' indicating a feature change or option selection. in the bar at the top.

Recent items section showing task details and search results in a project management tool.

To reference this artifact, three strings work:

  • Artifact #123

  • Art #123

  • Task #123

Practical information

The short name of our tracker is used to reference artifacts, which is why it must be chosen correctly for the information to be explicit

Here the short name of our task tracker is "task" which allows us to reference the artifact this way: task #123, when we see the reference, we know exactly what is behind the link. I chose to put it in the singular because we only reference one task at a time while the name of the tracker is in the plural because it contains several tasks.

Of course, this search takes into account the permissions and the artifact will only be presented to you if you have the rights to consult this artifact.

You can consult the references that exist in your project, in the project administration section, in the "References" submenu,

We find all the system references in the upper part and in particular art and artifact. In the lower part you will find the project reference templates that are implicitly created with your trackers and those created by the project administrator.

The use of references

References are used in text mode, for example:

  • In mediawiki, they can be used in text directly

  • In trackers, they can be used in comments, in text or string fields

  • In commit messages GIT or SVN

Practical information

Using a reference allows you to link an artifact to another element in Tuleap, whether it is a document, a wiki page, a delivery or any other artifact. These links are visible in both directions, making it easy to identify all the elements that reference an artifact using cross-reference fields.

Inter-artifact links

Inter-artifact links are an even more efficient way to link two artifacts together.

Here is the procedure:

1. Add the "Link to artifacts" field to the tracker

Administration interface showing various field types and highlighted artifact link option.

To learn how to add and configure a field in a tracker, check out this article.

2. Link to other artifacts

Artifacts can be of the same or a different type (i.e. from another tracker) but also in a different project. The only condition to link 2 artifacts together is to have the possibility to edit the artifact link field of the first one and to have visibility on the second.

There are three ways to add a link to an artifact:

  • Case 1 : You know the identifiers of the target artifacts. Then enter the identifiers, separated by commas, directly in the field.

  • Case 2 : the artifact exists but you don't know its identifier. Use the search button to select one or more target artifacts.

    In this mode, you first have to select the tracker that contains the artifacts to be linked as well as a report.

    By default, the current tracker is selected, but you can change to select any tracker you have access to. The tracker may be in another project of which you are a member. Then, you can select a report from the tracker to filter the artifacts.

    Once the two values have been selected, the artifacts that you want to link and validate remain to be checked.

    Links section showing artifact ID and options for creating new artifacts.

  • Case 3 : the artifact does not yet exist. Use the create button to create it immediately and then make the link.

    First of all, you have to select the tracker in which the new artifact will be created, it will be automatically added to the list of artifacts to be linked once created.

    Once the tracker is selected, simply fill in the fields, as with any artifact creation in this tracker.

Links section for project management with fields for title, project, and tracker selection.

The linking operation performed then just click or submit the changes.

Visualization of related artifacts:

Thereafter, the target artifacts will be listed in a multi-tabbed table. Artifacts will be classified by tracker as below:

Task management interface showing ongoing and to-do tasks for development projects.

Here the artifact is linked to two other artifacts of the Task tracker (Tasks). From one of the two artifacts it is possible to know the artifacts that link them.

To do this, simply click on the button: "Display reverse artifact links" to find out what they are.

Artifact details including ID, project, tracker, summary, status, and assigned user.