Formula Editor

Czym jest i dlaczego powstał

Wymagania dotyczące hamulców, czujników czy pętli sterowania często potrzebują wzoru: drogi hamowania, tolerancji, filtru. DOORS Next nie ma edytora wzorów. Zespoły wklejają zrzut ekranu z Worda, którego nikt później nie zmieni bez oryginalnego pliku, albo wpisują wzór jako zwykły tekst, który trudno czytać.

Formula Editor pozwala pisać wzór w LaTeX bezpośrednio w DOORS Next. Rysuje wzór na bieżąco podczas pisania i wstawia go do modułu jako obraz, w nowym artefakcie po zaznaczonym albo w zaznaczonym artefakcie. LaTeX jest zapisywany razem z artefaktem, więc późniejsze zaznaczenie wzoru otwiera go ponownie w edytorze.

Jakie problemy rozwiązuje

• Wzory wklejone jako zrzuty ekranu, których nikt nie zmieni bez pliku Worda, z którego pochodzą.
• Wzory wpisane jako zwykły tekst, np. s = v^2/(2*mu*g), trudne do czytania w przeglądach i eksportach.
• Obrazy wzorów, które nie pasują już do tekstu, bo jedno z nich zmieniono ręcznie.
• Przełączanie się do innego narzędzia i kopiowanie obrazów z powrotem przy każdym nowym lub zmienionym wzorze.

Korzyści

• Widać na bieżąco: podgląd rysuje wzór podczas pisania i pokazuje rozmiar obrazu.
• Można zmienić później: LaTeX jest przechowywany w artefakcie, więc zaznaczenie wzoru otwiera go ponownie, a Update rysuje nowy obraz.
• Tekst zostaje: Update na artefakcie z tekstem dodaje wzór po tekście i zachowuje słowa.
• Bez innej strony internetowej: wzór rysuje MathJax w Twojej przeglądarce; nie jest wysyłany do edytora online.
• Błędy wraz z miejscem: brakujący nawias klamrowy lub nieznane polecenie jest pokazywane pod polem razem ze znakiem, w którym występuje.

Jak używać

1. Otwórz moduł i zaznacz jeden artefakt.
2. Wpisz wzór w LaTeX albo klikaj przyciski pod polem: ułamek, pierwiastek, potęga, indeks, suma, całka, litera grecka, plus minus i macierz. More symbols pokazuje 21 kolejnych. Podgląd pokazuje obraz i jego rozmiar.
3. Kliknij Insert, aby dodać wzór w nowym artefakcie po zaznaczonym, albo Update, aby zapisać go w zaznaczonym artefakcie. Przeczytaj potwierdzenie i kliknij Insert formula lub Update formula.
4. Blok wyniku pokazuje, co zostało zrobione, a Log pobiera raport zmian.
5. Aby zmienić wzór, zaznacz go w module. Otworzy się w widżecie (Editing 1531 …); zmień LaTeX i kliknij Update.

Warto wiedzieć

• Pracuj w zestawie zmian (change set), aby móc go odrzucić, jeśli wynik nie jest taki, jak trzeba. Nowy artefakt jest zapisywany od razu.
• Obraz to plik PNG zapisany na serwerze DOORS Next, rysowany w dwukrotnym rozmiarze, aby pozostał ostry na ekranach i w eksportach. Settings ma trzy rozmiary: S, M i L.
• LaTeX trafia do atrybutu o nazwie Formula, jeśli projekt go ma, i zawsze do opisu obrazu, więc wzór otwiera się ponownie także w projekcie bez tego atrybutu.
• Nowe artefakty dostają typ zaznaczonego artefaktu. W Settings możesz wybrać dla Insert inny typ artefaktu projektu; widżet zapamiętuje go osobno dla każdego projektu. Update zachowuje typ.
• Gdy obraz wzoru został ręcznie zastąpiony, widżet to sygnalizuje, a potwierdzenie Update ostrzega, że ta zmiana zostanie utracona. LaTeX zawsze wygrywa.