# Formula Editor

> Saisissez une formule en LaTeX, voyez-la pendant la frappe et placez-la dans le module sous forme d'image que vous pouvez rouvrir et modifier.

Source: https://widgets.doorsnext.com/fr/widgets/formula-editor/

- Discipline: Qualité du contenu
- Fonctionne dans: Module IBM DOORS Next
- Produits pris en charge: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifie les données
- Keywords: formules mathématiques, LaTeX, équations dans les exigences, éditeur de formules, MathJax, image de formule, équations DOORS Next
- Version: 1.8 (Publiée le 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Déroulement: 1. Sélectionner un artefact dans le module → 2. Saisir la formule en LaTeX → 3. Aperçu de l'image → 4. Confirmer Insert ou Update → 5. Formule enregistrée comme image, avec son LaTeX → 6. Rapport de modifications dans Excel

## Ce que c'est et pourquoi il existe
Les exigences sur les freins, les capteurs ou les boucles de régulation ont souvent besoin d'une formule : une distance d'arrêt, une tolérance, un filtre. DOORS Next n'a pas d'éditeur de formules. Les équipes collent une capture d'écran de Word, que personne ne peut modifier ensuite sans le fichier d'origine, ou tapent la formule en texte brut, difficile à lire.

Formula Editor vous permet d'écrire la formule en LaTeX dans DOORS Next. Il dessine la formule pendant la frappe et la place dans le module sous forme d'image, soit dans un nouvel artefact après l'artefact sélectionné, soit dans l'artefact sélectionné. Le LaTeX est enregistré avec l'artefact : sélectionner la formule plus tard la rouvre dans l'éditeur.

## Problèmes résolus
- Des formules collées en captures d'écran que personne ne peut modifier sans le fichier Word d'où elles viennent.
- Des formules tapées en texte brut, comme s = v^2/(2*mu*g), difficiles à lire dans les revues et les exports.
- Des images de formules qui ne correspondent plus au texte après que l'un des deux a été modifié à la main.
- Passer à un autre outil et recopier des images pour chaque formule nouvelle ou modifiée.

## Avantages
- **Voir pendant la frappe :** l'aperçu dessine la formule pendant que vous écrivez et indique la taille de l'image.
- **Modifiable plus tard :** le LaTeX est conservé dans l'artefact, donc sélectionner une formule la rouvre et Update dessine une nouvelle image.
- **Le texte reste :** Update sur un artefact contenant du texte ajoute la formule après le texte et conserve les mots.
- **Aucun site externe :** la formule est dessinée dans votre navigateur par MathJax ; elle n'est pas envoyée à un éditeur en ligne.
- **Erreurs localisées :** une accolade manquante ou une commande inconnue s'affiche sous le champ avec le caractère où elle se trouve.

## Utilisation
1. Ouvrez un module et sélectionnez un artefact.
2. Saisissez la formule en LaTeX ou cliquez sur les touches sous le champ : fraction, racine, puissance, indice, somme, intégrale, lettre grecque, plus ou moins et matrice. **More symbols** en affiche 21 de plus. L'aperçu montre l'image et sa taille.
3. Cliquez sur **Insert** pour ajouter la formule dans un nouvel artefact après l'artefact sélectionné, ou sur **Update** pour l'écrire dans l'artefact sélectionné. Lisez la confirmation et cliquez sur **Insert formula** ou **Update formula**.
4. Le bloc de résultat indique ce qui a été fait, et **Log** télécharge le rapport de modifications.
5. Pour modifier une formule, sélectionnez-la dans le module. Elle s'ouvre dans le widget (**Editing 1531 …**) ; modifiez le LaTeX et cliquez sur **Update**.

## Bon à savoir
- Travaillez dans un ensemble de modifications, pour pouvoir l'abandonner si le résultat ne convient pas. Le nouvel artefact est enregistré immédiatement.
- L'image est un PNG enregistré sur le serveur DOORS Next, dessiné au double de sa taille pour rester nette à l'écran et dans les exports. **Settings** propose trois tailles : S, M et L.
- Le LaTeX est écrit dans un attribut nommé **Formula** quand le projet en possède un, et toujours dans la description de l'image : une formule se rouvre donc aussi dans un projet sans cet attribut.
- Les nouveaux artefacts reçoivent le type de l'artefact sélectionné. Dans **Settings**, vous pouvez choisir un autre type d'artefact du projet pour Insert ; le widget le retient par projet. Update conserve le type.
- Si l'image d'une formule a été remplacée à la main, le widget le signale et la confirmation de Update avertit que cette modification sera perdue. Le LaTeX l'emporte toujours.