Guide de l’Autodesk Automation API : exécuter 3ds Max et Revit dans le cloud

L’Autodesk Automation API permet d’exécuter dans le cloud, via Autodesk Platform Services (APS), des tâches CAO répétitives ou nécessitant un volume de traitement élevé. La documentation développeur Version 3 d’Autodesk couvre les moteurs AutoCAD, 3ds Max, Inventor, Revit et Fusion. Pour les équipes d’architecture, d’architecture d’intérieur et de visualisation, cette approche permet de soumettre des tâches adaptées, habituellement effectuées une à une sur un poste de travail, au moyen de scripts et de plugins. Les étapes ci-dessous s’appuient sur les workflows 3ds Max et Revit décrits dans la documentation officielle.

À quelles tâches l’automatisation peut-elle servir ?

L’Automation API exécute des tâches automatisées dans le cloud en s’appuyant sur les API principales des moteurs CAO pris en charge. Autodesk la destine aux tâches répétitives, à grande échelle ou exigeant une importante puissance de calcul. Le mode d’exécution dépend du logiciel utilisé : chaque moteur dispose de son propre environnement et de ses propres outils de développement.

Le moteur 3ds Max peut être utilisé avec MAXScript, Python et des plugins. La documentation cite l’importation et l’exportation de fichiers, l’exécution de scripts, la modification de fichiers, le rendu et les simulations. 3ds Max Batch permet également d’exécuter des scripts et des plugins existants dans des tâches cloud. Côté Revit, le moteur sans interface graphique exécuté dans le cloud sert à créer, examiner et modifier des données RVT, RTE et RFA. La préparation de contenu de familles, l’analyse de données de modèles, la production de rapports et l’automatisation de la documentation figurent parmi les exemples donnés dans la documentation.

Ces fonctionnalités ne constituent pas un modèle d’automatisation architecturale prêt à l’emploi. Pour exécuter un processus propre à un cabinet via l’API, il faut préparer la logique métier, le script ou le plugin nécessaire, ainsi que l’organisation des entrées et des sorties.

Étapes pour envoyer une tâche 3ds Max dans le cloud

Le tutoriel « Execute a 3ds Max MaxScript » de la documentation Autodesk Version 3 comprend six étapes principales. Elles présentent la séquence générale, de la préparation d’une tâche à la récupération des résultats :

1. Obtenir un jeton d’accès. Cette étape est nécessaire pour authentifier les opérations API. Une fois terminée, elle permet d’envoyer les requêtes suivantes au service.

2. Créer un nickname. Cette étape du tutoriel permet de définir un nom qui sera utilisé lors des opérations suivantes. La documentation répertorie la création du nickname comme une tâche distincte du workflow.

3. Publier une activity. Soumettez au service la définition de l’opération à exécuter. Cette étape fait partie du processus qui détermine dans le cadre de quelle activité d’automatisation la tâche sera exécutée.

4. Préparer le stockage cloud. Organisez le transfert des fichiers nécessaires à la tâche et de ses résultats. Disposer des entrées et des sorties nécessaires aide à garantir que la tâche envoyée sera exécutée avec les fichiers prévus.

5. Envoyer un WorkItem. Transmettez la tâche préparée au service. Le travail d’automatisation défini est alors envoyé pour exécution.

6. Télécharger les résultats. Une fois la tâche terminée, récupérez les fichiers générés et utilisez-les à l’étape suivante du projet.

Autodesk indique qu’en plus de MAXScript et Python, des plugins personnalisés en C++, MAXScript ou Python peuvent être chargés et utilisés avec 3ds Max. Les plugins permettent d’appliquer une logique reliée à différentes parties de 3ds Max. Toutefois, il ne faut pas supposer qu’un plugin fonctionnant sur un poste de travail sera aussi compatible avec le moteur cloud. La documentation souligne que les moteurs disposent de leurs propres environnements de développement ; il faut donc vérifier les plugins et les formats de fichiers dans le workflow visé.

En quoi le workflow Revit est-il différent ?

Le tutoriel consacré à Revit commence par la conversion d’un plugin Revit. Il se poursuit par l’obtention d’un jeton d’accès, la création d’un nickname, le chargement d’un AppBundle, la publication d’une activity, la préparation du stockage cloud, l’envoi d’un WorkItem et le téléchargement du résultat. La logique générale est similaire à celle du tutoriel MAXScript de 3ds Max, mais elle comprend des étapes propres aux plugins et aux données Revit.

Le moteur Revit sans interface graphique exécuté dans le cloud permet de travailler avec l’API Revit DB sans installer le logiciel de bureau. La documentation Autodesk cite parmi les cas d’usage la création et la modification de modèles, la mise en conformité de modèles existants avec les normes de l’entreprise, l’examen des données, la génération automatique de rapports et la création de documentation. Pour commencer, Autodesk recommande le tutoriel « Execute a Revit add-in », puis l’exemple de code Count/Delete Revit elements.

Pour les deux logiciels, il est utile de commencer par délimiter la tâche à automatiser : précisez clairement le fichier à traiter, le script ou le plugin à utiliser et le résultat attendu. Cette préparation clarifie l’envoi de la tâche au service et la vérification des résultats.

À quoi faire attention dans un workflow d’architecture et de visualisation ?

Si un cabinet souhaite, par exemple, automatiser le traitement répétitif de fichiers ou la création de rapports à partir de données de modèles, il doit d’abord définir le workflow existant. Il peut ensuite réaliser un essai à petite échelle en suivant le tutoriel officiel du moteur concerné. Le tutoriel MAXScript est un point de départ pour 3ds Max ; celui consacré aux plugins l’est pour Revit. La compatibilité avec les fichiers et plugins utilisés dans le workflow doit être testée séparément.

L’envoi de tâches dans le cloud permet de réduire la dépendance à la puissance de calcul de l’ordinateur local et à la bande passante du réseau ; Autodesk présente cette approche comme un moyen d’exécuter des traitements à plus grande échelle. Cependant, les sources ne précisent ni les exigences matérielles, ni le coût d’utilisation de l’API, ni la durée d’exécution d’une tâche donnée. Un lien vers les tarifs est disponible, mais aucun montant n’est indiqué ; le coût doit donc être calculé séparément à partir des informations tarifaires officielles.

Erreurs fréquentes

• Supposer qu’un plugin est compatible : ne mettez pas en production un plugin utilisé sur ordinateur de bureau sans l’avoir testé sur le moteur cloud.

• Ne pas définir les entrées et les sorties : avant d’envoyer un WorkItem, précisez quels fichiers seront traités et quels résultats devront être récupérés.

• Confondre les workflows des logiciels : les étapes documentées pour Revit et 3ds Max sont différentes ; suivez le guide propre au moteur concerné.

• Estimer les tarifs ou les exigences matérielles : les documents sources ne précisent ni prix ni exigences matérielles ; consultez les informations officielles à jour avant de prendre une décision.

L’Automation API offre aux équipes un environnement de développement pour mettre à l’échelle, dans le cloud, des tâches répétitives. Le plus sûr est de choisir une seule tâche, de suivre le tutoriel officiel du moteur adapté et d’élargir progressivement le périmètre après avoir vérifié les résultats.