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:
Set up the 3D model view as desired
Select Tools > Export Image from Screen
Save with a descriptive filename
Use ###ImageC[filename.jpg] in your template
🧾 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:
Software searches for Word .DOC or .DOT files first
If not found, searches for Excel .XLS or .XLT files
Finally uses default CAD templates from RoofWiz.dab
Replaces all key text strings with actual job data
Creates final document named: JobFile-ModelName-TemplateName
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
In MS Word, find the table format that you want:
This is the description to type into the TableFormats.csv file.
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_Desc_1 | ##LI_Cover_Qty_1 |
Flashing – Product Code | Description | Quantity |
##LI_Flashing_Code_1 | ##LI_Flashing_Desc_1 | ##LI_Flashing_Qty_1 |
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







