eaDocX Quick Document Video guides

To start...

1. Select the EA package, element, diagram, RTF Model document or RTF Master document you want to print,
2. Right click and choose Specialize | eaDocX | Quick Document.

This will generate a new Word document containing the package, element or diagram you selected.

What did eaDocX just create?

• MS Word has opened your document in a window inside EA.
• The document is based on your Word ‘Normal.dot’
• eaDocX has added some document information …
• … then the main content of the document
• The base of the document is the package and its ‘notes’
• It has included any diagrams it found (the Word diagram name comes from the EA diagram name) and notes from the diagram notes
• Then the children of the Package. In this case, first the Epic and notes
• Then children of the children – the User Story
• EA connectors have been made into Word hyperlinks – making the document more interactive
• And the Internal Requirements of the User Story are also listed.

eaDocX reads the EA model and creates the Quick document based on what it finds.

Each Use Case is formatted the same way – even if there is no data

• Remove the “(none)” output – it makes the document look messy – by using the eaDocX “Compact Document” option to clean up where there are blanks.
• Regenerate to see the difference – much neater

Next let’s look at the Quick Document defaults…

• Quick Document prints: (connector type):(target element type):(target element)…
• …which always works, but doesn’t read very well.
• Change this by editing the Profile. Profiles control how each element type is printed.
• In the Use Case Profile you can edit the captions to make them better for your readers
• You can also remove the Stereotype prefix in the Use Case heading
• Save your changes and regenerate to see the difference – Simpler and clearer.

• Run Quick document with the default settings – see what we get.
• We can see all the elements, some of the relationships…
• The Quick document default is to only show relationships in one direction. In this example, FROM the TestCase TO the requirement
• Maybe we also want to show the link in the other direction, FROM the requirement TO the TestCase
• There are also some important Tagged Values which are not in the document. Let’s get eaDocX Quick Document to find and print them as well.

Change the Quick Document defaults, and generate a new document

• In the EA Project Browser, Right click for Specialize > eaDocX > Settings > Application Settings
• This is where you can change the defaults – to make the document simple or to show more detail.
• Change “Show Reverse Relationships” to True
• Change “Show all Tagged Values” to True
• Create a New Quick Document and see the differences…
• …lots more connectors!
• …and the Tagged Values are being printed.

Use “Compact Document” to remove the (none) entries ( in Tools > Options and Settings menu) and regenerate.

• Now check the Forward and Backward links
• And the Tagged Values
• All done!