Traiter les modèles liés avec Revit Automation API : guide pas à pas

Ce que vous allez apprendre dans ce guide

Lorsqu’on associe un modèle Revit à un processus d’automatisation dans le cloud, on peut parfois télécharger un ZIP au lieu du fichier RVT attendu. Cela ne signifie pas nécessairement que le téléchargement a échoué : selon le guide d’Autodesk, si les fichiers liés d’un modèle Revit Cloud Worksharing ne sont pas dans le même état de publication à jour que le modèle principal, le paquet téléchargé peut contenir à la fois le fichier RVT principal et les fichiers RVT liés.

Dans ce guide, vous apprendrez à déterminer si un modèle est un fichier Revit Cloud Worksharing, s’il est identifié comme un projet composite et quelle méthode d’automatisation choisir. Nous examinerons également les différences entre le workflow des fichiers publiés avant le 7 février 2025 et celui des fichiers publiés à cette date ou après.

Autodesk indique que l’API Revit peut servir à automatiser des tâches répétitives et à étendre les fonctionnalités de Revit. Revit Automation API permet quant à elle d’effectuer des opérations telles que la création, l’examen et la modification de données Revit à l’aide d’applications et de services basés dans le cloud. Dans cet exemple, l’objectif est d’intégrer correctement le fichier Revit à un élément de travail d’automatisation.

Prérequis et préparation

Pour suivre ce workflow, il vous faut une application capable d’utiliser les API Autodesk Platform Services (APS), un moyen d’interroger les informations sur les fichiers et leurs versions, ainsi que les fichiers de modèle à intégrer à l’élément de travail. La page API d’Autodesk répertorie des guides pour les développeurs, des SDK, des exemples de code et des ressources communautaires. Revit Automation API permet de créer des applications cloud qui accèdent à l’API Revit DB sans nécessiter l’installation de Revit sur ordinateur.

L’ancienne annonce d’Automation API présente dans les sources mentionne un abonnement Forge actif ou un compte d’essai. Cette information ne confirme pas les conditions actuelles d’accès ou de tarification ; vérifiez les ressources APS les plus récentes concernant les prix et les exigences liées au compte avant de commencer. La documentation ne précise pas non plus de version de Revit particulière pour cette opération.

Avant de commencer, préparez les éléments suivants :

• L’enregistrement du fichier ou de la version du modèle Revit Cloud Worksharing à traiter sur APS.

• Les informations d’accès nécessaires pour effectuer des appels API authentifiés.

• Un outil permettant de vérifier la date de publication et les attributs associés à la version du fichier.

• Les informations d’enregistrement indiquant la date de publication du modèle et le nom du fichier principal.

Pas à pas : identifier le type de modèle et choisir la méthode de transfert

1. Vérifiez si le fichier est identifié comme un modèle Revit Cloud Worksharing. Le guide d’Autodesk recommande de consulter le champ attributes.extension.type dans les appels API qui renvoient le contenu d’un dossier de projet, l’enregistrement d’un élément ou les informations de version. Si ce champ a la valeur versions:autodesk.bim360:C4RModel, le fichier est identifié comme un modèle Revit Cloud Worksharing. Au lieu de vous fier uniquement à l’extension du fichier, examinez les données de version.

2. Consultez l’état du projet composite. Le champ attributes.data.isCompositeDesign du même enregistrement de version indique si le modèle est composite. Si la valeur est true, il s’agit d’un projet Revit composite ; le contenu téléchargé peut être un ZIP contenant le modèle principal et les fichiers RVT liés. Si la valeur est false, selon Autodesk, le fichier principal et ses liens ont été publiés avec leurs versions les plus récentes et le téléchargement peut être un seul fichier RVT.

3. Identifiez le nom du fichier du modèle principal. Dans un modèle composite, le champ attributes.data.compositeParentFile indique le nom du fichier Revit principal. Cette information est nécessaire, notamment dans l’ancien workflow, pour savoir quel fichier du ZIP utiliser comme modèle principal. Ne devinez pas son nom : fiez-vous à la valeur de l’enregistrement de version.

