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

How to Turn on Heading Numbers

 I can get heading numbers to display if I export the module to a spreadsheet, turn on isHeading where I need it, then re-import into the same module.  But, is there an easier way?  There does not seem to be an isheading attribute that I can add to get it to display in the column listing of a module.  Nor do I see anything in the display of artifacts in a module related to level numbers or isHeading.  Having to export then import seems hokey.

1

0 votes


Accepted answer

Permanent link

 Just thinking out loud, but in DOORS, all objects were part of a full time hierarchy, and if the object had a value in the heading attribute, then DOORS will automatically add the "heading number" (actually level) to the display.

In DNG, modules give a collection of Artifacts a "sense" of hierarchy, but it is forced on them in terms of parentId, order to display, and a single designator of Heading row or text row.  If isHeading is set, then DNG will apply some display of heading numbers, based on the other items mentioned to get it's level and position.  In other words, a backfill for us Classic users.  
The two architectures are contrary to each other, but you "can" represent a collection of objects in DOORS, and you "can" represent a document hierarchy in DNG.  Neither is intuitive or natural for the application.  Having said that, DNG is getting better (more transparent} at emulating Classic user expectations.  I look forward to 7.0.1
I am surprised if all you have to do is set isHeading in your export round trip, without worrying about parentId to get level info.

Scott Ankrum selected this answer as the correct answer

0 votes

Comments

Appologies.  Insufficient experimentation on my part. I see that creating new artifacts within a new module yields level numbers.I have found multiple ways of getting requirements loaded in a hierarchy, and I can always get level numbers on the Contents of the artifact. 

My experimentation continues.  Sometimes I get level numbers when creating a new module, and sometimes I don't.  It might be based on the Project template.  Unless somebody knows definitely why this is so, I am not going to pursue the question.  If I get level numbers in the Contents when creating a module, great.  If I don't, I will export then import with isHeading where needed.

[F]orced on them in terms of parentId, order to display, and a single designator of Heading row or text row.  If isHeading is set, then DNG will apply some display of heading numbers, based on the other items mentioned to get it's level and position.  In other words, a backfill for us Classic users.  

What do you mean by "backfill"? I dont know this word and all I found on the web about it doesnt make sense for me in the context you use it.

How are things you described here different form what DOORS 9.6 does? 
Isn't it almost the same approach there?

"My experimentation continues.  Sometimes I get level numbers when creating a new module, and sometimes I don't. .........."

Scott, a thought here.  If you are importing from Word documents, it is likely that some of your documents have headings set up correctly and some do not.  I have seen hundreds of specs where the headings were nothing more than Normal style text, with the numbering and styling applied to them by the author.  DNG and DOORS for that matter, would not know those were supposed to be headings, and consequently makes them normal text rows.  Hope this sheds some light.


2 other answers

Permanent link

 I read through your question and Cliffs answer several times, but I dont get what exactly you try to achieve and how Cliffs answer solves your question.


If you wonder how you can define an artifact in a module in IBM Jazz RM 6.0.3 (and some earlier versions) as heading (so that it is taken into account into the calculation of heading and section numbers):

  1. Perform a right click on the artifact you want to set as heading (or if it already is a heading, make it a normal artifact again) and select "Set as Heading or Content" and then "More Options".
    Select "More Options".

  2. In the bottom section of the dialog which opens, you can select the artifact to be a heading or a text artifact:
    Select the artifact type.
Cliff already mentioned this in his answer:
 [A] single designator of Heading row or text row.

0 votes


Permanent link
 For Phillip:
My original question concerned importing from a MS Word document.  Your screen image is more than a little confusing.  It looks like you are setting level numbers to each artifact one at a time.  I'll have to study that screen image to see exactly what you are doing.

0 votes

Comments

Yes, that's exactly what I'm doing here.

if you only consider your questions title, the text you provided to describe it and the tags you used, one can think that you only want to define whether an artifact should be a heading or not.

I also dont see any reference to a MS Word document in your question.
But thank you for the explanation, this makes it more clear for me.

Checked my work again.  I see that the actions Phillip suggest is changing the artifact type.  That is not what I am trying to do.  I just want level numbers to appear without changing the artifact type.  I have found two ways to do that. Both require an import.
1) in a MS Word document, set every entry to some heading level, then import.
OR
2) in a spread sheet, set parentBinding in each child to to point to its parent ID, and set isHeading on every entry, then import

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: Feb 27 '17, 3:23 p.m.

Question was seen: 6,284 times

Last updated: Mar 24 '17, 1:08 p.m.

Confirmation Cancel Confirm