Autodesk Automation API: 3ds Max- und Revit-Aufgaben in der Cloud ausführen

Mit der Autodesk Automation API lassen sich wiederkehrende CAD-Aufgaben oder Aufgaben mit hohem Verarbeitungsvolumen über Autodesk Platform Services (APS) in der Cloud ausführen. Die Autodesk-Entwicklerdokumentation zur Version 3 umfasst die Engines AutoCAD, 3ds Max, Inventor, Revit und Fusion. Für Architektur-, Innenarchitektur- und Visualisierungsteams ermöglicht dieser Ansatz, geeignete Aufgaben, die sonst einzeln auf dem Desktop erledigt werden, über Skripte und Plug-ins an einen Dienst zu übergeben. Die folgenden Schritte orientieren sich an den offiziellen Dokumentationen zu den Workflows für 3ds Max und Revit.

Für welche Aufgaben eignet sich die Automatisierung?

Die Automation API führt Automatisierungsaufgaben in der Cloud aus und nutzt dafür die grundlegenden APIs der unterstützten CAD-Engines. Autodesk sieht sie für häufig wiederkehrende, umfangreiche oder rechenintensive Aufgaben vor. Wie ein Auftrag ausgeführt wird, hängt von der verwendeten Software ab; jede Engine verfügt über eine eigene Entwicklungsumgebung und eigene Tools.

Die 3ds-Max-Engine kann mit MAXScript, Python und Plug-ins verwendet werden. In der Dokumentation werden der Import und Export von Dateien, das Ausführen von Skripten, das Ändern von Dateien sowie Rendering- und Simulationsaufgaben aufgeführt. Auch vorhandene Skripte und Plug-ins können über 3ds Max Batch in cloudbasierten Aufträgen ausgeführt werden. Für Revit wird eine Headless-Engine in der Cloud angeboten, mit der sich RVT-, RTE- und RFA-Daten erstellen, prüfen und ändern lassen. Zu den in der Dokumentation genannten Beispielen zählen das Erstellen von Familieninhalten, die Analyse von Modelldaten, die Berichterstellung und die Automatisierung der Dokumentation.

Diese Funktionen sind keine fertigen Vorlagen für die Architekturautomatisierung. Um einen bestimmten Büroprozess über die API auszuführen, müssen die Prozesslogik, das erforderliche Skript oder Plug-in sowie die Ein- und Ausgabestruktur vorbereitet werden.

Schritte zum Übermitteln eines 3ds-Max-Auftrags an die Cloud

Der in der Version-3-Dokumentation von Autodesk beschriebene Ablauf „Execute a 3ds Max MaxScript“ umfasst sechs Hauptschritte. Sie zeigen die allgemeine Reihenfolge von der Vorbereitung eines Auftrags bis zum Abruf der Ergebnisse:

1. Zugriffstoken abrufen. Dieser Schritt ist für die Authentifizierung bei API-Aufrufen erforderlich. Wenn er zuerst abgeschlossen wird, können nachfolgende Anfragen an den Dienst übermittelt werden.

2. Nickname erstellen. In diesem Schritt des Ablaufs wird ein Name festgelegt, der für die weiteren Vorgänge verwendet wird. Die Dokumentation führt das Erstellen eines Nicknames als eigenständige Aufgabe im Workflow auf.

3. Activity veröffentlichen. Stellen Sie dem Dienst die Beschreibung des auszuführenden Vorgangs bereit. Dieser Schritt gehört zu dem Ablauf, in dem festgelegt wird, im Rahmen welcher Automatisierungsaktivität der Auftrag ausgeführt wird.

4. Cloud-Speicher vorbereiten. Planen Sie in diesem Schritt die Übertragung der für den Auftrag benötigten Dateien und der Ergebnisse. Sind Ein- und Ausgaben vorbereitet, kann der übermittelte Auftrag mit den vorgesehenen Dateien ausgeführt werden.

5. WorkItem übermitteln. Übertragen Sie den vorbereiteten Auftrag an den Dienst. Damit wird die festgelegte Automatisierungsaufgabe zur Ausführung übermittelt.

6. Ergebnisse herunterladen. Rufen Sie nach Abschluss des Auftrags die erzeugten Ausgaben ab und verwenden Sie sie im nächsten Projektschritt.

Autodesk erklärt, dass für 3ds Max neben MAXScript und Python auch eigene C++-, MAXScript- oder Python-Plug-ins hochgeladen und verwendet werden können. Mit Plug-ins lässt sich Logik implementieren, die mit verschiedenen Bereichen von 3ds Max interagiert. Es sollte jedoch nicht davon ausgegangen werden, dass jedes Plug-in, das auf dem Desktop funktioniert, auch mit der Cloud-Engine problemlos läuft. Die Dokumentation betont, dass jede Engine über eine eigene Entwicklungsumgebung verfügt. Daher müssen Plug-ins und Dateiformate im vorgesehenen Workflow überprüft werden.

