Export Builders

TimberCloud provides two visual builders for creating export configurations: the CSV Export Builder for spreadsheet and CNC exports, and the ORD Export Builder for Cabinet Vision integration.

Both builders use a drag-and-drop interface—no coding required.

CSV Export Builder

The CSV Export Builder creates table-based exports where you define columns using a visual interface.

Interface Overview

The builder has a three-panel layout:

Opening the Builder

1. Navigate to Catalog → [Your Product]
2. Expand the Exports section
3. Click the green "Create CSV Export" or "Edit CSV Exports" button

Creating Columns

Drag and Drop

1. Find a field in the Available Fields panel
2. Drag it into the Export Preview area
3. The field becomes a new column
4. Click the column to configure it in the right panel

Add Button

1. Click "+ Add Column" below the preview
2. A new empty column appears
3. Configure its content in the Column Editor

Available Field Sources

Column Editor Settings

When you select a column, the right panel shows configuration options:

Header Name

The column header text that appears in the CSV:

Width,Height,Material  ← These are header names
24.5,34.5,Cherry

Content Type

How the column value is determined:

Number Format

For numeric fields, choose display format:

Decimals

For decimal format, specify precision (0-6 decimal places).

Prefix / Suffix

Add text before or after values:

Export Settings

At the bottom of the builder:

Quantity Format Options

Column Actions

Formula Columns

Click "+ Add Formula Column" to create calculated values:

1. Opens the Formula Builder modal
2. Build your calculation step by step
3. Use field values, numbers, and operators
4. Save to create the formula column

Example formulas:

• Square feet: width * height / 144
• Perimeter: (width + height) * 2
• Price per sqft: price / (width * height / 144)

Saving Your Export

1. Click the green "Save Export Config" button
2. Configuration saves to the product
3. Toast notification confirms save
4. Close the builder

Sorting & Grouping

Control row ordering in your CSV export with sorting rules.

Opening Sort Configuration

1. Click the Sort button in the export settings footer
2. The Sort & Group modal opens
3. Enable sorting with the toggle
4. Add sort rules

Sort Rule Settings

Available Sort Fields

Multi-Level Sorting

Add multiple sort rules for complex ordering:

1. Primary sort - First field to sort by (with optional grouping)
2. Secondary sort - Sort within the first
3. Tertiary sort - Further refinement

Example for CNC Export:

1. Sort by Material.name (group all Cherry together, then all Maple)
2. Sort by Width descending (widest first for nesting optimization)
3. Sort by Height descending

Grouping

Enable Group on the first sort rule to:

• Add blank rows between groups in the export
• Organize output by material, product type, or other criteria
• Improve readability for shop floor exports

Common Grouping Scenarios:

• Group by material for efficient sheet usage
• Group by thickness for saw setup optimization
• Group by cabinet type for assembly workflow

ORD Export Builder

The ORD Export Builder creates Cabinet Vision-compatible files with the proper section structure.

ORD File Structure

Cabinet Vision ORD files have three sections:

[Header]
Version=4
Unit=0
Name=Order-12345
Customer=John Smith

[Catalog]
BaseDoorStyle="Shaker"
Option="Cherry"

[Cabinets]
24,30,12,"Base Cabinet"
30,36,24,"Wall Cabinet"

The ORD Builder lets you configure each section separately.

Opening the Builder

1. Navigate to Catalog → [Your Product]
2. Expand the Exports section
3. Click the purple "Create ORD Export" or "Edit ORD Export" button

Interface Overview

Configuring [Header] Section

The Header section contains order metadata. Click to expand and add fields:

Adding Header Fields

1. Click the [Header] Section to expand
2. Click a field button (e.g., "+ Name", "+ Customer")
3. Configure the field value
4. Use {{field}} syntax for dynamic values

Configuring [Catalog] Section

The Catalog section defines material and style options:

Adding Catalog Fields

1. Click the [Catalog] Section to expand
2. Click a field button (e.g., "+ BaseDoorStyle")
3. Map to your product's attribute values

Configuring [Cabinets] Section

The Cabinets section contains line item data. Each line item becomes a row:

Adding Cabinet Columns

1. Click the [Cabinets] Section to expand
2. Click "+ Add Column"
3. Configure the column:
   • Name: Column identifier
   • Content: Field, static value, or template
   • Format: Number or text formatting

Dynamic Values with Templates

Use {{field}} syntax to insert dynamic values:

Field Selector

Click "Insert Field" to browse available fields:

ORD Preview

The right panel shows a live preview of your ORD file:

• Updates in real-time as you configure
• Shows actual field values with sample data
• Color-coded sections for easy reading
• Copy preview content for testing

Saving Your ORD Export

1. Click the purple "Save ORD Config" button
2. Configuration saves to the product
3. Toast notification confirms save
4. Close the builder

Undo / Redo

Both builders support undo and redo:

Changes are tracked in history, so you can step back through modifications.

Tips and Best Practices

CSV Export Tips

1. Match your CNC format: Configure columns in the exact order your machine expects
2. Use consistent units: Stick with decimals or fractions throughout
3. Include identifiers: Add order number or item index for traceability
4. Preview first: Always check the preview before saving

ORD Export Tips

1. Map required fields: Cabinet Vision needs Width, Height, Depth at minimum
2. Use correct keys: ORD field names must match Cabinet Vision's expectations
3. Test imports: Import a sample file into Cabinet Vision to verify
4. Check formatting: Numbers should be numbers, strings should be quoted

General Tips

1. Name exports clearly: "Panel Saw Export" is better than "Export 1"
2. One purpose per export: Create separate exports for different machines
3. Test with real orders: Verify exports work with actual production data
4. Keep it simple: Only include fields you actually need

Keyboard Shortcuts

Related Documentation

• Product Exports — Configure exports on products
• Exporting Order Data — Download exports from orders
• Build Sheet Builder — Visual production documents
• Formula Builder — Create calculations