Tworzenie wyrażeń skryptów do nadawania stylu nagłówkom

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.

Procedura

  1. Przeciągnij element Ikona tekstu Tekst do edytora treści szablonu.
  2. Wybierz element tekstu.
  3. W widoku Właściwości wybierz kartę Ogólne.
  4. W polu Nazwa stylu kliknij ikonę konfiguracji Ikona konfiguracji.
  5. Wybierz kartę Wyrażenie skryptu.
  6. Wybierz zmienną lub atrybut.
  7. Wprowadź wyrażenie JavaScript: parseInt(nazwa_atrybutu_lub_zmiennej) + 1.
  8. Kliknij przycisk OK.

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:
  1. W aplikacji Launcher utwórz specyfikację dokumentu i skonfiguruj źródło danych.
  2. W programie Document Studio otwórz nowy szablon.
  3. Dodaj przykładowy schemat źródła danych:
    1. 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.
    2. W polu Typ schematu wybierz opcję Ogólny XML.
    3. 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.
    4. Wprowadź własną nazwę w polu Identyfikator źródła danych.
    5. Kliknij przycisk Dalej. Przejrzyj wybrane opcje i kliknij przycisk Zakończ.
  4. Dodaj elementy do szablonu.
    1. Dodaj element Ikona kontenera Kontener.
    2. Wstaw element Ikona akapitu Akapit do elementu kontenera.
    3. Wstaw element Ikona tekstu Tekst do elementu akapitu.
      Przykład szablonu z elementami
  5. Dodaj zapytania do elementów.
    1. W widoku Schematy źródeł danych rozwiń projekt i wymagania.
    2. Przeciągnij element PRRequirement do elementu kontenera.
    3. Przeciągnij element FullTag (string) do elementu tekstu.
    4. W oknie Wybór kontekstu wybierz opcję Użyj jako wartości.
    5. Wybierz kontener PRRequirement i kliknij przycisk OK.
      Przykład szablonu z zapytaniami w elementach
  6. Utwórz wyrażenie skryptu definiujące styl dla elementu akapitu.
    1. Wybierz element akapitu.
    2. W widoku Właściwości wybierz kartę Ogólne.
    3. W polu Nazwa stylu kliknij ikonę konfiguracji Ikona konfiguracji.
    4. W oknie Ustawianie wartości nazwy stylu wybierz kartę Wyrażenie skryptu.
    5. Rozwiń opcję Atrybuty i źródło danych.
    6. Wybierz atrybut Level (poziom).
    7. Wpisz parseInt(Level) + 1.
  7. Kliknij opcję Publikuj > Generuj dokument, 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.

Opinia