Skip to content

Commit

Permalink
Improve readability of the "move artifact" section
Browse files Browse the repository at this point in the history
The big "Note" was harder to read, the list inside it was not rendered
properly. Fixed a syntax problem with the system types (this is
ReStructuredText, not Markdown).
Also added a proper image description to the screenshot.
  • Loading branch information
Hyzual authored and nterray committed Aug 28, 2023
1 parent 666952a commit 9d5e26e
Showing 1 changed file with 14 additions and 15 deletions.
29 changes: 14 additions & 15 deletions languages/en/user-guide/trackers/usage/move-artifact.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,25 +4,24 @@ Move artifacts
Since Tuleap 10.5, you can move artifacts from a tracker to another one.

To be able to move an artifact:
- you must be tracker administrator of both source and target trackers
- artifact deletion must be allowed (``Site admin > Administration > Tracker > Artifacts Deletion``)

However, there are some limitations:
- you must be tracker administrator of both source and target trackers
- artifact deletion must be allowed (``Site admin > Administration > Tracker > Artifacts Deletion``)

- Artifacts linked to FRS releases cannot be moved in another tracker.
- Artifacts related to a Program project (SAFE®) cannot be moved in another tracker.
However, there are some limitations:

- Artifacts linked to FRS releases cannot be moved in another tracker.
- Artifacts related to a Program project (SAFE®) cannot be moved in another tracker.

.. NOTE::
The artifact move works using "duck typing". If the source field and the destination field have the same name, the same type, or are compatible (string/text, int/float), then the field value can be moved to the destination tracker.
Regarding list fields, they need to have the same bind type (static values, users, user groups). If a value does not exist in the destination list field, then it will be ignored.
When a field does not match these conditions, then its data will be lost.
Artifact links are moved but follow some specific rules:

The artifact move works using duck typing. If the source field and the destination field have the same name, the same type, or are compatible (string/text, int/float), then the field value can be moved to the destination tracker.
Regarding list fields, they need to have the same bind type (static values, users, user groups). If a value does not exist in the destination list field, then it will be ignored.
When a field does not match these conditions, then its data will be lost.
Artifact links are moved but follow some specific rules:
- system types `_is_child`, `_covered_by` ... are cleared (the artifact is still link but the type is reset to no type)
- parent artifact is also cleared
- system types ``_is_child``, ``_covered_by``… are cleared (the artifact is still linked but the type is reset to "no type")
- parent artifact is also cleared

.. figure:: ../../../images/screenshots/tracker/move-artifact.png
:align: center
:alt: Move artifact modal
:name: Move artifact modal
:alt: Screenshot of the "Move artifact" modal. It shows an example where an artifact from the "Archer Airlines" tracker will be moved to the "Bugs" tracker. There is a red warning explaining that 9 fields cannot be moved and 3 fields will be fully migrated.

Move artifact modal

0 comments on commit 9d5e26e

Please sign in to comment.