# Formula Editor

> Scrivete una formula in LaTeX, vedetela mentre digitate e inseritela nel modulo come immagine che potete riaprire e modificare.

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

- Disciplina: Qualità dei contenuti
- Funziona in: Modulo IBM DOORS Next
- Prodotti supportati: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifica i dati
- Keywords: formule matematiche, LaTeX, equazioni nei requisiti, editor di formule, MathJax, immagine della formula, equazioni DOORS Next
- Versione: 1.8 (Rilasciata 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flusso di lavoro: 1. Selezionare un artefatto nel modulo → 2. Scrivere la formula in LaTeX → 3. Anteprima dell'immagine → 4. Confermare Insert o Update → 5. Formula salvata come immagine, con il suo LaTeX → 6. Report delle modifiche in Excel

## Che cos'è e perché esiste
I requisiti per freni, sensori o anelli di controllo hanno spesso bisogno di una formula: uno spazio di arresto, una tolleranza, un filtro. DOORS Next non ha un editor di formule. I team incollano uno screenshot da Word, che poi nessuno può modificare senza il file originale, oppure scrivono la formula come testo semplice, difficile da leggere.

Formula Editor vi permette di scrivere la formula in LaTeX dentro DOORS Next. Disegna la formula mentre digitate e la inserisce nel modulo come immagine, in un nuovo artefatto dopo quello selezionato oppure nell'artefatto selezionato. Il LaTeX viene salvato con l'artefatto, così selezionando la formula in seguito si riapre nell'editor.

## Problemi che risolve
- Formule incollate come screenshot che nessuno può modificare senza il file Word da cui provengono.
- Formule scritte come testo semplice, ad esempio s = v^2/(2*mu*g), difficili da leggere nelle revisioni e negli export.
- Immagini di formule che non corrispondono più al testo dopo che uno dei due è stato modificato a mano.
- Passare a un altro strumento e ricopiare le immagini per ogni formula nuova o modificata.

## Vantaggi
- **La vedete mentre digitate:** l'anteprima disegna la formula mentre scrivete e mostra la dimensione dell'immagine.
- **Modificabile in seguito:** il LaTeX resta nell'artefatto, così selezionando una formula si riapre e Update disegna una nuova immagine.
- **Il testo resta:** Update su un artefatto con testo aggiunge la formula dopo il testo e mantiene le parole.
- **Nessun sito esterno:** la formula è disegnata nel vostro browser da MathJax; non viene inviata a un editor online.
- **Errori con la loro posizione:** una parentesi graffa mancante o un comando sconosciuto viene mostrato sotto il campo con il carattere in cui si trova.

## Come si usa
1. Aprite un modulo e selezionate un artefatto.
2. Scrivete la formula in LaTeX oppure fate clic sui tasti sotto il campo: frazione, radice, potenza, pedice, sommatoria, integrale, lettera greca, più o meno e matrice. **More symbols** ne mostra altri 21. L'anteprima mostra l'immagine e la sua dimensione.
3. Fate clic su **Insert** per aggiungere la formula in un nuovo artefatto dopo quello selezionato, oppure su **Update** per scriverla nell'artefatto selezionato. Leggete la conferma e fate clic su **Insert formula** o **Update formula**.
4. Il blocco dei risultati mostra cosa è stato fatto, e **Log** scarica il report delle modifiche.
5. Per modificare una formula, selezionatela nel modulo. Si apre nel widget (**Editing 1531 …**); modificate il LaTeX e fate clic su **Update**.

## Da sapere
- Lavorate in un change set, così potete scartarlo se il risultato non è quello voluto. Il nuovo artefatto viene salvato subito.
- L'immagine è un PNG salvato sul server di DOORS Next, disegnato al doppio della sua dimensione perché resti nitido sugli schermi e negli export. **Settings** offre tre dimensioni: S, M e L.
- Il LaTeX va in un attributo chiamato **Formula** quando il progetto ne ha uno, e sempre nella descrizione dell'immagine, così una formula si riapre anche in un progetto senza quell'attributo.
- I nuovi artefatti ricevono il tipo dell'artefatto selezionato. In **Settings** potete scegliere un altro tipo di artefatto del progetto per Insert; il widget lo ricorda per ogni progetto. Update mantiene il tipo.
- Se l'immagine di una formula è stata sostituita a mano, il widget lo segnala e la conferma di Update avverte che quella modifica andrà persa. Il LaTeX prevale sempre.