Using Generic Preamble Documents

How to: Use generic preamble documents.

Environment: Comsense Advantage

In this article:

About Preambles

Preamble Generation Methods

Preambles are a section of a submittal that describes how to read the document. Preambles may include general notes, swing charts, or any other information that is useful to the reader. Comsense has two preamble generation methods:

We recommend using the generic preamble document if your company's preambles are the same for most projects. We recommend using the custom preamble document tool if your preambles are different for most projects. Your company should only use one preamble generation method because of the nature of the file location and system behavior. If you are unsure which preamble method is best for your company, Contact Support.

Generic Preamble Documents

A generic preamble document is a basic preamble that you use for most submittals. The preamble files are .doc files that live in your common folder. Comsense prepopulates your common folder with two empty .doc preamble files that you must use for the preambles or replace with the preamble documents. The empty files are called:

  • DF Preamble.doc
  • Hdw Preamble.doc

You cannot change the file name or type. If you change the file name or type, the system will not recognize the file.

Accessing Preamble Template Documents

Locating the Common Folder

If you do not know the location of your common folder, find the location of your common folder in the About Comsense Advantage window under Common Folder Location.

Advantage > Help > About Comsense Advantage > Common Folder Location

Click image to enlarge
Comsense Advantage; show the location of Help in the top toolbar and About Comsense Advantage in the Help drop-down menu.
Click image to enlarge
About Comsense Advantage window; shows the Common Folder Location.

Locating the Preamble Documents

Common Folder > Templates > Preambles > Templates

Click image to enlarge
Windows Explorer window; shows the pathway of the preamble templates and the default preamble template files.

Creating & Uploading a Generic Preamble

Create your generic preamble in the common folder word documents or replace the common folder word documents with files of the same name. Always be aware of document formatting and how it behaves with the submittal tool options e.g. headers, footers, margins, etc.

*Tip: Use Key Fields to auto-populate project data in the preamble document.

Click image to enlarge
Word Document; shows an example preamble with three sections called General Notes, Swing Chart, and Keying Information.

Using the Generic Preamble

Viewing the File in a Project

Comsense copies the preamble files into every new project. If your project requires a minor modification to the generic preamble, update the file in your project's file folder.

Click image to enlarge
Projects window; shows the location of the Show Related Documents button.

Including the Preamble in a Submittal

To use the preamble in your submittal, Add the preamble as the first line item in the New Submittal Tool.

Click image to enlarge
Submittal window; shows the Hardware Preamble as the first line item in the submittal contents.
Have more questions? Submit a request

Comments