Embedded Files
To fix a repeat issue, do the following
To fix a repeat issue, do the following
- Stop Immediately
As soon as the error occurs, do not interact with Revit any further (do not click or press any keys).
Document the Time
Document the Time
Write down the exact time the error occurred (to the minute). This is critical for identifying the issue in the journal file.
Exit Revit Safely
Exit Revit Safely
Close out of Revit by ending the process in Task Manager to avoid writing additional data to the journal file.
Locate the Journal File
Locate the Journal File
Navigate to the following folder:
C:\Users\%USERNAME%\AppData\Local\Autodesk\Revit\Autodesk Revit 2024\Journals
Send the Journal File
Send the Journal File
Locate the journal file that matches the timestamp of the error and send it to the Design Technology team.
Mention the time of error in your message so the issue can be pinpointed quickly.
Note:
Note:
For the future, ensure Revit and all related Autodesk software are fully updated.
Autodesk will typically not provide support if your software is not up to date.
2. Prepare to record the error next time it happens, Clear Local Data
2. Prepare to record the error next time it happens, Clear Local Data
Clean out old stuff
Clean out old stuff
Run `DeleteLocals.exe`, copy from the following path: `T:\Support\Apps\DeleteLocals.exe` to your desktop.
Ensure that the folder `C:\Autodesk\DiagnosticData` does not exist. If it does, delete it.
Perform a disk cleanup:
Perform a disk cleanup:
Open the Start menu, type `Disk Cleanup`, and select the Disk Cleanup app.
Choose the drive you want to clean up (usually C:).
Select the file types to delete (e.g., Temporary files, System cache) and click OK.
Confirm the deletion by clicking on "Delete Files".
Update your software
Update your software
Open Autodesk Access.
Navigate to the "Updates" section.
Check for any available updates for Revit or other Autodesk software.
Click "Update" to install any pending updates.
Be sure to also install the latest version up Desktop Connector, https://help.autodesk.com/desktopconnectorupdate
- Provided you previously did step 1 BEFORE the current error, Collect Data
Initial Documentation
Initial Documentation
Note the exact time the issue occurred.
Record the current view, sheet, and task being performed when the issue arose.
Collect the data
Collect the data
Copy the file `Collector v1.9m.bat` from `T:\Support\Apps\Troubleshooting\Revit_Issue_DataCollector\2024\Collector v1.9m.bat` to your desktop.
Launch the `.bat` file and wait for it to complete before doing any other work on the computer.
Send Diagnostic Data
Send Diagnostic Data
Locate the zip file `userData_20XX_Name_DayDate.zip` in `C:\Autodesk\DiagnosticData`.
Copy the zip file and send it to the BIM Manager.
Save and Send the Affected File
Save and Send the Affected File
Before making any further edits, perform a 'Save As' on the Revit file from which the error occurred.
Send the newly saved file to the BIM Manager.
View Visibility Issue
View Visibility Issue
Expand this list below of common Issues with Visibility and Graphic Display
One tool to aid in the discovery process of view graphics is the Default View Template. This is a view template of an out-of-the-box unmodified floor plan. By applying this View Template you can discover if it is a view-based override or something else.
Click the arrow to the right to expand on how to find visibility issues
The element or category is temporarily hidden
The element or category is hidden in the view
When turning on everything in Visibility Graphics,
Check, Which model categories in this view
Filter list: <show all>
Expand All
All
Uncheck all, then Check all while fully expanded.
The element is being obscured by another element
The element’s category or subcategory is hidden in the view
The element is outside the view’s view range
The view’s far clip depth is not sufficient to show the element
The element resides on a work set that is not loaded within the project
The element resides on a work set that is not visible in the view
The element resides on a work set that is not loaded in a linked file
The element resides on a work set that is not visible in a linked file
The element resides within a group (detail model) and it has been excluded from the group
The element is part of a design option that is not visible in the view
The element is part of a linked file that is not visible in the view
The element has one or more of its edges overridden to display as “Invisible Lines”
The element is a family and none of its geometry is set to be visible in the view type
The element is a family and none of its geometry is set to be visible at the view’s detail level
The element is set to not be visible at the category’s detail level
The element has been placed outside the view's crop region (visible extents)
The element is an annotation element and does not reside entirely within the annotation crop region
The element’s phase settings or the view’s phase settings prevent the element from displaying in the view
The view’s discipline is prohibiting the visibility of the element
The element is affected by a filter applied to the view
The element is subject to an element override, set to background color
The element is subject to a category override, set to background color
The element style is set to background color
The element is constrained to a scope boxes that is not visible in the view
The extents of the element itself don’t permit it to be seen
The element is a mass, and “Show Mass” is turned off
The element’s host view has been deleted (area boundaries)
The view’s scale is prohibiting the element’s visibility, "Hide at scales coarser than"
The element is a linked instance with coordinates too great for Revit to handle
The user has incorrectly identified the link instance to which the element belongs
The element is in a link that is not in its correct position
Credit: David Haynes via website and internally for Nick Ray for providing it for this page
RVT Cleaning
RVT Cleaning
Remove the chance of errors with good housekeeping!
Below is a list of how to deep clean a Revit file.
Click the arrow to the right to expand on how to clean a file
Revit File Cleanup Procedure
Revit File Cleanup Procedure
- Begin with .rvt files that contain linked files and annotated sheets:
Process source files last to identify 'Linked Views' within .rvt files that include linked models and annotated sheets.
This step is essential to ensure that the views you plan to delete do not interfere with the linked models and annotations in these files.
- File Preparation
Ensure all .rvt files in the project are published before continuing
Open the Revit file.
Perform an Audit on open (File > Audit) if opened from file explorer locally.
Remember before syncing the file, always check Compact Central Model (slow)
- Organize Views
Place all essential views onto sheets
In the Project Browser, right-click 'Views'
Select 'Browser Organization'
In the 'Views' tab, filter by 'not on sheets' and click OK
This action displays all unplaced views in the Project Browser
- Identify Linked Views Not On Sheets
For each view not on a sheet:
Open the view
Check Visibility Graphics (VG)
Navigate to Revit Links > Display Settings
Look for any links set to 'By Linked View'. Expand the link to check individual instances for 'By Linked View'.
If the links are greyed out, then there is a view template assigned to the view.
On a note pad, write down the name of each by linked view and the file it belongs to. This will be useful later when deleting views out of the source files.
If a view not on a sheet is set to "By Linked View" Append " - ByLinkedView" to the 'View Name' parameter
Example: "Floor Plan Level 1" becomes "Floor Plan Level 1 - ByLinkedView"
This renaming allows for easy identification of linked views
Delete all views not on sheets without the "- ByLinkedView" suffix
Exception: DO NOT delete Parent Views or the starting view
If you have a dependent view not on a sheet, check with your project manager before deletion.
- Identify Linked Views On Sheets
Now that the views not on sheets that are set to 'By Linked View' are deleted, reset the 'Browser Organization' in the 'Views' tab to all.
Open each view
Check Visibility Graphics (VG)
Navigate to Revit Links > Display Settings
Look for any links set to 'By Linked View'. Expand the link to check individual instances for 'By Linked View'.
If the links are greyed out, then there is a view template assigned to the view.
On a note pad, write down the name of each by linked view and the file it belongs to. This will be useful later when deleting views out of the source files.
Append " - ByLinkedView" to the 'View Name' parameter
Example: "Floor Plan Level 1" becomes "Floor Plan Level 1 - ByLinkedView"
This renaming allows for easy identification of linked views
Note: 'View Name' is hidden when 'Title on Sheet' is populated
If 'Title on Sheet' is empty, move View Name to 'Title on Sheet' and then append - ByLinkedView to 'View Name'. You do this so that the - ByLinkedView suffix is not shown on the printed sheet.
- Source File Cleanup
When deleting views in a source file, use the view list you made from the notepad to ensure the views you are deleting are not interfering with the file containing the links (DO NOT delete views from a source file that are written down on the note pad.
- File Optimization
Purge Unused Elements (Manage tab > Purge Unused) multiple times until 'Number of items checked' and 'Additional number of Imported Categories to purge' equal 0
Review and confirm elements to be purged
AT THIS POINT, MOVE ON TO THE NEXT FILE TO REPEAT STEPS 1-7. ONCE STEPS 1-7 ARE COMPLETE FOR EACH FILE, MOVE ON TO ADDITIONAL CLEANUP METHODS AS NEEDED.
- AutoCAD Cleanup (if applicable)
For AutoCAD .dwg cleanup, refer to the "AutoCAD to Revit .dwg cleanup" guide
Check with project manager before spending time to clean AutoCAD linked and imports to see if they can be deleted if they are not needed.
- py Revit checks
Open pyRevit in the Revit file.
In the 'Family' dropdown under the 'Project' tab, run the 'Family Quick Check'
Make necessary changes to resolve any family error.
Optional/ and perhaps not recommended at this time
In pyRevit under the 'Project' tab, click 'Preflight Checks'.
Run the 'Model Checker', 'RVTLinks warnings', 'Reference Plan Lister', and 'Schedules not on sheet lister' to check file quality.
Make necessary changes as you see fit per the pyRevit data.
- Removing Unnecessary Items
Remove unnecessary design options and phases
Delete unplaced rooms and areas as well as unbounded areas
At any time when working on a project, you can review a list of warning messages to find issues that might require review and resolution.
Click 'Manage' tab 'Inquiry' panel (Review Warnings).
Note: This tool is not enabled if there are no warning messages.
Click the arrow buttons as needed to scroll through the list of warning messages.
Click OK to close the list.
If errors are more than 2 in a single file, move on to next step and revisit later.
- Repeat for Base Files
Apply steps 1-10 to all base files in the project
Verify each Revit file has the same shared parameter and keynote files associated. Also make sure the shared parameter and keynote file are located in the ACC project.
- Documentation
Record any significant changes or decisions made during the cleanup process
Note any views or elements that required special handling
- Performance Check
Open and navigate through the cleaned file to ensure improved performance
Compare file size before and after cleanup
- Notes for Manager
Add a comment to each sync and let everyone in the file know to reload latest and sync to help track any errors in the cleanup process.
TESTING FOR FUTURE USE
TESTING FOR FUTURE USE
TEST TO SEE IF YOU NEED TO RE LINK REVIT FILES WHEN SAVING AS
Google Sites
Report abuse