GUIDE PRODUIT

Manuel Toolbox pour ExyViewer et JaMo App

Cette page sert de manuel de travail. Elle explique les commandes réellement exposées dans ExyViewer et les flux JaMo App représentés dans ce dépôt, afin que l’utilisateur sache où cliquer, quelles entrées préparer et quel résultat attendre.

Le contenu provient de la barre d’outils ExyViewer réelle, des panneaux latéraux, du module Drawing, ainsi que des flux JaMo App actuels de compatibilité, achat, téléchargement et activation présents dans ce dépôt.

catégories

commandes

Sommaire

ExyViewer + JaMo App

Résumé d’audit

Faiblesses de la page actuelle

La page Toolbox actuelle ressemble à une page marketing plutôt qu’à une page de référence.
Le contenu JaMo App reste général et orienté bénéfices, sans expliquer les vrais flux, les étapes de mise en route ni les entrées utilisateur.
Les commandes ExyViewer ne sont pas documentées alors que le viewer expose une surface fonctionnelle importante dans le code.
Le contenu de support manque de points d’entrée clairs, de parcours par tâche et d’attentes de résultat.

Plan de contenu retenu pour la refonte

ExyViewer : chargement, navigation, visibilité, arborescence, propriétés, markup, IDS, clashs, BCF, classification, drawing et reporting.
JaMo App : choix de version, téléchargement, activation, compatibilité Revit, déploiement modulaire du ruban, Smart Element Selection, validation de paramètres et références de mass modeling présentes dans le dépôt.
Architecture d’information : hero, bloc d’audit, table des matières, sections produit séparées, ancres de catégories et cartes de commande cohérentes.

VIEWER WEB

ExyViewer

ExyViewer est l’espace de revue de modèles dans le navigateur présent dans ce dépôt. Ses outils sont fournis via la barre du viewer, les panneaux latéraux et le module Drawing.

Cette section documente les contrôles réellement exposés dans le code du viewer, y compris les panneaux avancés et les outils de dessin technique.

catégories

commandes

Navigation, affichage et focus Sélection et inspection Validation, coordination et reporting

Navigation, affichage et focus

Commencez ici pour charger un modèle, naviguer dans la scène ou contrôler ce qui reste visible.

Aller à une section

Charger un IFC ou un FRAG Contrôles de navigation Contrôles de visibilité et de focus

Charger un IFC ou un FRAG

Objectif

Ouvre un fichier de modèle dans le viewer.

Retour en haut

Quand l’utiliser

À utiliser au début d’une session ou chaque fois que vous voulez ajouter un autre modèle dans l’espace de travail courant.

Où le trouver

Barre d’outils supérieure : bouton `Load`. Le panneau de structure permet aussi d’ajouter un autre modèle.

Options ou entrées principales

Formats acceptés : `.ifc` et `.frag`.
`.frag` est le format prétraité à chargement rapide généré par ExyViewer.

Étapes d’utilisation

1. Cliquez sur `Load` puis choisissez un fichier IFC ou FRAG.
2. Attendez que le canvas du viewer et l’arborescence de structure se remplissent.
3. Si vous travaillez avec plusieurs modèles, utilisez le panneau de structure pour en décharger ou en ajouter.

Résultat attendu

Le modèle apparaît dans la scène, devient disponible dans l’arborescence et ses données peuvent être utilisées par les panneaux d’analyse.

Notes et limites

Un modèle doit être chargé avant que les outils de visibilité, markup, IDS, clash, classification, drawing ou reporting deviennent utiles.
Les fichiers FRAG servent à réouvrir rapidement un modèle, pas à réécrire des modifications vers un IFC.

Bonne pratique

Si vous revoyez souvent le même gros fichier, exportez une version FRAG une fois puis réutilisez-la.

Contrôles de navigation

Objectif

Permet de se déplacer dans la scène et de réinitialiser rapidement la vue.

Retour en haut

Quand l’utiliser

À utiliser quand vous devez inspecter une géométrie depuis un autre angle ou retrouver une vue perdue.

Où le trouver

Barre d’outils supérieure : `Orbit`, `Pan`, `Zoom All`. Overlay en haut à droite : `ViewCube` et vues rapides.

Options ou entrées principales

Mode de navigation : `Orbit` ou `Pan`.
Raccourcis d’orientation : avant, arrière, gauche, droite, haut, bas et vues isométriques via le ViewCube.

Étapes d’utilisation

1. Choisissez `Orbit` pour tourner autour du modèle ou `Pan` pour déplacer la cible caméra.
2. Cliquez sur `Zoom All` si le modèle est hors champ ou si vous voulez tout recadrer.
3. Utilisez le ViewCube pour sauter vers une direction orthographique ou isométrique standard.

Résultat attendu

La caméra se met à jour immédiatement et le ViewCube reste synchronisé avec l’orientation courante.

Notes et limites

`Reset` remet aussi le viewer en mode orbit et relance un zoom global.
Le ViewCube est une aide d’orientation, pas un gestionnaire de vues enregistrées.

Bonne pratique

Utilisez `Zoom All` avant de produire un report, un screenshot ou une issue BCF si vous voulez un cadrage global propre.

Contrôles de visibilité et de focus

Objectif

Coupe, masque, isole, restaure et allège la scène.

Retour en haut

Quand l’utiliser

À utiliser quand vous devez inspecter une zone dense, comparer seulement quelques éléments ou revenir à la scène complète après un travail ciblé.

Où le trouver

Barre d’outils supérieure : `Section`, `Hide`, `Isolate`, `Reset` et `Grid`. Les réglages de section s’ouvrent depuis le chevron du bouton scindé.

Options ou entrées principales

