Dernières actualités
Visibilité des Scope Box dans Revit : comment la contrôler ?Traiter les projets Revit avec modèles liés via l’Automation APIFlou de mouvement réaliste dans Blender : réglages de l’obturateur et workflowRhino : Flow et FlowAlongSrf pour adapter une géométrie à une courbe ou une surfaceCaméra panoramique dans Blender : 360°, VR et projection dômeBlender 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 Blender
TutorielsRevitOMARevit Automation API

Traiter les projets Revit avec modèles liés via l’Automation API

Ce guide explique comment déterminer si les projets Revit Cloud Worksharing sont téléchargés sous forme d’archive ZIP ou de fichier RVT unique, et comment intégrer les modèles liés à un flux de travail Automation API.

Flux de travail BIM dans le cloud représenté par des volumes architecturaux liésImage IA
Image d’illustration générée par IA.Image : 3dsınıfı / FCA AI

En bref

  1. Vérifiez le champ `isCompositeDesign` pour savoir si un modèle Revit Cloud Worksharing contient une conception composite.
  2. Si `isCompositeDesign` vaut true, le téléchargement peut prendre la forme d’une archive ZIP contenant le modèle hôte et les fichiers RVT liés.
  3. Pour les fichiers publiés le 7 février 2025 ou après cette date, l’appel GET linked Revit files permet de récupérer les modèles liés.
  4. Dans l’ancien flux de travail, l’entrée ZIP est indiquée avec `zip: true`, et le nom du modèle hôte dans l’archive avec le champ `pathInZip`.

Ce que vous allez apprendre dans ce guide

Nous allons voir étape par étape pourquoi un fichier publié via Revit Cloud Worksharing est parfois téléchargé sous forme d’archive ZIP plutôt que d’un seul fichier RVT, et comment intégrer cette conception à un flux de travail Automation API. La distinction essentielle est de savoir si le modèle correspond à une conception composite : les modèles RVT liés peuvent alors se trouver dans le même paquet que le fichier hôte. Par conséquent, lors de la préparation d’une tâche d’automatisation, l’extension du fichier ne suffit pas ; il faut également vérifier les informations renvoyées par l’API pour la version du fichier.

Ce guide s’appuie sur les champs d’API décrits dans la documentation Autodesk Platform Services et présente deux flux de travail distincts. La date charnière entre l’ancienne et la nouvelle méthode est le 7 février 2025. L’objectif n’est pas de détailler toutes les étapes d’authentification et de configuration de l’application pour les appels API, mais d’interpréter les informations du modèle dont vous disposez et de choisir le bon format d’entrée.

Prérequis

  • Disposez d’un accès à un projet Revit Cloud Worksharing et à l’API Autodesk Platform Services permettant de lire les informations des fichiers. L’exemple des sources examine les informations du projet et des versions de fichiers au moyen d’appels API.

  • Tenez compte des conditions relatives à une version d’essai Forge active ou à un abonnement, mentionnées dans les sources, pour utiliser Automation API. La source concernée renvoie vers une page distincte pour les détails tarifaires ; aucun tarif actuel n’est indiqué ici.

  • Assurez-vous de pouvoir vérifier la date de publication du modèle ainsi que les champs attributes.extension et attributes.data dans la réponse relative à la version du fichier.

  • Ne partez pas du principe qu’une installation de Revit pour ordinateur est indispensable à ce flux de travail : la présentation d’Autodesk sur Revit Automation API indique que l’API de la base de données Revit est accessible sans installation de Revit pour ordinateur. Cela ne signifie toutefois pas qu’il est possible de se passer d’un accès à l’API ou des entrées de projet nécessaires.

Les sources ne précisant ni numéro de version de Revit, ni tarif d’abonnement actuel, ni procédure complète de configuration de l’authentification, ces informations ne sont pas supposées ici.

