Batch Editing

Batch editing allows you to modify multiple elements simultaneously, saving time when making bulk changes.

Overview

Use batch editing when you need to:

• Update the same field across many elements
• Apply a consistent value to a selection
• Quickly correct data entry errors

Selecting Elements

Before batch editing, select the elements you want to modify:

Selection Methods

Method	Action
Single Click	Select one element
Ctrl + Click	Add/remove from selection
Shift + Click	Select range
Ctrl + A	Select all visible
Checkbox Column	Click row checkboxes

Selection Indicators

• Selected rows are highlighted
• The status bar shows selection count
• The batch edit button becomes available

Opening the Batch Editor

1. Select two or more elements
2. Click the Batch Edit button in the toolbar
3. Or use the keyboard shortcut: Ctrl + Shift + E

The batch edit dialog opens showing your selection.

Screenshot Placeholder

TODO: Add screenshot of DataGrid batch edit dialog

Batch edit dialog showing field selector dropdown, value editor, current values preview for selected elements, and Apply to All button

Using the Batch Editor

1. Choose a Field

Select the field you want to edit from the dropdown:

Core Fields: - Name - Category - Status - Description - Object Type - IFC Class

Property Fields: Grouped by property set (e.g., Pset_Common, Custom_Properties)

2. Enter New Value

The editor type matches the field:

Field Type	Editor
Text	Text input
Number	Number input with controls
Boolean	Checkbox toggle
Date	Date picker
DateTime	Date and time picker
Select	Dropdown with options

3. Review Current Values

The dialog shows current values for the first 5 selected elements:

Element 1       Wall-001
Element 2       Wall-002
Element 3       Wall-003
... and 7 more

This helps you verify you're editing the right elements.

4. Apply Changes

Click Apply to All to update all selected elements.

Results and Feedback

After applying:

• A success message shows how many elements were updated
• If some updates fail, a warning lists the failures
• The dialog closes automatically on complete success
• For partial failures, review errors before closing

Field Types

Text Fields

• Enter any text value
• Existing value is replaced
• Empty value clears the field

Number Fields

• Enter numeric values
• Use +/- buttons or type directly
• Supports decimals based on field definition

Boolean Fields

• Toggle checkbox to True or False
• All selected elements receive the same value

Date Fields

• Click calendar to select date
• Format follows project settings
• Clear to remove date value

DateTime Fields

• Select both date and time
• Uses 24-hour or 12-hour based on locale

Select Fields

• Choose from predefined options
• Some fields allow clearing (null value)
• Multi-select fields show checkboxes

Property Fields

Property fields follow the pattern: PropertySet > PropertyName

When editing property fields:

1. The field is identified by property set and name
2. Value is validated against the property definition
3. Only the specified property is updated (others unchanged)

Property Paths

A field like Pset_Common > Reference updates only the Reference property within the Pset_Common property set.

Best Practices

Before Editing

• Double-check your selection
• Verify the current values shown
• Consider if batch edit is appropriate

Large Selections

• Batch edits on 100+ elements may take longer
• Wait for the operation to complete
• Check the results summary

Validation

• Some fields have validation rules
• Invalid values may cause individual failures
• Review errors and correct as needed

Troubleshooting

"Apply to All" is Disabled

• Ensure elements are selected
• Choose a field from the dropdown
• Check for any validation errors

Partial Failures

Some elements may fail to update due to:

• Permission restrictions
• Validation rules
• Locked elements
• Network issues

Review the error messages for specifics.

Changes Not Visible

After batch edit:

• Refresh the grid if needed
• Clear filters that might hide updated elements
• Check if the value actually changed

Performance Issues

For very large batches:

• Consider editing in smaller groups
• Check network connectivity
• Wait for background processing

Canceling

Click Cancel to close the dialog without making changes.

Warning

Once applied, batch edits cannot be undone in bulk. Each element's change is logged in its individual history.