Subversion Repositories DevTools

using System;

using System.Drawing;

using System.Collections;

using System.Text;

using System.ComponentModel;

using System.Windows.Forms;

using Word;

using Microsoft.Office.Core;

namespace EA_DocGen

{

   /// <summary>

   /// Summary description for createWordDoc.

   /// </summary>

   public class createWordDoc : System.Windows.Forms.Form

   {

      // Enterprise Architect Model related data

      private EA.Repository EA_Repository = null;

      private EA.Package EA_ParentPackage = null;

      private EA.Project EA_Project;

      private EA_Utilities EA_Utils = null;

      private TabularContent TableUtils = null;

      private TextualContent TextUtils = null;

      private StyleContent   StyleUtils = null;

      private DocSectionTracking DocSectionTracker = null;

      private bool oneShot_skipRootPackage = false;

      private bool oneShot_skipRootElementHeading = false;

      private int processingLink = 0;

      private ArrayList processedElements = null;

      // This data is designed to support unit test traceability. As such, it is only of real use

      // when making s/w design documents. It allows all non-private classes to be collected into

      // a list in order to generate a design-to-unit-test traceability table.

      private ArrayList classesNeedingUnitTests = null;

      private ArrayList classesWithUnitTests = null;

      private Word.Table utTraceabilityTable = null;

      // MS-Office Word related data

      private Word.Application WordApp = null;

      private Word.Document WordDocument = null;

      private System.Windows.Forms.TextBox textBox_template;

      private System.Windows.Forms.Button button_browse_template;

      private System.Windows.Forms.TextBox textBox_output_file;

      private System.Windows.Forms.Button button_browse_output_file;

      private System.Windows.Forms.Button button_cancel;

      private System.Windows.Forms.Button button_generate;

      private System.Windows.Forms.Button button_view_output;

      private System.Windows.Forms.Label label1;

      private System.Windows.Forms.Label label2;

      private System.Windows.Forms.TextBox textBox_progress;

      private System.Windows.Forms.Label label3;

      private System.Windows.Forms.CheckBox checkBox_WordVisibility;

      /// <summary>

      /// Required designer variable.

      /// </summary>

      private System.ComponentModel.Container components = null;

      public createWordDoc(EA.Repository theRepository, EA.Package theParentPackage, EA_Utilities theEA_Utils)

      {

         //

         // Required for Windows Form Designer support

         //

         InitializeComponent();

         EA_Repository    = theRepository;

         EA_ParentPackage = theParentPackage;

         EA_Project       = EA_Repository.GetProjectInterface();

         EA_Utils         = theEA_Utils;

         DocSectionTracker = new DocSectionTracking();

         TableUtils        = new TabularContent(WordApp, WordDocument, EA_Utils);

         TextUtils         = new TextualContent(WordApp, WordDocument, DocSectionTracker);

         StyleUtils        = new StyleContent(WordApp, WordDocument);

         WordApp = new Word.Application();

      }

      /// <summary>

      /// Clean up any resources being used.

      /// </summary>

      protected override void Dispose( bool disposing )

      {

         if( disposing )

         {

            if(components != null)

            {

               components.Dispose();

            }

         }

         base.Dispose( disposing );

      }

      #region Windows Form Designer generated code

      /// <summary>

      /// Required method for Designer support - do not modify

      /// the contents of this method with the code editor.

      /// </summary>

      private void InitializeComponent()

