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 aplikace Document Builder. Klepněte na tlačítko OK.
      Tip: Funkce skriptu JavaScript můžete opětovně použít v různých částech šablony tak, že nastavíte vlastnost Skript knihovny v kódu skriptu. Chcete-li nastavit vlastnost Skript knihovny, přejděte do pohledu Vlastnosti prvku Kód skriptu JavaScript, vyberte kartu Specifické a povolte zaškrtávací políčko Skript knihovny. Další informace o vlastnosti skriptu knihovny nalezete v tématu Vlastnosti prvku kódu skriptu JavaScript.

      V případě souborů vybraných z počítače nebo vzdáleného serveru se kopie kódu JavaScript z vybraného souboru otevře v editoru skriptu JavaScript.

      V případě souborů vybraných v aplikaci Document Builder se otevře okno Použít odkaz na skript. Musíte se rozhodnout, zda chcete zahrnout skript JavaScript jako referenční odkaz v šabloně:
    • Vyberete-li volbu Ano, odkaz na soubor skriptu JavaScript (.js) bude vložen do značky <Script>. Například, následující referenční odkaz se přidá do editoru skriptu JavaScript, který nesmíte změnit:
      <Script src= "library://api/scripts/51"></Script>
      Zapamatujte si: Když spustíte generování dokumentů ze šablony a máte v šabloně jako referenční odkaz uveden skript JavaScript, aplikace Document Builder musí být spuštěna a připojena k aplikaci Document Studio. Další informace viz téma Připojení k aplikaci Document Builder.
    • Pokud vyberete volbu Ne, kopie kódu JavaScript z vybraného souboru se otevře v editoru skriptu JavaScript.
    1. Klepněte na volbu Otevřít v editoru, chcete-li zadat skript do editoru Eclipse JavaScript. Skript se otevře na nové kartě editoru jako dočasný soubor .js a vy budete moci upravit skript JavaScript a spravovat jej pomocí voleb v pohledu s osnovou. Po úpravě skriptu uložte změny, zavřete kartu editoru s dočasným skriptem JavaScript a vraťte se do okna Vstupní kód pro prvek kódu JavaScript.
    2. Klepnutím na tlačítko Otestovat skript ověřte platnost kódu.
    3. 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.