Run Dynamo

Run Dynamo exécute un graphe Dynamo .dyn sélectionné depuis Revit en mode d’automatisation sans interface, sans ouvrir l’espace de travail Dynamo. Avant l’exécution, BIMO peut appliquer des valeurs d’entrée enregistrées ; après l’exécution, il peut afficher les valeurs des nœuds marqués comme sorties.

La commande se trouve dans BIMO > Interact > Run Dynamo.

Avertissement : un graphe Dynamo peut modifier le modèle Revit actif, écrire des fichiers ou appeler des services externes. Run Dynamo n’est pas un bac à sable et ne fournit pas d’annulation automatique. Testez un graphe inconnu sur une copie du modèle et enregistrez votre travail avant de le lancer.

Cette page décrit la commande intégrée de la bibliothèque BIMO. Pour faire apparaître un fichier .dyn comme une commande dédiée avec son propre nom dans le ruban, consultez Create commands from Dynamo .dyn.

Disponibilité et versions de Revit

Run Dynamo est présent et visible dans le ruban BIMO standard. Les sources actuelles ne concordent pas sur la version minimale réellement prise en charge :

L’ancienne page du site indique Revit 2023 et versions ultérieures. Le tableau ci-dessus suit l’implémentation exécutable plutôt que cette affirmation plus générale.

Quand l’utiliser

• Exécuter occasionnellement un fichier .dyn sans ouvrir l’interface Dynamo.

• Réutiliser un même graphe avec différents chemins ou valeurs grâce aux presets.

• Lancer des configurations fréquentes au moyen de trois variants dans le ruban.

• Afficher un calcul ou un rapport provenant de nœuds de sortie Dynamo.

• Exécuter un graphe validé qui modifie le modèle Revit actif.

Utilisez plutôt une commande Dynamo personnalisée générée lorsque le graphe doit disposer de son propre nom dans le ruban, d’entrées de sélection Revit typées ou d’une identité de commande distincte.

Avant l’exécution

• Fermez l’interface Dynamo. Run Dynamo refuse de démarrer tant que Dynamo est ouvert en mode interface.

• Ouvrez le document et la vue Revit attendus par le graphe.

• Ouvrez et testez manuellement le graphe dans la version de Dynamo utilisée par la version actuelle de Revit.

• Enregistrez le fichier .dyn dans un emplacement stable et accessible.

• Installez tous les packages Dynamo requis et rendez disponibles les fichiers externes nécessaires.

• Marquez les nœuds réutilisables comme Is Input et les nœuds de résultat comme Is Output dans Dynamo.

• Enregistrez ou sauvegardez le modèle Revit avant d’exécuter un graphe qui le modifie.

Réglages

Chaque ligne d’entrée contient :

Important : le formulaire ne vérifie pas que le fichier existe ni que chaque valeur peut être appliquée. Un fichier vide, déplacé ou incompatible peut donc atteindre l’étape d’exécution et échouer à ce moment-là.

Procédure

1. Fermez Dynamo et ouvrez le document Revit cible.

2. Lancez BIMO > Interact > Run Dynamo.

3. Dans Script file, sélectionnez le fichier .dyn requis.

4. Si le graphe contient des entrées réutilisables, cliquez sur From Script.

5. Contrôlez chaque Input ID, Input Name et Value importé.

6. Confirmez les réglages pour démarrer le graphe.

7. Attendez la fin de l’exécution et examinez la boîte de dialogue de résultat ou d’erreur BIMO.

L’élément principal Run Dynamo ouvre toujours sa fenêtre de réglages avant l’exécution. Une fois le graphe démarré, l’implémentation actuelle ne fournit ni fenêtre de progression BIMO ni bouton d’annulation.

Préparer les entrées

From Script lit les nœuds enregistrés comme entrées Dynamo et remplace la liste actuelle par les valeurs stockées dans le graphe. Si vous cliquez de nouveau sur ce bouton après avoir modifié les valeurs, contrôlez la liste : les valeurs par défaut enregistrées dans le graphe sont rechargées.

L’affectation des entrées suit plusieurs règles importantes :

• BIMO recherche une entrée par l’ID du nœud, et non par son nom affiché.

• Les noms servent uniquement de libellés et ne peuvent pas corriger un ID obsolète ou incorrect.

• Les valeurs sont transmises sous forme de chaînes ; utilisez le format attendu par le nœud cible.

• Pour une liste déroulante, utilisez le nom exact de l’élément enregistré dans Dynamo.

• Si l’ID du nœud est introuvable ou si Dynamo refuse la mise à jour, le service actuel ne signale pas individuellement cette entrée et peut exécuter le graphe avec la valeur déjà enregistrée.

• La commande intégrée ne propose pas de sélecteurs Revit typés pour les éléments, faces ou arêtes. Les graphes nécessitant une nouvelle sélection interactive conviennent mieux à des commandes Dynamo personnalisées générées.

