Dernières actualités
Blender Geometry Nodes : obtenir des données de surface et de collision avec Raycast NodeAfter Night There Is Nothing : une installation à trois dômes à SharjahGraphic Override Rules dans Archicad 29 : guide de créationAnalyser des images d’architecture avec Gemma 4 : installation et pratique en PythonCréer des chanfreins contrôlés et non destructifs avec le Bevel Modifier de BlenderAméliorer les performances de SketchUp : modélisation légère et transfert CAOGuide : exécuter un plug-in Revit dans le cloud avec APS Design AutomationComment créer un Agent Skill pour l’API Revit ? Guide dll2llmParamètres globaux et Parameters Service dans Revit : guide pratiqueGuide pour apprendre MAXScript dans 3ds Max : ouvrir et exécuter un script
Conseils et guidesRevitAutodeskOMA

Guide : exécuter un plug-in Revit dans le cloud avec APS Design Automation

La documentation d’Autodesk sur l’API APS Design Automation v3 explique comment exécuter des plug-ins Revit dans un environnement cloud sans interface utilisateur. Ce guide présente les étapes de préparation du plug-in, l’envoi de requêtes avec Postman ou cURL et les principales limites à prendre en compte.

Bureau d’architecture et espace de travail autour d’un modèle BIM évoquant l’automatisation cloudImage IA
Image d’illustration générée par IA.Image : 3dsınıfı / FCA AI

En bref

  1. Le walkthrough Revit porte sur l’exécution d’un plug-in existant dans Automation Service ; il n’enseigne pas le développement de plug-ins.
  2. Comme aucune interaction avec l’utilisateur n’est possible dans l’environnement Revit cloud, les références à l’interface doivent être supprimées du plug-in.
  3. Le processus présenté nécessite des modifications du code C# ; les personnes peu expérimentées en C# peuvent commencer à la deuxième tâche avec le plug-in d’exemple DeleteWalls.dll.
  4. Les requêtes peuvent être envoyées avec cURL ou exécutées à l’aide de la collection Postman préparée pour le walkthrough.

Autodesk Platform Services (APS) Design Automation API v3 permet de créer, d’examiner et de modifier des données Revit dans le cloud. Le walkthrough officiel d’Autodesk consacré à Revit montre comment exécuter un plug-in Revit existant dans l’environnement Automation Service, qui ne dispose pas d’interface utilisateur. Ce guide porte sur la préparation d’un plug-in existant pour une exécution dans le cloud et sur le suivi du flux de requêtes décrit dans la documentation, plutôt que sur le développement de plug-ins. La documentation ne précise ni version de Revit, ni configuration matérielle requise, ni tarif.

Quels types de tâches peuvent être transférés dans le cloud ?

  1. Identifiez les tâches répétitives. Commencez par déterminer quelles opérations sont fréquemment répétées dans les fichiers Revit ou doivent être appliquées à de nombreux modèles. La documentation APS présente Design Automation API comme un service permettant de lui transférer des charges de travail répétitives ou à grande échelle. Pour Revit, les cas d’usage cités comprennent la création de modèles, l’examen de données de modèles, la génération automatique de rapports, la modification de modèles existants selon les normes de l’entreprise et la préparation de la documentation.

    Cette étape permet de déterminer si le plug-in se prête réellement à l’automatisation. Si une opération dépend d’une décision de l’utilisateur ou d’un contrôle à l’écran, il peut être impossible de la transférer telle quelle dans le cloud. Clarifier au préalable les entrées et les résultats attendus aide à maîtriser le périmètre lors de la préparation du plug-in.

  2. Partez d’un plug-in Revit existant. Le walkthrough n’explique pas comment écrire un plug-in ; il se concentre uniquement sur son exécution dans Automation Service. Si vous n’avez pas encore de plug-in, ce guide ne doit pas être considéré à lui seul comme un tutoriel de création de plug-ins. Pour les informations sur le développement de plug-ins, Autodesk renvoie au Revit Developer Center.

    Cette distinction est importante : l’exécution dans le cloud ne remplace pas le développement du plug-in. Il ne faut pas supposer qu’un plug-in utilisé au bureau fonctionnera aussi dans le cloud ; les dépendances à l’interface et le déroulement des opérations doivent être examinés séparément. Limiter le premier essai à une tâche unique et clairement définie permet de mieux cerner les préparatifs nécessaires.