Options des arêtes de coupe : afficher les arêtes, couleur et épaisseur.
La visibilité de la grille est mémorisée dans le stockage local du navigateur.

Étapes d’utilisation

1. Sélectionnez un ou plusieurs éléments si vous voulez ne masquer ou isoler que ceux-ci.
2. Activez `Section` pour afficher les plans de coupe, puis ajustez les arêtes si besoin.
3. Utilisez `Hide` ou `Isolate` pour une revue ciblée, puis `Reset` pour effacer les coupes, restaurer la visibilité, fermer les vues scindées et revenir à l’état par défaut.

Résultat attendu

La scène devient plus lisible et vous pouvez vous concentrer sur une zone de problème sans modifier durablement le modèle source.

Notes et limites

`Hide` et `Isolate` nécessitent une sélection active.
`Reset` est volontairement large : il efface les coupes, restaure la visibilité, désactive le markup, ferme les vues scindées du drawing et recadre le modèle complet.

Bonne pratique

`Isolate` est plus rapide que des masquages répétés lorsque vous connaissez déjà les éléments à revoir.

Sélection et inspection

Ces outils aident à localiser des éléments, lire leurs métadonnées partagées et passer de la structure au détail.

Aller à une section

Arborescence et panneau Propriétés Overlay de markup

Arborescence et panneau Propriétés

Objectif

Parcourt la hiérarchie IFC, sélectionne des éléments et affiche leurs métadonnées.

Retour en haut

Quand l’utiliser

À utiliser quand vous devez comprendre où se situe un élément dans le modèle, comparer plusieurs sélections ou lire les propriétés IFC et les property sets.

Où le trouver

Barre d’outils supérieure : `Structure` ouvre le panneau de structure du modèle. Onglet latéral : `Properties`.

Options ou entrées principales

Le panneau de structure peut ajouter et décharger des modèles.
Le panneau de propriétés prend en charge la recherche et les résumés de multi-sélection.

Étapes d’utilisation

1. Ouvrez `Structure` pour parcourir la hiérarchie du modèle chargé et sélectionner un élément.
2. Ouvrez `Properties` pour inspecter les données d’identité, informations IFC, property sets, matériaux, couches et valeurs communes d’une multi-sélection.
3. Utilisez le champ de recherche dans `Properties` pour filtrer les longues listes.

Résultat attendu

Vous pouvez passer de la structure spatiale aux métadonnées détaillées d’un élément sans quitter le viewer.

Notes et limites

En multi-sélection, seules les propriétés communes sont montrées et les valeurs différentes sont signalées.
L’arborescence liste aussi les modèles chargés et permet de les décharger individuellement.

Bonne pratique

Utilisez l’arborescence pour atteindre rapidement un niveau ou un assemblage connu, puis passez à `Properties` pour la vérification détaillée.

Overlay de markup

Objectif

Crée des annotations légères directement sur la scène 3D.

Retour en haut

Quand l’utiliser

À utiliser en réunion de coordination ou de revue lorsque vous avez besoin de notes visuelles rapides sans ouvrir tout le module Drawing.

Où le trouver

Barre d’outils supérieure : `Markup`.

Options ou entrées principales

Les outils d’overlay incluent texte, nuage, flèche et annotations de coordonnées.
Les ancrages de markup peuvent suivre la géométrie lors des mouvements de caméra.

Étapes d’utilisation

1. Activez `Markup` depuis la barre d’outils.
2. Placez des notes, nuages, flèches ou coordonnées sur la zone à expliquer.
3. Quittez ensuite le mode markup pour retrouver des interactions viewer normales.

Résultat attendu

Vous obtenez des commentaires visuels rapides dans la scène, qui peuvent aussi être intégrés à des snapshots BCF manuels.

Notes et limites

Le markup est distinct de l’éditeur technique payant du drawing.
La barre d’outils suit l’état actif du markup et la présence d’éventuelles modifications non enregistrées.

Bonne pratique

Capturez un snapshot BCF après le markup si la note doit accompagner une issue partagée.

Validation, coordination et reporting

Ces panneaux couvrent les contrôles de conformité, la revue des clashs, les issues, la classification et les exports.

Aller à une section

Validation IDS Détection de clashs Issues BCF Classification Module Drawing Export de rapports

Validation IDS

Objectif

Charge un fichier IDS XML, valide le modèle contre ses règles et transforme les échecs en issues suivables.

Retour en haut

Quand l’utiliser

À utiliser lorsque vous devez confirmer que le contenu du modèle respecte des exigences d’échange ou des standards internes.

Où le trouver

Onglet latéral : `IDS`.

Options ou entrées principales

Fichier d’entrée : IDS XML.
Filtres de résultat : `FAIL`, `PASS` ou `ALL`.

Étapes d’utilisation

1. Ouvrez l’onglet `IDS` puis chargez un fichier IDS.
2. Cliquez sur `Run Validation` une fois que le modèle et le fichier IDS sont prêts.
3. Filtrez les résultats groupés, cliquez sur un élément en échec pour l’isoler et le zoomer, puis créez ou ouvrez l’issue BCF associée si nécessaire.

Résultat attendu

Vous obtenez des résultats pass/fail basés sur des règles, groupés par spécification, avec des détails au niveau élément.

Notes et limites

La validation exige que les métadonnées du modèle soient déjà chargées.
Les éléments en échec peuvent être surlignés en lot ou convertis en issues BCF pour suivi.

Bonne pratique

Commencez par le filtre `FAIL` afin de revoir d’abord uniquement les exceptions.

Détection de clashs

Objectif

Exécute des vérifications de clashs intra-modèle ou inter-modèles avec matrice et tolérances.

Retour en haut