      {

         this.textBox_template = new System.Windows.Forms.TextBox();

         this.button_browse_template = new System.Windows.Forms.Button();

         this.textBox_output_file = new System.Windows.Forms.TextBox();

         this.button_browse_output_file = new System.Windows.Forms.Button();

         this.button_cancel = new System.Windows.Forms.Button();

         this.button_generate = new System.Windows.Forms.Button();

         this.button_view_output = new System.Windows.Forms.Button();

         this.label1 = new System.Windows.Forms.Label();

         this.label2 = new System.Windows.Forms.Label();

         this.textBox_progress = new System.Windows.Forms.TextBox();

         this.label3 = new System.Windows.Forms.Label();

         this.checkBox_WordVisibility = new System.Windows.Forms.CheckBox();

         this.SuspendLayout();

         // 

         // textBox_template

         // 

         this.textBox_template.Location = new System.Drawing.Point(16, 40);

         this.textBox_template.Name = "textBox_template";

         this.textBox_template.Size = new System.Drawing.Size(592, 22);

         this.textBox_template.TabIndex = 0;

         this.textBox_template.Text = "";

         this.textBox_template.TextChanged += new System.EventHandler(this.textBox_template_TextChanged);

         // 

         // button_browse_template

         // 

         this.button_browse_template.Location = new System.Drawing.Point(616, 40);

         this.button_browse_template.Name = "button_browse_template";

         this.button_browse_template.Size = new System.Drawing.Size(80, 23);

         this.button_browse_template.TabIndex = 1;

         this.button_browse_template.Text = "Browse";

         this.button_browse_template.Click += new System.EventHandler(this.button_browse_template_Click);

         // 

         // textBox_output_file

         // 

         this.textBox_output_file.Location = new System.Drawing.Point(16, 112);

         this.textBox_output_file.Name = "textBox_output_file";

         this.textBox_output_file.Size = new System.Drawing.Size(592, 22);

         this.textBox_output_file.TabIndex = 2;

         this.textBox_output_file.Text = "";

         this.textBox_output_file.TextChanged += new System.EventHandler(this.textBox_output_file_TextChanged);

         // 

         // button_browse_output_file

         // 

         this.button_browse_output_file.Location = new System.Drawing.Point(616, 112);

         this.button_browse_output_file.Name = "button_browse_output_file";

         this.button_browse_output_file.Size = new System.Drawing.Size(80, 24);

         this.button_browse_output_file.TabIndex = 3;

         this.button_browse_output_file.Text = "Browse";

         this.button_browse_output_file.Click += new System.EventHandler(this.button_browse_output_file_Click);

         // 

         // button_cancel

         // 

         this.button_cancel.Location = new System.Drawing.Point(616, 384);

         this.button_cancel.Name = "button_cancel";

         this.button_cancel.Size = new System.Drawing.Size(80, 23);

         this.button_cancel.TabIndex = 4;

         this.button_cancel.Text = "Close";

         this.button_cancel.Click += new System.EventHandler(this.button_cancel_Click);

         // 

         // button_generate

         // 

         this.button_generate.Location = new System.Drawing.Point(496, 384);

         this.button_generate.Name = "button_generate";

         this.button_generate.Size = new System.Drawing.Size(96, 24);

         this.button_generate.TabIndex = 5;

         this.button_generate.Text = "Generate";

         this.button_generate.Click += new System.EventHandler(this.button_generate_Click);

         // 

         // button_view_output

         // 

         this.button_view_output.Enabled = false;

         this.button_view_output.Location = new System.Drawing.Point(376, 384);

         this.button_view_output.Name = "button_view_output";

         this.button_view_output.Size = new System.Drawing.Size(96, 23);

         this.button_view_output.TabIndex = 6;

         this.button_view_output.Text = "View Output";

         this.button_view_output.Click += new System.EventHandler(this.button_view_output_Click);

         // 

         // label1

         // 

         this.label1.Location = new System.Drawing.Point(16, 16);

         this.label1.Name = "label1";

         this.label1.Size = new System.Drawing.Size(224, 23);

         this.label1.TabIndex = 7;

         this.label1.Text = "Input Template or Document Name";

         // 

         // label2

         // 

         this.label2.Location = new System.Drawing.Point(16, 88);

         this.label2.Name = "label2";

         this.label2.Size = new System.Drawing.Size(280, 23);

         this.label2.TabIndex = 8;

         this.label2.Text = "Output Document Name";

         // 

         // textBox_progress

         // 

         this.textBox_progress.Location = new System.Drawing.Point(16, 184);

         this.textBox_progress.Multiline = true;

         this.textBox_progress.Name = "textBox_progress";

         this.textBox_progress.ReadOnly = true;

         this.textBox_progress.ScrollBars = System.Windows.Forms.ScrollBars.Vertical;

         this.textBox_progress.Size = new System.Drawing.Size(680, 168);

         this.textBox_progress.TabIndex = 9;

         this.textBox_progress.Text = "";

         // 

         // label3

         // 

         this.label3.Location = new System.Drawing.Point(16, 152);

         this.label3.Name = "label3";

         this.label3.TabIndex = 10;

         this.label3.Text = "Progress";

         // 

         // checkBox_WordVisibility

         // 

         this.checkBox_WordVisibility.Location = new System.Drawing.Point(16, 384);

         this.checkBox_WordVisibility.Name = "checkBox_WordVisibility";

         this.checkBox_WordVisibility.Size = new System.Drawing.Size(256, 24);

         this.checkBox_WordVisibility.TabIndex = 17;

         this.checkBox_WordVisibility.Text = "Show MS-WORD During Construction";

         // 

         // createWordDoc

         // 

         this.AutoScaleBaseSize = new System.Drawing.Size(6, 15);

         this.ClientSize = new System.Drawing.Size(712, 432);

         this.Controls.Add(this.checkBox_WordVisibility);

         this.Controls.Add(this.label3);

         this.Controls.Add(this.textBox_progress);

         this.Controls.Add(this.textBox_output_file);

         this.Controls.Add(this.textBox_template);

         this.Controls.Add(this.label2);

         this.Controls.Add(this.label1);

         this.Controls.Add(this.button_view_output);

         this.Controls.Add(this.button_generate);

         this.Controls.Add(this.button_cancel);

         this.Controls.Add(this.button_browse_output_file);

         this.Controls.Add(this.button_browse_template);

         this.Name = "createWordDoc";

         this.Text = "createWordDoc";

         this.Closing += new System.ComponentModel.CancelEventHandler(this.createWordDoc_Closing);

         this.ResumeLayout(false);

      }

