Verknüpfte Modelle mit der Revit Automation API verarbeiten: Schritt für Schritt

Das erfahren Sie in diesem Leitfaden

Beim Einbinden eines Revit-Modells in einen cloudbasierten Automatisierungsauftrag kann statt der erwarteten einzelnen RVT-Datei ein ZIP-Paket heruntergeladen werden. Das bedeutet nicht zwangsläufig, dass beim Download ein Fehler aufgetreten ist: Laut dem Leitfaden von Autodesk kann das Downloadpaket sowohl die Haupt-RVT als auch verknüpfte RVT-Dateien enthalten, wenn die verknüpften Dateien eines Revit Cloud Worksharing-Modells nicht denselben aktuellen Veröffentlichungsstand wie das Hauptmodell haben.

In diesem Leitfaden erfahren Sie, wie Sie feststellen, ob es sich um eine Revit Cloud Worksharing-Datei handelt, ob sie als zusammengesetztes Design gekennzeichnet ist und welche Automatisierungsmethode sich eignet. Außerdem geht es um die unterschiedlichen Workflows für Dateien, die vor dem 7. Februar 2025 beziehungsweise an oder nach diesem Datum veröffentlicht wurden.

Autodesk zufolge kann die Revit API wiederkehrende Aufgaben automatisieren und die Funktionen von Revit erweitern. Mit der Revit Automation API lassen sich Revit-Daten erstellen, prüfen und ändern – über cloudbasierte Anwendungen und Dienste. In diesem Beispiel liegt der Schwerpunkt darauf, die Revit-Datei korrekt in den Automatisierungsauftrag zu übernehmen.

Voraussetzungen und Vorbereitung

Für den Workflow benötigen Sie eine Anwendung, die mit den APIs von Autodesk Platform Services (APS) arbeiten kann, eine Möglichkeit, Datei- und Versionsinformationen abzufragen, sowie die Modelldateien, die in den Auftrag übernommen werden sollen. Auf der API-Seite von Autodesk finden Sie Entwicklerleitfäden, SDKs, Beispielcode und Ressourcen für den Community-Support. Mit der Revit Automation API lassen sich cloudbasierte Anwendungen erstellen, die ohne Installation von Revit Desktop auf die Revit DB API zugreifen können.

In einer älteren Ankündigung zur Automation API wird ein gültiges Forge-Abonnement oder ein Testkonto erwähnt. Diese Angabe bestätigt weder aktuelle Preise noch die geltenden Zugangsbedingungen. Prüfen Sie Preise und Kontoanforderungen anhand der aktuellen APS-Ressourcen, bevor Sie mit der Umsetzung beginnen. In der Dokumentation wird für diesen Vorgang auch keine bestimmte Revit-Version genannt.

Halten Sie vor dem Start Folgendes bereit:

• Den APS-Datei- oder Versionseintrag des zu verarbeitenden Revit Cloud Worksharing-Modells.

• Die erforderlichen Zugangsdaten für authentifizierte API-Aufrufe.

• Ein Tool, mit dem Sie das Veröffentlichungsdatum und die Attribute der Dateiversion prüfen können.

• Aufzeichnungen zum Veröffentlichungsdatum des Modells und zum Namen der Hauptdatei.

Schritt für Schritt: Modelltyp und Übertragungsweg bestimmen

1. Prüfen Sie, ob es sich um ein Revit Cloud Worksharing-Modell handelt. Im Leitfaden empfiehlt Autodesk, bei API-Aufrufen, die den Inhalt eines Projektordners, einen Item-Eintrag oder Versionsinformationen zurückgeben, das Feld attributes.extension.type zu prüfen. Lautet der Wert versions:autodesk.bim360:C4RModel, ist die Datei als Revit Cloud Worksharing-Modell gekennzeichnet. Entscheiden Sie nicht allein anhand der Dateiendung, sondern prüfen Sie die Versionsdaten.

2. Lesen Sie den Status des zusammengesetzten Designs aus. Das Feld attributes.data.isCompositeDesign im selben Versionseintrag gibt an, ob es sich um ein zusammengesetztes Modell handelt. Ist der Wert true, handelt es sich um ein zusammengesetztes Revit-Design; der Download kann dann als ZIP erfolgen und neben dem Hauptmodell auch damit verknüpfte RVT-Dateien enthalten. Ist der Wert false, wurden die Hauptdatei und ihre Verknüpfungen laut Autodesk mit ihren neuesten Versionen veröffentlicht, und der Download kann als einzelne RVT-Datei erfolgen.

3. Ermitteln Sie den Dateinamen des Hauptmodells. Bei einem zusammengesetzten Modell enthält das Feld attributes.data.compositeParentFile den Namen der Haupt-Revit-Datei. Diese Information wird insbesondere im älteren Workflow benötigt, um festzulegen, welche Datei im ZIP als Hauptmodell verwendet werden soll. Raten Sie den Namen der Hauptdatei nicht, sondern verwenden Sie den Wert aus dem Versionseintrag.

