Export Validation and Requirements
The export system validates your project data and provides feedback on what needs to be completed before generating export files.
How validation works
Section titled “How validation works”Validation occurs automatically as you work on your project. The system checks for completeness across all export requirements and displays errors that prevent export.
Validation locations
Section titled “Validation locations”Export Button:
- Located in top-right of Details Panel
- Becomes disabled when validation errors exist
- Tooltip explains what needs to be fixed
Export Tab:
- Alert banners at the top show validation issues
- Different colors indicate severity (red for errors, yellow for warnings)
- Each banner explains the specific issue
Export button status
Section titled “Export button status”The Export button reflects the current validation state of your project.
Disabled state
Section titled “Disabled state”Button is grayed out and not clickable when:
- Critical validation errors exist
- Required data is missing
- Project has unsaved changes
- You are offline
To enable export:
- Hover over the disabled button to see the validation tooltip
- Read the list of required fixes
- Address each validation error
- Button becomes active once all errors are resolved
Enabled state
Section titled “Enabled state”Button is active and clickable when all validation requirements are met.
To export:
- Click the Export button
- System generates XML file
- Download begins automatically
Validation categories
Section titled “Validation categories”The system checks several categories of data before allowing export.
Material assignment validation
Section titled “Material assignment validation”Requirement: All building elements with heat loss must have materials assigned.
Error Message: All building elements with heat loss must have a material
How to Fix:
- Navigate to the Details Panel
- Click through elements in the 3D viewer or hierarchy
- Assign materials to any elements showing as incomplete
- Use bulk material assignment for faster completion
Template selection validation
Section titled “Template selection validation”Requirement: An Energy10 Template must be selected for the export.
Error Message: Energy10 template must be selected
How to Fix:
- Open the Materials group and select Confirm that the thermal envelope is correct
- Scroll to the Template section at the top
- Select a template from the dropdown
- Template selection is saved automatically
Notes completion validation
Section titled “Notes completion validation”Requirement: All notes must be marked as completed (iOS only).
Error Message: “All tasks must be completed”
How to Fix:
- This validation applies to notes created in the iOS app
- Open the project in iOS
- Review and complete any outstanding notes
- Upload the updated project to web
Unsaved changes validation
Section titled “Unsaved changes validation”Requirement: All changes must be saved before export.
Error Message: “You have unsaved changes”
How to Fix:
- Click the Save button in the top toolbar
- Wait for save confirmation
- Export button becomes enabled once save completes
Offline validation
Section titled “Offline validation”Requirement: Internet connection required for saving before export.
Error Message: You are offline and cannot save data. Please check your internet connection and try again.
How to Fix:
- Check your internet connection
- Reconnect to the network
- Refresh the page if needed
- Export button becomes enabled once online
Validation warnings
Section titled “Validation warnings”Some validation issues are warnings rather than errors. These display as yellow alert banners in the Export tab but do not prevent export.
Missing material proposals
Section titled “Missing material proposals”Warning: The following materials have proposals available, but no proposal is selected:
What it means:
- Some materials have available proposals
- No proposal is selected for those materials
- Export can proceed, but proposals provide additional detail
Recommended Action:
- Review the list of materials in the warning
- Open the Materials group and select Confirm that the thermal envelope is correct
- Expand rows for those materials in the building elements tables
- Consider selecting a Proposals for more detailed construction information
Unassigned materials
Section titled “Unassigned materials”Warning: The following materials are not assigned:
What it means:
- Materials in your shortlist haven’t been used
- This is informational only
- Export can proceed normally
Recommended Action:
- Review if any shortlisted materials should be assigned
- No action required if intentional
Validation workflow
Section titled “Validation workflow”Step 1: check export button
Section titled “Step 1: check export button”- Look at the Export button in the Details Panel
- If enabled (clickable), you can export
- If disabled (grayed out), hover to see requirements
Step 2: review validation errors
Section titled “Step 2: review validation errors”- Open the Export tab in Details Panel
- Read alert banners at the top
- Each banner explains a specific validation issue
- Red banners are errors that block export
- Yellow banners are warnings that don’t block export
Step 3: fix critical errors
Section titled “Step 3: fix critical errors”Address each error:
Missing Materials:
- Assign materials to all building elements
- Use Details Panel or bulk assignment
Missing Template:
- Select template on the Preview of Energy10 screen
- Choose from available options
Unsaved Changes:
- Click Save button
- Wait for confirmation
Offline:
- Restore internet connection
- Refresh page
Step 4: verify export readiness
Section titled “Step 4: verify export readiness”- Return to Export button
- Confirm it’s enabled
- Tooltip should no longer show errors
- All red alert banners should be resolved
Step 5: export
Section titled “Step 5: export”- Click the enabled Export button
- Wait for file generation
- Download XML file automatically
Export data tables
Section titled “Export data tables”The Export tab contains several data tables showing your building information. While these don’t have individual validation indicators, the data they contain is validated as part of the overall export requirements.
Building elements tables
Section titled “Building elements tables”Walls, Floors, and Ceilings:
- Groups elements by material
- Shows area, U-value, orientation
- Allows Proposals selection
Doors and Windows:
- Groups openings by material
- Shows area, U-value, orientation
- Allows Proposals selection
Linear Thermal Loss:
- Shows thermal bridge lengths
- Groups by type
- Displays LT, B, and heat loss values
Area calculation tables
Section titled “Area calculation tables”BBR Areas:
- Shows calculated area rows by type
- Shows Floor area, BBR area, and Difference
Measured Areas Summary:
Troubleshooting validation
Section titled “Troubleshooting validation”Export button won’t enable
Section titled “Export button won’t enable”If all errors appear fixed but export is still disabled:
- Check for alert banners in Export tab
- Scroll through all sections
- Verify no red banners remain
- Try refreshing the page
- Go online
Can’t find validation error
Section titled “Can’t find validation error”If an error is mentioned but you can’t locate the problem:
- Review each alert banner carefully
- Check Details Panel for elements without materials
- Use the hierarchy to systematically check each story/room
- Look for elements with missing properties
Validation doesn’t update
Section titled “Validation doesn’t update”If you fixed an error but validation still shows it:
- Confirm changes were saved
- Click Save button if needed
- Refresh the Export tab
- Close and reopen Details Panel
- Refresh the entire page if needed
Export fails after passing validation
Section titled “Export fails after passing validation”If export button is enabled but export generation fails:
- Check browser console for errors
- Verify internet connection is stable
- Try exporting again
- Check if you were disconnected during export
- Contact support if issue persists with error details
Related information
Section titled “Related information”All building data is created in the iOS app or edited in the web interface. The Export tab provides a comprehensive view of your project data organized for thermal envelope export. Export format is XML following the Energy Performance Certificate standard required for energy calculations.