      #endregion

      #region Message handlers

      private void button_view_output_Click(object sender, System.EventArgs e)

      {

         if (WordApp != null)

         {

            WordApp.Visible = true;

         }

         button_view_output.Enabled = false;

      }

      private void button_generate_Click(object sender, System.EventArgs e)

      {

         if (this.textBox_template.Text.Length > 0)

         {

            if (this.textBox_output_file.Text.Length > 0)

            {

               button_generate.Enabled = false;

               createTheWordDoc();

            }

            else

            {

               MessageBox.Show("Error - must specify an output file");

            }

         }

         else

         {

            MessageBox.Show("Error - must specify an input template file");

         }

      }

      private void button_cancel_Click(object sender, System.EventArgs e)

      {

         this.Close();   

      }

      private void button_browse_template_Click(object sender, System.EventArgs e)

      {

         OpenFileDialog dialog = new OpenFileDialog();

         dialog.Filter = "Word Files (*.doc;*.dot)|*.doc;*.dot|All files(*.*)|*.*";

         dialog.FilterIndex = 1;

         dialog.ShowDialog();

         this.textBox_template.Text = dialog.FileName;

      }

      private void button_browse_output_file_Click(object sender, System.EventArgs e)

      {

         OpenFileDialog dialog = new OpenFileDialog();

         dialog.Filter = "Word Files (*.doc;*.dot)|*.doc;*.dot|All files(*.*)|*.*";

         dialog.FilterIndex = 1;

         dialog.CheckFileExists = false;

         dialog.ShowDialog();

         this.textBox_output_file.Text = dialog.FileName;

      }

      private void textBox_template_TextChanged(object sender, System.EventArgs e)

      {

      }

      private void textBox_output_file_TextChanged(object sender, System.EventArgs e)

      {

      }

      private void createWordDoc_Closing(object sender, System.ComponentModel.CancelEventArgs e)

      {

         if (WordApp != null)

         {

            // try-catch just in case user closed the application themselves whilst viewing the

            // generated output document

            try 

            {

               object nothing = Type.Missing;

               object notTrue = false;

               WordApp.Application.Quit( ref notTrue, ref nothing, ref nothing);

            }

            catch (Exception createWordDoc_Closing_exception)

            {

               // dummy statement

               String s = createWordDoc_Closing_exception.Message;

            }

         }

      }

      #endregion

      #region word document generation code

      /// <summary>

      /// Displays progress of the document generation in the createWordDocument dialog

      /// </summary>

      /// <param name="prefix"></param>

      /// <param name="EA_string"></param>

      private void displayProgress(string prefix, string EA_string)