Quand l’utiliser

À utiliser pour la coordination BIM, l’audit de modèles et les contrôles ciblés entre types IFC ou paires de modèles.

Où le trouver

Onglet latéral : `Clashes`.

Options ou entrées principales

Mode : `internal` pour un seul modèle ou `federated` pour des vérifications modèle à modèle.
Matrice de clash : activer ou désactiver les paires de types IFC.
Tolérances : horizontale, verticale, tolérance volumique optionnelle et volume minimum reportable.
Classes de clash : duplicate, inside et overlapping.
Import `.clss` optionnel pour limiter le périmètre via un fichier de classification.

Étapes d’utilisation

1. Choisissez le mode de clash et, si nécessaire, le modèle actif ou la paire de modèles.
2. Ajustez la matrice pour ne garder actives que les combinaisons pertinentes.
3. Définissez les tolérances puis lancez le pipeline de détection. Ensuite, inspectez les résultats groupés, isolez des paires de clash ou exportez les clashs sélectionnés en BCF.

Résultat attendu

Vous recevez des résultats groupés avec intégration viewer, métriques de clash et sélections d’issues exportables.

Notes et limites

Un périmètre `.clss` importé peut restreindre l’exécution et bloquer la détection tant que le fichier n’est pas résolu correctement.
Le panneau peut être docké ou undocké pour des sessions de revue plus longues.

Bonne pratique

Réduisez d’abord la matrice. De petits contrôles ciblés sont plus faciles à exploiter qu’un grand run global.

Issues BCF

Objectif

Crée, modifie, importe et exporte des issues de coordination avec vues, commentaires et captures.

Retour en haut

Quand l’utiliser

À utiliser quand les constats de revue doivent sortir du viewer et devenir des tâches de coordination partageables.

Où le trouver

Onglet latéral : `BCF`.

Options ou entrées principales

Champs d’issue : titre, description, priorité, statut, type, assigné et date d’échéance.
Capture d’instantané optionnelle et liaison avec les éléments sélectionnés.
Formats d’import/export : `.bcfzip` et XLSX.

Étapes d’utilisation

1. Sélectionnez un ou plusieurs éléments si l’issue doit rester liée à des composants du modèle.
2. Capturez un snapshot si vous voulez une référence visuelle, puis créez l’issue.
3. Modifiez ensuite les issues existantes pour ajouter des commentaires, mettre à jour les métadonnées, restaurer des vues ou exporter la liste.

Résultat attendu

Vous obtenez des issues de coordination au format BCF, exploitables dans ExyViewer ou partageables à l’extérieur.

Notes et limites

Les snapshots peuvent combiner la vue modèle et l’overlay de markup courant.
Les packages BCF importés peuvent être rouverts, modifiés puis réexportés depuis le panneau.

Bonne pratique

Utilisez des assignés et des échéances clairs lorsque la liste d’issues doit servir de registre d’actions.

Classification

Objectif

Crée des couches de classification, colore le modèle, calcule des métriques et exporte des périmètres ou classeurs.

Retour en haut

Quand l’utiliser

À utiliser lorsque vous avez besoin d’une vue filtrée réutilisable basée sur des métadonnées, property sets, valeurs de propriétés ou classifications imbriquées.

Où le trouver

Onglet latéral : `Classification`.

Options ou entrées principales

Couches de classification avec couleurs et prise en charge des doublons.
Sources de critères : règles basées sur des requêtes ou classifications existantes.
Les dimensions de requête incluent type IFC, champs de métadonnées, noms de property set, noms de propriétés et valeurs.
Les exports incluent templates, en-têtes personnalisés, colonnes choisies, lignes de formules, lignes d’éléments, export XLSX et export de périmètre `.clss`.

Étapes d’utilisation

1. Créez une classification et ajoutez une ou plusieurs couches.
2. Choisissez la source de règle, définissez la requête ou la classification référencée, puis examinez les correspondances et métriques.
3. Appliquez les couleurs dans le viewer, isolez un résultat si besoin, puis exportez soit le classeur soit le fichier `.clss`.

Résultat attendu

Le modèle peut être filtré et coloré par une logique réutilisable, puis réutilisé dans les workflows de périmètre de clash ou de reporting.

Notes et limites

Les classifications plus tardives écrasent visuellement les précédentes lorsqu’un même élément appartient à plusieurs couches.
Un export `.clss` exige au moins une classification résolue avec des éléments correspondants.

Bonne pratique

Utilisez les exports de classification lorsque le même périmètre doit servir à la fois au reporting et à la revue de clashs.

Module Drawing

Objectif

Génère des vues techniques, place des cotes et annotations, puis exporte les feuilles produites.

Retour en haut

Quand l’utiliser

À utiliser lorsque vous avez besoin de dessins de revue, de cotations de type paper space ou de livrables techniques légers depuis le viewer.

Où le trouver

Onglet latéral : `Drawing`.

Options ou entrées principales

Outils de mesure : cote, angle, pente, ruban et surface.
Préférences de mesure : couleurs, unités, précision, taille de police et décalage du texte.
Outils de l’éditeur technique : leader, callout et placement de symboles.
Outils de vue : smart views, plans d’étage, élévations contextuelles, capture de la vue courante, ouverture d’une vue scindée et fermeture des vues.
Formats d’export : SVG, PDF, PNG et DXF avec options pour mesures, annotations et dessins personnalisés.

Étapes d’utilisation

1. Générez une smart view, un plan d’étage, une élévation ou capturez la scène courante.
2. Ouvrez une vue générée en mode split lorsque vous avez besoin des outils techniques officiels comme les cotes, angles, tags de pente, leaders, callouts ou symboles.
3. Ajoutez des annotations ou des dessins manuels puis exportez la feuille dans le format adapté à votre workflow aval.

