Skip to main content

How do I create custom report templates using Microsoft Word and Excel?

Learn how to design and customize report templates using Microsoft Word and Excel to suit your business needs, including key text strings, image insertion, and advanced formatting options.

Updated this week

Menu path

Tools > More > Edit User Templates


🧾 What it does

AppliCad Roof Wizard allows you to create custom report templates using Microsoft Word or Excel instead of the default CAD templates. This provides greater design flexibility and familiarity for users who prefer working with Microsoft Office applications.

The software first looks for Microsoft Word (.DOC or .DOT) or Excel (.XLS or .XLT) templates with specific names. If found, these will be used instead of the default CAD templates stored in the RoofWiz.dab database file.


🔧 Setting Up MS Word/Excel as your Report Generator

Important compatibility requirements:

  • File format must be Microsoft Office 1997-2003 compatible
    (do not use XLTS or DOCX formats)

  • Templates must be saved in the ../User folder (local use) or ../Corporate folder (company-wide use)

  • File names must match exactly without spaces (e.g., QuotationLetter.DOC)

🧾 Standard Template Names

Report name

Template name

Intended Use

Quotation letter

QuotationLetter

A quotation to send to your customer detailing the information as a letter

Quotation form

QuotationForm

A quotation to send to your customer detailing the information in a tabular fashion.

Quotation acceptance

QuotationAcceptance

Same as above with the addition of a place for the customer to accept the quote with a signature

Quotation details

QuotationDetails

This report tabulates the materials and costs for the job

Installer pay summary

PaySummary

This report tabulates the labor costs for you to perhaps give to the installer

Material cutting list

MaterialCuttingList

This report tabulates the sheet and flashing cutting lists

User form 1

UserForm1

An extra form for you to define

User form 2

UserForm2

An extra form for you to define

User form 3

UserForm3

An extra form for you to define

User form 4

UserForm4

An extra form for you to define

Order Forms

OrderForm

The Supplier’s Order form. Generated for each supplier in your list of required items.

Tax invoice 1

TaxInvoice1

A tax invoice

Tax invoice 2

TaxInvoice2

A tax invoice

Bill of Quantities

BillOfQuantities

A Bill of Quantities report

Roof Quantities

Roof Quantities

Summary of roof geometry (areas and lengths) and a roof plan

⚠️ Important: Do not change the order of standard templates or add new templates above the standard list. Add custom templates below the standard list only.

🔧 Linking Templates to Output

To create custom templates with different names, use these CSV files:

  • UserReportNames.csv - Links report templates to display names

  • UserDrawingNames.csv - Links drawing templates to display names

Access these through Tools > More > Edit User Templates to add new custom reports to your print options list.

🔧 Define Print Options

Menu path: Tools > More > Define Print Options

Pre-set which reports print by default to streamline your workflow. Once configured, simply select OK when printing and all selected reports generate automatically.

🛠 Designing Your Own Templates

Templates use two types of text:

  • Regular text - Static content that appears exactly as typed

  • Key Text Strings (KTS) - Dynamic content marked with ### that gets replaced with actual job data

Example:

  • 'Date' = regular text

  • '###Date' = key text string that inserts the actual date

There are hundreds of available key text strings for different data fields. Plan your template by deciding what information to include, then add the appropriate key text strings for variable data.

🛠 Inserting Roof Drawings

###RoofImage[n]

  • Not for use with CAD templates

  • Must be placed in a single-cell table in Word or text box in Excel

  • The 'n' value controls which elements appear on the drawing

  • More flexible than ###RoofDrawing

🧾 Managing Content of Report Images

Use ###RoofImage[n] to control what appears on roof drawings. Add switch values together to get the desired combination:

Switch Value

Feature

1

Roof planes

2

Display walls

4

Panel/Block/Offcut layout

8

Dimensions

16

Roof pitch/slope

32

Line types

64

Flashing annotations

128

Battens/Purlins

256

Course lines

512

Downpipes

1024

Section details report

2048

Block-cutting

4096

Roof plane areas

8192

Display defined zones

16384

Automated roof plane labels

65536

Auto-rotate image to fit text box

Examples:

  • For pitch and dimensions: n=8+16=24, use ###RoofImage[24]

  • For flashing and downpipes: n=64+512=576, use ###RoofImage[576]

  • For comprehensive view: n=1+2+4+8+128+512=655, use ###RoofImage[655]

🛠 Wall Image Reports

###WallImage[n] works similarly for wall reports with these switches:

Switch Value

Feature

1

Wall plane shading

2

Wall panels

4

Wall dimensions

8

Wall line types

16

Flashing annotation

32

Wall battens/purlins

64

Wall section details

128

Wall plane areas

256

Overall dimensions

512

Automated wall plane labels

1024

Wall labels including windows/doors

2048

Window and door labels only

65536

Auto-rotate image

🛠 Inserting Bitmap Images

For custom images:

  • Save image files in the ../User folder

  • Use ###Image[filename.jpg] to fit image to text box (may distort proportions)

  • Use ###ImageC[filename.jpg] to constrain to original proportions

