Nastavení způsobu formátování a výpočtu dat

Definujte obsah prvku šablony nebo hodnoty jeho vlastností pro formátování a výpočet dat.

Informace o této úloze

Obsah šablony můžete definovat pomocí jednoduchých hodnot, datových výrazů nebo výrazů skriptu.

Datové výrazy i výrazy skriptu mají interní proměnné, které jsou k dispozici pro zvolení.
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 editoru obsahu šablony poklepejte na textový prvek. Otevře se okno Nastavit obsah pro aktuální prvek.
  2. Zadejte obsah pomocí jedné z následujících voleb:
    • Chcete-li použít jednoduchou hodnotu, klepněte na kartu Jednoduchá hodnota a zadejte hodnotu.
    • Chcete-li použít datový výraz, klepněte na kartu Datový výraz a proveďte jeden z následujících kroků:
      • Rozbalte položku Proměnné a vyberte proměnnou, kterou chcete použít.
      • Rozbalte položku Atributy a vyberte atribut dat, který chcete použít.
    • Chcete-li použít výraz skriptu, klepněte na kartu Výraz skriptu.
      • Rozbalte volbu Proměnné, vyberte proměnnou a zadejte kód JavaScript, který může používat proměnné v aktuálním kontextu.
      • Rozbalte volbu Atributy, vyberte atribut a zadejte kód JavaScript, který může použít atributy dat v aktuálním kontextu.
      • Pokud jste zkopírovali skript z XHTML, můžete vybrat volbu Vstup XHTML, chcete-li povolit úpravu značek XHTML obsažených ve skriptu.
      • Pokud generujete šablonu do výstupu XHTML, můžete vybrat volbu Výstup XHTML, chcete-li skript analyzovat a vykreslit jako formátovaný text.
      Chcete-li například vybrat atributy jako absolutní číslo, název a hodnotu, zadejte kód JavaScript jako:
      "object:"+Absolute Number+
      "attribute"+name+
      "value"+_value
      Tip: Pokud máte velmi složitou šablonu, můžete popsat jednotlivé bloky v šabloně pomocí vlastností Název a Popis. Pole názvu a popisu jsou standardně prázdná, obsah názvu se zobrazuje v šabloně a obsah popisu lze zobrazit v poli pokynu prvku šablony. To může být užitečné pro ostatní při opakovaném použití šablony.

      Máte také možnost importovat existující skript nebo pracovat v editoru JavaScript místo v kartě Výraz skriptu:

    1. Pokud vkládáte nový skript z jiného souboru, klepněte na volbu Zahrnout skript a vyberte soubor ze svého počítače, vzdáleného serveru nebo komponenty Centrální správa. Klepnutím na tlačítko OK zavřete okno. Poté poklepejte na prvek a znovu otevřete okno Vložit kód pro prvek kódu skriptu JavaScript.
    2. Klepněte na volbu Otevřít v editoru, abyste zadali skript do editoru Eclipse JavaScript. Skript se otevře v nové kartě editoru jako dočasný soubor .js a vy budete moci upravit JavaScript.
      Poznámka: Pokud začnete zapisovat a po zadání období nebo jiného znaku jako hodnoty se může objevit zpráva Chyba přístupu k souboru skriptu JavaScript. Může být také následována zprávou Problémy během obsahové asistence. Pokud zjistíte tyto zprávy, dokončete instrukce ve zprávě a vypněte volbu Další návrhy skriptu JavaScript:
      1. Klepněte na volbuOkno > Předvolby > JavaScript > Editor > Obsahová asistence > Rozšířené.
      2. V sekci cyklování Obsahová asistence vymažte volbu Další návrhy skriptu JavaScript.
      3. Klepnutím na tlačítko OK zavřete okno.
    3. Spravujte skript prostřednictvím voleb v pohledu Osnova.
    4. Uložte změny.
    5. Zavřete dočasnou kartu editoru JavaScript. Vrátíte se do okna Vložit kód pro prvek kódu skriptu JavaScript.
    6. Klepnutím na tlačítko Otestovat skript ověřte platnost kódu.
    7. Klepnutím na tlačítko OK uložte změny a opusťte okno.
  3. Klepnutím na tlačítko OK uložte změny.

Příklad

Příklad použití datového výrazu
Chcete-li ve vašich tabulkách zobrazit automaticky generovaná čísla řádků:
  1. Přetáhněte prvek tabulky do editoru.
  2. Zadejte pro tabulku 3 řádky a 3 sloupce a klepněte na tlačítko OK.
  3. Přetáhněte do každé buňky textový prvek.
  4. Vyberte první buňku v prvním řádku.
  5. v pohledu Vlastnosti vyberte kartu Obsah a klepněte na ikona Konfigurace. Stejné okno také otevře poklepání na prvek.
  6. Klepněte na kartu Datový výraz a vyberte _row_number. Potom klepněte na tlačítko OK.
  7. Opakujte pro první buňku ve druhém řádku a ve třetím řádku.
  8. Odeberte z buněk čísel řádků ohraničení:
    1. Podržte klávesu CTRL a vyberte první buňku v každém řádku. Když máte vybráno více prvků, můžete upravit vlastnosti pro všechny současně.
    2. V pohledu Vlastnosti vyberte kartu Ohraničení.
    3. U vlastnosti Styl vyberte hodnotu žádný.
  9. Uložte šablonu.
  10. Otestujte šablonu generováním výstupu. První buňka obsahuje číslo řádku a nemá kolem sebe ohraničení:
    Příklad výstupu
  11. Dokončete přidání atributů ze schématu zdroje dat pro zbývající buňky v šabloně a dokončete tabulku.

Zpětná vazba