You can copy artifacts between projects in the Requirements
Management (RM) application.
Before you begin
Before you copy artifacts between projects, verify the following items:
- You are logged in as a user with JazzAdmins or JazzProjectAdmins repository permissions. You are
assigned the Administrator role.
- Both projects have the same setting for configuration
management: either both are enabled or both are disabled.
- If you use global configurations, ensure that you are using a global configuration that has
contributions from both projects.
- The target project contains the same artifact types, artifact attributes, and attribute data
types as the artifacts in the source project.
Important: To copy artifacts, the target
project must contain the same artifact types as the source artifacts that are being copied,
including URIs or artifact names. Otherwise, no artifacts are copied. If the target project does not
contain the same artifact attributes or attribute data types, the source artifacts are copied, but
the attribute values are not.
In projects that are enabled for configuration management, confirm whether you want to copy
artifacts between components or clone them. To help you decide, see Cloning artifacts between components.
About this task
You can copy most artifacts between projects, including collections, modules, embedded artifacts,
and diagrams. However, the copy function does
not support copying the following items:
- Graphical artifacts that require a browser plug-in, such as sketches, storyboards, screen flows,
and business and use case diagrams
- Tags
- Comments
Procedure
-
Verify that the target project contains the same artifact types, artifact attributes, and
attribute data types as the artifacts that you plan to copy. To view the project properties,
complete these steps:
-
Open the target project, click the drop-down menu for the Administration icon
and select Manage Project Properties.
Note: If configuration management is enabled for your project, on the
Administration menu, click Manage Component
Properties.
-
Click the Artifact Types tab, the Artifact
Attributes tab, and the Attribute Data Types tab.
Tip: If your target project does not contain the necessary project properties, you can
import the artifact type system from the source project. For information about importing the type
system from another project, see
Importing project
properties.
Important: To copy artifacts between projects, the value in the
URI field for artifact types or the artifact names in both the source and
target projects must match. The URI value or name must also match between source and target artifact
attributes and between artifact data types.
The value in the URI fields
must be in this format:
https://hostname/word1/word2
For example, if
you work for a company called Big-Bank, and you want to copy artifacts of type
Actor
from a source project, you might put the following value in the Actor
artifact type
URI
field:
https://www.big-bank.com/types/actor
If you copy the type system from
the source project to the target project, you ensure that the value in the source
URI field gets propagated to the target
URI field in
the target project.
-
In the target project, right-click the folder into which to copy the artifacts and click
Copy from a project.
-
In the wizard that opens, follow the prompts to select the project, and the artifacts or
modules to copy. When you select modules, all the views from those modules will be copied from the
source to the target.
Tip: You can also view the collections that need to be copied or cloned to the target
project by clicking the Add Collection button.
-
If the servers are hosted by the same domain server or different domain servers, you can also
use the Paste as Link option between components on different servers.
-
Copy the source artifact.
-
Select the target artifact and click Paste as Link
.
-
In the Create Link window, select the link type.
-
Click OK and a Link has been created message will
be displayed.