Definování a přiřazování proměnných

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

  1. V pohledu Osnova klepněte na volbu Proměnné > Vložit > Nová proměnná. Otevře se okno Nová proměnná.
  2. Zadejte podrobnosti proměnné do těchto polí:
    1. 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.
    2. Popis: Zadejte popis proměnné.
    3. Výchozí hodnota: Zadejte hodnotu proměnné.
    4. 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.
  3. 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é.
    Prvek tabulky s kontejnerovým prvkem. Uvnitř kontejnerového prvku je prvek řádku se třemi prvky buňky.
    1. Klepněte pravým tlačítkem myši na prvek, a poté klepněte na volbu Data > Upravit přiřazení. Otevře se okno Editor přiřazení.
    2. Klepněte na tlačítko Přidat. Otevře se okno Vybrat proměnnou.
    3. Zadejte název proměnné a klepněte na tlačítko OK.
    4. 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 Ikona Přiřazení proměnné v editoru obsahu šablony.

Prvek odstavce s dotazem a přiřazením proměnné

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 Hledat > Odkazy proměnných v prvku 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 Hledat > Všechny odkazy v prvku 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.


Zpětná vazba