Préparer le plug-in à une exécution dans le cloud

  1. Supprimez les dépendances à l’interface utilisateur. Selon Autodesk, aucune interaction avec l’utilisateur n’est possible dans Automation Service. Les plug-ins Revit étant généralement conçus pour interagir avec l’interface utilisateur, toutes les références à celle-ci doivent être supprimées du plug-in avant son exécution dans le cloud.

    Dans cet environnement, personne ne peut ouvrir une fenêtre à l’écran pour faire une sélection ou cliquer sur un bouton de confirmation. Le processus doit donc être converti en un flux qui n’attend aucune décision intermédiaire de l’utilisateur. La documentation présente Task 1 comme l’étape consistant à rendre le plug-in compatible avec Automation API. La suppression des références à l’interface fait partie de cette préparation.

  2. Évaluez les modifications de code nécessaires. Le walkthrough d’Autodesk demande de modifier le code C# lors de la première tâche. Si vous n’avez pas suffisamment d’expérience en C#, la documentation indique que vous pouvez commencer à Task 2 avec le plug-in d’exemple prêt pour Automation API, nommé DeleteWalls.dll. Ce nom désigne le plug-in d’exemple ; il ne faut pas le considérer comme un outil polyvalent adapté à toutes les opérations Revit.

    Utiliser cet exemple peut aider à suivre les étapes d’envoi des requêtes, mais ne résout pas automatiquement les dépendances à l’interface ni la logique métier du plug-in d’un projet réel. Lors du passage à votre propre plug-in, il faudra examiner séparément le code et les opérations qu’il effectue. La documentation ne fournit ni liste précise des modifications de code à apporter ni recette de conversion applicable à tous les plug-ins.

Envoyer les requêtes et suivre le flux de travail

  1. Suivez l’ordre des tâches du walkthrough. Le walkthrough Revit décompose en plusieurs étapes le processus nécessaire à l’exécution du plug-in dans Automation Service. La première tâche se déroule uniquement dans Visual Studio ; aucune requête n’est envoyée à APS. C’est pourquoi la collection Postman d’Autodesk ne comporte pas de groupe pour Task 1.

    Cette précision évite à ceux qui cherchent la première tâche dans Postman de penser qu’il manque quelque chose. L’objectif est d’abord de rendre le plug-in compatible, puis de passer aux étapes de communication avec le service. Les noms des tâches et des requêtes sont associés dans la documentation ; les suivre permet de repérer à quelle étape correspond chaque requête.

  2. Utilisez Postman ou cURL. La collection Postman préparée par Autodesk regroupe les requêtes HTTP utilisées dans le walkthrough. Les requêtes y sont classées par tâche ; si vous ne souhaitez pas utiliser Postman, vous pouvez suivre le même walkthrough avec cURL. Postman est présenté comme une option avec interface pour envoyer des requêtes HTTP.

    Les équipes qui préfèrent envoyer les requêtes manuellement peuvent choisir cURL, tandis que celles qui souhaitent les exécuter dans une interface peuvent opter pour la collection Postman. L’essentiel est de suivre ensemble le nom de la requête d’exemple et la tâche à laquelle elle se rapporte. Le texte source ne fournit ni tableau de compatibilité des versions de Revit ni paramètres de requête applicables à tous les projets ; il ne faut donc pas supposer de valeurs absentes de la documentation.

  3. Exécutez l’opération dans l’environnement Revit cloud. APS donne accès, avec Automation API, à une version de Revit exécutée dans le cloud et dépourvue d’interface utilisateur. La documentation indique qu’il est possible d’accéder à Revit DB API sans installer Revit sur un poste de travail. Cette structure ouvre la voie à des applications et services cloud capables de créer, d’extraire et de modifier des données de modèle.

    À cette étape, vérifiez l’opération visée par le plug-in, les données d’entrée et le résultat attendu au regard des exigences du projet. Cette vérification finale ne signifie pas qu’Autodesk fournit une commande de validation spécifique ; c’est une pratique de projet qui peut contribuer à utiliser l’automatisation de manière fiable dans le flux de travail du bureau. Les sources ne précisent ni méthode détaillée de téléchargement des résultats ni version de Revit particulière.

