Operation
|
Procedure
|
||
To add a live source link to an item (GUI only)
|
Live source links display the member or project at the time the link is clicked by a user. Live source links are denoted by :live in the Revision column of the source link field.
Do one of the following:
• Drag the member (source file) from a Sandbox or Project view, that does not have a top-level build project, to a source link field in the Item Edit view.
Your ViewSet must contain both an Item Edit view and a Sandbox or Project view (mainline or variant) to add a source link using this method of drag and drop.
• Drag a top-level project (that is not a build project) from the Project view to a source link field in the Item Edit view.
Your ViewSet must contain both an Item Edit view and a Project view.
|
||
To add a source link to an item (not a live source link, GUI only)
|
Do one of the following:
• Drag the member (source file) from a Sandbox or Project view, that has a top-level build project, to a source link field in the Item Edit view.
Your ViewSet must contain both an Item Edit view and a Sandbox or Project view (mainline, variant, or build) to add a source link using this method of drag and drop.
• Drag the desired revision from a Member History view to a source link field in the Item Edit view.
Your ViewSet must contain both an Item Edit view and a Member History view to add a source link using this method of drag and drop.
• Drag a build project from the Build Project view to a source link field in the Item Edit view.
Your ViewSet must contain both an Item Edit view and a Build Project view.
• Drag a build project from the Build Sandbox view to a source link field in the Item Edit view.
Your ViewSet must contain both an Item Edit view and a Build Sandbox view.
• Drag a project revision from the Project History view to a source link field in the Item Edit view.
Your ViewSet must contain both an Item Edit view and a Project History view to add a source link using this method of drag and drop.
• Drag a build subproject from any Project (or Sandbox) view to a source link field in the Item Edit view.
Your ViewSet must contain both an Item Edit view and the relevant Project or Sandbox view.
|
||
To view source links for an item
|
Display the Items view, Item Edit or Item Details view, Relationship view, or Document view (GUI only).
|
||
To follow a source link for an item
|
Display the Items view, Item Edit or Item Details view, Relationship view, or Document view (GUI only); then do one of the following:
• Double click the link. If it is a member link, the link opens the Member History view. If it a project or subproject, the link opens the Build Project view.
• Right click the link and then select View Member History or View Project.
|
||
To delete a source link from an item (GUI only)
|
In the Item Edit view, select a source link and click beside the source link field. CLI equivalent: im editissue. |
||
To add a source trace to an item (GUI only)
|
Drag the member (source file) from a Sandbox or Project view to a source link field in the Item Edit view.
Your ViewSet must contain both an Item Edit view and a Sandbox or Project view (mainline, variant, or build) to add a source trace using drag and drop.
|
||
To delete a source trace from an item (GUI only)
|
In the Item Edit view, select a source trace and click beside the source link field. CLI equivalent: im editissue. |
||
To view source traces for an item
|
Display the Items view, Item Edit or Item Details view, Relationship view, or Document view (GUI only).
|
||
To move a source link or source trace from one field to another
|
In the Item Edit view, drag the value of a source link field to another source link field on the same item (or on a different item if that item is also displayed in a separate Item Edit view).
Note the following:
• Dragging a source link to a source link field with trace enabled converts the value to a source trace.
• Dragging a source trace to a source link field that does not have trace enabled converts the value to a source link.
• A source link to a project (or subproject) cannot be moved to a source link field with trace enabled.
|
||
To copy a source link or source trace from one field to another
|
In the Item Edit view, press CTRL and drag the value of a source link field to another source link field on the same item (or on a different item if that item is also displayed in a separate Item Edit view).
Note the following:
• Pressing CTRL while dragging a source link to a source link field with trace enabled converts the copied value to a source trace.
• Pressing CTRL while dragging a source trace to a source link field that does not have trace enabled converts the copied value to a source link.
• A source link to a project (or subproject) cannot be copied to a source link field with trace enabled.
|
||
To update the member revision on a source trace
|
Delete the existing source trace and add a new source trace to the current revision.
|
||
To display the Source Trace Viewer from an item (GUI only)
|
Do one of the following in the Item Edit or Item Details view:
• If the source link field is in table format, select the source trace and select > > .
• If the source link field is in comma separated values format, click on the source trace.
CLI equivalent: im viewsourcetraces
• If the source link field is in table format, double click on the source trace.
• If the source link field is in table format, right click the source trace and select Source Trace Viewer.
|
||
To display the Source Trace Viewer from a member (GUI only)
|
Select a member or revision in one of the following views:
• Sandbox view
• Project view
• Member History view
Select
> > .
|
||
To view the contents of a traced member revision (GUI only)
|
From the Source Trace Viewer, select
> > . The contents of the traced member revision displays in an editor.
|
||
To view project information for a traced member revision (GUI only)
|
From the Source Trace Viewer, select the
> .To locate the specific member within the project, use the Members With Name filter.
|