      {

         textBox_progress.AppendText( prefix + EA_string + "\r\n" );

         // Display to the output tab as well - as a longer term record of what happened

         StringBuilder sb = new StringBuilder("");

         DocSectionTracker.appendHeadingNumber(ref sb);

         while (sb.Length < 30)

            sb.Append(" ");

         sb.Append(prefix);

         sb.Append(EA_string);

         EA_Repository.WriteOutput( Main.GUI_OUTPUT_TAB_NAME, sb.ToString(), 0);

      }

      /// <summary>

      /// This method takes the specified EA diagram element and puts the diagram image

      /// into the clipboard from where it can be pasted into the word document. After

      /// pasting it into the document, it sets the style and other aspects of the image.

      /// </summary>

      /// <param name="theDiagram"></param>

      private void appendAndSelectDiagramViaClipboard(EA.Diagram theDiagram)

      {

         // NOTE: diagrams only use one stereotype, not a list of them, so dont use StereotypeEx field

         if (  EA_Utils.options.opt_ConsiderAPIDiagramsOnly 

            && !theDiagram.Stereotype.Equals("API") )

         {

            displayProgress( "SKIPPED DIAGRAM: ", theDiagram.Name.ToString() );

         }

         // open the diagram in EA and copy it's image to the clipboard

         else if (EA_Project.PutDiagramImageOnClipboard(theDiagram.DiagramGUID,0))

         {

            object startLocation;

            object endLocation;

            TextUtils.appendDescription( theDiagram.Notes, EA_Utils );

            // create a range at the end of the document

            startLocation = WordDocument.Content.End;

            WordDocument.Content.InsertParagraphAfter();

            endLocation = WordDocument.Content.End;

            Word.Range WordRange = WordDocument.Range(ref startLocation, ref endLocation);

            object direction = Word.WdCollapseDirection.wdCollapseEnd;

            WordRange.Collapse(ref direction);  // collapse prevents existing content being replaced

            // Get ready for the diagram paste and the formatting we want to do on it with the

            // selection object.

            TextUtils.SelectInsertionPointAtEndOfDocument();

            // Paste the diagram into the document

            WordRange.Paste();           

            // Set style of the diagram to "Normal" so that it can occupy space all the way to the left margin

            object l_style = EA_Constants.styleName_Normal;

            endLocation = WordDocument.Content.End;

            WordRange = WordDocument.Range(ref startLocation, ref endLocation);

            WordRange.set_Style(ref l_style);

            // Center the diagram on the page

            object unit = Word.WdUnits.wdLine;

            object missing = Type.Missing;

            object count = 1;

            WordApp.Selection.MoveDown( ref unit, ref count, ref missing);

            WordApp.Selection.ParagraphFormat.Alignment = Word.WdParagraphAlignment.wdAlignParagraphCenter;

            // Add a caption

            WordDocument.Content.InsertParagraphAfter();

            TextUtils.SelectInsertionPointAtEndOfDocument();         

            object Label = "Figure";

            object Title = Type.Missing;

            object TitleAutoText = Type.Missing;

            object Position = Word.WdCaptionPosition.wdCaptionPositionAbove;

            object ExcludeLabel = 0;

            WordApp.Selection.InsertCaption( ref Label, ref Title, ref TitleAutoText, ref Position, ref ExcludeLabel);

            WordApp.Selection.TypeText( ": " + theDiagram.Name.ToString());

            WordApp.Selection.ParagraphFormat.Alignment = Word.WdParagraphAlignment.wdAlignParagraphCenter;

            // experimental code to create a bookmark for the figure caption

            //WordDocument.Paragraphs[ WordDocument.Paragraphs.Count ].Range.Select();

            //object lastParaRange = WordDocument.Paragraphs[ WordDocument.Paragraphs.Count ].Range;

            //string bookmarkName = theDiagram.Name;

            //bookmarkName = bookmarkName.Replace(' ', '_');

            //WordDocument.Bookmarks.Add( bookmarkName, ref lastParaRange );

            // Close the diagram in EA

            EA_Repository.CloseDiagram(theDiagram.DiagramID);

            displayProgress( "DIAGRAM: ", theDiagram.Name.ToString() );

         }

      }

      #region special element processing functions (link elements, table and text elements, etc)

      /// <summary>

      /// This is an attempt to create a table similar in style to those made by the ERG doc template macros.

      /// It is not exaclty that same though, and further work could be done to align it more precisely.