Étapes : identifier la conception et préparer la tâche

  1. Vérifiez que le fichier correspond à un modèle Revit Cloud Worksharing. Examinez le champ attributes.extension.type dans la réponse aux appels API portant sur le contenu du projet, l’élément fichier ou les versions. Si la valeur est versions:autodesk.bim360:C4RModel, la source indique que le fichier est un modèle Revit Cloud Worksharing. Cette vérification est la première étape pour interpréter correctement les informations relatives à une conception composite.

  2. Lisez l’indicateur de conception composite. Dans la même réponse de version, repérez le champ attributes.data.isCompositeDesign. Si sa valeur est true, le modèle est identifié comme une conception composite ; le téléchargement peut alors être une archive ZIP contenant le modèle hôte et les fichiers RVT liés. Si sa valeur est false, la source précise qu’un seul fichier RVT est récupéré lorsque les dernières versions du fichier hôte et des fichiers liés sont publiées.

  3. Déterminez le nom du modèle hôte. Pour une conception composite, le champ attributes.data.compositeParentFile indique le nom du fichier Revit hôte. Cette valeur est utilisée notamment dans l’ancien flux de travail, où il faut sélectionner le modèle principal contenu dans l’archive ZIP. Considérez-la comme un nom de fichier ; ne la remplacez pas par une valeur devinée.

  4. Évaluez la date de publication par rapport au 7 février 2025. La source décrit l’ancienne méthode pour les modèles publiés avant cette date et la nouvelle méthode pour ceux publiés à cette date ou après. Prenez votre décision à partir de la valeur attributes.createTime du fichier. Appliquer le même format d’entrée à tous les modèles sans vérifier leur date peut créer un décalage entre le fichier attendu par la tâche et le fichier effectivement fourni.

  5. Définissez l’entrée ZIP dans l’ancien flux de travail. Si le fichier a été publié avant le 7 février 2025 et contient une conception composite, définissez zip sur true dans les paramètres inputFile de la tâche. Dans le champ pathInZip, indiquez le nom du fichier hôte figurant dans compositeParentFile. La tâche utilise ainsi l’archive ZIP comme entrée, tout en précisant le fichier RVT à traiter à l’intérieur. La source illustre cette méthode avec une tâche d’exportation DXF ; appliquez cette logique en fonction des exigences de l’activité sélectionnée.

  6. Dans le nouveau flux de travail, récupérez ensemble le modèle hôte et les fichiers liés. Pour les fichiers publiés le 7 février 2025 ou après, l’appel GET linked Revit files peut renvoyer le modèle hôte ainsi que les fichiers RVT liés non publiés. Vérifiez le fichier hôte et les résultats linkedFiles dans la réponse, puis contrôlez les noms des modèles, les informations de version et leur état de publication. Transmettez ensuite aux entrées de la tâche les URL signées fournies par cet appel. L’exemple de la source indique l’état Published pour le fichier hôte et NotPublished pour le fichier lié ; ces états montrent que le modèle hôte et le modèle lié ne sont pas nécessairement dans le même état de publication.

  7. Vérifiez la structure des entrées avant d’exécuter la tâche. L’ancienne méthode utilise l’archive ZIP et le nom du fichier hôte qu’elle contient ; la nouvelle s’appuie sur les URL du modèle hôte et des fichiers liés renvoyées par GET linked Revit files. Ne mélangez pas ces deux approches comme s’il s’agissait d’une seule structure. Vérifiez que les entrées attendues par l’activité de la tâche correspondent aux fichiers récupérés via l’API.

Erreurs fréquentes

Interpréter le téléchargement d’une archive ZIP comme un signe que le fichier est corrompu peut induire en erreur lorsque des modèles liés non publiés sont présents. Commencez par examiner le champ isCompositeDesign et le nom du modèle hôte. Autre erreur : utiliser zip: true pour chaque fichier sans vérifier la valeur de isCompositeDesign ; pour un modèle non composite, ce paramètre peut ne pas correspondre à l’entrée RVT unique attendue.

La date de publication mérite également attention. D’après la source, les fichiers antérieurs au 7 février 2025 relèvent de l’ancienne méthode, tandis que ceux publiés à cette date ou après sont traités avec GET linked Revit files. Enfin, ne remplacez pas la valeur de compositeParentFile par un nom de fichier arbitraire et, avec la nouvelle méthode, ne récupérez pas uniquement le modèle hôte en omettant les fichiers liés.

Conséquences pour les flux de travail en architecture et visualisation

