140 List Elements in Views

Table of Contents

• Key Features
• Requirements
• Interface Guide
• Output Format
• Step-by-Step Guide
• Example Workflows
• Tips and Best Practices
• Common Use Cases
• Troubleshooting

Key Features

• Comprehensive Element Counting: Analyzes all non-hidden elements in selected views by category
• Multi-View Processing: Process multiple views simultaneously for efficient batch analysis
• Flexible Selection: Filter and select views using built-in grid filtering capabilities
• Multiple Export Formats: Export results to CSV or Excel for further analysis
• View Context Information: Includes view names, sheet numbers, and sheet names in output
• JSON Backup: Automatically creates a JSON backup file alongside CSV export
• Automatic Opening: Exported file opens automatically in the default application
• Progress Tracking: Real-time progress indicator during processing
• Template Exclusion: Automatically skips view templates to focus on actual views

Requirements

Essential Components

1. Valid Bonus Tools License: Active license key required
2. Revit Project: Open project with views to analyze
3. Views with Elements: At least one view containing visible elements
4. Write Permissions: Ability to save files to local drive

Recommended Setup

• Clean Views: Ensure view templates are properly applied
• Updated Graphics: Views should have graphics regenerated
• Typical Scale: Views at appropriate scale for element visibility
• Categories Enabled: Required categories turned on in view properties

Interface Guide

Main Grid

The grid displays all available views in the project with the following columns:

Columns:

• Id: Unique element ID of the view
• View Name: Name of the view as shown in project browser
• View Type: Type of view (Floor Plan, Section, Elevation, 3D View, etc.)
• Select: Checkbox to include/exclude view from processing

Grid Features:

• Filtering: Click column headers to filter views
• Sorting: Click column headers to sort ascending/descending
• Multi-Select: Select multiple rows for bulk operations
• Row Indexing: Shows row numbers for easy reference

Control Buttons

Selection Controls:

• Select Selected: Toggle selection state of highlighted rows
• Select All: Select all visible (non-filtered) views
• Select None: Deselect all views
• Reset Filters: Clear all column filters to show all views

Export Options:

• CSV: Export grid view to CSV format (for quick viewing)
• Excel: Export grid view to Excel format (for advanced filtering)
• Ok: Process selected views and export element inventory

Additional Controls:

• About: Display version and license information
• Close: Exit the tool (also: ESC key)
• Help: Access online help documentation (? button)

Status Indicators

Total Selected: Shows count of views selected for processing Total Views: Shows total number of views in grid (after filtering)

Output Format

CSV File Structure

The exported CSV contains one row per view with the following columns:

Metadata Columns:

• ID: View element ID
• View Name: Name of the view
• Sheet Number: Sheet number if view is placed on a sheet (or "NA")
• Sheet Name: Sheet name if view is placed on a sheet (or "NA")

Category Columns: Dynamic columns created for each category found, showing element counts:

• Walls
• Doors
• Windows
• Furniture
• Generic Models
• Text Notes
• Dimensions
• Detail Items
• [Any other categories present in views]

Example Output:

ID,View Name,Sheet Number,Sheet Name,Walls,Doors,Windows,Furniture,Text Notes,Dimensions
123456,Level 1 Floor Plan,A101,Floor Plans,145,23,18,42,67,89
234567,Building Section 1,A201,Sections,78,12,8,0,34,45

JSON Backup File

A .txt file containing JSON data is automatically created with the same name as the CSV file:

• Contains complete structured data
• Useful for data recovery or programmatic processing
• Includes all metadata and category counts
• Formatted with indentation for readability

Step-by-Step Guide

Basic Workflow

1. Launch the Tool

   • Go to Bonus Tools ribbon
   • Click "140 List Elements in Views"
   • Wait for the view list to load

2. Select Views to Analyze

   • Review the view list
   • Use checkboxes or selection buttons to choose views
   • Apply filters if needed to narrow down views

3. Process and Export

   • Click "Ok" to begin processing
   • Monitor the progress bar
   • Choose save location when prompted
   • Review the automatically opened CSV file

Advanced Selection Techniques

Using Filters:

1. Click the filter icon in any column header
2. Enter filter criteria:
   • Text contains: "Level 1"
   • View Type equals: "Floor Plan"
   • Multiple conditions with AND/OR logic
3. Click "Select All" to select filtered results

Bulk Selection:

1. Use "Select All" for all visible views
2. Hold Ctrl and click specific rows to add/remove
3. Use "Select Selected" to toggle highlighted rows
4. Use "Select None" to start fresh

