acad-database-operations

WblockCloneObjects performs cross-database transfers using an IdMapping to match old-to-new ObjectIds, while DeepCloneObjects copies objects within a single database using symbol-table-aware cloning for layers, blocks, and records.

You can configure DuplicateRecordCloning choices including Ignore, Replace, XrefMangleName, and MangleName to manage name collisions and resolve conflicts during cross-database migration operations.

Consolidate symbol tables across drawings by configuring a source and destination database, then calling WblockCloneObjects with selected object IDs to migrate layers, blocks, and symbol-table records with proper transaction management.

IdMapping is required for cross-database copies to translate IDs and match old-to-new ObjectIds, ensuring references between migrated layers, blocks, and symbol-table records remain intact during WblockCloneObjects operations.

Use DeepCloneObjects to copy objects within a single AutoCAD database, whereas WblockCloneObjects is required for inter-drawing migration and cross-database transfers across side databases and main drawings.

You can use Database.Purge to remove unused records and Database.Audit to repair errors and maintain consistency during side database batch processing, auditing, and safe migration operations.