Welcome to Telelogic Product Support
  Home Downloads Knowledgebase Case Tracking Licensing Help Telelogic Passport
Telelogic DOORS (steve huntington)
Decrease font size
Increase font size
Topic Title: Requirements imported to DOORS
Topic Summary: Maximum number of requirements imported to DOORS
Created On: 27-Mar-2007 07:52
Status: Post and Reply
Linear : Threading : Single : Branch
Search Topic Search Topic
Topic Tools Topic Tools
Quick Reply Quick Reply
Subscribe to this topic Subscribe to this topic
E-mail this topic to someone. E-mail this topic
Bookmark this topic Bookmark this topic
View similar topics View similar topics
View topic in raw text format. Print this topic.
 27-Mar-2007 07:52
User is offline View Users Profile Print this message


Joycelyn Rodrigo

Posts: 7
Joined: 29-Jan-2007

Hi, Is there a maximum number of requirements that can be exported from a Word document into DOORS?  We are planning to export some requirements documents from Word into DOORS, and  some of the documents have too much information. Thanks.
Report this to a Moderator Report this to a Moderator
 27-Mar-2007 08:36
User is offline View Users Profile Print this message


Tony Goodman

Posts: 1098
Joined: 12-Sep-2002

There is no limit on the amount of information that can be imported into doors.
However, import from word is slow and can fail if the importer encounters some URLs or large tables.
You may find that very large documents will need splitting up before import, so you can import them in reasonable sized chunks.

I would also recommend doing a little pre-processing on your word documets before you start. By this I mean remove anything you don't need such as table of contents. Also make sure that the word document has a good hierarchical structure - DOORS recognises the standard heading styles and uses these to construct the module hierarchy.

-------------------------
Tony Goodman
http://www.smartdxl.com
Report this to a Moderator Report this to a Moderator
 27-Mar-2007 08:39
User is offline View Users Profile Print this message


Robert Swan

Posts: 86
Joined: 14-Apr-2005

I've had no problem with the number of requirements. Large documents just take longer and more resources.

Although it is a good idea to do some trimming before hand to remove cover pages, company logo jpegs, tables of contents etc. All can be imported and edited in DOORS, it's just easier to do those things in a word processor first.

Tables are a pain to control in DOORS so should be reviewed to decide if they would be better held as images.

Sometimes images, especially pictures, cause problems and may be better inserted by cut and paste rather than import. I've had imports freeze when dealing with large jpeg images.

If you're really worried split the document and import each section in turn.
Report this to a Moderator Report this to a Moderator
 27-Mar-2007 08:41
User is offline View Users Profile Print this message


Robert Swan

Posts: 86
Joined: 14-Apr-2005

Nice to know my experiences and practices align with the experts.
Report this to a Moderator Report this to a Moderator
 27-Mar-2007 11:12
User is offline View Users Profile Print this message


Hazel Woodcock

Posts: 78
Joined: 6-May-2005

You might also want to consider the size of DOORS module that you will be working with. While the tool imposes no practical limit, you will find some 'ease of use' issues. In the same way that a very large Word document is awkward, so is a very large DOORS module.
I would aim for somewhere between 10 and 100 pages of printed document per DOORS module. Any less than that and you have too many modules to open to get to a reasonable amount of information and any more than that and you have trouble finding the right place in a module.
Obviously this all depends on your data structure and there are no hard rules here. It is easier to find what you want in a DOORS module than in a Word document because you can filter and use database functionality to display the data you are interested in.
The other consideration is time taken to open a DOORS module; if it is 'too large' it will take a 'long time' to open. The definition of too large is a tough one and dependent on your network and your client machine as well as the actual content of the module.

Does anyone else have a better rule of thumb for 'useable' module sizes?

Hazel
Report this to a Moderator Report this to a Moderator
 18-Apr-2007 17:14
User is offline View Users Profile Print this message


Alexander Almoian

Posts: 10
Joined: 13-Feb-2007

quote:

Originally posted by: Tony Goodman
 Also make sure that the word document has a good hierarchical structure - DOORS recognises the standard heading styles and uses these to construct the module hierarchy.


I do not believe this is true.  DOORS uses the 'Outline level' to create the hierarchy.  In a 'good' Word document these are in correpondence e.g., style Heading 3 will have Outline level = Level 3 AND Level 3 will be associated only with Heading 3. 
I have encountered a customer Word document where this was not true and caused erroneous hierarchy in DOORS.

Report this to a Moderator Report this to a Moderator
 18-Apr-2007 21:39
User is offline View Users Profile Print this message


Louie Landale

Posts: 2070
Joined: 12-Sep-2002

Yes, its the 'Outline Level' that is recognized by DOORS to distinquish Headings from Text, and also to determine the level of the Headings.