4. Choisissez la méthode en fonction de la date de publication. Si le fichier a été publié avant le 7 février 2025, vous pouvez utiliser l’ancienne méthode d’Autodesk : définissez zip sur true pour le fichier d’entrée de l’élément de travail, puis indiquez le nom du fichier du modèle principal dans pathInZip. Le paquet ZIP est ainsi transmis au processus d’automatisation, avec le chemin vers le fichier principal que Revit doit ouvrir.

5. Pour un modèle publié le 7 février 2025 ou après, suivez la nouvelle méthode. Pour un fichier publié à cette date ou après, Autodesk recommande d’utiliser l’appel GET linked Revit files afin de récupérer le modèle principal et les fichiers RVT liés non publiés. Intégrez à l’élément de travail les informations renvoyées sur le modèle principal et les fichiers liés. Au lieu d’appliquer directement l’ancienne approche par ZIP, utilisez la méthode déterminée par cette date.

6. Vérifiez les entrées de l’élément de travail. Si vous avez choisi l’ancienne méthode, assurez-vous que le paramètre ZIP et la valeur pathInZip sont corrects. Avec la nouvelle méthode, vérifiez que les fichiers liés renvoyés par l’appel sont transmis avec le modèle principal. Dans l’exemple d’Autodesk, des URL signées sont utilisées pour ces fichiers ; utilisez les valeurs à jour renvoyées par votre propre appel API au lieu de copier les URL de l’exemple.

Erreurs fréquentes

• Considérer automatiquement le ZIP comme un fichier endommagé : si les versions récentes des modèles liés n’ont pas été publiées, recevoir un ZIP peut être normal.

• Confondre le type de modèle et son état composite : la valeur C4RModel identifie le type de fichier Cloud Worksharing ; isCompositeDesign indique si le projet est composite. Effectuez les deux vérifications.

• Choisir le fichier RVT principal par supposition : utilisez le champ compositeParentFile pour identifier le bon nom de fichier dans le ZIP.

• Ignorer la distinction de date : le guide décrit des méthodes de transfert différentes pour les fichiers publiés avant et après le 7 février 2025.

• Utiliser les liens d’accès temporaires de l’exemple : les URL signées de la source font partie d’une réponse d’exemple. Utilisez les liens renvoyés par votre propre appel.

Conséquences pour les workflows d’architecture et de visualisation

Cette approche est importante pour les équipes qui intègrent des tâches répétitives d’examen de modèles, d’extraction de données, de création de rapports ou de documentation automatisée à des workflows Revit dans le cloud. Parmi les cas d’utilisation cités par Autodesk figurent l’examen et l’analyse des données Revit, leur exportation, la création de familles Revit personnalisées et la génération automatique de documentation. Les agences d’architecture, les équipes d’architecture d’intérieur et les responsables BIM peuvent réduire le risque d’utiliser des données d’entrée erronées ou incomplètes en vérifiant l’état des versions des modèles liés avant l’automatisation.

Pour les équipes de visualisation également, le transfert conjoint du fichier principal et de ses liens permet à l’automatisation de fonctionner avec les données de projet attendues. Toutefois, ce guide ne fournit aucune information sur les performances de rendu, les exigences matérielles ou la compatibilité avec un logiciel de visualisation particulier. Avant la mise en œuvre, vérifiez les conditions d’accès à l’API, le statut de la licence et la compatibilité du workflow utilisé avec les données Revit.

Étapes suivantes

Effectuez votre premier essai sur un modèle qui n’est pas critique. Enregistrez les attributs de version du fichier, vérifiez sa date de publication et choisissez la méthode correspondant à cette date. Contrôlez dans le résultat de l’automatisation que le fichier RVT principal attendu a bien été traité. Vous pourrez ensuite consulter les guides de l’API Revit, les tutoriels de démarrage et les exemples de code d’Autodesk pour adapter le workflow à vos besoins d’extraction de données ou de création de rapports.

Sources et licence

Ce guide a été adapté en turc à partir des pages d’Autodesk consacrées à Revit Automation API et à l’API Revit, ainsi que d’un article destiné aux développeurs expliquant comment intégrer des projets Revit composites à des éléments de travail d’automatisation. Toutes les sources sont des contenus officiels destinés aux développeurs et publiés sous licence libre.