Cette distinction est importante pour les équipes qui exportent, examinent ou analysent automatiquement des données Revit dans le cloud. Il est possible que les modèles liés d’un même projet ne soient pas tous publiés au même moment ; une automatisation qui attend un seul RVT peut donc traiter des données incomplètes si elle ne gère pas correctement les entrées composites. Vérifier les informations du modèle au préalable aide l’automatisation à traiter le bon ensemble de fichiers.

Pour les agences d’architecture et les équipes BIM, les principaux points d’attention ne concernent pas le matériel, mais l’accès à l’API, les conditions d’abonnement et la configuration correcte des entrées de fichier. Les équipes de visualisation peuvent également tirer parti de ce flux pour des tâches répétitives telles que l’exportation ou l’analyse de modèles ; toutefois, les sources ne précisent ni la compatibilité avec un logiciel de rendu particulier, ni la durée de traitement, ni les coûts. Il est judicieux d’effectuer un test de validation à petite échelle avec l’activité et la structure de fichiers utilisées avant de passer en production.

Étapes suivantes

Les ressources pour développeurs Revit API d’Autodesk répertorient des guides de démarrage, des exemples de code et une assistance communautaire. Commencez par vérifier dans la réponse de version du fichier le type de modèle, l’indicateur de conception composite et le nom du modèle hôte. Choisissez ensuite la méthode adaptée à la date de publication et testez les entrées de la tâche. Pour étendre le flux de travail, vous pouvez examiner les cas d’utilisation mentionnés dans les sources, tels que l’extraction et la modification de données Revit, la génération automatique de rapports et la production de documentation.

Sources et licence

Ce guide s’appuie sur la présentation générale de Revit API d’Autodesk Platform Services, l’annonce d’Automation API et le guide de traitement des conceptions Revit composites. Les trois sources sont en accès libre (licence=libre) ; leur contenu a été adapté en turc.

Sources

3 sources
A
aps.autodesk.comaps.autodesk.com/developer/overview/revit
Résumé
A
aps.autodesk.comaps.autodesk.com/blog/design-automation-api-revit-inventor-3ds-max-now-available
Résumé
A
aps.autodesk.comaps.autodesk.com/blog/make-composite-revit-design-work-revit-automation-api
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 agences en Turquie, l’avantage le plus concret de cette approche est qu’elle permet de repérer, avant le démarrage de l’automatisation, les entrées ZIP inattendues dues à l’état de publication des modèles liés. Pour les équipes qui réalisent régulièrement des exportations et des analyses de modèles, choisir le bon format d’entrée peut réduire le besoin de relancer les tâches et de trier manuellement les fichiers.

Pour décider d’investir, la priorité va à l’accès à l’API, aux conditions d’abonnement et à la compatibilité avec le flux de travail existant, avant même le matériel puissant. Les sources ne précisant ni les tarifs actuels ni les coûts de traitement, les agences doivent évaluer leurs propres cas d’usage au moyen d’un petit test. Pour les étudiants aussi, il s’agit d’un exemple utile pour comprendre comment transférer des modèles Revit liés vers une automatisation dans le cloud ; la compatibilité avec une version logicielle particulière doit toutefois être vérifiée séparément.

Questions fréquentes

Comment savoir si un fichier correspond à une conception composite dans Revit Automation API ?

Vérifiez le champ `attributes.data.isCompositeDesign` de la version du fichier. Si sa valeur est `true`, la conception est identifiée comme composite et le téléchargement peut être une archive ZIP contenant le modèle hôte et les fichiers RVT liés.

Quelle méthode permet d’intégrer les modèles Revit liés à Automation API ?

Pour les fichiers publiés le 7 février 2025 ou après, l’appel GET linked Revit files peut fournir le modèle hôte et les fichiers liés. Les URL signées de cette réponse sont transmises aux entrées de la tâche.

Faut-il installer Revit pour ordinateur pour utiliser Revit Automation API ?

Selon la présentation d’Autodesk sur Revit Automation API, l’API de la base de données Revit est accessible sans installation de Revit pour ordinateur. Les sources mentionnent séparément les conditions d’accès à l’API et d’abonnement.

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

À lire aussi