Dla elementów szablonu można tworzyć style nagłówków odpowiadające wartościom atrybutów danych lub zmiennych z pewnymi właściwościami
dotyczącymi formatowania.
O tym zadaniu
W danych wyjściowych w formacie programu Microsoft Word, PDF i HTML można tworzyć tytuły
sekcji i przypisywać do nich style nagłówków, tworząc hierarchię informacyjną w dokumencie. Produkt
Rational Publishing Engine
wymaga przypisania tym tytułom numerów rozpoczynających się od
1, tak aby odpowiadały numerowi stylu nagłówka. Niektóre
dane, którym mają zostać przypisane style nagłówków, nie
zaczynają się od 1 lub mają wartości literowe zamiast liczbowych. Ponadto w każdym formacie wyjściowym są używane inne nazwy stylów nagłówków, co
dodatkowo komplikuje standaryzację tych stylów we wszystkich formatach wyjściowych. Na przykład w programie
Microsoft Word styl nagłówka najwyższego poziomu nazywa się
Nagłówek 1. W języku HTML ten
sam styl nagłówka ma oznaczenie
H1.
Aby dopasować wartości atrybutu lub zmiennej do wartości liczbowych rozpoczynających się od 1, można użyć wyrażenia JavaScript parseInt(nazwa_atrybutu_lub_zmiennej). Następnie, aby utworzyć
podpunkty w danych potomnych, należy dodać jeden do wyrażenia:
parseInt(nazwa_atrybutu_lub_zmiennej)
+ 1. To wyrażenie skryptu umożliwia uzgodnienie wartości w sposób
narastający ze stylami nagłówków we wszystkich danych wyjściowych w formatach
Microsoft Word, PDF i HTML.
Przykład
W tym przykładzie użyto ogólnego schematu XML
RequisitePro.xsd, który obejmuje atrybut Level
w zapytaniu PRRequirement.
Końcowy dokument wyjściowy utworzony przez szablon w tym przykładzie:
- Wyświetla wartości FullTag (pełny znacznik) jako tytuły sekcji.
- Wyświetla widoczną hierarchię wymagań:
- Wymagania są nagłówkami najwyższego poziomu i używają stylu Nagłówek 1.
- Wymagania potomne są nagłówkami niższego poziomu i używają stylu Nagłówek 2.
- Tworzy hierarchię wartości atrybutu Level.
Aby utworzyć raport ze stylami nagłówków zastosowanymi do atrybutu
FullTag:
- W aplikacji Launcher utwórz specyfikację dokumentu i skonfiguruj źródło danych.
- W programie Document Studio otwórz nowy szablon.
- Dodaj przykładowy schemat źródła danych:
- W widoku Schematy źródeł danych kliknij ikonę Dodaj schemat źródła danych. Po otwarciu kreatora
Schemat źródła danych kliknij przycisk Dalej.
- W polu Typ schematu wybierz opcję Ogólny XML.
- Kliknij przycisk Przeglądaj i wybierz przykładowy plik danych RequisitePro.xsd zainstalowany wraz z produktem. Położenie
domyślne: %RPE_HOME%\source\XML\examples\RequisitePro.xsd.
Kliknij przycisk Otwórz.
- Wprowadź własną nazwę w polu Identyfikator źródła danych.
- Kliknij przycisk Dalej. Przejrzyj wybrane opcje i kliknij przycisk Zakończ.
- Dodaj elementy do szablonu.
- Dodaj element
Kontener.
- Wstaw element
Akapit do
elementu kontenera.
- Wstaw element
Tekst do elementu akapitu.
- Dodaj zapytania do elementów.
- W widoku Schematy źródeł danych rozwiń projekt i wymagania.
- Przeciągnij element PRRequirement do elementu kontenera.
- Przeciągnij element FullTag (string) do elementu tekstu.
- W oknie Wybór kontekstu wybierz opcję Użyj jako wartości.
- Wybierz kontener PRRequirement i kliknij przycisk
OK.
- Utwórz wyrażenie skryptu definiujące styl dla elementu akapitu.
- Wybierz element akapitu.
- W widoku Właściwości wybierz kartę Ogólne.
- W polu Nazwa stylu kliknij ikonę konfiguracji
.
- W oknie Ustawianie wartości nazwy stylu wybierz kartę Wyrażenie skryptu.
- Rozwiń opcję Atrybuty i źródło danych.
- Wybierz atrybut Level (poziom).
- Wpisz parseInt(Level) + 1.
- Kliknij opcję , aby wygenerować dokument wyjściowy.
W
miarę jak wartości atrybutu Level będą się zwiększać o jeden, tak samo będzie rosła numeracja stylów nagłówków. Styl
Nagłówek 1 zostanie ustawiony jako wartość elementu
FullTag (pełny znacznik) dla wymagań, dla których atrybut
Level (poziom) ma wartość 0.
Styl Nagłówek 2 zostanie ustawiony jako wartość elementu FullTag dla wymagań, dla których atrybut
Level ma wartość 1.
Co dalej
Styl nagłówka to najczęściej stosowany styl przy użyciu wyrażeń skryptów. Można jednak również stosować wyrażenia skryptu do
wielkości czcionki, wielkości ramki lub wielkości marginesów.