Worin unterscheidet sich der Revit-Workflow?

Der für Revit beschriebene Ablauf beginnt mit der Konvertierung eines Revit-Plug-ins. Danach folgen das Abrufen eines Zugriffstokens, das Erstellen eines Nicknames, das Hochladen eines AppBundle, das Veröffentlichen einer Activity, das Vorbereiten des Cloud-Speichers, das Übermitteln eines WorkItem und das Herunterladen des Ergebnisses. Der Ablauf folgt einer ähnlichen Grundlogik wie der MAXScript-Workflow für 3ds Max, umfasst jedoch Revit-spezifische Plug-in- und Datenprozesse.

Die Headless-Engine von Revit in der Cloud ermöglicht die Arbeit über die Revit DB API, ohne die Desktop-Software zu installieren. In der Autodesk-Dokumentation werden das Erstellen und Ändern von Modellen, das Anpassen bestehender Modelle an Unternehmensstandards, die Datenprüfung, die automatische Berichterstellung und das Erstellen von Dokumentationen als Anwendungsbereiche genannt. Als Einstieg empfiehlt Autodesk den Ablauf „Execute a Revit add-in“ und anschließend das Codebeispiel Count/Delete Revit elements.

Bei beiden Softwareprodukten ist es sinnvoll, zunächst die zu automatisierende Aufgabe einzugrenzen: Es sollte klar festgelegt werden, welche Datei verarbeitet, welches Skript oder Plug-in verwendet und welche Ausgabe erwartet wird. So werden die Übermittlung des Auftrags an den Dienst und die Prüfung der Ergebnisse übersichtlicher.

Worauf ist bei Architektur- und Visualisierungs-Workflows zu achten?

Wenn ein Büro beispielsweise wiederkehrende Dateivorgänge automatisieren oder Berichte aus Modelldaten erstellen möchte, sollte es zunächst den bestehenden Workflow definieren. Anschließend kann anhand des offiziellen Ablaufs der jeweiligen Engine ein Test mit begrenztem Umfang durchgeführt werden. Für 3ds Max ist der MAXScript-Ablauf ein möglicher Ausgangspunkt, für Revit der Plug-in-Ablauf. Ob der Workflow mit den eigenen Dateien und Plug-ins funktioniert, muss zusätzlich geprüft werden.

Aufträge an eine Cloud-Umgebung zu übermitteln, bietet eine Möglichkeit, die Abhängigkeit von der Rechenleistung des lokalen Computers und der Netzwerkbandbreite zu verringern. Autodesk beschreibt diesen Ansatz als Möglichkeit, Verarbeitung in größerem Umfang auszuführen. In den Quellen finden sich jedoch keine Angaben zu Hardwareanforderungen, den Kosten für die API-Nutzung oder der Dauer, die ein bestimmter Auftrag benötigt. Es gibt zwar einen Link zu Preisinformationen, aber keine konkreten Beträge. Daher sollten die Kosten anhand der offiziellen Preisinformationen gesondert kalkuliert werden.

Häufige Fehler

• Plug-in-Kompatibilität voraussetzen: Binden Sie ein Plug-in, das auf dem Desktop verwendet wird, nicht in einen Produktionsauftrag ein, ohne es zuvor mit der Cloud-Engine zu testen.

• Ein- und Ausgaben nicht festlegen: Bestimmen Sie vor dem Übermitteln eines WorkItem, welche Dateien verarbeitet und welche Ergebnisse abgerufen werden sollen.

• Workflows verschiedener Softwareprodukte verwechseln: Die dokumentierten Schritte für Revit und 3ds Max unterscheiden sich. Folgen Sie dem Leitfaden für die jeweilige Engine.

• Preis oder Hardwareanforderungen schätzen: Die Quelldokumentation nennt weder einen konkreten Preis noch Hardwareanforderungen. Prüfen Sie vor einer Entscheidung die aktuellen offiziellen Angaben.

Die Automation API bietet Teams, die wiederkehrende Aufgaben in der Cloud skalieren möchten, eine Entwicklungsgrundlage. Der sicherste Einstieg besteht darin, eine einzelne Aufgabe auszuwählen, dem offiziellen Ablauf der passenden Engine zu folgen und den Umfang schrittweise zu erweitern, während die Ergebnisse geprüft werden.