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

How to create cross-references to figures, titles, tables in DOORS next artifacts that work in MS Word?

Hi,

I'd like to have a way to create the same thing I get in Word by adding a cross reference to a figure (or a title or table).

I want to be able to write something like "see figure 3-1 for more details" where the "figure 3-1" is updated correctly if another image is added before this.
How do I do this in Word?
* add figure
* add a caption to that figure
* move to the spot where i need the reference, click cross-reference, select image, done.

How can I do this in ELO Publishing / DOORS next?
I imagine that I should be able to use a placeholder in the DOORS next artifact (e.g. "see {refToFigure 1234567} for more details"), and then somehow check in ELO Publishing whether this placeholder is part of the ext of an artifact. If it is not then I just print the content as Text. If it is there I could split the text, put the first part as text, add a field to use for the reference, put the third part as another text.

How can I do this properly? I guess this has been done millions of times already... I just can't find an example for this.

I'd be happy for any ideas.
Thanks!


1

0 votes



3 answers

Permanent link
As you hinted above, you need to come up with some sort of convention for annotating text with a cross reference, and then you can insert field codes in ELO Publishing document templates.



0 votes

Comments

Hi Davyd, thanks for your answer.

I saw that post already but as far as I understand it does not talk about referencing the image/caption somewhere else.
I guess I need to use bookmarks in a certain way but have no idea how  :/


Permanent link

Cross-references in DOORS Next are a bit different from Word because they rely more on artifact linking rather than automatic numbering. One practical approach is to maintain consistent artifact IDs or use link types that can later be formatted correctly in the publishing template.

0 votes


Permanent link
As you hinted above, you need to come up with some sort of convention for annotating text with a cross reference, and then you can insert field codes in ELO Publishing document templates.

This blog will give you a good starting point to go off: 
Hi, I have accessed the article and found it unclear about the reference issue, can you please review it?

-1 votes

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
× 2

Question asked: Sep 03 '25, 4:05 a.m.

Question was seen: 527 times

Last updated: Sep 05 '25, 5:27 a.m.

Confirmation Cancel Confirm