Effets sur les flux de travail en architecture et en visualisation

Les équipes d’architecture et d’architecture d’intérieur qui effectuent régulièrement des contrôles, extraient des données, produisent des rapports ou préparent de la documentation dans des modèles Revit peuvent envisager cette approche. L’application d’opérations similaires à plusieurs modèles constitue notamment un bon point de départ pour déterminer si des tâches effectuées une à une sur un poste de travail se prêtent à l’automatisation cloud. Les sources ne donnent toutefois aucun chiffre concernant un gain de vitesse ou de temps.

Pour les équipes d’archviz, aucune fonction de rendu n’est décrite directement. La documentation porte sur l’exécution de plug-ins Revit dans le cloud ; elle ne précise ni moteur de rendu, ni réglage de qualité d’image, ni configuration de carte graphique requise. Il convient donc de limiter les cas d’usage aux données de modèle et aux opérations de plug-in Revit. Les conditions de licence et les tarifs ne sont pas non plus détaillés ici ; ils doivent être examinés séparément avant de passer à un flux de travail cloud.

Erreurs fréquentes

  • Transférer dans Automation Service, sans modification, un plug-in qui utilise l’interface utilisateur. La documentation exige la suppression des références à l’interface.

  • Prendre le walkthrough pour une formation au développement de plug-ins. Le guide explique comment exécuter un plug-in existant.

  • Chercher Task 1 dans la collection Postman. La première tâche se déroule dans Visual Studio et n’envoie aucune requête à APS.

  • Considérer l’exemple DeleteWalls.dll comme une solution prête à l’emploi pour tous les projets. La source le présente comme un plug-in d’exemple précis permettant de commencer à Task 2.

  • Supposer une version de Revit, un tarif, une configuration matérielle ou des paramètres de requête qui ne figurent pas dans la documentation. Ces éléments ne sont pas mentionnés dans les sources.

Sources

2 sources
A
aps.autodesk.comaps.autodesk.com/en/docs/design-automation/v3/developers_guide/overview
Résumé
A
aps.autodesk.comaps.autodesk.com/en/docs/design-automation/v3/developers_guide/revit
Résumé

Les textes sources ne sont pas republiés ; les courtes citations sont signalées, le reste est notre propre résumé et commentaire.

L’avis de 3dsınıfı
3dL’analyse de la rédaction

Pour les bureaux d’architecture et d’architecture d’intérieur en Turquie, APS Design Automation peut être une approche intéressante à étudier, notamment pour les équipes qui répètent les mêmes opérations Revit. Toutefois, le principal travail ne consiste pas simplement à envoyer une requête dans le cloud : il faut aussi supprimer les dépendances du plug-in à l’interface et vérifier qu’il produit le bon résultat dans le flux de travail réel. Il est donc préférable de commencer par une opération de portée limitée et clairement définie.

La documentation ne précise ni tarifs, ni conditions de licence, ni version de Revit, ni configuration matérielle requise ; il ne faut pas décider en supposant des coûts ou une compatibilité. De plus, l’exemple `DeleteWalls.dll` ne remplace pas les plug-ins utilisés par chaque bureau. Pour commencer concrètement, les équipes peuvent d’abord évaluer les besoins liés à leurs plug-ins existants et à leurs compétences en code, puis suivre le walkthrough officiel avec Postman ou cURL.

Questions fréquentes

Peut-on exécuter un plug-in Revit dans le cloud avec APS Design Automation ?

Oui. La documentation d’Autodesk sur APS Design Automation API v3 propose un walkthrough pour exécuter des plug-ins Revit dans Automation Service. L’environnement cloud ne permet aucune interaction avec l’utilisateur.

Que faut-il faire avant d’exécuter un plug-in Revit dans Automation Service ?

Il faut supprimer les références du plug-in à l’interface utilisateur. Le walkthrough d’Autodesk comprend également une étape de préparation qui nécessite de modifier le code C#.

Peut-on envoyer les requêtes Revit Automation API avec Postman ?

Oui. La collection Postman d’Autodesk regroupe les requêtes HTTP du walkthrough par tâche. Les requêtes peuvent également être envoyées avec cURL.

Les commentaires et le forum sont en turc.Rejoindre la discussion
+

À lire aussi