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: Door import from MS Word
Topic Summary:
Created On: 5-Feb-2003 10:54
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.
 5-Feb-2003 10:54
User is offline View Users Profile Print this message


Brendon Shaw

Posts: 1
Joined: 5-Feb-2003


I am a new Doors user and been dropped into a project requiring Door's and the need to convert a large number of Word documents into Doors. Ideally want I need is an automatic Doors importing tools, allowing all the files in a single directory to be imported. I have been looking at .DXL language and found information relating to .rtf format importing, but nothing relating to importing Word files.

Can any one point me in the right direction for any suitable Word importing .DXL scripts? Also the import tool within Word allowing importing documents into Doors, is that a .DXL script/program?
Report this to a Moderator Report this to a Moderator
 5-Feb-2003 16:13
User is offline View Users Profile Print this message


Michael Sutherland

Posts: 248
Joined: 13-Sep-2002

The method of importing from Word provided by DOORS is the "Export to DOORS" Word Macro. You can find a copy of the macro in the Word template file located in $DOORSHOME/lib/word/doors.dot

Unfortunately for your needs, the Word Macro is password protected by Telelogic, so it cannot be modified unless the password is known. It will only import one Word document at a time.

-------------------------
Michael Sutherland
michael@galactic-solutions.com
http://galactic-solutions.com
Report this to a Moderator Report this to a Moderator
 6-Feb-2003 22:48
User is offline View Users Profile Print this message


Paul Miller

Posts: 376
Joined: 2-Oct-2002

Hi Brendon,

Having exported from MSWord to DOORS many many times, I feel compelled to pass on some tips - this can be a very difficult excercise, hopefully I can save you some time.

Firstly - I havn't known of any document authored in MSWord that hasn't required some pre-formatting prior to export into DOORS.

Make sure that front matter pages with corporate logos, title blocks, tables of contents etc are all blown away, these are not required within DOORS and not export very well NOTE: all headers and footers will be ignored in the export.

Make sure that all Headings are indeed using the correct MSWord heading style level and these styles have been defined with the correct outline levels - DOORS is very sensitive to the outline hierarchy of the MSWord document - I find that some authors fiddle with the default definition settings for heading levels and this will screw up the export.

Make sure that all text paragraph styles being used have been defined with the outline level set to "Body Text".

Bullet lists - boy, do I have fun with bullet lists - MSWord bullets are virtual symbols - if you're using an alphanumeric bullet list such as 1), 2) a.) b.) etc, these will not be exported - they need to be converted to hard text so that they will export across to DOORS.

Make sure that all embedded OLE graphics are not floating - they need to be inseretd in place within a paragraph.

MS Word Tables - beware of tables that look like a piece of art work that should be hung in a gallery! DOORS will do the best it can to replicate such tables but it will often look awful. Nice, simple and small tables export like a dream, but anything complex that uses effects such as rotated text, merged cells, vertical & horizontal alignment effects, small fonts to cram text into a cell etc will not look anything like the original article once exported to DOORS - tell your authors to keep tables simple - I find they rarely need to be "works of art. - alternatively, insert a word picture object into the document and then cut-n- paste the table into the word picture object - the table will now be exported as a MSWord Picture OLE - not all MSWord tables need to be presented as DOORS tables.

Look - I can go on and on here - if you would like to know more, please get in touch with me - my contact details are shown below.

------------------------------------------
Paul Miller
Contractor - EuroCyber,
Tenix Specification Practices Project,
Nelson House, Williamstown,
Victoria, Australia, 3016.
Desk Phone: +61 (0)3 9244 4078
Mobile: +61 (0)418 135 103
E-mail: paul.miller@tenix.com
------------------------------------------


If there are any footnotes, the footnote text will end up being embedded adjacent to where the footnote reference bookmark is located - can look ugly or is not picked up until someone tries to read the para.



-------------------------
Paul Miller
Specification Practices Specialist,
EuroCyber,
Melbourne, Australia.
Mobile: +61 (0)418 135 103
Web Site: http://www.eurocyber.biz
E-mail: miller@eurocyber.biz">pmiller@eurocyber.biz
Report this to a Moderator Report this to a Moderator
 6-Feb-2003 23:49
User is offline View Users Profile Print this message


Louie Landale

Posts: 2070
Joined: 12-Sep-2002

Give it up.

In my experience, I have found only a SINGLE ms-word file suitable for importing into DOORS. All others require a significant amount of massaging BEFORE you import. Otherwise, you'll have a royal mess to clean up in DOORS.

[1] DOORS headings map to those MS-Word paragraphs that appear in the MS-Word "Document Map" (left pane, when activated); they do NOT map to MS-Word "Heading" styles. Although, of course, MS-Word headings appear in the Document map. View the Map. Click on unwanted paragraphs, and adjust their "Outline Level" to "body text" on the Paragraph's properties sheet.

[2] Each MS-Word Paragraph is mapped to a separate DOORS object. You will often want to convert MS-Word paragraphs (the Enter key) with MS-Word Line-Breaks (shift-enter). These are converted to DOORS CRs AFTER inserting into the objects. View all characters in MS-Word.

When you do import (..err.. "export" from MS-Word), be sure DOORS is open to the correct folder. Pick a suitable module name.

- Louie
Report this to a Moderator Report this to a Moderator
 7-Feb-2003 01:16
User is offline View Users Profile Print this message


Michael Sutherland

Posts: 248
Joined: 13-Sep-2002

I just discovered that the existing "Export to DOORS" word macro can be run without the interface, so it could be run multiple times from the same calling function. The downside is I'm not yet sure if there is a way to pass it the parameters that you normally enter from the "Export to DOORS" dialog box.

Running it this way will Export a document to a Module called "No Title Supplied". Additional Exports would append to this Module.

Are there any VB experts out there than can help determine how to pass parameters to the function?

-------------------------
Michael Sutherland
michael@galactic-solutions.com
http://galactic-solutions.com
Report this to a Moderator Report this to a Moderator
Statistics
20925 users are registered to the Telelogic DOORS forum.
There are currently 1 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 1 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.