Résultat attendu

Vous obtenez des mesures et annotations liées à un espace de drawing, ainsi que des sorties techniques prêtes à être exportées.

Notes et limites

Les outils techniques officiels ne fonctionnent que sur des plans ou élévations générés ouverts dans le panneau scindé.
Le markup SVG manuel du module Drawing reste distinct de l’overlay de markup plus léger de la barre supérieure.

Bonne pratique

Commencez par `Smart Views`. L’outil privilégie les plans d’étage pour les bâtiments et bascule vers des élévations contextuelles pour des modèles de type infrastructure.

Export de rapports

Objectif

Exporte les résultats IDS, clashs et données BCF dans des formats adaptés au reporting.

Retour en haut

Quand l’utiliser

À utiliser après une validation IDS, une détection de clashs ou une création d’issues lorsque vous avez besoin de fichiers de revue, d’archivage ou de passation.

Où le trouver

Onglet latéral : `Report`.

Options ou entrées principales

Formats : JSON, CSV et XLSX.
Blocs inclus : validation IDS, résultats de clashs et issues BCF selon les données disponibles et le format choisi.

Étapes d’utilisation

1. Ouvrez `Report` après avoir terminé l’analyse voulue.
2. Choisissez le format d’export et activez les blocs de données à inclure.
3. Lancez l’export puis utilisez les noms de fichiers générés à partir du nom du modèle et de l’horodatage.

Résultat attendu

Vous recevez une sortie exploitable par machine ou tableur sans relancer l’analyse.

Notes et limites

Le format XLSX prend en charge la validation et l’export BCF, tandis que l’export CSV de clash reste dans le flux CSV.
Le panneau reste désactivé tant qu’aucun résultat d’analyse ou issue n’existe.

Bonne pratique

JSON convient le mieux aux échanges système à système ; CSV et XLSX sont plus adaptés aux revues et au suivi manuel.

ADD-IN REVIT

JaMo App

JaMo App est un add-in Revit avec une vraie surface de commandes dans le dépôt refactor actuel. Cette section documente les panneaux réellement présents, les noms de commandes et les principaux cas d’usage exposés dans le code.

Le contenu ci-dessous s’appuie sur le ruban actuel de `Calculator1980/JaMoApp_refactor`, ses classes de commandes, ses tooltips et ses notes d’implémentation pour Revit 2024, 2025, 2026 et 2027.

catégories

commandes

Configuration, licence et accès Panneau Pset_Parameters Panneau Family_Panel Panneau OpenBIM_Panel

Configuration, licence et accès

Commencez ici pour choisir le bon build, l’installer, activer la licence et comprendre comment l’accès aux commandes est contrôlé.

Aller à une section

Choisir la bonne édition Revit et la bonne durée Installer et activer JaMo App About et récupération de licence Vérifier la compatibilité avant déploiement

Choisir la bonne édition Revit et la bonne durée

Objectif

Vérifie que l’utilisateur télécharge l’installateur correspondant à la bonne année Revit et à la bonne durée de licence.

Retour en haut

Quand l’utiliser

À utiliser avant l’achat, pendant l’approvisionnement et avant de transmettre un lien de téléchargement à un utilisateur.

Où le trouver

Sélection produit sur le site, métadonnées de checkout, téléchargements du dashboard et e-mails de licence.

Options ou entrées principales

Éditions produit prises en charge dans les métadonnées du repository : Revit 2024, 2025, 2026 et 2027.
Durées de licence présentes dans les mappings du repository : 3 mois, 6 mois et 1 an.

Étapes d’utilisation

1. Confirmez la version de Revit utilisée par l’utilisateur.
2. Choisissez l’édition JaMo App et la durée de licence correspondantes.
3. Utilisez le bon installateur et le bon mapping de téléchargement pour cette combinaison exacte.

Résultat attendu

L’utilisateur reçoit un installateur qui correspond à la fois à l’année Revit et à la durée de licence achetée.

Notes et limites

Le repository contient des mappings MSI explicites pour chaque édition et chaque durée prises en charge.
Utiliser la mauvaise édition peut provoquer un décalage d’installation ou d’activation plus tard dans le processus.

Bonne pratique

Traitez l’année Revit comme une exigence stricte, pas comme une préférence.

Installer et activer JaMo App

Objectif

Installe le MSI, saisit les clés d’activation livrées et débloque les commandes du ruban dans Revit.

Retour en haut

Quand l’utiliser

À utiliser après achat, après réception d’un package de démo ou dès qu’un nouveau poste doit être activé.

Où le trouver

Flux de téléchargement du site, e-mail d’achat ou de démo, écrans de l’installateur et ruban JaMo App après installation.

Options ou entrées principales

L’activation utilise une clé de licence et une hash key.
Le dépôt refactor inclut les flux installateur, service de licence et fenêtre About pour l’activation puis la revalidation.
La plupart des commandes du ruban restent désactivées tant que la validation de licence n’a pas réussi.

Étapes d’utilisation

1. Téléchargez le MSI correspondant à l’année Revit visée.
2. Lancez l’installateur puis saisissez les clés d’activation lorsque cela est demandé.
3. Ouvrez Revit et vérifiez que l’onglet `JaMoApp` apparaît avec ses panneaux.
4. Si les commandes restent désactivées, ouvrez `About` puis terminez l’activation ou la revalidation de licence.

Résultat attendu

JaMo App se charge dans Revit et les commandes licenciées deviennent disponibles après validation.

Notes et limites

La base de code vérifie les données de licence stockées au démarrage et met à jour l’état des boutons selon le résultat.
La commande `About` reste disponible même si la licence est invalide afin de permettre la récupération d’accès.