      /// </summary>

      /// <param name="tableTitle"></param>

      /// <param name="numRows"></param>

      /// <param name="numCols"></param>

      /// <returns></returns>

      /// <summary>

      /// This function process a package link element, parsing each linked package by the

      /// parse_package() recursive function.

      /// </summary>

      /// <param name="theElement"></param>

      /// <param name="recurse_level"></param>

      private void processPackageLink(EA.Element theElement, int recurse_level)

      {

         string [] EA_DocGenPkgLnk = null;

         string delimStr = "\r\n";

         char [] delim = delimStr.ToCharArray();

         EA_DocGenPkgLnk = theElement.Notes.ToString().Split(delim,100);

         string linkedName = "";

         foreach(string s in EA_DocGenPkgLnk)

         {

            if (s.Length > 0 && s != "\n" && s != "\r")

            {

               if (s == "skiproot")

               {

                  oneShot_skipRootPackage = true;

               }

               else if (s[0] == '{')

               {

                  EA.Package theFoundPackage = EA_Utils.EA_Finder.findPackageInRepositoryByGUID(s);

                  if (theFoundPackage != null)

                  {

                     parse_package(theFoundPackage, recurse_level);

                  }

                  else

                  {

                     MessageBox.Show("WARNING - Could not find linked package : " + linkedName );

                  }

               }

               else

               {

                  linkedName = s;

               }            

            }

         }

      }

      /// <summary>

      /// This function process a diagram link element, using the appendAndSelectDiagramViaClipboard()

      /// for each linked diagram.

      /// </summary>

      /// <param name="theElement"></param>

      private void processDiagramLink(EA.Element theElement)

      {

         string [] EA_DocGenDiagLnk = null;

         string delimStr = "\r\n";

         char [] delim = delimStr.ToCharArray();

         EA_DocGenDiagLnk = theElement.Notes.ToString().Split(delim,100);

         string linkedName = "";

         foreach(string s in EA_DocGenDiagLnk)

         {

            if (s.Length > 0 && s != "\n" && s != "\r" )

            {

               if (s[0] == '{')

               {

                  EA.Diagram theFoundDiagram = EA_Utils.EA_Finder.findDiagramInRepositoryByGUID(s);

                  if (theFoundDiagram != null)

                  {

                     appendAndSelectDiagramViaClipboard( theFoundDiagram );

                  }

                  else 

                  {

                     MessageBox.Show("WARNING - Could not find linked diagram : " + linkedName );

                  }

               }

               else

               {

                  linkedName = s;

               }            

            }

         }         

      }

      /// <summary>

      /// This function process an element link element, parsing each linked element by the

      /// parse_element() recursive function.

      /// </summary>

      /// <param name="theElement"></param>

      /// <param name="recurse_level"></param>

      private void processElementLink(EA.Element theElement, int recurse_level )

      {

         string [] EA_DocGenEleLnk = null;

         string delimStr = "\r\n";

         char [] delim = delimStr.ToCharArray();

         EA_DocGenEleLnk = theElement.Notes.ToString().Split(delim,100);

         string linkedName = "";

         foreach(string s in EA_DocGenEleLnk)

         {

            if (s.Length > 0 && s != "\n" && s != "\r")

            {

               if (s == "skiproot")

               {

                  oneShot_skipRootElementHeading = true;

               }

               else if ( s[0] == '{')

               {

                  EA.Element theFoundElement = EA_Utils.EA_Finder.findElementInRepositoryByGUID(s);

                  if (theFoundElement != null)

                  {

                     parse_element( theFoundElement, recurse_level );

                  }

                  else 

                  {

                     MessageBox.Show("WARNING - Could not find linked element : " + linkedName );

                  }

               }

               else

               {

                  linkedName = s;

               }            

            }

         }         

      }

      /// <summary>

      /// This method is recursive and searches a model structure to find a match to any 

      /// of the names given in a list. Matched package structure is then parsed for

      /// document content generation.

      /// </summary>

      /// <param name="parentPackage"></param>

      /// <param name="thePackage"></param>

      /// <param name="recurse_level"></param>

      /// <param name="skipRoots"></param>

      /// <param name="names"></param>