Quick image capture:

  1. Set up the 3D model view as desired

  2. Select Tools > Export Image from Screen

  3. Save with a descriptive filename

  4. Use ###ImageC[filename.jpg] in your template

This image shows the Inserting Bitmap Images box in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

🧾 Standard Model Data Options

Model Name

Purpose

LENGTHS

Material lengths

PITCH

Roof pitch diagram

AZIMUTH

Roof azimuth diagram

GRID

Grid layout

SHADOW*

Shadow analysis

INSOLATION*

Solar insolation map

* Only available with Solar Wizard module

💡 Image Padding

Adjust image spacing using ImagePad.DAT file in the user folder. Default setting is 1000 (1 metre). Increase padding for more space around images, but this makes the roof image smaller and text harder to read.

Changing the padding from 1000 to 4000 results in more space, but smaller text.

🔧 How the Process Works

When you select Print from Supply Only or Supply+Install:

  1. Software searches for Word .DOC or .DOT files first

  2. If not found, searches for Excel .XLS or .XLT files

  3. Finally uses default CAD templates from RoofWiz.dab

  4. Replaces all key text strings with actual job data

  5. Creates final document named: JobFile-ModelName-TemplateName

  6. Saves completed document to ../User folder

🛠 Word Table Formats

Customize table appearance using tableformats.csv file:

  • Line 1: Table name

  • Line 2: Microsoft Word table style name

  • Line 3: Column widths in millimetres

    This image shows the Word Table Format in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>


    In MS Word, find the table format that you want:

    This image shows the Tables in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>


    This image shows the Tables in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>


    This is the description to type into the TableFormats.csv file.

    This image shows the Table Formats CSV in AppliCad Roof Wizard <a href="https://www.applicad.com" target="_blank" rel="nofollow noopener noreferrer">https://www.applicad.com</a>

Width formatting:

  • Positive number = left justified

  • Negative number = right justified

  • Add 5 to number for centre justified (e.g., 518 = 18mm wide, centre justified)

🧾 User Defined Report/Drawing Names

Modify report names while maintaining functionality:

  • Edit UserReportNames.csv for estimates and quotations

  • Edit UserDrawingNames.csv for plans and layouts

  • Drawing templates require type specification for automatic content insertion

⚠️ Important rules:

  • Do not change the order of standard reports

  • Do not add custom reports above standard list

  • Exception: OrderForm template must be named 'OrderFormTemplate.doc'


🛠 Computing Values Using Line Items

Line items are values generated by the software and displayed in the Reporting > Supply Only or Supply and Install dialog box.

Using Line Items is a standard function of the software and is typically used to extract values for your reports based on calculated values using the Line Items where the value will vary with each job and quotation calculation.

Extract calculated values for Word/Excel reports using ##LI strings (two # signs, not three):

Format: ##LI_

_

_

Subcategories:

  • SUP = Supplier

  • CODE = Product Code

  • PRO = Profile

  • FIN = Finish

  • QTY = Quantity

  • RATE = Cost

  • TOT = Total

  • DISC = Discount

  • SUB = Sub-total

  • COL = Colour

The structure is:

##LI_<Category>_<Sub-Category>_<Line-Number>
where the use of the underscore between each element in the key text string is essential.

Examples:

  • ##LI_Roof Tiles_Qty_1 (first roof tile quantity)

  • ##LI_Fascia_Qty_2 (second fascia quantity)

  • ##LI_SEARCH(FRGHT)_Sub_1 (search for freight charges)

Further examples of the use of these strings in your template might be:

Cover – Product Code

Description

Quantity

##LI_Cover_Code_1
##LI_Cover_Code_2
##LI_Cover_Code_3Etc.

##LI_Cover_Desc_1
##LI_Cover_Desc_2
##LI_Cover_Desc_3Etc.

##LI_Cover_Qty_1
##LI_Cover_Qty_2
##LI_Cover_Qty_3Etc.

Flashing – Product Code

Description

Quantity

##LI_Flashing_Code_1
##LI_Flashing_Code_2Etc.

##LI_Flashing_Desc_1
##LI_Flashing_Desc_2Etc.

##LI_Flashing_Qty_1
##LI_Flashing_Qty_2Etc.

Where the cover material product code, the description and the quantity for three different cover materials on the job cost summary are shown in your report, followed by two types of flashing.


🛠 Inline Calculations with Key Text Strings

Embed calculations in text using this format:

%CALC []:

Example: To add 10% to total price:

"The total price for you is %CALC [###totalinctax + ###totalinctax / 10]:2"

If ###totalinctax was $3000, this will display $3300.00


💡 Best Practices

  • Start with standard templates and make small modifications

  • Test thoroughly before implementing

  • Use constrained images (###ImageC) for dimensioned drawings

  • Set up model view before generating reports with ###RoofImage[n]

  • Keep backup copies of working templates

  • Ensure all referenced image files exist in ../User folder


Did this answer your question?