Processing Views

During Processing:

• Progress bar shows current view being processed
• Status shows "X of Y" views completed
• Cancel option available if needed
• Processing may take time for views with many elements

After Processing:

• Save dialog appears automatically
• Choose location and filename
• CSV opens in default application (Excel, Notepad, etc.)
• JSON backup saved to same location

Example Workflows

Workflow 1: Coordination Review Inventory

Goal: Generate element inventory for all coordination views before a design review meeting

Steps:

1. Launch tool and wait for view list
2. Filter View Type column to show only:
   • Floor Plans
   • Sections
   • Elevations
3. Click "Select All" (selects filtered views)
4. Click "Ok" to process
5. Save as "CoordinationInventory[Date].csv"
6. Review in Excel:
   • Sort by element counts
   • Identify views with missing content
   • Check for consistency across views

Key Metrics to Review:

• Views with zero elements (empty views)
• Inconsistent element counts across similar views
• Missing categories in coordination views
• Views with unusually high element counts

Workflow 2: Sheet-Based Content Audit

Goal: Verify all sheet views contain appropriate content before issuing

Steps:

1. Open the tool
2. Filter to show only views with Sheet Numbers
3. Select all filtered views
4. Process and export
5. In Excel:
   • Filter for views with Sheet Number ≠ "NA"
   • Create pivot table by Sheet Number
   • Sum elements by category per sheet
   • Identify sheets missing critical categories

Quality Checks:

• All architectural sheets have dimensions
• All sheets have title blocks (if included)
• Sections have appropriate detail elements
• Plans have all required annotation categories

Workflow 3: View Template Compliance Check

Goal: Ensure similar views have consistent element visibility

Steps:

1. Launch tool
2. Filter View Name to show related views:
   • Example: All views with "Level" in name
3. Select filtered views
4. Export element inventory
5. Compare element counts across views:
   • Views at same scale should have similar counts
   • Identify outliers for review
   • Check for missing or extra categories

Analysis in Excel:

• Create comparison table by view type
• Calculate average elements per category
• Highlight views outside ±20% of average
• Review template assignments for outliers

Workflow 4: Model Progression Tracking

Goal: Track model development over time for specific view sets

Steps:

1. Create view filter for project milestone views
2. Run tool monthly on same view set
3. Save with date stamp: "Elements_2026-01-27.csv"
4. Compare month-over-month:
   • Track element count growth
   • Monitor specific categories
   • Identify rapid changes for review

Tracking Metrics:

• Total elements trend line
• Category-specific growth rates
• Views with declining element counts
• New categories appearing

Workflow 5: Discipline Coordination

Goal: Prepare element inventory for coordination meetings

Steps:

1. Filter views to show only coordination views
2. Select architecture views vs. structural views separately
3. Export separate inventories:
   • "Arch_Elements.csv"
   • "Struct_Elements.csv"
4. Compare in coordination meeting:
   • Identify overlapping elements
   • Check for missing coordination elements
   • Verify visibility settings

Tips and Best Practices

Selection Best Practices

Use Filtering Effectively:

• Start broad, then refine filters
• Combine multiple column filters for precise selection
• Reset filters between different analysis tasks
• Save time by selecting "all filtered" instead of manual selection

Strategic View Selection:

• Exclude view templates (automatically done by tool)
• Include only views that are actively used
• Group similar views for consistent analysis
• Consider view scale when interpreting results

Performance Optimization

For Large Projects:

• Process views in batches rather than all at once
• Close unnecessary applications to free memory
• Process during off-peak hours if possible
• Consider processing by discipline or level

Speed Tips:

• Deselect 3D views if not needed (they process slower)
• Skip duplicate views (same content, different names)
• Process detail views separately from model views
• Use filtered selections to reduce processing time

Data Analysis Tips

In Excel:

• Use pivot tables for quick summaries
• Create charts to visualize element distribution
• Compare against project standards/benchmarks
• Use conditional formatting to highlight outliers

Quality Indicators:

• Zero element counts = potential empty or hidden views
• Very high counts = check for duplicate elements
• Missing categories = verify view template settings
• Inconsistent counts = review similar views

File Management

Naming Conventions:

• Include date: "ElementInventory_2026-01-27.csv"
• Include phase: "ElementInventory_CD_Phase.csv"
• Include scope: "ElementInventory_Level01.csv"
• Keep JSON backup for data recovery