      private void processNameLinkPackage(EA.Package parentPackage, EA.Package thePackage, int recurse_level, bool skipRoots, ref ArrayList names)

      {

         // search for the package name in the names[] list

         int i = 0;

         bool found = false;

         foreach (string name in names)

         {

            // users can specify parent\child in a name to help narrow down exactly what package they 

            // are looking for so deal with that, but the parent\ part is optional.

            int splitpos = name.IndexOf('\\',0);

            if (splitpos >= 0)

            {

               if (parentPackage != null)

               {

                  if (name.Substring(0,splitpos).Equals(parentPackage.Name))

                  {

                     if (name.Substring(splitpos+1).Equals(thePackage.Name))

                     {

                        found = true;

                        break;

                     }

                  }

               }

               else

               {

                  if (name.Substring(splitpos+1).Equals(thePackage.Name))

                  {

                     found = true;

                     break;

                  }

               }

            }

            else

            {

               if (name.Equals(thePackage.Name))

               {

                  found = true;

                  break;

               }

            }

            i++;

         }

         if (found)

         {

            // remove the found name, arm the skiproot mechanism if needed, and parse the package

            names.RemoveAt(i);

            if (skipRoots == true)

               oneShot_skipRootPackage = true;

            parse_package(thePackage, recurse_level);

         }

         else if (names.Count > 0)  // any names left to process?

         {

            // recurse for each of this packages sub-packages

            foreach(EA.Package subPackage in thePackage.Packages)

            {

               processNameLinkPackage(thePackage, subPackage, recurse_level, skipRoots, ref names);                        

            }         

         }

      }

      private void processNameLink(EA.Element theElement, int recurse_level )

      {

         string delimStr = "\r\n";

         char [] delim = delimStr.ToCharArray();

         string [] EA_DocGenNameLnk = theElement.Notes.ToString().Split(delim,100);

         string linkedName = "";

         bool gotLinkedName = false;

         ArrayList names = new ArrayList();

         EA.Package theFoundPackage = null;

         bool skipRoots = false;

         // search through the option strings

         foreach(string s in EA_DocGenNameLnk)

         {

            if (s.Length > 0 && s != "\n" && s != "\r")

            {

               if (s == "skiproot")

               {

                  skipRoots = true;

               }

               else if (s[0] == '{')  // is it a GUID?

               {

                  // find the package by its GUID

                  theFoundPackage = EA_Utils.EA_Finder.findPackageInRepositoryByGUID(s);

               }

               else if (s.StartsWith("package="))

               {

                  // add the users named package to our list of names

                  names.Add( s.Substring(8, s.Length - 8) );

               }

               else if (gotLinkedName == false)

               {

                  // capture name of package refered to by the GUID - this is only for diagnostic purposes

                  gotLinkedName = true;

                  linkedName = s;

               }            

            }

         }  

         // If the GUID was resolved...

         if (theFoundPackage != null)

         {

            processNameLinkPackage(null, theFoundPackage, recurse_level, skipRoots, ref names);

            if (names.Count > 0)

            {

               StringBuilder sb = new StringBuilder();

               sb.Append("WARNING - Could not find named package(s)\n");

               sb.Append("within name link: ");

               sb.Append(linkedName);

               sb.Append("\n\nProblem package= directives are:\n");

               foreach(String s in names)

               {

                  sb.Append("\n");

                  sb.Append(s);

               }

               MessageBox.Show(sb.ToString());

            }

         }

         else

         {

            MessageBox.Show("WARNING - Could not find linked package : " + linkedName );

         }

      }

      /// <summary>

      /// This function processes a name link element. These are elements that point

      /// (using a GUID) to a package, and the user has specified text names of sub-packages

      /// within the package that they wish to have processed for document generation.

      /// This is a useful way of getting content when you cannot be sure that the GUIDs

      /// of the packages you want will remain constant (eg. when re-using content from

      /// a reqpro import (for doc gen purposes)).

      /// </summary>

      /// <param name="theElement"></param>

      /// <param name="recurse_level"></param>

      private void processTestLink(EA.Element theElement, int recurse_level )

