JavaScript kód elem hozzáadása

JavaScript kód elemet kell használni a sablonban szereplő minden egyes kódblokkhoz.
Korlátozás: Új szolgáltatás ikon A JavaScript kód elem csak a 2-es változatú sablonokban érhető el.

Erről a feladatról

A JavaScript lehet egy egyszerű argumentum, de akár bonyolult parancsfájl is.
  • Egyszerű argumentum esetén parancsfájlt alkalmazhat egy elem, például Szöveg elem tartalmára. Kattintson duplán a szöveg elemre, válassza a Parancsfájl-kifejezés lapot, és adjon meg egy parancsfájlt.
  • Összetett parancsfájloknál ezzel a feladattal alkalmazhatja a parancsfájlt a JavaScript kódelem használatával.
A JavaScript kódelem használatának a következő előnyei vannak az elem Parancsfájl-kifejezés lapjának használatával szemben:
  • Újrafelhasználhat más felhasználóktól származó parancsfájlokat.
  • Csoportosíthatja a számításokat és nem kell aggódnia a végrehajtási sorrend miatt.
  • Létrehozhat normál és összetett adatszerkezeteket, például gyűjteményeket, és folyamatosan adhat hozzájuk adatokat.
    Tipp: A Rational Publishing Engine 2.1 változatától kezdve a JavaScript kódelemben meghatározott függvények már meghívhatók másik JavaScript kódból vagy Parancsfájl-kifejezésből egy Könyvtár parancsfájl tulajdonság beállításával a parancsfájl kódban. A Könyvtár parancsfájl tulajdonság beállításához kattintson a JavaScript kódelem Beállítások nézetére, és a Speciális lapon jelölje be a Könyvtár parancsfájl jelölőnégyzetet. További információkért a parancsfájl tulajdonsággal kapcsolatban tekintse meg a JavaScript kódelem tulajdonságok témakört.

A telepítési fájlok és az előre meghatározott Document Builder összetevő fájlok tartalmazzák a JavaScript utils.js fájlt, amellyel egyszerű JavaScript kódot használhat, például felveheti az aktuális dátumot a jelentéskimenetbe.

A sablonban meglévő JavaScript kódok listájának megjelenítéséhez kattintson a Sablon > JavaScript áttekintése menüpontra. Megnyílik a Keresés nézet és megjelenik a JavaScript kódot használó elemek listája. A natív szűrőket nem tekintjük JavaScript kódnak ebben a kontextusban. A natív szűrők nem szerepelnek a keresési eredményekben.

Eljárás

  1. Mentse a sablont mielőtt megkezdené a munkát a JavaScript kóddal.
  2. A Paletta nézetben válassza ki a JavaScript kód ikon JavaScript kód elemet, és húzza a sablontartalom-szerkesztőbe.
  3. Kattintson duplán a JavaScript kód elemre.
  4. A Parancsfájl kifejezés lapon válasszon ki egy változót a fából, amelyre alkalmazza a JavaScript kódot.
  5. Adja meg a JavaScript kódot az alábbi lehetőségek egyikének használatával:
    • Kézileg írjon parancsfájlt ebben az ablakban
    • Külső szerkesztőből másoljon le és illesszen be egy parancsfájlt ebbe az ablakba
    • Kattintson a Parancsfájl szerepeltetése elemre, és válasszon ki egy fájlt a saját számítógépéről, távoli kiszolgálóról vagy a Document Builder összetevőből.
  6. Választható: Ha XHTML-ből másolta a parancsfájlt, akkor az alábbi lehetőségei vannak:
    • Jelölje be az XHTML bemenet jelölőnégyzetet, hogy a parancsfájlban található XHTML címkék szerkeszthetők legyenek.
    • Szüntesse meg az XHTML bemenet lehetőség kijelölését az összes XHTML címke eltávolításához a parancsfájlból.
    Ha formázott szöveget másol vagy formázott szöveget használ a feltételekben, akkor be kell jelölnie az XHTML bemenet lehetőséget.
    Fontos: Az érvénytelen XHTML miatt a dokumentumelőállítás meghiúsul. A módosítások mentése előtt győződjön meg róla, hogy az XHTML érvényes.
  7. Választható: Ha XHTML kimenetbe állítja elő a sablont, akkor az alábbiakra van lehetősége:
    • Jelölje be az XHTML kimenet lehetőséget a parancsfájl értelmezéséhez és a parancsfájl előállításához formázott szövegként.
    • Szüntesse meg az XHTML kimenet lehetőség kijelölését, ha sima szövegként akarja kezelni a parancsfájlt.
    Ez a választás a kifejezésben szereplő összes adatforrás-attribútumra vonatkozik. Nem lehet sima szöveg és XHTML vegyesen a parancsfájlban.

    Ha formázott szöveget másol vagy formázott szöveget hoz létre menet közben, akkor be kell jelölnie az XHTML kimenet lehetőséget.

  8. A parancsfájl megadása után kattintson a Parancsfájl tesztelése gombra a kód érvényesítéséhez. Ha hibák vannak a JavaScript kódban, akkor lehet, hogy a dokumentumelőállítás sikertelen lesz.
  9. A módosítások mentéséhez kattintson az OK gombra. A kódblokk össze van húzva az elemben. A sablontartalom-szerkesztőben kibonthatja a kódot és megtekintheti azt.