Bonne pratique

Gardez l’e-mail contenant les clés d’activation ouvert pendant l’installation pour copier les données sans interruption.

About et récupération de licence

Objectif

Ouvre la fenêtre d’information JaMo App, affiche l’état de licence et donne accès au parcours d’achat ou d’activation lorsque les autres commandes sont verrouillées.

Retour en haut

Quand l’utiliser

À utiliser lorsque JaMo App démarre avec des commandes désactivées, lorsqu’une licence a expiré ou lorsqu’un utilisateur doit vérifier son état de produit et de licence.

Où le trouver

Onglet JaMoApp, panneau `Info`, bouton `About`.

Options ou entrées principales

Le bouton `About` reste toujours activé.
La fenêtre About est le point d’accès prévu pour l’achat et la récupération d’activation lorsque la licence bloque le reste du ruban.

Étapes d’utilisation

1. Ouvrez `About` depuis le panneau `Info`.
2. Consultez l’état de licence affiché, la date d’expiration et l’état d’activation.
3. Utilisez les actions d’achat ou d’activation disponibles si l’add-in n’est pas actuellement licencié.

Résultat attendu

L’utilisateur peut vérifier l’état actuel de licence et récupérer l’accès sans réinstaller l’add-in.

Notes et limites

La logique d’activation des boutons dans le dépôt maintient explicitement `About` disponible tandis que les autres commandes peuvent être bloquées.
C’est le point d’entrée sûr lorsque le ruban est visible mais inutilisable.

Bonne pratique

Commencez par `About` avant de pousser plus loin le dépannage de licence ou de déploiement.

Vérifier la compatibilité avant déploiement

Objectif

Confirme que le poste et l’environnement Revit respectent les prérequis documentés pour JaMo App.

Retour en haut

Quand l’utiliser

À utiliser avant des installations individuelles ou avant un déploiement d’entreprise.

Où le trouver

Planification installateur, scripts de déploiement, métadonnées produit du site et matrice de build du dépôt refactor.

Options ou entrées principales

Système d’exploitation : Windows 10 ou 11, 64 bits.
Éditions Revit prises en charge dans les dépôts web et add-in : 2024, 2025, 2026 et 2027.
L’add-in utilise des builds spécifiques par version et une gestion de compatibilité API adaptée à ces versions Revit.

Étapes d’utilisation

1. Vérifiez que la machine utilisateur est sur une version Windows prise en charge.
2. Vérifiez que la bonne année Revit est installée.
3. Confirmez que vous déployez bien le build JaMo App correspondant à cette année Revit.
4. Vérifiez les prérequis runtime et installateur avant un déploiement plus large.

Résultat attendu

Vous réduisez les installations échouées et évitez de distribuer des builds à des postes non pris en charge.

Notes et limites

Le dépôt refactor inclut des scripts d’installation et une gestion de build par version plutôt qu’un binaire universel unique.
Si votre image IT interne ajoute d’autres prérequis, documentez-les séparément de ce guide public.

Bonne pratique

Validez la compatibilité avant de générer un package de déploiement en lot.

Panneau Pset_Parameters

Ces commandes sont dédiées à la consultation, au contrôle et à l’audit des paramètres dans le modèle ou la famille Revit active.

Aller à une section

Parameters Parameter Checker PaRadar

Parameters

Objectif

Parcourt les shared parameters et exécute des calculs de paramètres via la fenêtre dédiée de JaMo App.

Retour en haut

Quand l’utiliser

À utiliser lorsque vous devez inspecter des valeurs de paramètres, travailler sur des workflows de shared parameters ou appliquer la logique de calcul de l’add-in.

Où le trouver

Onglet JaMoApp, panneau `Pset_Parameters`, bouton `Parameters`.

Options ou entrées principales

Passe par `ParametersWindow` avec un service de paramètres et un service de calcul.
Utilise le document Revit actif et s’ouvre en fenêtre modeless.

Étapes d’utilisation

1. Ouvrez `Parameters` depuis le panneau `Pset_Parameters`.
2. Parcourez les données de paramètres disponibles et choisissez le workflow de consultation ou de calcul souhaité.
3. Laissez la fenêtre ouverte si vous devez continuer à travailler en parallèle dans Revit.

Résultat attendu

Vous pouvez consulter et traiter les shared parameters sans quitter la session Revit.

Notes et limites

Cette commande vérifie la licence avant de s’ouvrir.
Elle applique un modèle single-instance, donc un second clic doit simplement réactiver la fenêtre existante.

Bonne pratique

Utilisez cette commande comme espace de travail principal sur les paramètres avant de passer à des audits ou mappings spécialisés.

Parameter Checker

Objectif

Vérifie la présence d’un paramètre et colore les éléments en fonction du résultat.

Retour en haut

Quand l’utiliser

À utiliser lorsque vous voulez une revue visuelle rapide de la présence ou non de paramètres requis sur des éléments visibles.

Où le trouver

Onglet JaMoApp, panneau `Pset_Parameters`, bouton `Parameter Checker`.

Options ou entrées principales

Lance `ParameterCheckerWindow` avec le `UIDocument` courant.
Est conçu pour un contrôle rapide et un retour visuel coloré plutôt que pour du reporting détaillé.

Étapes d’utilisation

1. Ouvrez `Parameter Checker`.
2. Choisissez le paramètre ou le périmètre de contrôle dans le dialogue.
3. Lancez le contrôle puis observez le résultat coloré dans le modèle.

Résultat attendu

Les éléments peuvent être contrôlés et différenciés visuellement selon leur état de paramètre directement dans Revit.

Notes et limites

