Repairing data shortcuts and data references
Last updated: 2021-09-03
The following topics describe situations where the relationship between a Civil 3D object and the data shortcut has changed or data references have been broken and need to be repaired. The solutions to these situations are listed below.
Warning: It is generally recommended that civil objects and files are NOT renamed or moved after they have been data referenced in other files during the design and plans production process.
Term | Definition |
---|---|
Data Shortcut | A data shortcut is the mechanism used to create a data reference. The data shortcuts are listed at the bottom in the Civil 3D Toolspace Prospector. |
Data Reference | A data reference is the actual object reference connection between the host and source drawings. Once a data reference is created, the data shortcut no longer needs to exist for the data reference to be valid. (Think of it like a shortcut on your desktop. You can delete the shortcut, but the application that it pointed to will still work.) |
Civil Object | In the scope of this topic, this refers to an object that could have a data shortcut and/or data reference created for it. There are some Civil 3D-specific objects that cannot have data shortcuts/data references, but for this topic, we will focus on items found in Toolspace > Prospector > Data Shortcuts |
Validate and repair data shortcuts #validate
Info: All data shortcuts and data references should be fully functional prior to a project migration effort to a new version of Civil 3D.
All data shortcuts must by synchronized and working properly to create new data references in consuming files.
- Ensure all project files are closed. This may require communication with the entire project team
- Toolspace > Prospector tab > Right-click Data Shortcuts > Set Data Shortcuts Project Folder.. to view all available data shortcuts for a project.
- Toolspace > Prospector tab > right-click Data Shortcuts > Validate Data Shortcuts
- Expand the entire Data Shortcut tree for each object, and search for any exclamation symbols
-
Use the right click menu to Remove or Repair Broken Shortcuts
- An additional dialog box may prompt to Repair All Broken Shortcuts
- YES
- This may repair the rest of the broken Shortcuts in the project depending on the data shortcut issue.
- Search for any more Exclamation symbols in the Data Shortcut tree in the Prospector tab
-
Close and reopen Civil 3D to save Data Shortcut edits
Civil 3D also includes a tool to assist users in repairing broken data references within a drawing. Information on how to use the Data Shortcut Manager is published on Autodesk's website.
Civil object is renamed after data shortcut has been created
Scenario
- Data shortcut has already been created
- Civil object has been data referenced into another drawing
- Civil object is now renamed in source file
-
Source Civil 3D file has been saved and closed
Solution
Validate and repair data shortcuts #validate and repair and synchronize broken references in consuming files.
In the file consuming the data reference created by the data shortcut...
-
Manage tab > Data Shortcuts panel > Synchronize References
- Update the reference name
-
The data shortcut name has been updated and synchronized.
-
Save the file.
Test repair
- Select data referenced object in the consuming DWG file
- Right-click > Open Source Drawing
- DWG that contains the data shortcuts source Civil 3D object is opened
Source DWG file is renamed after data shortcut has been created
Scenario
- Data shortcut has already been created
-
DWG that contains the source Civil 3D object is renamed, saved, and closed
Solution
Validate and repair data shortcuts #validate and repair and synchronize broken references in consuming files.
In the file consuming the data reference created by the data shortcut...
-
Toolspace > Prospector tab > Data Shortcuts > Alignments > Centerline Alignments
- Right-click 51 alignment data shortcut > Repair Broken References...
- Browse to the file that contains the Civil object used for the data shortcut
- Open
- Repair all broken references
- Manage tab > Data Shortcuts panel > Synchronize References
-
Save the file
Test repair
- Select data referenced object in the consuming DWG file
- Right-click > Open Source Drawing
- DWG that contains the data shortcuts source Civil 3D object is opened
The civil object is moved to a different source file after the data shortcut has been created #civil-objct-mov
Scenario
- Data shortcut has already been created
- User decides that the source civil object referenced by the data shortcut should be kept and maintained in a different file.
-
Data referenced object is promoted into a new drawing
Solution
Validate and repair data shortcuts #validate and repair and synchronize broken references in consuming files.
In file consuming the data reference..
- Manage tab > Data Shortcuts panel > Manage Data Shortcuts
- Data Shortcut Manager dialog box > Data Shortcuts panel (right side of dialog box)
Source File: Select folder and browse to new file that be the source of the data shortcut
- OK
- Additional broken shortcuts may happen as a result of changing the source file.
Select Repair all broken shortcuts
- Data Shortcut Manager dialog box > Data Shortcuts panel (right side of dialog box)
-
Save the file.
Test repair
- Toolspace > Prospector tab > Data Shortcut
- Check that Data Shortcuts folder is set for the current project
- Right-click Data Shortcuts > Validate Data Shortcuts
- Check for error messages
- Select the data shortcut for the moved object
- The source file name should be correct in the table at the bottom of the Prospector tab
- Open drawing using updated data shortcut
- Select the data referenced object > right-click > Open Source Drawing
An existing data reference needs to point to a different source civil object
Scenario
- Data shortcut has already been created
-
The original civil object no longer exists
Solutions
Validate and repair data shortcuts #validate and...
- If the new source object has the same name and is in the same file - Civil 3D will associate the new source object with the existing data reference.
-
If the new source object has the same name but is in a different file - See The civil object is moved to a different source file after the data shortcut has been created #civil-objct-mov
Test repair
- Select data referenced object in the consuming DWG file
- Right-click > Open Source Drawing
- DWG that contains the data shortcuts source Civil 3D object is opened
Replace drawing objects with data shortcut references
Scenario
- Data shortcut has already been created
- A duplicate object that is not data referenced or an object representing the same design entity exists in a file that is not the source drawing
-
The duplicate entity is to be replaced with a data reference of the source object
Solution
In the file with the duplicate object, replace it with a data shortcut.
-
Manage tab > Data Shortcuts panel > Manage Data Shortcuts
- Additional information on how to use the Data Shortcut Manager is published on Autodesk's website.
Test
- Select data referenced object in the consuming DWG file
- Right-click > Open Source Drawing
- DWG that contains the data shortcuts source Civil 3D object is opened
Replace an existing data reference with a new data shortcut reference
Scenario
- Data reference has already been created for the civil object that will be replaced
-
There is a new source object that has a different name and it is located in a different file
Solution
In consuming files with the incorrect data reference, promote the incorrect data reference to a civil object and replace it with the correct data shortcut.
- Promote the data referenced object in the consuming file
- Rename the civil object in the consuming file to match the name of the new source civil object
- Create a new data shortcut from the new object in the new source file
-
Manage tab > Data Shortcuts panel > Manage Data Shortcuts
- Replace drawing objects with data shortcut references
- Additional information on how to use the Data Shortcut Manager is published on Autodesk's website.
-
Delete the old data shortcut
Test repair
- Select data referenced object in the consuming DWG file
- Right-click > Open Source Drawing
- DWG that contains the data shortcuts source Civil 3D object is opened
A data shortcutted object is deleted but is still needed for the project
Scenario
- The object for a data shortcut is deleted and the source file is then saved.
- The object has been data referenced into another drawing
-
The data shortcut still exists
Solution
- Open a dwg file where the object has been data referenced
- A cached copy of the object still exists within the consuming drawing
- Output tab > Export panel > Export to LandXML
- Export to LandXML dialog box
- Pick from drawing
- Select data shortcutted object that was deleted
- Enter
- OK
- Pick from drawing
- Browse to the desired location and save the LandXML file
- Export to LandXML dialog box
- Close the dwg file
- Open the drawing that will be the source file for the data shortcutted object
- Insert tab > LandXML > browse and select xml file > Open > OK
-
Save and close the file
Test
- Open a dwg file that is using the data shortcut
- Check that the data shortcut is working properly
- If errors or warnings occur - See The civil object is moved to a different source file after the data shortcut has been created #civil-objct-mov.
Verifying and updating data shortcut paths
The Data Shortcuts Editor can be used to re-path Civil 3D data shortcuts from one location to another location. This is important when moving a Civil 3D project from one storage location to another (N drive to C drive for instance).
- Close Civil 3D
- Windows Start > All Programs > Autodesk Civil 3D 20XX - English > Data Shortcuts Editor
- File > Open Data Shortcuts Folder... > C:\Civil 3D Projects\<project folder>\_Shortcuts folder
-
View the data shortcuts in the Editor window. You will notice the path is pointing to the original location of the files. Take note of this folder path only up to and including the project number.
-
Edit > Find and Replace...
- Find and Replace dialog box
- Find = <old folder path> (Example: N:\PDS\C3D\XXXXXXXX)
- Only enter the part of the path up to and including the project number
- Replace with = <new folder path> (Example: C:\Civil 3D Projects\XXXXXXXX)
- Only enter the part of the path up to and including the project number
- Replace All
- Find = <old folder path> (Example: N:\PDS\C3D\XXXXXXXX)
- Find and Replace dialog box
-
Verify the new path is correct in the Editor window.
- Save
- You must click the "Save" button before exiting the Data Shortcuts Editor or you will lose any changes made.
- File > Exit