Munka a JavaScript szerkesztőben

A JavaScript szerkesztőben színezett szintaxissal és tartalomsegéddel dolgozhat a parancsfájlokon.

Erről a feladatról

A szintaxis színezés a saját színeivel és stílusával azt határozza meg, hogy a JavaScript hogy adja vissza a forráskódot. Ha módosítani kívánja az alapértelmezett szintaxis színezés beállításait, akkor a Document Studio alkalmazásban kattintson az Ablak > Beállítások > JavaScript > Szerkesztő > Szintaxis színezés lehetőségre.

A tartalomsegéd egy előugró ablakban a jelenlegi kódsor befejezés érvényes alternatíváinak listáját jelenít meg. A tartalomsegéd aktiválásához nyomja le a Ctrl + szóköz billentyűkombinációt.

Ez egy képernyőkép a JavaScript szerkesztőről.

Eljárás

  1. Kattintson duplán a JavaScript kód elemre. Megnyílik a Kód bevitele a JavaScript kód elemhez ablak.
  2. Választható: Másik fájlból származó új parancsfájl szerepeltetésekor kattintson a Parancsfájl szerepeltetése lehetőségre, és válasszon ki egy fájlt a számítógépről, egy távoli kiszolgálóról vagy a Document Builder összetevőből. Kattintson az OK gombra.

    Saját gépéről vagy távoli kiszolgálóról választott fájlok esetén a kiválasztott fájl JavaScript kódjának másolata megnyílik a JavaScript szerkesztőben.

    Document Builder összetevőből választott fájlok esetén megnyílik a Parancsfájl beállítások használata ablak. Válassza ki, hogy szerepelteti-e a sablonban a JavaScript fájlt referenciahivatkozásként.
    • Ha a választása Igen, akkor a JavaScript fájlra mutató hivatkozás (.js) beágyazásra kerül a <Parancsfájlt> címkébe. Például a a JavaScript szerkesztőbe a következő, nem módosítható referenciahivatkozás kerül felvételre:
      <Script src= "library://api/scripts/51"></Script>
      Ne feledje: Amikor a sablonból dokumentumelőállítást futtat, és a sablonban JavaScript referenciahivatkozás van, akkor a Document Builder alkalmazásnak futnia kell, és kapcsolatban kell lennie a Document Studio alkalmazással. Részletes információkért lásd a Csatlakozás a Document Builder összetevőhöz témakört.
    • Ha választása Nem, akkor a kiválasztott fájl JavaScript kódjának másolata megnyílik a JavaScript szerkesztőben.
  3. Választható: Kattintson a Megnyitás szerkesztőben lehetőségre a kód beviteléhez egy Eclipse JavaScript szerkesztőben. A parancsfájl új szerkesztőlapon nyílik meg ideiglenes .js fájlként úgy, hogy szerkesztheti a JavaScript kódot, és a Vázlat nézet paramétereinek segítségével kezelheti a parancsfájlt. A parancsfájl szerkesztése után mentse a változásokat és zárja be az ideiglenesJavaScript szerkesztőlapot, hogy visszatérjen a JavaScript kódelem bemeneti kódja ablakba.
  4. Kattintson a Parancsfájl tesztelése gombra a kód érvényesítéséhez.
  5. Az OK gombra kattintva mentse a módosításokat és lépjen ki az ablakból.