Cette commande est utile pour des passes QA rapides avant des workflows plus formels de mapping ou d’IDS.
Contrairement à plusieurs commandes plus récentes, le fichier de commande n’effectue pas actuellement de vérification de licence explicite avant l’ouverture de la fenêtre.

Bonne pratique

Utilisez-la tôt pour repérer visuellement les données manquantes avant export ou validation contre des exigences externes.

PaRadar

Objectif

Ouvre le tableau de bord d’audit des paramètres pour filtrer, analyser et gérer les paramètres de projet et de famille avec des indicateurs de statut colorés.

Retour en haut

Quand l’utiliser

À utiliser lorsque vous avez besoin d’une vue d’audit plus large que le simple checker, notamment à l’échelle du projet et des familles.

Où le trouver

Onglet JaMoApp, panneau `Pset_Parameters`, bouton `PaRadar`.

Options ou entrées principales

Nécessite un document Revit actif.
Lance une fenêtre de tableau de bord modale et transmet le `UIDocument` actif au workflow d’audit.
Est pensé pour le filtrage, l’analyse et la lecture par statut.

Étapes d’utilisation

1. Ouvrez `PaRadar` depuis le ruban.
2. Filtrez l’inventaire des paramètres ou le périmètre d’audit selon le contexte modèle ou famille.
3. Analysez les indicateurs du tableau de bord et utilisez-les pour orienter les actions de nettoyage ou de suivi.

Résultat attendu

Vous obtenez un audit plus structuré des paramètres de projet et de famille qu’avec un simple contrôle visuel ponctuel.

Notes et limites

La commande affiche une erreur claire si aucun document actif n’est disponible.
Le tooltip du ruban positionne explicitement PaRadar comme un dashboard d’audit, pas comme un éditeur de paramètres.

Bonne pratique

Utilisez PaRadar lorsque vous devez comprendre la santé des paramètres à une échelle plus large qu’un seul champ.

Panneau Family_Panel

Ces commandes prennent en charge des workflows de modélisation géométrique intensifs directement dans Revit.

Aller à une section

Mass Surface FloorFromTopo

Mass Surface

Objectif

Crée une géométrie de masse via la fenêtre dédiée du workflow JaMo App.

Retour en haut

Quand l’utiliser

À utiliser lorsque vous avez besoin d’un support rapide pour des tâches de modélisation conceptuelle ou géométriquement lourdes.

Où le trouver

Onglet JaMoApp, panneau `Family_Panel`, bouton `Mass Surface`.

Options ou entrées principales

Ouvre `MassSurfaceWindow` sur le `UIDocument` actif.
Fonctionne comme un workflow modal ciblé.

Étapes d’utilisation

1. Ouvrez `Mass Surface`.
2. Renseignez les entrées demandées dans le dialogue.
3. Revoyez le résultat produit dans Revit puis poursuivez les raffinements nécessaires.

Résultat attendu

Vous pouvez générer une géométrie via un workflow guidé JaMo App plutôt que tout construire manuellement.

Notes et limites

Le tooltip du ruban reste succinct, donc le code confirme l’existence de la commande mais pas chaque champ du dialogue.
C’est la commande actuelle du ruban qui correspond le mieux aux anciens messages de mass modeling présents sur le site.

Bonne pratique

Utilisez-la là où la répétabilité géométrique est plus importante qu’une intervention manuelle ponctuelle.

FloorFromTopo

Objectif

Crée ou remodèle un plancher à partir d’un Toposolid sélectionné en projetant une trame dense de points topo dans la forme de dalle du plancher.

Retour en haut

Quand l’utiliser

À utiliser lorsqu’un plancher doit suivre plus finement une situation de site ou de terrain qu’une dalle plate classique.

Où le trouver

Onglet JaMoApp, panneau `Family_Panel`, bouton `FloorFromTopo`.

Options ou entrées principales

Nécessite la sélection d’un Toposolid et d’un Floor.
Utilise l’édition de forme de dalle et des points densément échantillonnés sur les arêtes du Toposolid sélectionné.

Étapes d’utilisation

1. Cliquez sur `FloorFromTopo`.
2. Sélectionnez le Toposolid source lorsque la commande le demande.
3. Sélectionnez ensuite le plancher à modifier.
4. Laissez JaMo App reconstruire les points de forme de dalle à partir de la géométrie topographique.

Résultat attendu

Le plancher choisi reçoit une édition de forme plus dense pilotée par le Toposolid sélectionné.

Notes et limites

C’est la commande derrière le cas d’usage d’adaptation au site souvent décrit comme `Floor-to-Topo` dans les contenus existants du site.
La commande écrit directement dans le plancher cible ; elle exige donc un document modifiable et un floor compatible avec l’édition de forme.

Bonne pratique

Travaillez avec un Toposolid source propre et un plancher cible à géométrie stable avant de lancer la commande.

Panneau OpenBIM_Panel

Ce panneau regroupe les commandes JaMo App les plus récentes et spécialisées pour le mapping IFC, les workflows IDS, les mappings de property sets et quantity sets, le phasage et la géoréférenciation.

Aller à une section

IFCmap Pset_map Qto_map IDS Spec IDS_Map PH4D BIMGeoRef

IFCmap

Objectif

Affecte des entités d’export IFC aux éléments visibles dans la vue filtrée active.

Retour en haut

Quand l’utiliser

À utiliser avant un export IFC, avant un mapping Pset ou Qto, et chaque fois qu’une classification d’export maîtrisée est nécessaire sur les éléments visibles.

Où le trouver

Onglet JaMoApp, panneau `OpenBIM_Panel`, bouton `IFCmap`.

Options ou entrées principales

