Podczas projektowania szablonu może być konieczne obliczenie wartości lub udostępnienie atrybutów danych w kontekstach, w których
są one zwykle niedostępne. W takich sytuacjach można zdefiniować zmienne i przypisać im wartości. Wartości mogą być danymi statycznymi lub danymi
dostępnymi w bieżącym kontekście.
O tym zadaniu
Zmienne mogą być używane jako obiekty zastępcze dla danych obliczanych w czasie wykonywania (przypisania zmiennych) lub mogą być udostępniane w
specyfikacji dokumentu. Zmiennych można również używać na stronach wzorcowych (w przeciwieństwie do atrybutów danych).
Można wyróżnić dwa typy
zmiennych:
- Zmienne zdefiniowane przez użytkownika: takie zmienne są definiowane przez projektanta szablonu. Zmienne zdefiniowane przez
użytkownika mogą być wewnętrzne lub zewnętrzne.
- Wewnętrzne zmienne zdefiniowane przez użytkownika: określenie zmiennej jako wewnętrznej pozwala wykonywać obliczenia lub tymczasowo przechowywać
informacje, jak w przypadku zmiennej używanej do przeniesienia danych do stron wzorcowych. Zmienne wewnętrzne nie są wyświetlane w specyfikacji dokumentu,
dlatego nie można ich udostępnić razem z wartościami.
- Zewnętrzne zmienne zdefiniowane przez użytkownika: zmienną należy określić jako zewnętrzną, aby ją udostępnić z wartością. Zmienne zewnętrzne są
wyświetlane w specyfikacji dokumentu. Patrz:
Tworzenie specyfikacji dokumentu.
- Zmienne w produkcie Rational Publishing Engine:
zmienne w produkcie Rational Publishing Engine to zmienne
wewnętrzne, których można używać w szablonach.
Tabela 1. Zmienne wewnętrzneZmienna |
Opis |
_element_id |
Zmienna przechowywana wewnętrznie w szablonie i używana do debugowania. |
_element_level |
Rekurencyjny poziom elementu. |
_row_number |
Numer wiersza w bieżącej tabeli.
Jeśli element nie jest wierszem, wartość tej zmiennej wynosi 0. |
_cell_number |
Numer komórki w bieżącym wierszu. Jeśli element nie jest komórką, wartość tej zmiennej wynosi 0. |
Procedura
- W widoku Schemat kliknij opcję . Zostanie otwarte okno Nowa zmienna.
- Wprowadź szczegóły zmiennej w następujących polach:
- Nazwa: wprowadź nazwę zmiennej. Nazwa zmiennej musi zawierać poprawne identyfikatory języka
Java™ lub JavaScript, ponieważ są one używane w skryptach.
- Opis: wprowadź opis zmiennej.
- Wartość domyślna: wprowadź wartość zmiennej.
- Dostęp: używając listy zdecyduj, czy zmienna ma być wewnętrzna, czy zewnętrzna.
- Zmienne wewnętrzne nie są wyświetlane w specyfikacji dokumentu, dlatego nie można udostępnić im wartości.
- Zmienne zewnętrzne są wyświetlane w specyfikacji dokumentu i można udostępnić im wartości.
- Aby przypisać zmienną do elementu:
Wskazówka: Zmienne należy przypisywać do elementów kontener zawsze, kiedy to możliwe.
Zmienna
jest stosowana do elementów wewnątrz elementu kontener.
Na przykład można użyć zmiennej w tabeli, aby utworzyć nowy wiersz dla każdej zmiennej. Przypisanie
zmiennej do elementu tabela spowoduje utworzenie tabeli dla każdej zmiennej. Niekiedy te kolejne tabele są scalane, ale czasami są wyświetlane jako
osobne tabele. Po dodaniu elementu kontener wewnątrz tabeli i przeciągnięciu wiersza do elementu kontener, a następnie przypisaniu zmiennej do elementu
kontener dla każdej zmiennej będzie tworzona jedna tabela z
wierszami.
- Kliknij element prawym przyciskiem myszy i kliknij opcję . Zostanie otwarte okno Edytor przypisań.
- Kliknij przycisk Dodaj. Zostanie otwarte okno Wybór zmiennej.
- Wprowadź nazwę zmiennej i kliknij przycisk OK.
- Kliknij przycisk OK w oknie Edytor przypisań.
Wyniki
Wybrana zmienna zostanie zdefiniowana i przypisana do bieżącego elementu.
Podczas przypisywania zmiennej do elementu w edytorze treści
szablonu jest wyświetlana ikona
.
Co dalej
Wskazówka: Listę przypisań zmiennych używanych w elemencie można przeszukiwać, klikając prawym przyciskiem myszy
element, do którego przypisano zmienną, i wybierając opcję . Zostanie otwarty widok Wyszukiwanie z wyświetloną listą przypisań zmiennych. Dwukrotne kliknięcie przypisania
zmiennej w wynikach umożliwia jego edycję.
Listę
przypisań zmiennych, atrybutów i zapytań używanych w elemencie można
przeszukiwać, klikając element prawym przyciskiem myszy i wybierając opcję
. Zostanie otwarty widok Wyszukiwanie z
wyświetloną listą. Dwukrotne kliknięcie pozycji w wynikach umożliwia jej edycję.