      {

         string [] EA_DocGenEleLnk = null;

         string delimStr = "\r\n";

         char [] delim = delimStr.ToCharArray();

         EA_DocGenEleLnk = theElement.Notes.ToString().Split(delim,100);

         string linkedName = "";

         foreach(string s in EA_DocGenEleLnk)

         {

            if (s.Length > 0 && s != "\n" && s != "\r")

            {

               if ( s[0] == '{')

               {

                  try

                  {

                     // try to find the GUID as a package

                     EA.Package theFoundPackage = EA_Utils.EA_Finder.findPackageInRepositoryByGUID(s);

                     if (theFoundPackage != null)

                        TextUtils.appendUnitTestSuite(theFoundPackage, recurse_level, ref classesWithUnitTests, ref EA_Utils);

                     else 

                     {

                        // try to find the GUID as an element

                        EA.Element theFoundElement = EA_Utils.EA_Finder.findElementInRepositoryByGUID(s);

                        if (theFoundElement != null)

                           TextUtils.appendUnitTestSuite(theFoundElement, recurse_level, ref classesWithUnitTests, ref EA_Utils);

                        else 

                           MessageBox.Show("WARNING - Could not find linked element : " + linkedName );

                     }

                  }

                  catch 

                  {

                     // try to find the GUID as an element

                     EA.Element theFoundElement = EA_Utils.EA_Finder.findElementInRepositoryByGUID(s);

                     if (theFoundElement != null)

                        TextUtils.appendUnitTestSuite(theFoundElement, recurse_level, ref classesWithUnitTests, ref EA_Utils);

                     else 

                        MessageBox.Show("WARNING - Could not find linked element : " + linkedName );

                  }

               }

               else

               {

                  linkedName = s;

               }            

            }

         }         

      }

      private void processTestTraceability( EA.Element theElement, int recurse_level )

      {

         if (classesNeedingUnitTests.Count > 0)

         {

            if (theElement.Notes.Length > 0)

            {

               TextUtils.appendAndSelectText( theElement.Notes, EA_Constants.styleName_Body1);

            }

            int tableNum = TableUtils.Table_Create("Design Element to Unit Test Suite Traceability", 2, 2);

            utTraceabilityTable = WordDocument.Tables[tableNum];

            TableUtils.Table_SetTableColumnTitle(utTraceabilityTable, "Design Element (class)", 1);

            TableUtils.Table_SetTableColumnTitle(utTraceabilityTable, "Test Suite", 2);

         }

      }

      private void completeTestTraceability()

      {

         if (utTraceabilityTable != null)

         {

            int numClassesRemaining = classesNeedingUnitTests.Count;

            int row = 2;

            foreach(int elementId in classesNeedingUnitTests)

            {

               EA.Element theElement = EA_Repository.GetElementByID( elementId );

               if (theElement != null)

               {

                  utTraceabilityTable.Cell(row,1).Range.Text = theElement.Name;

                  if (classesWithUnitTests.Contains( elementId ))

                  {

                     utTraceabilityTable.Cell(row,2).Range.Text = TextUtils.testSuiteName(theElement);

                  }

                  else

                  {

                     utTraceabilityTable.Cell(row,2).Range.Text = "Missing tests!";

                     utTraceabilityTable.Cell(row,2).Range.Font.Color = Word.WdColor.wdColorRed;

                  }

               }

               numClassesRemaining--;

               if (numClassesRemaining > 0)

               {

                  TableUtils.Table_InsertNewRowAfterThisRow(utTraceabilityTable, row);

                  row++;

               }

            }

         }

      }

      #endregion

      #region special section processing functions (references, terminology, etc)

      /// <summary>

      /// This function processes elements as if they represented document references for

      /// the References section of a document.

      /// </summary>

      /// <param name="thePackage"></param>

      private void createReferencesSection(EA.Package thePackage)

      {

         foreach(EA.Element theElement in thePackage.Elements)

         {

            // Here we want to apply the special ERG template styles for each reference

            // item.

            TextUtils.appendAndSelectText( theElement.Name.ToString(), EA_Constants.styleName_RefListNum );

            TextUtils.appendAndSelectText( theElement.Notes.ToString(), EA_Constants.styleName_RefListText );

         }

      }

      private void createTerminologySection(EA.Package thePackage, int recurse_level)

