All ProjectConsole Template Builder information is stored in Word documents as comments within a ProjectConsole Template Builder template. ProjectConsole Template Builder uses these to populate the Web page; the comments as you see them in Word do not appear in the generated page.
ProjectConsole Template Builder uses comments to:
§ Store the strings that hold the values of the ProjectConsole Template Builder commands
§ Identify the beginning and ending points of ProjectConsole Template Builder commands
Word 2000 - Comments are marked by a name and number enclosed in brackets, for example, [OPEN1] and [DISPLAY2]. The number is sequential in the document, from 1 to the total number of comments. Template Builder uses the comment names to help identify commands.
Word 2002 – Comments are identified by a comment marker, shown magnified here: . To see a non-functional representation of the comment as Word 2000 displays it, click ProjectConsole > Show/Hide Commands.
Note: To read about the comment differences between the Word versions, see Word 2000 and Word 2002 Comparison.
Here are the names ProjectConsole Template Builder uses:
Comment Name |
Description |
OPEN |
An OPEN Command (a single command) |
REPEAT |
The start of a REPEAT command. |
ENDREP |
The end of a REPEAT command |
DISPLAY |
The start of a DISPLAY command |
ENDDISP |
The end of a DISPLAY command |
LIMIT |
The start of a LIMIT command. |
ENDLIM |
The end of a LIMIT command |
ProjectConsole Template Builder generates and uses the commands [MASTER] and [ENDMAST] internally. These commands are associated with the REPEAT command. Do not alter any [MASTER] or [ENDMAST] commands or your template could be corrupted.
Unlike Word, which treats comments as separate and of equal value, ProjectConsole Template Builder uses most comments in pairs and hierarchically.
· Comment pairs define the beginning and end of a command, such as DISPLAY and ENDDISP.
· You can nest a REPEAT command hierarchically within another REPEAT command.
Here is an example of a hierarchical relationship between REPEAT commands:
OPEN to a ReqPro Project
REPEAT1 for Requirements
DISPLAY Requirement Information
REPEAT2 for TracedTo Requirements
DISPLAY TracedTo Requirement Information
In this example, REPEAT2 is dependent and internal to REPEAT1. If REPEAT1 results in a null value, REPEAT2 is never exercised. Word’s definition of comment would make all of these equal regardless of their order and placement, and they would be processed sequentially from top to bottom.
To see the hierarchy of ProjectConsole Template Builder commands, click ProjectConsole > Template View.