Přidání prvku kódu JavaScript

Použijte prvek kódu JavaScript pro každý blok kódu, který používáte v šabloně.
Omezení: ikona Nová funkce Prvek kódu JavaScript je k dispozici pouze pro šablony verze 2.

Informace o této úloze

Skript JavaScript může nabývat rozsahu od jednoduchých argumentů po složité skripty.
  • V případě jednoduchých argumentů můžete použít skript na obsah určitého, např. textového prvku. Poklepejte na textový prvek, vyberte kartu Výraz skriptu a zadejte skript.
  • V případě složitých skriptů můžete použít tuto úlohu pro použití skriptu pomocí prvku kódu JavaScript.
Při použití prvku kódu JavaScript v kartě Výraz skriptu prvku jsou zde výhody:
  • Je možné znovu používat skripty od jiných uživatelů.
  • Můžete seskupit výpočty bez obav o pořadí jejich provedení.
  • Můžete vytvářet běžné a komplexní datové struktury, jako např. kolekce, a průběžně do nich přidávat.
    Tip: Počínaje vydáním produktu Rational Publishing Engine V2.1 můžete vyvolat funkci definovanou v jednom prvku kódu skriptu JavaScript v jiném kódu skriptu JavaScript nebo výrazu skriptu nastavením vlastnosti 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 naleznete v tématu Vlastnosti prvku kódu skriptu JavaScript.

Soubor skriptu JavaScript utils.js je zahrnut v instalačních souborech a v předdefinovaných souborech aplikace Document Builder, abyste jej mohli použít pro jednoduchý skript JavaScript, jako je zahrnutí aktuálního data do výstupu sestavy.

Chcete-li zobrazit seznam stávajících kódů JavaScript v šabloně, klepněte na volbu Šablona > Přezkoumat skripty JavaScript. Pohled Vyhledávání se otevře a zobrazí se seznam prvků, které používají skript JavaScript. Nativní filtry nejsou v tomto kontextu považovány za skripty JavaScript. Nativní filtry nejsou ve výsledcích hledání uvedeny.

Postup

  1. Než začnete pracovat se skriptem JavaScript, uložte šablonu.
  2. V pohledu Paleta vyberte prvek Ikona kódu skriptu JavaScript Kód skriptu JavaScript a přetáhněte jej do editoru obsahu šablony.
  3. Poklepejte na prvek kódu JavaScript.
  4. V kartě Výraz skriptu vyberte proměnnou ze stromu, abyste pro ni použili kód JavaScript.
  5. Zadejte kód JavaScript pomocí jedné z těchto voleb:
    • Zapište skript ručně v tomto okně.
    • Skript do tohoto okna zkopírujte a vložte z jiného editoru.
    • Klepněte na volbu Zahrnout skript a vyberte soubor ze svého počítače, ze vzdáleného serveru nebo z aplikace Document Builder.
  6. Volitelné: Pokud jste skript zkopírovali z XHTML, můžete:
    • Vybrat volbu Vstup XHTML, chcete-li povolit úpravu značek XHTML obsažených ve skriptu.
    • Zrušit výběr volby Vstup XHTML, chcete-li odebrat ze skriptu všechny značky XHTML.
    Pokud kopírujete formátovaný text nebo používáte formátovaný text v podmínkách, musíte vybrat volbu Vstup XHTML.
    Důležité: Neplatný dokument XHTML způsobuje, že se generování dokumentů nezdaří. Před uložením změn ověřte platnost svého jazyka XHTML.
  7. Volitelné: Pokud generujete šablonu do výstupu XHTML, můžete:
    • Vybrat volbu Výstup XHTML, chcete-li skript analyzovat a vykreslit jako formátovaný text.
    • Zrušit výběr volby Výstup XHTML, chcete-li interpretovat skript jako prostý text.
    Tento výběr platí pro všechny atributy zdroje dat ve výrazu. Ve skriptu nelze směšovat prostý text a XHTML.

    Pokud kopírujete formátovaný text na bázi ad-hoc, musíte vybrat volbu Výstup XHTML.

  8. Po zadání skriptu ověřte platnost kódu klepnutím na volbu Otestovat skript. Pokud jsou ve skriptu JavaScript chyby, generování dokumentů nemusí být úspěšně dokončeno.
  9. Klepnutím na tlačítko OK uložte změny. Blok kódu se v prvku sbalí. Chcete-li kód zobrazit v editoru obsahu šablony, můžete jej rozbalit.

Práce v editoru JavaScript

Použijte editor JavaScript pro práci na skriptu s barevným značením syntaxe a číslováním řádků.

Informace o této úloze

Barevné značení syntaxe uvádí, jak je zdrojový kód skriptu JavaScript vykreslen pomocí vlastních barev a stylů. Chcete-li změnit výchozí předvolby barev syntaxe, v aplikaci Document Studio vyberte volby Windows > Předvolby > JavaScript > Editor > Barevné značení syntaxe.

Obsahová asistence zobrazí v informačním okně seznam platných alternativ pro dokončení aktuálního řádku kódu. Chcete-li aktivovat obsahovou asistenci, stiskněte klávesu Ctrl + mezerník.

Jedná se o snímek obrazovky editoru skriptu JavaScript.

Postup

  1. Poklepejte na prvek kódu JavaScript. Otevře se okno Vložit kód pro prvek kódu skriptu JavaScript.
  2. Volitelné: 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.

    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.
  3. Volitelné: 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.
  4. Klepnutím na tlačítko Otestovat skript ověřte platnost kódu.
  5. Klepnutím na tlačítko OK uložte změny a opusťte okno.