Jazz Forum Welcome to the Jazz Community Forum Connect and collaborate with IBM Engineering experts and users

Instances in which one would insert an Artifact within an Artifact?

Good day,


I am playing with certain features that we typically would not have used before.  I ran across this idea of inserting an artifact within another artifact.

The only reason why I could think this would be useful is the following:
  • You insert Artifact B into Artifact A.
  • You open Artifact B in another tab.
  • You copy some portion of Artifact B into Artifact A.
  • You finish and remove Artifact B from Artifact A.
Is there some other reason that inserting an Artifact within an Artifact is useful?  

Thanks again!

Mary 

0 votes


Accepted answer

Permanent link
Here are a few reason I have done it in the past:
 - inserting a diagram into a paragraph of text, where the diagram is drawn in DNG and its parts are also linked to other artefacts

 - inserting quotes from other documents where you only want to maintain one source

 - inserting lists of reference documents, in particular standards. You leave them collapsed so you just see titles but then you have a link to the source in your reference list

 - going the other way and manually marking up content to turn it into inserted artefacts. This is especially useful in two situations a) meeting or workshop notes, where you want to preserve the note as written but then dissect it into artefacts and b) tables, where it's useful for contents of the table to be traced as individual artefacts
Mary Miller selected this answer as the correct answer

1 vote

Comments
Okay, thank you!  This is helpful!


One other answer

Permanent link
Or where you insert a table into an artifact and then want the table values to be identifiable artifacts in their own right for traceability reasons.

There are, however, problems
  • the behaviour of holding the mouse over the inserted attributed causes a small tool set to be shown which can obscure the value in the table cell
  • visibility of the traceability in reports / views [the relationship of the artifact to the inserted one needs to be known]

0 votes

Comments
Two comments:
 - then don't hover your mouse over it :-)
 - inserting an artefact into another does not create any sort of link by default. You can select to do so if you want but I never do - I always add links manually if it's appropriate. In particular for table contents I use parent/child links to a top level artefact to indicate decomposition. Most often the top level artefact is the container for the table itself as long as it has a name or text that makes sense in list views

It is very difficult to edit something without hovering over the value at some point.

Inserting an artefact into another must create a relationship between the parent and the child element (in just the same way that there is a relationship between a module and an artefact). It might not be an explicit traceability link created by the user but the relationship must be exploitable so that analysis can be done.

The trouble is that there is no explicit model declared against which queries can be planned - it seems to rely on prior knowledge, empirical discovery or the like.

Your answer

Register or log in to post your answer.

Dashboards and work items are no longer publicly available, so some links may be invalid. We now provide similar information through other means. Learn more here.

Search context
Follow this question

By Email: 

Once you sign in you will be able to subscribe for any updates here.

By RSS:

Answers
Answers and Comments
Question details
× 12,014

Question asked: Nov 14 '19, 11:59 a.m.

Question was seen: 1,116 times

Last updated: Nov 20 '19, 2:27 a.m.

Confirmation Cancel Confirm