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".

Considering the uniqueness of the identifiers, it is possible to find a specific artifact on the platform using the search box
in the bar at the top.

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

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.

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.

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:

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.