      {

         // Use local package elements as source of glossary, but if none are present, resort to using

         // the project glossary in the repository 

         int numItems = thePackage.Elements.Count;

         if (numItems == 0)

         {

            numItems = EA_Repository.Terms.Count;

            // Create a table

            int tableNum = TableUtils.Table_Create("Terminology", numItems+1, 2);

            Word.Table table = WordDocument.Tables[tableNum];

            object center = Word.WdParagraphAlignment.wdAlignParagraphCenter;

            TableUtils.Table_SetTableColumnTitle(table, "Term", 1);

            TableUtils.Table_SetTableColumnTitle(table, "Definition", 2);

            table.Columns[1].SetWidth(100, Word.WdRulerStyle.wdAdjustSameWidth );

            int row = 2;

            // inject the glossary into the table

            foreach(EA.Term theTerm in EA_Repository.Terms)

            {

               table.Cell(row,1).Range.Text = theTerm.Term;

               table.Cell(row,2).Range.Text = theTerm.Meaning;

               row++;

            }

         }

         else

         {

            // scan content of terminology package - allow user to specify tables, text, package links,

            // and diagram links.

            ArrayList infoItems = new ArrayList();

            foreach(EA.Element theElement in thePackage.Elements)

            {

               if (theElement.Name.StartsWith(EA_Constants.EA_DocGenTable))

               {

                  TableUtils.processTableElement( theElement, recurse_level);

               }

               else if (theElement.Name.StartsWith(EA_Constants.EA_DocGenPackageLink))

               {

                  processingLink++;

                  processPackageLink( theElement, recurse_level );

                  processingLink--;

               }

               else if (theElement.Name.StartsWith(EA_Constants.EA_DocGenText))

               {

                  TextUtils.appendAndSelectText( theElement.Notes.ToString(), EA_Constants.styleName_Body1 );

               }

               else if (theElement.Name.StartsWith(EA_Constants.EA_DocGenDiagramLink))

               {

                  processingLink++;

                  processDiagramLink( theElement );

                  processingLink--;

               }

               else if (theElement.Name.StartsWith(EA_Constants.EA_DocGenElementLink))

               {

                  processingLink++;

                  processElementLink( theElement, recurse_level );

                  processingLink--;

               }

               else if (!theElement.Name.StartsWith(EA_Constants.EA_DocGenBaseName)   // ignore all other special EA_DocGen elements

                  || theElement.Name.Length == EA_Constants.EA_DocGenBaseName.Length) // allow EA_DocGen to be used as a term/acronym

               {

                  infoItems.Add( theElement );

               }

            }

            if (infoItems.Count > 0)

            {

               // Create a table

               int tableNum = TableUtils.Table_Create("Terminology", infoItems.Count+1, 2);

               Word.Table table = WordDocument.Tables[tableNum];

               object center = Word.WdParagraphAlignment.wdAlignParagraphCenter;

               TableUtils.Table_SetTableColumnTitle(table, "Term", 1);

               TableUtils.Table_SetTableColumnTitle(table, "Definition", 2);

               table.Columns[1].SetWidth(100, Word.WdRulerStyle.wdAdjustSameWidth );

               int row = 2;

               foreach(EA.Element theElement in infoItems)

               {

                  table.Cell(row,1).Range.Text = theElement.Name.ToString();

                  table.Cell(row,2).Range.Text = theElement.Notes.ToString();

                  row++;

               }

            }

         }

      }

      #endregion

      private bool generatePackageHeadingAndDescription( EA.Package thePackage, int recurse_level )

      {

         bool processLowerLevelContent = true;  // return value for this function

         // The package name is a heading, and the package notes are paragraphs 

         // directly under that heading

         TextUtils.appendAndSelectHeadingText( thePackage.Name.ToString(), recurse_level );

         displayProgress( "PACKAGE: ", thePackage.Name.ToString() );

         // Special handling for package called "Terminology" 

         if (thePackage.Name == "Terminology")

         {

            TextUtils.appendAndSelectText( thePackage.Notes.ToString(), EA_Constants.styleName_Body1 );

            createTerminologySection(thePackage, recurse_level);

            processLowerLevelContent = false;

         }

         else if (thePackage.Name == "References")

         {

            TextUtils.appendAndSelectText( thePackage.Notes.ToString(), EA_Constants.styleName_Body1 );

            createReferencesSection(thePackage);

            processLowerLevelContent = false;

         }

         else

         {