Travaille sur les éléments de la vue active.
Nécessite un document modifiable.
Prend en charge l’exploration du schéma IFC et l’affectation d’entités.

Étapes d’utilisation

1. Ouvrez la vue Revit cible et filtrez-la sur les éléments à traiter.
2. Lancez `IFCmap`.
3. Passez en revue les éléments visibles puis affectez les entités d’export IFC souhaitées.

Résultat attendu

Les éléments de la vue courante peuvent recevoir des affectations d’entités IFC pour l’export et les workflows de mapping suivants.

Notes et limites

La commande peut encore s’ouvrir si la vue active ne contient aucun élément, mais le mapping n’a d’intérêt qu’une fois des éléments visibles.
C’est la commande de base pour les workflows `Pset_map` et `Qto_map` qui suivent.

Bonne pratique

Travaillez depuis une vue de travail fortement filtrée afin que l’affectation d’entités reste maîtrisée et relisible.

Pset_map

Objectif

Valide et attache des property sets standard buildingSMART aux éléments de la vue active.

Retour en haut

Quand l’utiliser

À utiliser après l’affectation des entités IFC et avant une livraison IFC, une vérification IDS ou une revue qualité d’échange.

Où le trouver

Onglet JaMoApp, panneau `OpenBIM_Panel`, bouton `Pset_map`.

Options ou entrées principales

Nécessite un document modifiable et une vue active contenant des éléments visibles.
Conçu pour des éléments déjà préparés via `IFCmap`.

Étapes d’utilisation

1. Préparez une vue active contenant les éléments à traiter.
2. Confirmez que le mapping IFC a déjà été appliqué si nécessaire.
3. Ouvrez `Pset_map` puis lancez le workflow de validation et d’attachement des property sets.

Résultat attendu

Le périmètre choisi peut être vérifié contre les property sets standard puis complété en conséquence.

Notes et limites

La commande s’ouvre en mode modeless pour permettre de continuer à interagir avec Revit.
Si la vue active est vide, la commande s’arrête tôt car il n’y a aucun élément à enrichir.

Bonne pratique

Lancez d’abord le mapping IFC. Le travail sur les Pset est plus propre lorsque l’entité d’export est déjà connue.

Qto_map

Objectif

Valide et attache des quantity sets standard buildingSMART aux éléments de la vue active.

Retour en haut

Quand l’utiliser

À utiliser lorsque des métadonnées de quantités doivent être préparées pour un échange IFC, une QA ou des workflows de métrés.

Où le trouver

Onglet JaMoApp, panneau `OpenBIM_Panel`, bouton `Qto_map`.

Options ou entrées principales

Nécessite un document modifiable et une vue active avec des éléments visibles.
Pensé pour des éléments déjà préparés via `IFCmap`.

Étapes d’utilisation

1. Ouvrez une vue de travail contenant les éléments cibles.
2. Vérifiez que les affectations d’entités IFC sont déjà en place.
3. Lancez `Qto_map` puis exécutez le workflow de quantity sets.

Résultat attendu

Les éléments peuvent être vérifiés puis enrichis par rapport aux quantity sets standard.

Notes et limites

Comme `Pset_map`, cette commande est pilotée par la vue active et attend des éléments visibles.
Utilisez-la lorsque la livraison dépend d’un jeu de quantités plus riche que la seule géométrie.

Bonne pratique

Gardez le Qto mapping dans la même vue filtrée que le mapping IFC afin de limiter les écarts.

IDS Spec

Objectif

Ouvre l’éditeur IDS et le workflow de contrôle modèle pour la validation buildingSMART IDS.

Retour en haut

Quand l’utiliser

À utiliser lorsque vous devez charger, créer, éditer ou valider des Information Delivery Specifications contre le modèle.

Où le trouver

Onglet JaMoApp, panneau `OpenBIM_Panel`, bouton `IDS Spec`.

Options ou entrées principales

Repose sur des workflows de type IDS 1.0 dans le dépôt refactor.
Utilise ensemble les services document, validation et mapping IFC.
S’ouvre comme fenêtre modeless single-instance.

Étapes d’utilisation

1. Ouvrez `IDS Spec`.
2. Chargez ou créez la définition IDS souhaitée.
3. Lancez la validation puis analysez les résultats de conformité.

Résultat attendu

Vous pouvez gérer des spécifications IDS et valider le modèle actif directement depuis Revit.

Notes et limites

C’est le versant édition et validation du workflow IDS.
Le dépôt garde cette fenêtre en single-instance pour qu’un nouveau clic réactive simplement la session en cours.

Bonne pratique

Utilisez `IDS Spec` pour définir les règles et valider, puis `IDS_Map` lorsque le but est de corriger les valeurs.

IDS_Map

Objectif

Renseigne les valeurs IDS requises sur les éléments en analysant la vue active pour détecter les valeurs erronées ou vides puis en aidant à les corriger.

Retour en haut

Quand l’utiliser

À utiliser lorsque les exigences IDS sont déjà définies et qu’il faut corriger les valeurs, pas seulement produire un rapport.

Où le trouver

Onglet JaMoApp, panneau `OpenBIM_Panel`, bouton `IDS_Map`.

Options ou entrées principales

Nécessite un document modifiable.
Travaille comme complément en écriture de `IDS Spec`.
Se concentre sur les valeurs de propriétés et d’attributs fausses ou manquantes.

Étapes d’utilisation

1. Ouvrez le modèle et assurez-vous que le document est modifiable.
2. Lancez `IDS_Map`.
3. Chargez l’IDS concerné, examinez les écarts puis appliquez les valeurs requises aux éléments cibles.

Résultat attendu

