Při návrhu šablony může být nezbytné vypočítat hodnoty nebo zpřístupnit atributy dat v kontextech, kde běžně nejsou dostupné. Pro tyto situace můžete definovat proměnné a přiřadit jim hodnoty. Hodnoty mohou být statická data nebo to mohou být data, která jsou k dispozici v aktuálním kontextu.
Informace o této úloze
Proměnné mohou být použity jako zástupné znaky pro data vypočítávaná za běhu (přiřazení proměnných), nebo mohou být zadány ve specifikaci dokumentu. Na rozdíl od atributů dat můžete také použít proměnné ve stránkách předlohy.
Existují dva typy proměnných:
- Uživatelem definované proměnné: Proměnné definované uživatelem se definují pomocí návrháře šablon. Uživatelem definované proměnné mohou být interní nebo externí.
- Interní proměnné definované uživatelem: Zadejte proměnnou jako interní pro provádění výpočtů nebo k dočasnému uložení informace, jako je proměnná, která se používá k zobrazení dat do stránek předlohy. Interní proměnné se nezobrazují ve specifikaci dokumentu, a proto nemůžete zadávat jejich hodnoty.
- Externí proměnné definované uživatelem: Zadejte proměnnou jako externí, pokud ji zadáváte s hodnotou. Externí proměnné se zobrazují ve specifikaci dokumentu. Viz článek Vytvoření specifikace dokumentu.
- Proměnné produktu Rational Publishing Engine: Proměnné produktu Rational Publishing Engine jsou interní proměnné dostupné pro použití v šabloně dokumentu.
Tabulka 1. Interní proměnnéProměnná |
Popis |
_element_id |
Interně uchovávané v šabloně a používané pro ladění. |
_element_level |
Rekurzivní úroveň prvku. |
_row_number |
Číslo řádku v aktuální tabulce.
Pokud prvek není řádek, hodnota je 0. |
_cell_number |
Číslo buňky je aktuální řádek. Pokud prvek není buňka, hodnota je 0. |
Postup
- V pohledu Osnova klepněte na volbu . Otevře se okno Nová proměnná.
- Zadejte podrobnosti proměnné do těchto polí:
- Název: Zadejte název proměnné. Název proměnné musí používat platné identifikátory jazyka Java™ nebo JavaScript, protože se používají ve skriptech.
- Popis: Zadejte popis proměnné.
- Výchozí hodnota: Zadejte hodnotu proměnné.
- Přístup: Vyberte ze seznamu, zda je proměnná interní nebo externí.
- Interní proměnné se nezobrazují ve specifikaci dokumentu, a proto nemůžete zadávat jejich hodnoty.
- Externí proměnné se ve specifikaci dokumentu zobrazují a můžete zadávat jejich hodnoty.
- Přiřazení proměnné prvku:
Tip: Pokud je to možné, přiřazujte proměnné kontejnerovým prvkům.
Proměnná bude použita pro prvky uvnitř kontejnerového prvku.
Například můžete chtít použít proměnnou v tabulce tak, aby byl pro každou proměnnou vytvořen nový řádek. Pokud přiřadíte proměnnou prvku tabulky, pro každou proměnnou může být vytvořena tabulka. Někdy se tyto po sobě jdoucí tabulky sloučí, ale někdy se zobrazí jako samostatné tabulky. Pokud přidáte kontejnerový prvek do tabulky a přetáhnete řádek do kontejnerového prvku, a potom přiřadíte proměnnou kontejnerovému prvku, vytvoří se jedna tabulka s řádky pro jednotlivé proměnné.
- Klepněte pravým tlačítkem myši na prvek, a poté klepněte na volbu . Otevře se okno Editor přiřazení.
- Klepněte na tlačítko Přidat. Otevře se okno Vybrat proměnnou.
- Zadejte název proměnné a klepněte na tlačítko OK.
- Klepnutím na tlačítko OK v okně Editor přiřazení.
Výsledky
Vybraná proměnná bude definována a přiřazena aktuálnímu prvku.
Když přiřadíte proměnnou prvku, prvek zobrazí ikonu
v editoru obsahu šablony.
Jak pokračovat dále
Tip: Klepnutím pravým tlačítkem myši na prvek, ke kterému je přiřazena proměnná, a výběrem volby můžete vyhledat seznam přiřazení proměnných použitých v prvku. Otevře se pohled Hledat a zobrazí se seznam přiřazení proměnných. Pokud chcete upravit přiřazení proměnné, poklepejte na něj ve výsledcích.
Klepnutím pravým tlačítkem myši na prvek a výběrem volby můžete vyhledat seznam přiřazení proměnných, atributů a dotazů použitých v prvku. Otevře se pohled Hledat a zobrazí se seznam. Pokud chcete upravit položku, poklepejte na ni ve výsledcích.