Kurz gesagt
- Der APS Automation Service stellt eine Headless-Version von Revit bereit.
- Bei Add-ins, die in der Cloud ausgeführt werden sollen, müssen Referenzen auf die Benutzeroberfläche entfernt werden.
- Die Vorbereitung erfordert Änderungen am C#-Code. Wer keine C#-Erfahrung hat, kann mit der fertigen DeleteWalls.dll direkt bei Task 2 einsteigen.
- Laut offiziellem Walkthrough lassen sich HTTP-Anfragen mit cURL oder einer Postman-Sammlung senden.
Die Dokumentation zur APS Design Automation API v3 von Autodesk bietet einen Schritt-für-Schritt-Walkthrough für Entwickler, die Revit-Add-ins auf dem Automation Service ausführen möchten. Der Leitfaden konzentriert sich darauf, ein vorhandenes Add-in für den Einsatz in der Cloud vorzubereiten und die erforderlichen HTTP-Anfragen mit Postman oder cURL nachzuvollziehen. APS stellt in der Cloud eine Headless-Version von Revit bereit und ermöglicht den Zugriff auf die Revit DB API. So lassen sich Aufgaben wie das Erstellen, Prüfen und Ändern von Modelldaten ohne installierte Desktop-Version von Revit erledigen.
Vorab den Umfang festlegen
Die zu automatisierende Aufgabe definieren. Laut Autodesk lassen sich mit der Automation API Cloud-Anwendungen entwickeln, die Revit-Daten erstellen, auslesen und ändern. Die Dokumentation nennt Beispiele wie das Erstellen benutzerdefinierter Revit-Familien, das Automatisieren der Modellkonfiguration, das Analysieren von Modelldaten, das Erstellen von Berichten, das Anpassen vorhandener Modelle an Unternehmensstandards und das Erstellen von Dokumentationen. Zunächst sollte feststehen, welche dieser Aufgaben das Add-in übernehmen soll.
Die Grenzen des Walkthroughs beachten. Das Dokument beschreibt nicht, wie ein Revit-Add-in von Grund auf neu entwickelt wird, sondern wie ein vorhandenes Add-in auf dem Automation Service ausgeführt werden kann. Für die Add-in-Entwicklung verweist Autodesk auf das Revit Developer Center. Wer Entwicklung und Ausführung in der Cloud getrennt betrachtet, kann die Schritte des Leitfadens besser einordnen.
Nicht von einer Desktop-Oberfläche ausgehen. Der Automation Service unterstützt keine Benutzerinteraktion. Ein Add-in, das mit der Revit-Oberfläche kommuniziert, muss daher vor dem Einsatz in der Cloud von diesen Abhängigkeiten befreit werden. Falls das Add-in auf Auswahlen oder Bestätigungen durch Benutzer wartet, sollte gesondert geklärt werden, wie diese Schritte in der Automatisierungsumgebung abgebildet werden. Die ausdrücklich genannte grundlegende Vorbereitung im offiziellen Walkthrough besteht darin, Referenzen auf die Benutzeroberfläche zu entfernen.
Das Revit-Add-in für die Automation API vorbereiten
Referenzen auf die Benutzeroberfläche entfernen. Die erste Aufgabe des Walkthroughs besteht darin, das Revit-Add-in für die Automation API vorzubereiten. Dazu muss der C#-Code geändert und die Referenzen auf die Benutzeroberfläche müssen bereinigt werden. Da der Service keine Benutzerinteraktion zulässt, können Funktionen mit Abhängigkeit von der Oberfläche andernfalls zu einem Konflikt zwischen dem Verhalten des Add-ins und den Einschränkungen der Cloud-Umgebung führen.
Den passenden Weg entsprechend den C#-Kenntnissen wählen. Entwickler mit C#-Kenntnissen können die Vorbereitungsschritte der ersten Aufgabe im Walkthrough befolgen. Dabei werden die UI-bezogenen Teile des vorhandenen Add-ins herausgelöst und für die Ausführung in der Cloud angepasst. Da der Leitfaden keine allgemeine Einführung in die Add-in-Entwicklung bietet, werden hier keine Codebeispiele oder Implementierungsdetails ergänzt, die nicht in der Dokumentation stehen.
Ein fertiges Beispiel verwenden. Wer keine C#-Erfahrung hat, kann die von Autodesk bereitgestellte Datei
DeleteWalls.dllherunterladen, die erste Aufgabe überspringen und bei Task 2 weitermachen. So lassen sich die Schritte zum Ausführen eines Add-ins auf dem Service anhand einer Beispieldatei nachvollziehen. Die verfügbare DLL bedeutet jedoch nicht, dass auch andere Add-ins ohne Änderungen funktionieren. Die Abhängigkeiten von der Benutzeroberfläche müssen für jedes Add-in gesondert geprüft werden.
Anfragen mit Postman oder cURL senden
Die Aufgaben im Walkthrough der Reihe nach durchgehen. Der Leitfaden beschreibt die HTTP-Anfragen, die beim Ausführen eines Add-ins auf dem Automation Service verwendet werden. Wer Postman nutzen möchte, kann die von Autodesk verlinkte APS-Tutorial-Sammlung importieren. Darin sind die Anfragen nach Aufgaben gruppiert und ihre Namen den Schritten im Walkthrough zugeordnet. Alternativ können dieselben Anfragen über cURL gesendet werden.
Beachten, dass Task 1 nicht in der Sammlung enthalten ist. Die Vorbereitung des Add-ins erfolgt in Visual Studio und sendet keine HTTP-Anfrage an APS. Deshalb gibt es in der Postman-Sammlung keine Gruppe für Task 1. Sobald das Add-in vorbereitet ist, kann mit den entsprechenden Aufgaben in der Sammlung fortgefahren werden.
Aufgaben- und Anfragenamen abgleichen. Da die Gruppen und Anfragen in der Sammlung dieselben Namen wie die Schritte im Walkthrough tragen, lässt sich die jeweilige Position einer Anfrage im Ablauf nachvollziehen. Zuerst sollte überprüft werden, ob die Vorbereitung des Add-ins abgeschlossen ist. Anschließend geht es in der in der Dokumentation angegebenen Reihenfolge weiter. Für Authentifizierung, Datei-Upload oder Ausführungsparameter, die im Quell-Walkthrough nicht erläutert werden, werden diesem Leitfaden keine zusätzlichen Befehle hinzugefügt.
Auswirkungen auf Architektur- und Visualisierungs-Workflows
Architektur- und Innenarchitekturbüros, die wiederkehrende Modellaufgaben, Standardprüfungen oder die Berichtserstellung in Revit automatisieren möchten, können in Betracht ziehen, ihre Add-ins in der Cloud auszuführen. Laut Autodesk ermöglicht die Automation API über die Revit DB API Workflows zum Erstellen, Auslesen und Ändern von Modelldaten. Das kann für Teams interessant sein, die wiederkehrende Aufgaben von der Desktop-Nutzung entkoppeln möchten. Die Quellen enthalten jedoch keine Zahlen zu Ausführungszeit, Kapazität, Kosten oder Leistung.
Archviz-Teams können mögliche Anwendungsfälle rund um die Prüfung und automatisierte Verarbeitung von Modelldaten untersuchen. Der Walkthrough erläutert jedoch weder die Kompatibilität bestimmter Render-Engines noch Render-Einstellungen. Die Möglichkeit, ein Revit-Add-in in der Cloud auszuführen, sollte daher nicht als Hinweis darauf verstanden werden, dass ein bestimmtes Visualisierungstool unterstützt wird. Auch Angaben zu lokaler Hardware, Lizenzen und Kosten fehlen in der Dokumentation. Diese Punkte sollten vor der Umsetzung gesondert geprüft werden.
Häufige Fehler
Ein Add-in mit UI-Abhängigkeiten unvorbereitet ausführen: Da der Automation Service keine Benutzerinteraktion unterstützt, müssen Referenzen auf die Benutzeroberfläche entfernt werden.
Den Walkthrough als Anleitung zur Add-in-Entwicklung verstehen: Der Leitfaden beschreibt, wie ein vorhandenes Add-in in der Cloud ausgeführt wird.
Task 1 in der Postman-Sammlung suchen: Die Vorbereitung erfolgt in Visual Studio, daher ist diese Aufgabe nicht in der Sammlung enthalten.
Die Beispieldatei als fertige Lösung für alle Add-ins betrachten:
DeleteWalls.dlldient als Einstiegsbeispiel. Andere Add-ins müssen gesondert für den Cloud-Einsatz vorbereitet werden.
Der grundlegende Ablauf im Revit-Walkthrough zur APS Design Automation API v3: Abhängigkeiten des Add-ins von der Benutzeroberfläche entfernen, es mit C# vorbereiten oder mit dem fertigen Beispiel starten und anschließend die HTTP-Anfragen mit Postman oder cURL nachvollziehen. Zu Kompatibilität, Kosten und Leistung, die außerhalb des Umfangs des Leitfadens liegen, sollten zusätzliche Informationen eingeholt werden.
Quellen
2 QuellenQuelltexte werden nicht neu veröffentlicht; kurze Zitate sind gekennzeichnet, der Rest ist eigene Zusammenfassung und Einordnung.
Für Architektur- und Innenarchitekturbüros in der Türkei liegt der praktische Nutzen dieses Ansatzes darin, wiederkehrende Revit-Aufgaben in einen cloudbasierten Workflow zu übertragen. Er kann für Aufgaben wie die Analyse von Modelldaten, Standardprüfungen und die Berichterstellung interessant sein. Allerdings müssen Abhängigkeiten des Add-ins von der Benutzeroberfläche vorher entfernt werden.
Vor einer Entscheidung sollten die Lizenz- und Kostenbedingungen gesondert geprüft werden; die offizielle Dokumentation macht keine Angaben zu Kosten, Kapazität oder Hardwareanforderungen. Auch die Kompatibilität mit Render-Tools liegt außerhalb des Umfangs des Walkthroughs. Büros sollten daher zunächst einen begrenzten Workflow testen und prüfen, ob ihr Add-in für die Cloud-Umgebung geeignet ist.
Häufige Fragen
Kann ein Revit-Add-in auf dem APS Automation Service die Benutzeroberfläche verwenden?
Nein. Laut dem Autodesk-Walkthrough ist auf dem Automation Service keine Benutzerinteraktion möglich. Referenzen auf die Benutzeroberfläche müssen vor der Ausführung des Add-ins entfernt werden.
Sind C#-Kenntnisse zwingend erforderlich, um ein Revit-Add-in über APS auszuführen?
Die Vorbereitungsaufgabe erfordert Änderungen am C#-Code. Wer keine C#-Erfahrung hat, kann mit der von Autodesk bereitgestellten DeleteWalls.dll bei Task 2 einsteigen.
Wie wird die Postman-Sammlung im APS-Revit-Walkthrough verwendet?
Die Sammlung gruppiert die Anfragen nach Aufgaben und ordnet ihre Namen den Schritten im Walkthrough zu. Da die Vorbereitung des Add-ins in Visual Studio erfolgt, ist Task 1 nicht in der Sammlung enthalten.