Fortunately, the MS-Word 'Document Map' aligns itself with 'Outline Level'. Thus, before import you shoudl view the Word Document Map and make sure everthing in there are the headings you like. You can click on something that's not supposed to be a heading, format properties and changes the Outline Level to Body Text. Then select the next paragraph that's not supposed to be there and cntl-Y to repeat the formatting.

I've noticed that Captions tend to have an Outline Level. I've also seen documents where just about everything does.

When done, the Document Map should look pretty sniffy ..err.. spiffy.

The only real problem comes when you goof in the hierarchy in Word, e.g. putting a Heading 4 paragraph under a Heading 2; skipping 3. I think DOORS will force it to level 3 which will probably mess up other parts of the document.

- Louie
Report this to a Moderator Report this to a Moderator
 19-Apr-2007 10:33
User is offline View Users Profile Print this message


Hazel Woodcock

Posts: 78
Joined: 6-May-2005

quote:

Originally posted by: Louie Landale
The only real problem comes when you goof in the hierarchy in Word, e.g. putting a Heading 4 paragraph under a Heading 2; skipping 3. I think DOORS will force it to level 3 which will probably mess up other parts of the document.

- Louie


DOORS will insert an empty level 3 object if you put a H4 directly after a H2, it will not mess about with the levels of things you are importing, but it will force a structrue around that to allow it to exist.

Options for viewing in Word are many; as an alternative to Louie's sugggestion you could use the Outline View which allows you to see the structure of the document and adjust it relatively easily, or you could use the normal view and show the style area (Tools>Options), this displays the name of the style in a column down the left hand side.

You could also consider saving as an RTF and importing that way.

So many options to choose from :-)

Hazel
Report this to a Moderator Report this to a Moderator
 19-Apr-2007 20:04
User is offline View Users Profile Print this message


Louie Landale

Posts: 2070
Joined: 12-Sep-2002

Bingo!! That's what we ended up doing, converting the doc to RTF and then pulling it into a newly opened empty DOORS module. I had a about 8 pages of how-to-prepare-Word-for-DOORS and it got hoplessly out of hand; converting to RTF gracefull dealt with all those odd-ball Word options that DOORS didn't like.
Report this to a Moderator Report this to a Moderator
 19-Apr-2007 20:04
User is offline View Users Profile Print this message


Louie Landale

Posts: 2070
Joined: 12-Sep-2002

Bingo!! That's what we ended up doing, converting the doc to RTF and then pulling it into a newly opened empty DOORS module. I had a about 8 pages of how-to-prepare-Word-for-DOORS and it got hoplessly out of hand; converting to RTF gracefull dealt with all those odd-ball Word options that DOORS didn't like.
Report this to a Moderator Report this to a Moderator
 20-Apr-2007 19:10
User is offline View Users Profile Print this message


Jacqueline Schertz

Posts: 8
Joined: 8-Nov-2006

quote:

Originally posted by: Robert Swan
Tables are a pain to control in DOORS so should be reviewed to decide if they would be better held as images.


If you do have tables, you should probably paste them in as OLE objects. Basically, copy the table from your document in Word and Paste Special in your DOORS module. When you Paste Special in DOORS, be sure to select Microsoft Word Document... Pasting it in this way will give you a table that should appear the same as it does in your Word document AND it will be editable when you double-click in the table in DOORS.

If the following error message appears upon pasting:
          UNABLE TO OBTAIN OLE INTERFACE!


Then you need to save and close the module, and close DOORS. When you reopen DOORS, you should be able to create an OLE object in that module.

Just thought I'd share a tip about tables... and Word and DOORS.

Of course, this is DOORS 7.1, since we have not been allowed to have our files in DOORS 8.1 yet.



-------------------------
jacqueline.schertz@ge.com
GE Healthcare
System Requirements Specialist

Edited: 20-Apr-2007 at 19:11 by Jacqueline Schertz
Report this to a Moderator Report this to a Moderator
 23-Apr-2007 21:56
User is offline View Users Profile Print this message


Krishna Kandala

Posts: 170
Joined: 8-Jul-2006

"I would aim for somewhere between 10 and 100 pages of printed document per DOORS module. Any less than that and you have too many modules to open to get to a reasonable amount of information and any more than that and you have trouble finding the right place in a module."

We import large Word documents (upto 200 pages) to DOORS . As long as the Word document is well-structured, there is no problem in importing.
Report this to a Moderator Report this to a Moderator
Statistics
20925 users are registered to the Telelogic DOORS forum.
There are currently 0 users logged in.
The most users ever online was 15 on 15-Jan-2009 at 16:36.
There are currently 0 guests browsing this forum, which makes a total of 0 users using this forum.
You have posted 0 messages to this forum. 0 overall.

FuseTalk Standard Edition v3.2 - © 1999-2009 FuseTalk Inc. All rights reserved.