ArcGIS GeoBIM Tools Fehlerbehebung

Eunan_Gillen

Willkommen zum Fehlerbehebungsleitfaden für die ArcGIS GeoBIM Tools. Dieser Artikel soll Ihnen klare und umsetzbare Lösungen bieten, um Probleme zu identifizieren und zu beheben, die beim Synchronisieren von Autodesk Forma-Daten in ArcGIS GeoBIM auftreten können.

Hinweis: Ab dem ArcGIS Online Juli 2026 Update wurde die AnalyzeFunktion auf der ArcGIS GeoBIM Tools-Seite eingeführt, um Vor-Sync-Analysefunktionen für Ihre Autodesk Forma .dwg-, .ifc- und .rvt-Dateien anzubieten. Dies ermöglicht es Ihnen, problematische Dateien im Pre-sync Analysis Report zu identifizieren, bevor Sie Synchronisationsvorgänge in ArcGIS GeoBIM starten. Weitere Informationen finden Sie unter analyze BIM documents.

Daher richtet sich dieser Fehlerbehebungsartikel hauptsächlich an Benutzer, die mit ArcGIS GeoBIM auf Enterprise 12.1 oder darunter arbeiten.

Die ArcGIS GeoBIM Tools-Seite ermöglicht es Ihnen, Geoverarbeitungswerkzeuge (Add Document Extents, Add Document Models; nur 12.0 und höher, Add Project Issues, und Add Project Boundaries) für unterstützte Dateiformate.

Nach Ausführung der Werkzeuge in ArcGIS GeoBIM können Meldungen wieJob failed oderJob succeeded with errors imHistoryTab erscheinen. Dies zeigt an, dass ein Problem beim Versuch auftrat, Ihre BIM-Projektdaten zu synchronisieren.

Wenn dies passiert, können Sie die Ergebnisse über folgende Methoden überprüfen:

• View Job Summary Fenster

Verwenden Sie diese Methode, um schnell die Dateien zu identifizieren, die nicht mit ArcGIS GeoBIM synchronisiert werden konnten.

Hinweis: Das Job-Fehlererlebnis wurde für das ArcGIS Online Juli 2026 Update neu gestaltet, um alle Jobfehler in einem dedizierten Post-sync Error Report zusammenzufassen. Dieser Bericht ersetzt die im View Job Summary-Fenster aufgeführten Datei-Fehler.

Weitere Informationen finden Sie unter job failures.

Führen Sie die folgenden Schritte aus:

1. Klicken Sie auf den History Tab auf der Tools-Seite.
2. Klicken Sie auf das View Job Summary (Info-)Symbol neben der Warnmeldung im History-Tab.
   1. Der Job Summary-Dialog öffnet sich.
3. Überprüfen Sie die im Bereich Job Errors aufgeführten Dateien und deren zugehörige Fehlermeldungen.
   1. Überprüfen Sie die Fehlermeldungen im Tool-Protokoll (weiter unten in diesem Artikel beschrieben).

• Download Error Report

Verwenden Sie diese Methode, um ein vollständiges Protokoll des Geoverarbeitungsjobs einzusehen, die Ursache und Muster von Fehlern zu identifizieren sowie Tool-Ausführungen über die Zeit zu prüfen.

Hinweis: Das Fehlerberichterlebnis wurde für das ArcGIS Online Juli 2026 Update neu gestaltet, um alle Jobfehler in einem dedizierten Post-sync Error Report. Daher wird das gezippte Fehlerprotokoll nicht mehr bereitgestellt.

Führen Sie die folgenden Schritte aus:

1. Klicken Sie auf den History Tab auf der Tools-Seite.
2. Klicken Sie unten im History-Tab auf Download Error Report.
   1. Das gezippte Fehlerprotokoll wird auf Ihr lokales Laufwerk heruntergeladen.
3. Entpacken Sie die Zip-Datei und öffnen Sie die Textdatei.
   1. Überprüfen Sie das Tool-Protokoll, um die Ursache und/oder Muster der Fehler zu identifizieren.
   2. Überprüfen Sie Fehlerberichte über mehrere Tool-Ausführungen hinweg, um Synchronisationsergebnisse zu auditieren.

• Jobs-Tabelle

Verwenden Sie diese Methode, um alle Tool-Jobs und zugehörige Metadaten zu überwachen.

Führen Sie die folgenden Schritte aus:

1. Öffnen Sie die ArcGIS GeoBIM Projects Homepage.
2. Klicken Sie auf das View Project Details (Info-)Symbol auf der ArcGIS GeoBIM Projektkarte und dann im Detailbereich auf den Link zum Feature Service link in the Details pane.
   1. The feature service item details page opens. 
3. Scroll down to the Tables section and then click Jobs.
4. Once the Jobs page opens, click the Data tab.
   1. 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.