Après avoir modifié les nœuds d’entrée d’un graphe, enregistrez le fichier .dyn, relancez From Script et contrôlez les presets qui dépendent des anciens ID.

Exécution et sorties

BIMO démarre Dynamo en mode d’automatisation sans interface, charge le graphe, applique les lignes d’entrée et force une exécution.

Lors d’une exécution réussie :

• seules les valeurs des nœuds marqués Is Output sont collectées ;

• un seul nœud de sortie est affiché sans préfixe correspondant au nom du nœud ;

• plusieurs nœuds de sortie sont affichés avec leurs noms ;

• les collections et dictionnaires sont formatés pour être lisibles ;

• le résultat peut être copié dans le presse-papiers.

Si le graphe ne contient aucun nœud de sortie ou si sa sortie formatée est vide, BIMO n’affiche aucune boîte de dialogue de réussite. Cela ne prouve pas que le graphe ne s’est pas exécuté ni qu’il n’a pas modifié le modèle.

En cas d’erreur :

• les nœuds Dynamo à l’état Error produisent une boîte de dialogue d’erreur ;

• les détails de l’exception peuvent être développés et copiés ;

• tous les avertissements Dynamo ordinaires ne sont pas considérés comme des échecs ;

• la détection des erreurs intervient après l’exécution du graphe et ne garantit donc pas l’annulation des modifications antérieures.

Presets et variants

Run Dynamo prend en charge des presets enregistrant :

• le chemin du fichier .dyn ;

• les ID et noms d’entrée importés ;

• les valeurs d’entrée.

Un preset peut être affecté à Variant #1, Variant #2 ou Variant #3. L’élément principal ouvre les réglages ; un variant utilise son preset affecté et peut ignorer la fenêtre lorsque le formulaire est considéré comme valide.

Avertissement : la validation du chemin ne vérifie pas que le fichier existe encore. Un variant peut donc tenter d’exécuter un graphe déplacé ou supprimé sans rouvrir d’abord la fenêtre de réglages.

Chaque variant est un élément de commande distinct du ruban Revit et peut recevoir un raccourci clavier. Un raccourci démarre immédiatement le preset affecté : vérifiez le document actif, le chemin du graphe et les entrées susceptibles de modifier le modèle avant de l’utiliser.

Après l’exécution d’un variant, BIMO restaure le preset précédemment actif. Consultez Presets and Variants.

Exemples

Exécuter un contrôle en lecture seule

Préparez un graphe qui lit le document actif et marque un nœud de synthèse comme Is Output. Importez ses entrées, enregistrez un preset et exécutez-le dans le projet cible. Examinez ou copiez le résultat.

Remplir des paramètres avec deux configurations

Enregistrez des presets distincts pour les valeurs de test et de production. Vérifiez les deux sur une copie avant d’affecter le preset de production à un variant.

Exporter des données

Utilisez un nœud d’entrée pour le chemin d’export et marquez un nœud de statut comme Is Output. Vérifiez que la destination existe et que le graphe peut créer ou écraser les fichiers comme prévu.

Impact sur le modèle et le système

• Le graphe s’exécute avec accès à l’environnement Revit/Dynamo actif.

• Les modifications du modèle, l’accès aux fichiers, les appels réseau et le comportement des packages dépendent du graphe et de ses nœuds.

• BIMO ne prévisualise pas les modifications et n’enveloppe pas l’ensemble du graphe dans une annulation garantie.

• Un graphe peut effectuer des modifications partielles avant qu’une erreur ne soit signalée.

• Le comportement de Undo dépend de Dynamo et des nœuds utilisés ; ne supposez pas que toute l’exécution correspond à une seule action réversible.

• BIMO ne permet pas d’annuler une fois l’exécution sans interface commencée.

Erreurs et dépannage

Limites connues

• L’implémentation d’exécution confirmée commence actuellement avec Revit 2024 malgré des métadonnées indiquant 2023.

• Accepte un seul fichier de graphe par preset et ne valide pas son existence avant l’exécution.

• Fonctionne sans interface et ne peut pas s’exécuter lorsque l’interface Dynamo est ouverte.

• Ne fournit ni affichage de progression BIMO ni annulation de l’exécution.

• Les lignes d’entrée intégrées sont des chaînes et ne proposent pas de sélecteurs d’objets Revit typés.

• Les échecs de mise à jour des entrées ne sont pas signalés individuellement.

• Tous les avertissements ou nœuds non pris en charge ne sont pas remontés comme erreurs bloquantes.

• Affiche uniquement les valeurs des nœuds Dynamo marqués comme sorties.

• Ne garantit pas l’annulation après une erreur du graphe.

Pages associées

• BIMO Toolbar Settings

• Presets and Variants

• Create commands from Dynamo .dyn

• Run Python