Using the Custom Preamble Tool

How to: Use the custom preamble tool.

Environment: Comsense Advantage

In this article:

About Preambles

Preamble Generation Methods

Preambles are 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 custom preamble tool if your preambles are different for most projects. We recommend using the generic preamble document if your company's preambles are the same 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.

Custom Preamble Documents

The custom preamble tool creates a preamble using different preamble sections. Preamble sections are a portion of your preamble such as general notes or swing charts. The preamble tool allows you to upload different sections to the system and select the required sections at the time of preamble generation. 

Your common folder is prepopulated with two empty .doc preamble files. The empty files are called:

  • DF Preamble.doc
  • Hdw Preamble.doc

Do not remove these files or update the document contents. The files must be in the common folder and be empty for the custom preamble document tool to function properly.

Adding Preamble Sections

Before uploading the preamble sections to Comsense, you must complete and save the preamble section word documents as individual files .doc files e.g. General Notes.doc, Swing Chart.doc, Keying Information.doc, etc. Always be aware of 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 sections.

Click image to enlarge
Word Document; shows an example of a General Notes preamble section.

Accessing Preamble Sections

Advantage > Maintenance > Preamble Sections

Click image to enlarge
Comsense Advantage; shows the location of Maintenance in the top tooler and Preamble Sections in the Maintenance drop-down menu.

Uploading Preamble Sections

Preamble sections sort by the type column in ascending order numerically and alphabetically. If there is a standard of preference for your company, we recommend numbering each section type in your desired order using a three-digit value e.g. 001 General Notes, 002 Hardware, 003 Swing Chart, etc.

In the fillable line item:

  1. Enter the section type & section description
Click image to enlarge
Preamble Section Maintenance window; shows Type and Description Field.
  1. Click ...
Click image to enlarge
Preamble Section Maintenance window; shows the location of the ellipses button.

In the File Explorer:

  1. Select the .doc file
  2. Click OK
Click image to enlarge
File Explorer; shows a highlighted word doc file and the location of the Open button.
  1. Repeat steps 1-4 for each section
  2. Click OK

The preamble sections are now available for the custom preamble document tool.

Creating a Custom Preamble

You must create the custom preamble for your project in the Preamble window before creating your submittal with a preamble.

Accessing Preamble

Advantage > Detailing > Preamble

Click image to enlarge
Advantage Navigation menu; shows the location of Detailing and Preamble.

Selecting the Preamble Sections & Options

*Note: Always confirm the project number before creating the preamble.

In the Preamble window:

  1. Select the required preamble sections using the Select checkboxes
Click image to enlarge
Project Preamble Selector window; shows selected preamble sections.

In the Preamble Template pane:

  1. Select Hardware or Door-Frame
Click image to enlarge
Project Preamble Selector window; shows the location of the Preamble Template pane.

In the File Options pane:

  1. Select Append or Replace
    • Append adds the selected sections to the current file
    • Replace replaces the current file with a file containing the selected sections
Click image to enlarge
Project Preamble Selector window; shows the location of the File Option pane.
  1. Click Create Preamble
    • The word document will open
Click image to enlarge
Project Preamble Selector window; shows the location of the Create Preamble button.

If your preamble requires any minor modifications:

  1. Update the word document
  2. Click Save

Your project now has a custom preamble for your project's submittal. The preamble file is in the project's related documents folder.

Click image to enlarge
File Explorer; shows the project file folder and the new preamble file.

Using 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 listed as the first line item in the submittal.
Have more questions? Submit a request

Comments