4. Wählen Sie die Methode anhand des Veröffentlichungsdatums. Wurde die Datei vor dem 7. Februar 2025 veröffentlicht, können Sie die ältere Methode von Autodesk verwenden: Setzen Sie für die Eingabedatei im Auftrag zip auf true und geben Sie für pathInZip den Dateinamen des Hauptmodells an. So wird das ZIP-Paket in den Automatisierungsauftrag übernommen und der Pfad zur Hauptdatei angegeben, die Revit öffnen soll.

5. Verwenden Sie für Modelle, die am oder nach dem 7. Februar 2025 veröffentlicht wurden, die neue Methode. Für eine Datei, die an oder nach diesem Datum veröffentlicht wurde, empfiehlt Autodesk den Aufruf GET linked Revit files, um das Hauptmodell und nicht veröffentlichte verknüpfte RVT-Dateien abzurufen. Übernehmen Sie die zurückgegebenen Informationen zum Hauptmodell und zu den verknüpften Dateien in den Auftrag. Wenden Sie nicht einfach die ältere ZIP-Methode an, sondern verwenden Sie das anhand dieses Datums festgelegte Verfahren.

6. Prüfen Sie die Eingaben des Auftrags. Wenn Sie die ältere Methode verwenden, kontrollieren Sie, ob die ZIP-Einstellung und der Wert für pathInZip korrekt sind. Bei der neuen Methode prüfen Sie, ob neben dem Hauptmodell auch die vom Aufruf zurückgegebenen verknüpften Dateien übernommen wurden. Im Beispiel von Autodesk kommen für diese Dateien signierte URLs zum Einsatz. Kopieren Sie keine URLs aus dem Beispieltext, sondern verwenden Sie die aktuellen Werte aus der Antwort Ihres eigenen API-Aufrufs.

Häufige Fehler

• Ein ZIP automatisch für eine beschädigte Datei halten: Wenn verknüpfte Modelle nicht mit ihren aktuellen Versionen veröffentlicht wurden, kann ein ZIP-Download zu erwarten sein.

• Modelltyp und Status als zusammengesetztes Design verwechseln: C4RModel kennzeichnet den Cloud Worksharing-Dateityp; isCompositeDesign zeigt an, ob das Design zusammengesetzt ist. Prüfen Sie beide Angaben.

• Die Haupt-RVT-Datei einfach annehmen: Ermitteln Sie den korrekten Dateinamen anhand des Felds compositeParentFile.

• Die Datumsgrenze übersehen: Für Dateien, die vor beziehungsweise ab dem 7. Februar 2025 veröffentlicht wurden, beschreibt der Leitfaden unterschiedliche Übertragungswege.

• Temporäre Zugriffslinks aus dem Beispiel verwenden: Die signierten URLs in der Quelle sind Teil einer Beispielantwort. Verwenden Sie die Links aus Ihrem eigenen Aufruf.

Auswirkungen auf Architektur- und Visualisierungs-Workflows

Dieser Ansatz ist für Teams relevant, die wiederkehrende Schritte wie Modellprüfung, Datenextraktion, Reporting oder automatisierte Dokumentation in cloudbasierte Revit-Workflows integrieren. Zu den von Autodesk genannten Anwendungsfällen zählen die Prüfung und Analyse von Revit-Daten, der Datenexport, das Erstellen benutzerdefinierter Revit-Familien und die automatisierte Erstellung von Dokumentation. Architekturbüros, Innenarchitekturbüros und BIM-Manager können das Risiko falscher oder unvollständiger Eingaben insbesondere dadurch verringern, dass sie den Versionsstatus verknüpfter Modelle vor der Automatisierung prüfen.

Auch für Visualisierungsteams ist es wichtig, Hauptdatei und Verknüpfungen gemeinsam zu übernehmen, damit die Automatisierung mit den erwarteten Projektdaten arbeitet. Dieser Leitfaden enthält jedoch keine Angaben zur Renderleistung, zu Hardwareanforderungen oder zur Kompatibilität mit bestimmter Visualisierungssoftware. Prüfen Sie vor der Umsetzung die API-Zugangsbedingungen, den Lizenzstatus und die Kompatibilität des Workflows mit den verwendeten Revit-Daten.

Nächste Schritte

Führen Sie den ersten Test mit einem unkritischen Modell durch. Dokumentieren Sie die Versionsattribute der Datei, prüfen Sie das Veröffentlichungsdatum und wählen Sie die dazu passende Methode. Kontrollieren Sie in der Ausgabe des Automatisierungsauftrags, ob die erwartete Haupt-RVT verarbeitet wurde. Anschließend können Sie den Workflow mithilfe der Revit API-Leitfäden, Einsteiger-Tutorials und Codebeispiele von Autodesk an Ihre Anforderungen für Datenextraktion oder Reporting anpassen.

Quelle und Lizenz

Dieser Leitfaden wurde auf Grundlage der Seiten von Autodesk zur Revit Automation API und Revit API sowie eines Entwicklerbeitrags zur Übernahme zusammengesetzter Revit-Designs in Automatisierungsaufträge ins Türkische adaptiert. Alle Quellen stammen aus offiziellen Entwicklerressourcen von Autodesk und werden unter einer freien Lizenz bereitgestellt.