Formula Editor

Was es ist und warum es existiert

Anforderungen an Bremsen, Sensoren oder Regelkreise brauchen oft eine Formel: einen Anhalteweg, eine Toleranz, einen Filter. DOORS Next hat keinen Formeleditor. Teams fügen einen Screenshot aus Word ein, den ohne die Originaldatei später niemand ändern kann, oder tippen die Formel als einfachen Text, der schwer zu lesen ist.

Mit Formula Editor schreiben Sie die Formel in LaTeX direkt in DOORS Next. Er zeichnet die Formel beim Tippen und fügt sie als Bild in das Modul ein, entweder in einem neuen Artefakt nach dem ausgewählten oder im ausgewählten Artefakt. Das LaTeX wird mit dem Artefakt gespeichert, sodass sich die Formel später beim Auswählen wieder im Editor öffnet.

Gelöste Probleme

• Als Screenshots eingefügte Formeln, die niemand ohne die Word-Datei ändern kann, aus der sie stammen.
• Als einfacher Text getippte Formeln wie s = v^2/(2*mu*g), die in Reviews und Exporten schwer zu lesen sind.
• Formelbilder, die nicht mehr zum Text passen, nachdem eines von beiden von Hand geändert wurde.
• Bei jeder neuen oder geänderten Formel in ein anderes Werkzeug wechseln und Bilder zurückkopieren.

Vorteile

• Beim Tippen sehen: Die Vorschau zeichnet die Formel, während Sie schreiben, und zeigt die Größe des Bildes.
• Später änderbar: Das LaTeX bleibt im Artefakt, sodass sich eine ausgewählte Formel wieder öffnet und Update ein neues Bild zeichnet.
• Der Text bleibt: Update auf einem Artefakt mit Text fügt die Formel nach dem Text ein und behält die Wörter.
• Keine fremde Website: Die Formel wird von MathJax in Ihrem Browser gezeichnet und nicht an einen Online-Editor gesendet.
• Fehler mit ihrer Stelle: Eine fehlende Klammer oder ein unbekannter Befehl wird unter dem Feld mit dem Zeichen angezeigt, an dem er steht.

Verwendung

1. Öffnen Sie ein Modul und wählen Sie ein Artefakt aus.
2. Geben Sie die Formel in LaTeX ein oder klicken Sie auf die Tasten unter dem Feld: Bruch, Wurzel, Potenz, Index, Summe, Integral, griechischer Buchstabe, Plus-Minus und Matrix. More symbols zeigt 21 weitere. Die Vorschau zeigt das Bild und seine Größe.
3. Klicken Sie auf Insert, um die Formel in einem neuen Artefakt nach dem ausgewählten hinzuzufügen, oder auf Update, um sie in das ausgewählte Artefakt zu schreiben. Lesen Sie die Bestätigung und klicken Sie auf Insert formula oder Update formula.
4. Der Ergebnisblock zeigt, was getan wurde, und Log lädt den Änderungsbericht herunter.
5. Um eine Formel zu ändern, wählen Sie sie im Modul aus. Sie öffnet sich im Widget (Editing 1531 …); ändern Sie das LaTeX und klicken Sie auf Update.

Gut zu wissen

• Arbeiten Sie in einem Änderungsset, damit Sie es verwerfen können, wenn das Ergebnis nicht passt. Das neue Artefakt wird sofort gespeichert.
• Das Bild ist ein PNG, das auf dem DOORS Next-Server gespeichert wird, in doppelter Größe gezeichnet, damit es auf Bildschirmen und in Exporten scharf bleibt. Settings bietet drei Größen: S, M und L.
• Das LaTeX kommt in ein Attribut namens Formula, wenn das Projekt eines hat, und immer in die Bildbeschreibung, sodass sich eine Formel auch in einem Projekt ohne dieses Attribut wieder öffnet.
• Neue Artefakte erhalten den Typ des ausgewählten Artefakts. In Settings können Sie für Insert einen anderen Artefakttyp des Projekts wählen; das Widget merkt ihn sich pro Projekt. Update behält den Typ.
• Wurde das Bild einer Formel von Hand ersetzt, weist das Widget darauf hin, und die Update-Bestätigung warnt, dass diese Änderung verloren geht. Das LaTeX hat immer Vorrang.