Organization:

• Create dedicated folder for element inventories
• Archive historical exports for comparison
• Share with team via shared drive or BIM 360
• Include in QA/QC documentation packages

Common Use Cases

Quality Assurance

Empty View Detection:

• Export all sheet views
• Filter for views with zero total elements
• Review why views are empty
• Remove from sheets or populate with content

Content Consistency:

• Compare similar view types
• Ensure consistent category visibility
• Verify view template application
• Check for missing standard elements

Project Documentation

As-Built Documentation:

• Export final element inventory
• Include in project closeout package
• Provide baseline for future renovations
• Document what's included in each drawing

Milestone Deliverables:

• Export at each design phase
• Track element count growth
• Document model development
• Provide to client as progress metric

Coordination

Multi-Discipline:

• Export by discipline
• Compare overlapping views
• Identify missing coordination elements
• Verify visibility across disciplines

Clash Detection Preparation:

• Identify high-density areas
• Prioritize coordination views
• Verify element presence before clash tests
• Document baseline element counts

Performance Analysis

Model Bloat Detection:

• Compare element counts over time
• Identify views with excessive elements
• Find opportunities for optimization
• Track purge effectiveness

View Performance:

• Correlate element counts with regeneration time
• Identify problem views
• Optimize high-element-count views
• Balance detail level with performance

Troubleshooting

Common Issues

Problem: "No views appear in the grid"

• Cause: Project has no views or only templates
• Solution:
  • Check project browser for views
  • Verify you're in a project file (not family)
  • Ensure views aren't deleted
  • Check if all views are filtered out

Problem: "Views show zero elements but they're not empty"

• Cause: Elements are hidden in the view
• Solution:
  • Check view visibility settings
  • Verify view template isn't hiding categories
  • Turn on hidden element display temporarily
  • Check element workset visibility
  • Note: Tool only counts visible, non-hidden elements

Problem: "Processing is very slow"

• Cause: Large views or many selected views
• Solution:
  • Process views in smaller batches
  • Exclude 3D views (they process slower)
  • Close other applications
  • Check if Revit is generating graphics
  • Consider processing overnight for very large projects

Problem: "Export fails or CSV won't open"

• Cause: File permissions or path issues
• Solution:
  • Choose different save location
  • Close file if already open in Excel
  • Check write permissions on folder
  • Avoid special characters in filename
  • Ensure sufficient disk space

Problem: "Sheet Number shows 'NA' for views on sheets"

• Cause: View not actually placed on sheet or parameter issue
• Solution:
  • Verify view is placed on a sheet
  • Check sheet number is populated
  • Ensure view is current (not outdated viewport)
  • Try selecting view on sheet to verify

Problem: "Categories are missing from output"

• Cause: Categories are hidden or have zero elements
• Solution:
  • Only categories with at least one element appear
  • Check view visibility settings
  • Verify category isn't turned off in view
  • This is expected behavior - empty categories don't create columns

Problem: "Special characters appear garbled in output"

• Cause: View names contain unsupported characters
• Solution:
  • Tool automatically removes: ¬, ", "Fin"
  • Open CSV in Excel (not Notepad) for proper encoding
  • Use UTF-8 encoding if opening in other programs
  • Rename views to avoid special characters if persistent

Performance Issues

Slow Loading:

• Large projects may take 1-2 minutes to load view list
• Progress bar shown during load
• Be patient, especially for 1000+ view projects

High Memory Usage:

• Processing many complex views uses significant memory
• Close unnecessary applications
• Process in batches if memory limited
• Consider workstation upgrade for very large projects

Canceled Processing:

• Use Cancel button in progress dialog if needed
• Partial results are not saved
• Must start over if canceled
• Save progress by processing in batches

Data Quality Issues

Inconsistent Counts:

• Element counts reflect current visibility settings
• Views with different templates show different counts
• Hidden elements don't count
• Workset visibility affects counts

Missing Views:

• View templates automatically excluded
• System views excluded
• Only model views included
• Schedule views excluded

Export Issues

Cannot Save File:

• Check folder permissions
• Close file if open in another program
• Choose different location
• Avoid network drives if slow/unreliable

CSV Format Issues:

• Open in Excel for best compatibility
• Use "Import Data" in Excel if format issues
• JSON backup available if CSV problematic
• Contact support if persistent issues

Need Help? Contact support or refer to additional Bonus Tools documentation.

Thank you for using Bonus Tools - 140 List Elements in Views!