Les valeurs non conformes liées à l’IDS peuvent être corrigées directement dans l’add-in au lieu de rester au stade du constat.

Notes et limites

Le code décrit explicitement cette commande comme un outil de définition de valeurs, pas seulement comme un contrôleur.
Utilisez-la avec un périmètre maîtrisé car elle écrit réellement dans les données du modèle.

Bonne pratique

Travaillez avec une vue active ciblée afin que les corrections restent focalisées et facilement vérifiables.

PH4D

Objectif

Crée des workflows de phasage 4D BIM avec templates de phase, vues dérivées et séquences de construction animées.

Retour en haut

Quand l’utiliser

À utiliser lorsque les équipes doivent simuler la séquence de construction, organiser des vues de phasage ou présenter une chronologie de chantier dans Revit.

Où le trouver

Onglet JaMoApp, panneau `OpenBIM_Panel`, bouton `PH4D`.

Options ou entrées principales

Nécessite un document modifiable et une vue active.
Dépend de paramètres numériques de phasage tels que `JM_Existing`, `JM_Demolished`, `JM_TEMporary` et `JM_New`.
Pris en charge dans le dépôt refactor pour Revit 2024 à 2027.

Étapes d’utilisation

1. Préparez les paramètres de phasage requis et affectez des valeurs aux éléments.
2. Ouvrez `PH4D` puis créez ou contrôlez les templates et lignes de phase.
3. Lancez la simulation ou la génération de vues pour examiner la séquence de construction.

Résultat attendu

Vous pouvez organiser des vues de phasage et produire une visualisation 4D progressive où les éléments apparaissent au fil du temps.

Notes et limites

Les notes d’implémentation du dépôt décrivent désormais ce comportement comme une vraie visualisation de timeline, plus seulement comme un changement de template.
Si les paramètres JM_* requis sont absents, la commande avertit avant de continuer.

Bonne pratique

Traitez la préparation des paramètres comme une étape de setup à part entière. PH4D fonctionne mieux avec des valeurs de phase propres et cohérentes dès le départ.

BIMGeoRef

Objectif

Valide et corrige la géoréférenciation IFC4 jusqu’au niveau LoGeoRef 50.

Retour en haut

Quand l’utiliser

À utiliser avant une livraison IFC lorsque l’alignement GIS, les métadonnées CRS projetées ou la qualité de la map conversion doivent être contrôlés puis corrigés.

Où le trouver

Onglet JaMoApp, panneau `OpenBIM_Panel`, bouton `BIMGeoRef`.

Options ou entrées principales

Cible des workflows de géoréférenciation IFC4.
Couvre des vérifications autour de `IfcProject`, `IfcGeometricRepresentationContext`, `IfcMapConversion` et `IfcProjectedCRS`.
Le PRD associé décrit des valeurs éditables comme EPSG, eastings, northings, hauteur, rotation d’axe et échelle.

Étapes d’utilisation

1. Ouvrez `BIMGeoRef`.
2. Lancez la validation des données de géoréférenciation IFC.
3. Analysez les règles en échec, modifiez les valeurs requises puis sauvegardez l’IFC corrigé si nécessaire.

Résultat attendu

Vous pouvez contrôler la qualité de la géoréférenciation IFC et corriger les données manquantes ou mal formées avant échange.

Notes et limites

L’implémentation vise explicitement IFC4 et les workflows LoGeoRef 50.
Cette commande cible la qualité d’échange, pas la gestion générale des coordonnées natives Revit.

Bonne pratique

Placez BIMGeoRef plutôt en fin de préparation IFC, lorsque les mappings d’entités et de propriétés sont déjà propres.

Références visuelles

Cette structure accepte de vraies captures plus tard. Aucune image d’interface inventée n’a été ajoutée lorsque le dépôt ne fournit pas de captures réelles.

Besoin d’aide pour choisir le bon outil ?

Utilisez d’abord ce manuel en autonomie, puis contactez l’équipe si vous avez besoin d’une démonstration, d’un accompagnement ou d’une recommandation produit.

Demander une démo Ouvrir la documentation

Manuel Toolbox pour ExyViewer et JaMo App

Résumé d’audit

Faiblesses de la page actuelle

La page Toolbox actuelle ressemble à une page marketing plutôt qu’à une page de référence.
Le contenu JaMo App reste général et orienté bénéfices, sans expliquer les vrais flux, les étapes de mise en route ni les entrées utilisateur.
Les commandes ExyViewer ne sont pas documentées alors que le viewer expose une surface fonctionnelle importante dans le code.
Le contenu de support manque de points d’entrée clairs, de parcours par tâche et d’attentes de résultat.

Plan de contenu retenu pour la refonte

ExyViewer : chargement, navigation, visibilité, arborescence, propriétés, markup, IDS, clashs, BCF, classification, drawing et reporting.
JaMo App : choix de version, téléchargement, activation, compatibilité Revit, déploiement modulaire du ruban, Smart Element Selection, validation de paramètres et références de mass modeling présentes dans le dépôt.
Architecture d’information : hero, bloc d’audit, table des matières, sections produit séparées, ancres de catégories et cartes de commande cohérentes.

ExyViewer

ExyViewer est l’espace de revue de modèles dans le navigateur présent dans ce dépôt. Ses outils sont fournis via la barre du viewer, les panneaux latéraux et le module Drawing.

Cette section documente les contrôles réellement exposés dans le code du viewer, y compris les panneaux avancés et les outils de dessin technique.

JaMo App

Le contenu ci-dessous s’appuie sur le ruban actuel de `Calculator1980/JaMoApp_refactor`, ses classes de commandes, ses tooltips et ses notes d’implémentation pour Revit 2024, 2025, 2026 et 2027.