CupixWorks Support Center

SpreadSmart

TABLE OF CONTENTS

Introduction

SpreadSmart connects CupixWorks data to Google Sheets for custom reports that match your company standards. Create templates once and generate reports with a single click, automatically filling spreadsheets with text, numbers, and images from your projects. This eliminates manual data transfer, saving time while ensuring consistent, accurate documentation.

What is SpreadSmart?

SpreadSmart is a feature that intelligently connects your CupixWorks data with Google Sheets templates. The system:

  • Identifies predefined variables in your selected Google Sheet templates
  • Replaces these variables with actual data from your CupixWorks projects
  • Automatically populates spreadsheets with various data types including text values, numerical data, dates, and visual elements

With SpreadSmart, you can transform standard CupixWorks report data into customized formats that meet your specific company standards or client requirements with just one click.


Compatible Report Types

SpreadSmart currently supports generating reports with the following CupixWorks Report features:

  • OmniNote Reports (Available now)
  • Timeline Reports (Coming soon)
  • Annotation Reports (Coming soon)
  • SiteInsights Reports (Coming soon)

Creating Templates with Predefined Variables

Design your report template in Google Sheets and insert predefined variables where you want CupixWorks data to appear. These variables act as placeholders that are automatically replaced with your project data when generating reports.

To create effective templates:

  • Review the available variables in the list below in this article
  • Copy the exact variable name with its formatting
  • Paste it into your Google Sheets template where needed

[Sample SpreadSmart template showing predefined variables in a Google Sheet]


Generating a SpreadSmart Report

  1. Navigate to the OmniNote Report in CupixWorks.
  2. Enter a Title or Description for your report, then select which OmniNotes to include by choosing from:
    • Current capture
    • Capture date range
    • Selected captures
  3. Click the 'SpreadSmart Report' button to proceed.
  4. When the dialog appears, sign in with the Google account where your predefined spreadsheet template is stored.
  5. From the file browser, select your template Spreadsheet. If your file contains multiple sheets, choose which specific sheet to use as your template.
  6. Select your preferred report format by choosing one of the layout options:
    • Data arranged in row direction
    • Data arranged in column direction
    • Create multiple sheets
  7. Choose your output preference:
    • Generate as a brand new spreadsheet file
    • Insert data into your existing template file
  8. The system will automatically populate all data fields according to the variables placed in your template

    Supported Template Variables

  • Team, Project, SiteView

Field

Type

Description

[Team.Name]

Text

Team name

[Team.Logo]

Image

Team logo image

[Project.Name]

Text

Project name

[Project.Address]

Text

Project address

[SiteView.Link]

Link

SiteView link

[SiteView.Name]

Text

SiteView name

Report

Field

Type

Description

[Report.Title]

Text

Report title

[Report.Description]

Text

Report Description

[Today]

Date

The date of the report generation. 

[Reporter.Name]

Text

Report generator's name

[Reporter.Email]

Email

Report generator’s email

Item Enumeration and Iteration

Field

Type

Description

[ItemIter.Title]

Text

Title

[ItemIter.OmniNote.Description]

Text

OmniNote description

[ItemIter.Type]

Text

Report type

Item Enumeration and Iteration Variations

Field

Type

Description

[ItemIter.(ItemType).Image]

Image

Photo image

[ItemIter.(ItemType).Description]

Text


[ItemIter.(ItemType).Location.Level]

Text

Level containing the object

[ItemIter.(ItemType).Location.Room]

Text

The nearest room name

[ItemIter.(ItemType).Location.Grid]

Text

The nearest grid name

[ItemIter.(ItemType).Location.Workarea]

Text

Work area containing the object (from the active work group)

[ItemIter.(ItemType).Floormap.Focused]

Image

Zoomed-in Reference Plan image showing the specific location 

[ItemIter.(ItemType).Floormap.All]

Image

Complete Reference Plan image 

[ItemIter.(ItemType).Capture.Date]

Date

Capture date associated with this object.

[ItemIter.(ItemType).Capture.Label]

Text

Capture Label

[ItemIter.(ItemType).Capturer.Name]

Text

Capturer’s name

[ItemIter.(ItemType).Capturer.Email]

Email

Capturer’s email

[ItemIter.(ItemType).Creator.Name]

Text

Item creator’s name

[ItemIter.(ItemType).Creator.Email]

Email

Item creator’s email

[ItemIter.(ItemType).Tag]

Text

OmniNote Tag


Optional Image Sizing and Fitting

You can customize image dimensions by adding size parameters to image variables:

  • Add 'width x height' in pixels after the image variable to set size
  • Images maintain proportions while fitting within dimensions (similar to CSS 'contain')
  • Set width or height to '0' to keep original proportions while fixing one dimension

Examples:

  • [Project.Client.Logo480x240]: Set width to 480 pixels and height to 240 pixels
  • [Project.Client.Logo480x0]: Set width to 480 pixels and maintain aspect ratio
  • [Project.Client.Logo0x240]: Set height to 240 pixels and maintain aspect ratio
J
Jim is the author of this solution article.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.