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é produktu Rational Publishing Engine
    Proměnná Popis
    _cell_number Číslo buňky je aktuální řádek. Pokud prvek není buňka, hodnota je 0. Proměnnou _cell_number můžete použít z karty Datový výraz nebo Výraz skriptu.
    _element_id Číslo prvku v šabloně. Interně uchovávané v šabloně a používané pro ladění. Proměnnou _element_id můžete použít z karty Datový výraz nebo Výraz skriptu.
    _element_level Rekurzivní úroveň prvku. Pokud není pro prvek ve vlastnosti Rekurzivní úroveň na kartě Data nastavena hodnota, hodnota je 1. Proměnnou _element_level můžete použít z karty Datový výraz nebo Výraz skriptu.
    _row_number Číslo řádku v aktuální tabulce. Pokud není prvek obsažen v prvku řádku, hodnota je 0. Proměnnou _row_number můžete použít z karty Datový výraz nebo Výraz skriptu.
    _sessionInfo Informace o vlastnosti běhového prostředí ze šablony nebo specifikace dokumentu. Na kartě Výraz skriptu vyberte proměnnou _sessionInfo a zadejte skript. Použijte prázdné uvozovky bez hodnoty uvnitř, abyste generovali výchozí hodnotu vlastnosti ve výstupu. Příklady skriptů:

    _sessionInfo.getDocspecProperty("property", "");
    _sessionInfo.getTemplateProperty("property", "");
    _sessionInfo.getDatasourceProperty("data_source_name","property", "");
    _sessionInfo.getOutputProperty("output_type","property", "");
    _sessionInfo.docspecVersion
    _sessionInfo.templateVersion
    _sessionInfo.engineVersion
    _sessionInfo.buildNumber

    Pro skript getDocspecProperty můžete použít existující vlastnosti specifikace dokumentu, nebo vytvořit vlastní vlastnosti metadat.

    _sessionLogger Pro účely ladění můžete zobrazit upravené informace, zprávy o chybě, varování nebo ladění v souboru TEMP\rpe\rpe.log, pohledu Konzola nebo pohledu Problémy. Zprávy se zobrazí v umístění definovaném v souboru log4j.properties.

    Výchozím nastavením je zobrazit informační zprávy v pohledu Konzola, ale ne v souboru rpe.log.

    Na kartě Výraz skriptu vyberte proměnnou _sessionLogger a zadejte skript. Záznamy protokolu můžete generovat jednou z následujících metod:
    1. _sessionLogger.debug(zpráva)
    2. _sessionLogger.info(zpráva)
    3. _sessionLogger.error(zpráva)
    4. _sessionLogger.warn(zpráva)

    Když se rozhodujete o tom, co do skriptu zadáte jako zprávu, zvažte použití vizuálního popisku, jako jsou vaše iniciály nebo jméno uživatele, a použití proměnných ze šablony a vytvořte smysluplné zprávy,

    _sessionUtils Na kartě Výraz skriptu můžete tuto proměnnou použít ke spuštění funkce na skriptu s názvem tidyXHTML. Tato proměnná je užitečná, když si ve výstupu všimnete bloků prázdných míst vytvořených nevhodným kódováním XHTML. Pomocí proměnné _sessionUtils se zpracuje řetězcový argument a soubor XHTML se vyčistí, aby se ve výstupu nezobrazoval další bílý znak.

    Příklad: _sessionUtils.tidyXHTML(text);

    Při použití proměnné _sessionUtils také na kartě Výraz skriptu vyberte volby Vstup XHTML a Výstup XHTML.
    Poznámka: Šablony zahrnující tyto proměnné lze načíst do starší verze produktu Rational Publishing Engine, ale skripty nelze správně vyhodnotit.

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 Java™ nebo JavaScript, jelikož se používají ve skriptech. Pravidla pro identifikátory JavaScript:
      • Musí začínat písmenem, podtržítkem (_) nebo značkou dolaru ($)
      • Následné znaky mohou být číslice (0-9)
      • Písmena rozlišují velikost písmen
      • Lze použít písmena ISO 8859-1 nebo Unicode, jako jsou například å nebo ü
      • Jako znaky lze použít řídicí posloupnost \uXXXX Unicode
    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