Kurz gesagt
- Der Revit-Walkthrough konzentriert sich darauf, ein vorhandenes Add-in mit dem Automation Service auszuführen; die Entwicklung von Add-ins wird nicht vermittelt.
- Da in der Revit-Umgebung in der Cloud keine Benutzerinteraktion möglich ist, müssen Verweise auf die Benutzeroberfläche aus dem Add-in entfernt werden.
- Der Beispielablauf erfordert Änderungen am C#-Code; wer keine Erfahrung mit C# hat, kann mit dem Beispiel-Add-in DeleteWalls.dll ab Task 2 beginnen.
- Anfragen lassen sich mit cURL senden oder über die für den Walkthrough vorbereitete Postman-Sammlung ausführen.
Autodesk Platform Services (APS) Design Automation API v3 ermöglicht Workflows zum Erstellen, Prüfen und Ändern von Revit-Daten in der Cloud. Der offizielle Revit-Walkthrough von Autodesk zeigt, wie ein vorhandenes Revit-Add-in in der Automation-Service-Umgebung ohne Benutzeroberfläche ausgeführt wird. Im Mittelpunkt dieses Leitfadens steht nicht die Entwicklung eines Add-ins, sondern die Vorbereitung eines vorhandenen Add-ins für die Ausführung in der Cloud und das Nachvollziehen des in der Dokumentation beschriebenen Anfrageablaufs. Die Dokumentation nennt weder eine bestimmte Revit-Versionsnummer noch Hardwareanforderungen oder Preise.
Welche Aufgaben lassen sich in die Cloud verlagern?
Wiederkehrende Aufgaben identifizieren. Legen Sie zunächst fest, welche Vorgänge in Revit-Dateien regelmäßig wiederholt oder auf zahlreiche Modelle angewendet werden. Laut APS-Dokumentation eignet sich die Design Automation API dazu, wiederkehrende oder umfangreiche Verarbeitungslasten an den Service auszulagern. Als Beispiele für Revit nennt Autodesk das Erstellen von Modellen, das Prüfen von Modelldaten, die automatische Erstellung von Berichten, das Ändern vorhandener Modelle nach Unternehmensstandards und die Vorbereitung von Dokumentationen.
So lässt sich feststellen, ob sich das Add-in tatsächlich für die Automatisierung eignet. Beruht ein Vorgang auf einer Benutzerentscheidung oder einer Kontrolle auf dem Bildschirm, kann er möglicherweise nicht unverändert in die Cloud verlagert werden. Wenn Sie Eingaben und erwartete Ausgaben zunächst klar definieren, lässt sich der Umfang bei der Vorbereitung des Add-ins besser kontrollieren.
Ein vorhandenes Revit-Add-in als Ausgangspunkt verwenden. Der Walkthrough erklärt nicht, wie ein Add-in geschrieben wird, sondern konzentriert sich darauf, es mit dem Automation Service auszuführen. Wenn noch kein Add-in vorhanden ist, sollte dieser Leitfaden daher nicht als eigenständige Anleitung zur Add-in-Entwicklung verstanden werden. Für Informationen zur Entwicklung von Add-ins verweist Autodesk auf das Revit Developer Center.
Diese Unterscheidung ist wichtig: Die Ausführung in der Cloud ersetzt nicht die Entwicklung des Add-ins. Sie sollten nicht davon ausgehen, dass ein im Büro verwendetes Add-in automatisch auch in der Cloud funktioniert. Abhängigkeiten von der Benutzeroberfläche und der Ablauf des Vorgangs müssen gesondert berücksichtigt werden. Mit einem einzelnen, klar abgegrenzten Test lassen sich die nötigen Vorbereitungen leichter ermitteln.
Das Add-in für die Ausführung in der Cloud vorbereiten
Abhängigkeiten von der Benutzeroberfläche entfernen. Laut Autodesk ist im Automation Service keine Benutzerinteraktion möglich. Da Revit-Add-ins üblicherweise für die Interaktion mit der Benutzeroberfläche entwickelt werden, müssen vor der Ausführung in der Cloud alle Verweise auf die Benutzeroberfläche aus dem Add-in entfernt werden.
In der Cloud kann niemand ein Fenster auf dem Bildschirm öffnen, eine Auswahl treffen oder auf eine Bestätigungsschaltfläche klicken. Der Vorgang muss deshalb so gestaltet sein, dass er keine Zwischenentscheidungen der Benutzer erfordert. In der Dokumentation ist Task 1 als Schritt zur Anpassung des Add-ins an die Automation API definiert. Das Entfernen von Verweisen auf die Benutzeroberfläche ist Teil dieser Vorbereitung.
Erforderliche Codeänderungen prüfen. Der Walkthrough von Autodesk sieht für die erste Aufgabe Änderungen am C#-Code vor. Wer über keine ausreichende Erfahrung mit C# verfügt, kann laut Dokumentation ab Task 2 mit dem bereitgestellten, für die Automation API vorbereiteten Beispiel-Add-in
DeleteWalls.dllbeginnen. Der Dateiname bezeichnet das Beispiel-Add-in; es sollte nicht als universelles Werkzeug für andere Revit-Aufgaben verstanden werden.Das Beispiel kann dabei helfen, die Schritte zum Senden von Anfragen nachzuvollziehen. Es beseitigt jedoch nicht automatisch die Abhängigkeiten von der Benutzeroberfläche oder die Ablauflogik eines Add-ins aus einem realen Projekt. Wenn Sie Ihr eigenes Add-in verwenden, müssen Sie dessen Code und Funktion gesondert prüfen. Die Dokumentation enthält weder eine konkrete Liste der Codeänderungen noch ein allgemeingültiges Umwandlungsrezept für alle Add-ins.
Anfragen senden und den Workflow verfolgen
Die Aufgabenreihenfolge des Walkthroughs einhalten. Der Revit-Walkthrough unterteilt den Ablauf, der zum Ausführen des Add-ins mit dem Automation Service nötig ist, in einzelne Schritte. Die erste Aufgabe wird ausschließlich in Visual Studio ausgeführt und sendet keine Anfrage an APS. Deshalb gibt es in der Postman-Sammlung von Autodesk keine Gruppe für Task 1.
So entsteht nicht fälschlicherweise der Eindruck, dass in Postman eine Aufgabe fehlt. Zunächst soll das Add-in für die Ausführung vorbereitet werden; erst danach folgen die Schritte zur Kommunikation mit dem Service. Die Bezeichnungen der Aufgaben und Anfragen in der Dokumentation sind einander zugeordnet. Wenn Sie dem Ablauf folgen, hilft diese Benennung dabei, die jeweilige Anfrage der passenden Phase zuzuordnen.
Postman oder cURL verwenden. Die von Autodesk vorbereitete Postman-Sammlung bündelt die im Walkthrough verwendeten HTTP-Anfragen. Die Anfragen sind nach Aufgaben gruppiert. Wer Postman nicht verwenden möchte, kann dem Walkthrough auch mit cURL folgen. Postman wird als Option mit grafischer Oberfläche zum Senden von HTTP-Anfragen vorgestellt.
Teams, die Anfragen lieber manuell senden, können cURL verwenden; wer die Anfragen über eine Oberfläche ausführen möchte, kann die Postman-Sammlung wählen. Wichtig ist, den Namen einer Beispielanfrage zusammen mit der zugehörigen Aufgabe nachzuverfolgen. Der Ausgangstext enthält weder eine Tabelle zur Kompatibilität mit bestimmten Revit-Versionen noch Anforderungsparameter, die für jedes Projekt gelten. Es wäre daher nicht sinnvoll, Werte anzunehmen, die in der Dokumentation nicht genannt werden.
Den Vorgang in der Revit-Umgebung in der Cloud ausführen. APS ermöglicht über die Automation API den Zugriff auf eine Revit-Version, die in der Cloud und ohne Benutzeroberfläche ausgeführt wird. Laut Dokumentation kann auf die Revit DB API zugegriffen werden, ohne Revit auf einem Desktop zu installieren. Dadurch werden cloudbasierte Anwendungen und Services ermöglicht, die Modelldaten erstellen, auslesen und ändern.
Prüfen Sie an diesem Punkt anhand der Projektanforderungen, welchen Vorgang das Add-in ausführen soll, welche Eingaben verwendet werden und welches Ergebnis erwartet wird. Diese abschließende Prüfung bedeutet nicht, dass Autodesk einen bestimmten Validierungsbefehl bereitstellt; sie ist eine mögliche Vorgehensweise, um die Automatisierung zuverlässig in einem Büro-Workflow einzusetzen. Die Quellen nennen weder eine detaillierte Methode zum Herunterladen der Ergebnisse noch eine bestimmte Revit-Version.
Auswirkungen auf Workflows in Architektur und Visualisierung
Architektur- und Innenarchitekturbüros mit wiederkehrenden Prüf-, Datenextraktions-, Berichts- oder Dokumentationsschritten in Revit-Modellen können diesen Ansatz in Betracht ziehen. Werden gleichartige Vorgänge auf mehrere Modelle angewendet, ist das ein guter Ausgangspunkt, um zu untersuchen, ob sich Aufgaben aus der Desktop-Umgebung für die Cloud-Automatisierung eignen. Die Quellen nennen allerdings weder eine konkrete Geschwindigkeitssteigerung noch einen bestimmten Zeitgewinn.
Für Archviz-Teams wird keine direkte Renderfunktion beschrieben. Die Dokumentation konzentriert sich auf die Ausführung von Revit-Add-ins in der Cloud und nennt weder eine Render-Engine noch Einstellungen für die Bildqualität oder Anforderungen an die Grafikkarte. Der Einsatzbereich sollte daher auf Modelldaten und Revit-Add-in-Vorgänge beschränkt betrachtet werden. Auch Lizenz- und Gebührenbedingungen werden hier nicht erläutert und sollten vor dem Wechsel zu einem Cloud-Workflow gesondert geprüft werden.
Häufige Fehler
Ein Add-in, das mit der Benutzeroberfläche interagiert, unverändert in den Automation Service übertragen. Laut Dokumentation müssen Verweise auf die Benutzeroberfläche entfernt werden.
Den Walkthrough für eine Anleitung zur Add-in-Entwicklung halten. Er beschreibt die Ausführung eines vorhandenen Add-ins.
In der Postman-Sammlung nach Task 1 suchen. Die erste Aufgabe findet in Visual Studio statt und sendet keine Anfrage an APS.
Das Beispiel
DeleteWalls.dllals fertige Lösung für jedes Projekt betrachten. In der Quelle wird es als bestimmtes Beispiel-Add-in vorgestellt, mit dem sich ab Task 2 beginnen lässt.Revit-Versionen, Preise, Hardwareanforderungen oder Anfrageparameter voraussetzen, die in der Dokumentation nicht aufgeführt sind. Diese Angaben werden in den Quelltexten nicht gemacht.
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 ist APS Design Automation ein Ansatz, den insbesondere Teams mit wiederkehrenden Revit-Aufgaben prüfen sollten. Der eigentliche Aufwand besteht jedoch nicht nur darin, eine Anfrage in die Cloud zu senden: Das Add-in muss von Abhängigkeiten zur Benutzeroberfläche befreit und seine Ergebnisse müssen im realen Workflow überprüft werden. Daher ist es sinnvoll, mit einem kleinen, klar abgegrenzten Vorgang zu beginnen.
Die Dokumentation erläutert weder Preise und Lizenzbedingungen noch Revit-Versionen oder Hardwareanforderungen. Entscheidungen sollten deshalb nicht auf Annahmen zu Kosten oder Kompatibilität beruhen. Außerdem ersetzt das Beispiel `DeleteWalls.dll` nicht das Add-in eines Büros. Ein praktischer Einstieg ist, zunächst den Bedarf an vorhandenem Add-in- und Codewissen zu bewerten und anschließend dem offiziellen Walkthrough mit Postman oder cURL zu folgen.
Häufige Fragen
Lässt sich ein Revit-Add-in mit APS Design Automation in der Cloud ausführen?
Ja. Die Dokumentation zu Autodesk APS Design Automation API v3 enthält einen Walkthrough zur Ausführung von Revit-Add-ins mit dem Automation Service. In der Cloud ist keine Benutzerinteraktion möglich.
Was ist vor der Ausführung eines Revit-Add-ins im Automation Service zu tun?
Verweise des Add-ins auf die Benutzeroberfläche müssen entfernt werden. Der Walkthrough von Autodesk umfasst außerdem einen Vorbereitungsschritt, der Änderungen am C#-Code erfordert.
Können Revit-Automation-API-Anfragen mit Postman gesendet werden?
Ja. Die Postman-Sammlung von Autodesk enthält die HTTP-Anfragen aus dem Walkthrough, nach Aufgaben gruppiert. Die Anfragen lassen sich auch mit cURL senden.



