Welcome to the troubleshooting guide for the ArcGIS GeoBIM Tools. This article aims to provide you with clear and actionable solutions to help identify and resolve issues that you may encounter while synchronizing Autodesk Forma data into ArcGIS GeoBIM.
Note: As of the ArcGIS Online July 2026 update, the Analyze feature was introduced to the ArcGIS GeoBIM Tools page to offer pre-sync analysis capabilities for your Autodesk Forma .dwg, .ifc, and .rvt files. This allows you to identify problematic files in the Pre-sync Analysis Report before starting synchronization operations in ArcGIS GeoBIM. To learn more, see analyze BIM documents.
Therefore, this troubleshooting article is primarily aimed at users working with ArcGIS GeoBIM on Enterprise 12.1 or below.
The ArcGIS GeoBIM Tools page allows you to configure and run geoprocessing tools (Add Document Extents, Add Document Models;12.0 and above only, Add Project Issues, and Add Project Boundaries) for supported file file formats.
After executing the tools in ArcGIS GeoBIM, you may encounter messages such as Job failed or Job succeeded with errors on the History tab. This indicates that there was a problem whilst trying to sync your BIM project data.
If this happens, you can review the results via:
Use this method to quickly identify the files that could not be synced to ArcGIS GeoBIM.
Note: The job failure experience was redesigned for the ArcGIS Online July 2026 update to consolidate all job errors into a dedicated Post-sync Error Report. This report replaces the file errors listed in the View Job Summary window.
To learn more, see job failures.
Complete the following steps:
- Click the History tab on the Tools page.
- Click the View Job Summary (info) icon next to the warning message in the History tab.
- The Job Summary dialog opens.
- Review the files listed in the Job Errors and their associated error message.
- Review the tool log error messages (described later in this article).
Use this method to see a complete log of the geoprocessing job, identify root cause and patterns of failures, as well as audit tool runs over time.
Note: The error report experience was redesigned for the ArcGIS Online July 2026 update to consolidate all job errors into a dedicated Post-sync Error Report. As a result, the zipped error report log is no longer provided.
Complete the following steps:
- Click the History tab on the Tools page.
- Click Download Error Report at the bottom of the History tab.
- The zipped error report is downloaded to your local drive.
- Extract the zip file and open the text file.
- Review the tool log to identify the root cause and/or pattern of failures.
- Review error reports over successive tool runs to audit sync results.
Use this method to monitor all tool jobs and associated metadata.
Complete the following steps:
- Open the ArcGIS GeoBIM Projects homepage.
- Click View Project Details (info) icon on the ArcGIS GeoBIM project card and then click the Feature Service link in the Details pane.
- The feature service item details page opens.
- Scroll down to the Tables section and then click Jobs.
- Once the Jobs page opens, click the Data tab.
- Identify Type messages (error, info, status) across all submitted jobs, plus more field entries.
After reviewing the tool run results through these methods, you should have identified the problematic design files that caused errors during the ArcGIS GeoBIM tool run. Continue reading below to understand the specific tool log errors.
Tool log errors
This section offers guidance and descriptions on common geoprocessing tool errors. Use this information to troubleshoot the specific errors experienced with your Autodesk Forma data.
Error message | Description | Troubleshooting |
|---|
Error creating GIS document | Indicates a problem was encountered when trying to create GIS features of BIM documents. | Ensure your documents are compatible for the sync process. See georeferencing workflows. |
Error syncing document | Indicates a problem was encountered when trying to sync BIM documents from the linked Autodesk projects. | Ensure your documents are compatible for the sync process. See georeferencing workflows. |
Unable to project geometry
| Indicates the Autodesk document contents are out of bounds for the spatial reference used. | Ensure your documents are compatible for the sync process. See georeferencing workflows. |
exception: Job failed! | Indicates the GP service has encountered an issue or error during the job execution which results in the termination of the process. | Contact GeoBIMSupport@esri.com if you are encountering this error. |
exception: User not authorized for this account or project. | Indicates the user does not have the necessary permissions to access the Autodesk account or project. | Verify you have permissions to the Autodesk account and projects included in the GeoBIM project.
Reach out to your Autodesk administrator if you require permission updates.
|
DA job failed | Indicates a failure in the design automation process. | Contact GeoBIMSupport@esri.com if you are encountering this error. |
An unexpected error happened during phase Publishing of job | Indicates there was a problem or failure that occurred while attempting to publish or execute the GP tools. | Contact GeoBIMSupport@esri.com if you are encountering this error. |
Job failed! Failed to create ArcGIS GeoBIM 3D Document Models Service: Expecting value: line 1 column 1 (char 0) | Indicates the GP service encountered an issue or error during the execution of the Add Document Models tool which results in termination of the process. | Double check your configuration of the geoprocessing service configuration file for GeoBIMUtilities |
Job failed! Failed to create ArcGIS GeoBIM 3D Document Models Service: Service name not available | Indicates the GP service has encountered an issue or error during the execution of the Add Document Models tool which results in termination of the process. | If you are using an Organization that has no 3D scene services published (via ArcGIS Pro or by directly uploading a geodatabase) before, the 3D Object Feature Layer creation fails. Add Document Extents tool requires this one-time setup prior to running the tool. To workaround, publish a 3D scene service to your Organization from ArcGIS Pro or upload a file geodatabase. |
If you encountered an error with the ArcGIS GeoBIM geoprocessing tools that is not listed in the table above and you are unsure on next steps, please follow the steps outlined in the Issue not listed? section of the ArcGIS GeoBIM troubleshooting hub.
