En bref
- APS Automation Service donne accès à une version de Revit sans interface graphique.
- Pour exécuter des plugins dans le cloud, il faut supprimer les références dépendantes de l’interface utilisateur.
- La préparation nécessite de modifier le code C# ; les personnes sans expérience en C# peuvent commencer à Task 2 avec le fichier DeleteWalls.dll fourni.
- Selon le walkthrough officiel, les requêtes HTTP peuvent être envoyées avec cURL ou avec une collection Postman.
La documentation d’Autodesk sur APS Design Automation API v3 propose un walkthrough détaillé aux développeurs qui souhaitent exécuter des plugins Revit sur Automation Service. Ce guide explique comment préparer un plugin existant pour qu’il fonctionne dans le cloud et suivre les requêtes HTTP nécessaires avec Postman ou cURL. APS met à disposition dans le cloud une version de Revit sans interface graphique et donne accès à l’API Revit DB. Il est ainsi possible de créer, d’examiner et de modifier des données de modèles sans installer Revit sur un ordinateur de bureau.
Définir le périmètre avant de commencer
Définissez la tâche à automatiser. Autodesk indique que l’Automation API permet de développer des applications cloud qui produisent, extraient et modifient des données Revit. La documentation cite notamment la création de familles Revit personnalisées, l’automatisation de la configuration d’un modèle, l’analyse de données de modèles, la génération de rapports, la modification de modèles existants selon les normes de l’entreprise et la création de documentation. Commencez par déterminer laquelle de ces tâches le plugin doit effectuer.
Tenez compte des limites du walkthrough. Ce document explique comment exécuter un plugin existant sur Automation Service, et non comment réécrire un plugin Revit depuis le début. Pour le développement de plugins, il renvoie vers le Revit Developer Center d’Autodesk, une ressource distincte. Séparer le développement des étapes d’exécution dans le cloud aide à interpréter correctement les consignes du guide.
Ne partez pas du principe que l’interface de bureau sera disponible. L’interaction avec l’utilisateur n’est pas prise en charge sur Automation Service. Un plugin qui communique avec l’interface de Revit doit donc être débarrassé de ces dépendances avant d’être exécuté dans le cloud. Si le plugin attend une sélection ou une confirmation de l’utilisateur, il faut également réfléchir à la manière de gérer ces étapes dans un environnement automatisé. La condition de préparation fondamentale explicitement énoncée dans le walkthrough officiel est la suppression des références à l’interface.
Préparer le plugin Revit pour l’Automation API
Supprimez les références à l’interface. La première tâche du walkthrough consiste à rendre le plugin Revit compatible avec l’Automation API. Cette opération nécessite de modifier le code C# et de supprimer les références liées à l’interface utilisateur. Le service ne permettant aucune interaction avec l’utilisateur, conserver telles quelles les fonctions liées à l’interface risque de créer un décalage entre le fonctionnement du plugin et les contraintes de l’environnement cloud.
Choisissez la marche à suivre en fonction de votre maîtrise du C#. Les développeurs qui connaissent le C# peuvent suivre les étapes de préparation de la première tâche du walkthrough. À ce stade, les parties du plugin existant liées à l’interface sont retirées afin de l’adapter à l’exécution dans le cloud. Le guide n’étant pas un tutoriel général de développement de plugins, nous n’ajoutons pas d’exemples de code ni de détails de mise en œuvre qui ne figurent pas dans la documentation.
Utilisez l’exemple fourni. Les personnes sans expérience en C# peuvent télécharger le fichier
DeleteWalls.dllfourni par Autodesk, ignorer la première tâche et commencer à Task 2. Elles peuvent ainsi suivre les étapes d’exécution d’un plugin sur le service à partir d’un fichier d’exemple. Toutefois, la disponibilité d’une DLL prête à l’emploi ne signifie pas qu’un autre plugin fonctionnera sans modification ; les dépendances à l’interface de chaque plugin doivent être évaluées séparément.
Envoyer des requêtes avec Postman ou cURL
Suivez l’ordre des tâches indiqué dans le walkthrough. Le guide décrit les requêtes HTTP utilisées pour exécuter un plugin sur Automation Service. Les personnes qui préfèrent Postman peuvent importer la collection de tutoriels APS vers laquelle Autodesk fournit un lien. Les requêtes de la collection sont regroupées par tâche et leurs noms correspondent aux étapes du walkthrough. Il est également possible d’envoyer ces mêmes requêtes avec cURL.
N’oubliez pas que Task 1 ne figure pas dans la collection. La préparation du plugin s’effectue dans Visual Studio et n’implique pas l’envoi d’une requête HTTP à APS. C’est pourquoi la collection Postman ne comporte aucun groupe pour Task 1. Une fois la préparation du plugin terminée, vous pouvez poursuivre avec les tâches correspondantes de la collection.
Comparez les noms des tâches et des requêtes. Les groupes et les requêtes de la collection portent les mêmes noms que les étapes du walkthrough, ce qui permet de repérer la place de chaque requête dans le processus. Vérifiez d’abord que la préparation du plugin est terminée, puis suivez l’ordre donné dans la documentation. Nous n’ajoutons pas de commandes supplémentaires pour l’authentification, le chargement de fichiers ou les paramètres d’exécution qui ne sont pas expliqués dans le walkthrough source.
Conséquences pour les workflows d’architecture et de visualisation
Les agences d’architecture et d’architecture d’intérieur qui souhaitent automatiser des opérations récurrentes sur les modèles Revit, des contrôles de conformité ou la production de rapports peuvent envisager d’exécuter leurs plugins dans le cloud. Selon Autodesk, l’Automation API donne accès aux workflows de création, d’extraction et de modification des données de modèles via l’API Revit DB. Cette solution peut être pertinente pour les équipes qui veulent dissocier les tâches répétitives de l’utilisation de Revit sur ordinateur. Toutefois, les sources ne fournissent aucune donnée chiffrée sur la durée de traitement, la capacité, le coût ou les performances.
Les équipes d’archviz peuvent étudier les utilisations possibles pour l’examen et le traitement automatisé des données de modèles ; toutefois, le walkthrough ne précise ni la compatibilité avec des moteurs de rendu spécifiques ni les paramètres de rendu. Il ne faut donc pas interpréter la possibilité d’exécuter un plugin Revit dans le cloud comme une confirmation de la prise en charge d’un outil de visualisation particulier. La documentation ne précise pas non plus les exigences matérielles locales, les licences ou les tarifs. Ces points doivent être vérifiés séparément avant toute mise en œuvre.
Erreurs fréquentes
Exécuter sans préparation un plugin dépendant de l’interface : l’interaction avec l’utilisateur n’étant pas disponible sur Automation Service, les références à l’interface doivent être supprimées.
Prendre le walkthrough pour un tutoriel de développement de plugins : le guide décrit le processus d’exécution dans le cloud d’un plugin existant.
Chercher Task 1 dans la collection Postman : la préparation s’effectue dans Visual Studio, cette tâche ne figure donc pas dans la collection.
Considérer l’exemple de DLL comme une solution prête à l’emploi pour tous les plugins :
DeleteWalls.dllest fourni comme exemple de départ ; tout autre plugin doit être préparé séparément pour fonctionner dans le cloud.
Pour suivre le walkthrough Revit d’APS Design Automation API v3, l’ordre général consiste à supprimer les dépendances du plugin à l’interface, à le préparer avec C# ou à partir de l’exemple fourni, puis à suivre les requêtes HTTP avec Postman ou cURL. Les aspects de compatibilité, de coût et de performances qui ne sont pas couverts par le guide doivent être vérifiés séparément.
Sources
2 sourcesLes textes sources ne sont pas republiés ; les courtes citations sont signalées, le reste est notre propre résumé et commentaire.
Pour les agences d’architecture et d’architecture d’intérieur en Turquie, l’intérêt pratique de cette approche tient à la possibilité de transférer des opérations Revit répétitives vers un workflow cloud. Elle peut être envisagée pour l’analyse des données de modèles, le contrôle des normes et la création de rapports ; toutefois, les dépendances du plugin à l’interface doivent être supprimées au préalable.
Avant de prendre une décision, il est important de se renseigner séparément sur les licences et les tarifs ; la documentation officielle ne précise ni les coûts, ni la capacité, ni les exigences matérielles. La compatibilité avec les moteurs de rendu ne relève pas non plus du périmètre du walkthrough. Il serait judicieux pour les agences de commencer par tester un workflow limité et de vérifier que le plugin utilisé est adapté à l’environnement cloud.
Questions fréquentes
Un plugin Revit peut-il utiliser l’interface utilisateur sur APS Automation Service ?
Non. Selon le walkthrough d’Autodesk, aucune interaction avec l’utilisateur n’est possible sur Automation Service. Les références à l’interface doivent être supprimées avant l’exécution du plugin.
Faut-il connaître le C# pour exécuter un plugin Revit via APS ?
La tâche de préparation nécessite de modifier le code C#. Les personnes sans expérience en C# peuvent commencer à Task 2 avec le fichier DeleteWalls.dll fourni par Autodesk.
Comment utiliser la collection Postman du walkthrough APS Revit ?
La collection regroupe les requêtes par tâche et leurs noms correspondent aux étapes du walkthrough. La préparation du plugin s’effectuant dans Visual Studio, Task 1 ne figure pas dans la collection.



