Editing rich-text artifacts

Essentials of IBM® Rational® DOORS Next Generation V4.01
Editing rich-text artifacts 1© Copyright IBM Corporation 2013
Course materials may not be reproduced in whole or in part without the prior written permission of IBM.
© Copyright IBM Corporation 2013
Editing rich-text artifacts
Contents
Module overview -2
Editing artifacts in the Artifact editor -3
Working with an artifact in the Artifact editor -5
Embedding artifact -7
Glossaries -8
Extracting artifacts -9
Lab: Creating requirements artifacts -10
Review -11
Module summary -12

2 © Copyright IBM Corporation 2013
Module overview
After you complete this module, you should be able to
do these tasks:
 Edit a rich-text artifact
 Create requirements from a text artifact

Editing artifacts in the artifact editor
Open an artifact to view and edit its content,
attributes, and links.
Click Edit to open the artifact
editor.
After you open the artifact is open, click Edit
to open the editor.
In this example, a simple business goal is
depicted in a text artifact

The artifact editor for a text artifact
Tags
Editing toolbar
Content Sidebar
Artifact summary
The breadcrumb shows the location of the
artifact and aids navigation.
When you edit a text artifact, you edit the
attributes of the artifact and its content.
In this example, the elaboration of a story is
shown in a text artifact.

Editing a text artifact in the artifact editor
Type content here. Use the
formatting and content tools on
the menu bar.
When you are finished, click Save to
save the artifact or Done to save the
artifact and close the artifact editor.
Set attributes for the
artifact.
When you created the artifact, if you
selected the check box to
automatically open the artifact after it
is created , the new artifact opens in
the artifact editor. The content area is
a rich-text editor.
When you embed an artifact within
an artifact, the artifact is updated if
any change is made to its embedded
artifacts. The audit history of this
change is captured in the history of
the embedded artifact, not in the
history of the container artifact.

Embedding artifacts
You can embed an artifact in another artifact. If a
change is made to the embedded artifact, the
container artifact is automatically updated.
Double-click the embedded
artifact to go to it.
If any embedded artifacts are updated, the
containing artifact is automatically updated.
The changes to an embedded artifact are
captured in the history of the embedded
artifact, not in the history of the container
artifact.

Example of an embedded artifact
Artifact 322 is
Embedded in artifact 189
Artifact 189 Embeds artifact 322
This example represents a “Story”
that has been elaborated in an artifact
that is of the Text format.
This artifact contains rich text,
numbered lists, hyperlinks, embedded
artifacts, and references to glossary
terms.

Glossaries
Lookup, use, or create
a glossary term
While in edit mode of a rich text
artifact, you can look up a glossary
term. If it exists, you can hyperlink
to it. If it does not exist, you can
create one and hyperlink to it.

Extracting artifacts
You can extract new requirements from
requirements artifacts.
In the artifact editor, select and
right-click the content to capture
as a new requirement.
1
From the menu, select to link to
or insert the new artifact. The
new artifact will be the same type
as the current requirement.
2
You can extract new requirements artifacts
from an artifact. You can link the current
artifact to the new artifact, or you can embed
the new artifact in the current artifact.
For example, you might want to extract and
link requirements when you are transforming
meeting notes into managed requirements.
If you right-click an artifact and select the
menu item to create an artifact , the new
artifact has the artifact type of the current
artifact. In the example on this slide, the
current artifact is a feature artifact. Therefore,
if you right-click that artifact to create
another artifact, the new artifact will be a
feature artifact.
To create an artifact of a different type,
extract the artifact by clicking the Save
Selection as New Artifact and Link or Save
Selection as New Artifact and Insert icons
on the toolbar. When you click either of those
icons, a window opens that prompts you to
select information about the artifact,
including its type and location.

Lab: Creating requirement artifacts
After you complete this lab, you
should be able to do these tasks:
 Create requirements artifacts at the
project level
 Import a rich text file as a single
artifact
 Extract requirements from artifacts

Review
What are some reasons for using rich text artifacts?
Which of these statements are true about artifacts of text format:
[T/F] Text artifacts can be linked to other artifacts.
[T/F] The content of a text artifact can have hyperlinks to other artifacts
[T/F] New artifacts can be extracted form text in the original artifact
[T/F] Changes to an embedded artifact will reflect in the artifact that
embeds it.
[T/F] Changes to a hyperlinked artifact will reflect in the hyperlinked
text.
[T/F] Views can be created in the text artifact based on artifact
attributes
[T/F] Embedded artifacts can be edited directly within the Text artifact.
[T/F] Rich hover provides details about the embedded artifacts

Module summary
In this module, you learned how to create requirements
artifacts in these ways:
 By the Create Artifact wizard
 By using the one-click create function

Editing rich-text artifacts

More Related Content

What's hot (19)

Viewers also liked (17)

Similar to Editing rich-text artifacts (7)

More from IBM Rational software (20)

Recently uploaded (20)

Editing rich-text artifacts