Kurz gesagt
- Prüfen Sie anhand des Felds `isCompositeDesign`, ob ein Revit-Cloud-Worksharing-Modell ein zusammengesetztes Design enthält.
- Ist `isCompositeDesign` true, kann der Download ein ZIP-Paket mit dem Host-Modell und verknüpften RVT-Dateien sein.
- Für Dateien, die am oder nach dem 7. Februar 2025 veröffentlicht wurden, können Sie über den Aufruf GET linked Revit files verknüpfte Modelle abrufen.
- Im älteren Workflow wird die ZIP-Eingabe mit `zip: true` angegeben; der Name des Host-Modells im ZIP wird über `pathInZip` festgelegt.
Was erfahren Sie in diesem Leitfaden?
Wir sehen uns Schritt für Schritt an, warum eine über Revit Cloud Worksharing veröffentlichte Datei manchmal als ZIP statt als einzelne RVT-Datei heruntergeladen wird und wie sich dieses Design in einen Automation-API-Workflow übernehmen lässt. Entscheidend ist, ob es sich um ein zusammengesetztes Design handelt: Neben der Host-Datei können auch verknüpfte RVT-Modelle im Paket enthalten sein. Deshalb reicht es bei der Vorbereitung einer Automatisierungsaufgabe nicht aus, nur auf die Dateierweiterung zu achten; auch die Informationen in der API-Antwort zur Dateiversion müssen geprüft werden.
Der Leitfaden stützt sich auf die in der Dokumentation von Autodesk Platform Services beschriebenen API-Felder und zwei unterschiedliche Workflows. Die zeitliche Grenze zwischen der älteren und der neueren Methode ist der 7. Februar 2025. Ziel ist nicht, sämtliche Schritte zur Authentifizierung und Einrichtung einer Anwendung zu erläutern, sondern die vorliegenden Modellinformationen richtig zu interpretieren und das passende Eingabeformat auszuwählen.
Voraussetzungen
Sie benötigen Zugriff auf ein Revit-Cloud-Worksharing-Projekt und auf die Autodesk Platform Services API, über die Sie Dateiinformationen abrufen können. Das Beispiel in den Quellen untersucht Projekt- und Dateiversionsinformationen mithilfe von API-Aufrufen.
Berücksichtigen Sie für die Arbeit mit der Automation API die in den Quellen genannten Voraussetzungen für eine aktive Forge-Testversion oder ein Abonnement. Die betreffende Quelle verweist für Preisdetails auf eine separate Seite; aktuelle Preise werden hier nicht angegeben.
Stellen Sie sicher, dass Sie das Veröffentlichungsdatum des zu verarbeitenden Modells sowie die Felder
attributes.extensionundattributes.datain der Antwort zur Dateiversion prüfen können.Gehen Sie nicht davon aus, dass für diesen Workflow eine Revit-Desktopinstallation erforderlich ist: In der Beschreibung der Revit Automation API von Autodesk wird der Zugriff auf die Revit-Datenbank-API ohne installierte Revit-Desktopversion erwähnt. Das bedeutet jedoch nicht, dass kein API-Zugriff oder keine erforderlichen Projekteingaben nötig sind.
Da die Quellen weder eine bestimmte Revit-Versionsnummer noch aktuelle Abonnementpreise oder eine vollständige Einrichtung der Authentifizierung nennen, werden diese Informationen hier nicht vorausgesetzt.
Schritt für Schritt: Design erkennen und Aufgabe vorbereiten
Prüfen Sie, ob die Datei ein Revit-Cloud-Worksharing-Modell darstellt. Untersuchen Sie in der Antwort der API-Aufrufe für Projektinhalte, Dateielemente oder Versionen das Feld
attributes.extension.type. Laut Quelle handelt es sich bei der Datei um ein Revit-Cloud-Worksharing-Modell, wenn der Wertversions:autodesk.bim360:C4RModellautet. Diese Prüfung ist der erste Schritt, um die Informationen zum zusammengesetzten Design im richtigen Kontext zu interpretieren.Lesen Sie das Kennzeichen für zusammengesetzte Designs aus. Suchen Sie in derselben Versionsantwort nach dem Feld
attributes.data.isCompositeDesign. Ist der Werttrue, wird das Modell als zusammengesetztes Design gekennzeichnet; der Download kann ein ZIP-Paket mit dem Host-Modell und verknüpften RVT-Dateien sein. Ist der Wertfalse, wird laut Quelle eine einzelne RVT-Datei abgerufen, wenn die neuesten Versionen des Host-Modells und der verknüpften Dateien veröffentlicht wurden.Ermitteln Sie den Namen des Host-Modells. Bei einem zusammengesetzten Design enthält
attributes.data.compositeParentFileden Namen der Host-Revit-Datei. Dieser Wert wird insbesondere im älteren Workflow benötigt, wenn Sie das Host-Modell im ZIP auswählen müssen. Behandeln Sie den Inhalt des Felds als Dateinamen und ersetzen Sie den von der API gelieferten Wert nicht durch eine eigene Schätzung.Ordnen Sie das Veröffentlichungsdatum anhand des Stichtags 7. Februar 2025 ein. Laut Quelle wird für Modelle, die vor diesem Datum veröffentlicht wurden, die ältere Methode verwendet; für Modelle, die an diesem Datum oder später veröffentlicht wurden, die neue Methode. Treffen Sie die Entscheidung anhand des Werts
attributes.createTimeder Datei. Wenn Sie das Datum nicht prüfen und für alle Modelle dasselbe Eingabeformat verwenden, kann die tatsächliche Eingabe von der für das Arbeitselement erwarteten Datei abweichen.Definieren Sie die ZIP-Eingabe im älteren Workflow. Wurde die Datei vor dem 7. Februar 2025 veröffentlicht und enthält sie ein zusammengesetztes Design, setzen Sie in den
inputFile-Einstellungen des Arbeitselementszipauftrue. Geben Sie im FeldpathInZipden Host-Dateinamen auscompositeParentFilean. So wird das ZIP-Paket als Eingabe für die Aufgabe verwendet und zugleich festgelegt, welche RVT-Datei darin verarbeitet werden soll. Die Quelle veranschaulicht diese Methode anhand einer beispielhaften DXF-Exportaufgabe; die Logik sollte entsprechend den Eingabeanforderungen der ausgewählten Aktivität angewendet werden.Rufen Sie Host- und verknüpfte Dateien im neuen Workflow gemeinsam ab. Für Dateien, die am oder nach dem 7. Februar 2025 veröffentlicht wurden, kann der Aufruf GET linked Revit files das Host-Modell und nicht veröffentlichte verknüpfte RVT-Dateien zurückgeben. Prüfen Sie in der Antwort die Host-Datei und die Ergebnisse unter
linkedFiles; kontrollieren Sie Modellnamen, Versionsinformationen und Veröffentlichungsstatus. Übergeben Sie anschließend die von diesem Aufruf bereitgestellten signierten URLs an die Eingaben des Arbeitselements. Das Beispiel der Quelle zeigt für das Host-Modell den StatusPublishedund für die verknüpfte DateiNotPublished. Diese Statusangaben helfen zu erkennen, dass Host- und verknüpfte Datei nicht denselben Veröffentlichungsstatus haben müssen.Prüfen Sie die Eingabestruktur vor dem Ausführen der Aufgabe. Bei der älteren Methode werden das ZIP und der Name des Host-Modells darin verwendet; bei der neuen Methode kommen die Host- und Dateiadressen der verknüpften Modelle aus der Antwort von GET linked Revit files. Behandeln Sie diese beiden Ansätze nicht so, als wären sie eine einzige Struktur. Prüfen Sie, ob die vom Arbeitselement erwarteten Eingaben mit den über die API abgerufenen Dateien übereinstimmen.
Häufige Fehler
Ein ZIP-Download ist nicht automatisch ein Zeichen für eine beschädigte Datei; insbesondere bei nicht veröffentlichten verknüpften Modellen kann diese Annahme irreführend sein. Prüfen Sie zuerst das Feld isCompositeDesign und den Host-Namen. Ein weiterer Fehler ist, für jede Datei zip: true zu verwenden, ohne den Wert von isCompositeDesign zu kontrollieren. Bei einem nicht zusammengesetzten Modell kann diese Einstellung nicht mit der erwarteten einzelnen RVT-Eingabe übereinstimmen.
Auch das Veröffentlichungsdatum darf nicht übersehen werden. Laut Quelle werden Dateien vor dem 7. Februar 2025 mit der älteren Methode verarbeitet, Dateien ab diesem Stichtag mit dem Ansatz GET linked Revit files. Schreiben Sie schließlich nicht irgendeinen Dateinamen anstelle des Werts compositeParentFile hinein und lassen Sie bei der neuen Methode nicht nur das Host-Modell abrufen, während Sie die verknüpften Dateien auslassen.
Auswirkungen auf Architektur- und Visualisierungs-Workflows
Diese Unterscheidung ist für Teams wichtig, die Revit-Daten in der Cloud automatisch exportieren, prüfen oder auswerten. Es ist möglich, dass nicht alle verknüpften Modelle eines Projekts gleichzeitig veröffentlicht wurden. Deshalb kann eine Automatisierung, die nur eine einzelne RVT-Datei erwartet, mit unvollständigen Daten arbeiten, wenn sie zusammengesetzte Eingaben nicht korrekt verarbeitet. Eine vorherige Prüfung der Modellinformationen hilft dabei, mit der Automatisierung den richtigen Dateisatz zu verarbeiten.
Für Architekturbüros und BIM-Teams sind vor allem der API-Zugriff, die Abonnementbedingungen und die korrekte Konfiguration der Dateieingabe entscheidend – nicht die Hardware. Visualisierungsteams können diesen Workflow bei wiederkehrenden Aufgaben wie Exporten oder Modellanalysen nutzen; die Quellen machen jedoch keine Angaben zur Kompatibilität mit bestimmter Rendering-Software, zur Verarbeitungszeit oder zu Kosten. Vor dem Einsatz in einer Produktionspipeline empfiehlt sich ein kleiner Test mit der verwendeten Aktivität und Dateistruktur.
Nächste Schritte
Die Entwicklerressourcen zur Revit API von Autodesk listen Einstiegshilfen, Codebeispiele und Community-Support auf. Prüfen Sie zunächst in der Antwort zur Dateiversion den Modelltyp, das Kennzeichen für zusammengesetzte Designs und den Namen des Host-Modells. Wählen Sie danach die zum Veröffentlichungsdatum passende Methode aus und testen Sie die Eingabe des Arbeitselements. Bei der Erweiterung des Workflows können Sie die in den Quellen genannten Anwendungsbereiche wie das Extrahieren und Ändern von Revit-Daten, die automatische Berichterstellung und die Dokumentationserstellung berücksichtigen.
Quellen und Lizenz
Dieser Leitfaden basiert auf der Revit-API-Übersicht von Autodesk Platform Services, der Ankündigung der Automation API und dem Leitfaden zur Verarbeitung zusammengesetzter Revit-Designs. Alle drei Quellen sind frei zugänglich (Lizenz = frei); die Inhalte wurden ins Türkische übertragen.
Quellen
3 QuellenQuelltexte werden nicht neu veröffentlicht; kurze Zitate sind gekennzeichnet, der Rest ist eigene Zusammenfassung und Einordnung.
Für Büros in der Türkei besteht der praktische Nutzen dieses Ansatzes vor allem darin, unerwartete ZIP-Eingaben aufgrund des Veröffentlichungsstatus verknüpfter Modelle zu erkennen, bevor die Automatisierung startet. Besonders bei Teams, die regelmäßig Exporte und Modellanalysen durchführen, kann die Wahl des richtigen Eingabeformats den Bedarf an erneuten Versuchen und manueller Dateiauswahl verringern.
Bei Investitionsentscheidungen sollten API-Zugriff, Abonnementbedingungen und die Kompatibilität mit dem bestehenden Workflow Vorrang vor leistungsstarker Hardware haben. Da die Quellen weder aktuelle Preise noch Verarbeitungskosten nennen, sollten Büros ihre eigenen Anwendungsszenarien mit einem kleinen Test bewerten. Auch für Studierende ist dies ein nützliches Beispiel dafür, wie verknüpfte Revit-Modelle in die Cloud-Automatisierung übernommen werden; die Kompatibilität mit bestimmten Softwareversionen muss jedoch separat geprüft werden.
Häufige Fragen
Wie lässt sich in der Revit Automation API erkennen, ob es sich bei einer Datei um ein zusammengesetztes Design handelt?
Prüfen Sie das Feld `attributes.data.isCompositeDesign` der Dateiversion. Ist der Wert `true`, wird das Design als zusammengesetzt gekennzeichnet; der Download kann ein ZIP mit dem Host-Modell und verknüpften RVT-Dateien sein.
Welche Methode wird verwendet, um verknüpfte Revit-Modelle in die Automation API zu übernehmen?
Für Dateien, die am oder nach dem 7. Februar 2025 veröffentlicht wurden, kann der Aufruf GET linked Revit files Host- und verknüpfte Dateien bereitstellen. Die signierten URLs aus dieser Antwort werden den Eingaben des Arbeitselements übergeben.
Ist für die Revit Automation API eine Revit-Desktopinstallation erforderlich?
Laut der Beschreibung der Revit Automation API von Autodesk ist der Zugriff auf die Revit-Datenbank-API ohne installierte Revit-Desktopversion möglich. Die Quellen nennen API-Zugriff und Abonnementbedingungen gesondert.



