Adatok formázásának és kiszámításának beállítása

Határozza meg a sablonelemek tartalmát vagy tulajdonságértékeit az adatok formázásához és kiszámításához.

Erről a feladatról

Egy sablon tartalmát meghatározhatja egyszerű értékek, adatkifejezések vagy parancsfájl-kifejezések használatával.

Az adatkifejezések és a parancsfájl-kifejezések egyaránt tartalmaznak a felhasználó által kiválasztható belső változókat.
1. Táblázat Rational Publishing Engine belső változói
Változó Leírás
_cell_number A cella száma az aktuális sorban. Ha az elem nem cella, akkor az értéke 0. Használhatja az Adatkifejezés vagy a Parancsfájl-kifejezés lapon található _cell_number értéket.
_element_id Az elem száma a sablonon belül. Belsőleg tárolódik a sablonban és hibakereséshez használatos. Használhatja az Adatkifejezés vagy a Parancsfájl-kifejezés lapon található _element_id értéket.
_element_level Az elem rekurzív szintje. Ha az elem értéke nincs beállítva az Adatok lapon található Rekurzív szint tulajdonságban, akkor az értéke 1. Használhatja az Adatkifejezés vagy a Parancsfájl-kifejezés lapon található _element_level értéket.
_row_number A sor száma az aktuális táblázatban. Ha az elemet nem sor elem tartalmazza, akkor az értéke 0. Használhatja az Adatkifejezés vagy a Parancsfájl-kifejezés lapon található _row_number értéket.
_sessionInfo A sablonból vagy dokumentummeghatározásból származó futási tulajdonság információk. A Parancsfájl-kifejezés lapon válassza ki a _sessionInfo változót és adja meg a parancsfájlt. A tulajdonság alapértelmezett értékének előállításához a kimenetben, használjon üres idézőjeleket, bennük foglalt érték nélkül. Parancsfájl példák:

_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

A getDocspecProperty esetében használhat létező dokumentummeghatározás tulajdonságokat vagy létrehozhat egyéni metaadat tulajdonságokat.

_sessionLogger Kizárólag hibakeresési céllal megjeleníthet egyéni információkat, hiba-, figyelmeztetési vagy hibakeresési üzeneteket a TEMP\rpe\rpe.log fájlban, a Konzol nézetben vagy a Problémák nézetben. Az üzenetek a log4j.properties fájlban megadott helyen jelennek meg.

Az alapértelmezett beállítás szerint az információs üzenetek a Konzol nézetben megjelennek, de az rpe.log fájlban nem.

A Parancsfájl-kifejezés lapon válassza ki a _sessionLogger változót és adja meg a parancsfájlt. A naplóbejegyzéseket a következő metódusok egyikével állíthatja elő:
  1. _sessionLogger.debug(message)
  2. _sessionLogger.info(message)
  3. _sessionLogger.error(message)
  4. _sessionLogger.warn(message)

Amikor eldönti, hogy mit ad meg a message változó értékeként a parancsfájlban, fontolja meg vizuális azonosító szöveg (például a monogramja vagy felhasználóneve), valamint a sablonból származó változók használatát, hogy az előállított üzenetek minél informatívabbak legyenek.

_sessionUtils A Parancsfájl-kifejezés lapon ezzel a változóval futtathat függvényt a tidyXHTML nevű parancsfájlon. Ez a változó olyankor hasznos, ha üres helyeket lát a kimenetben, amit a helytelen XHTML kódolás okoz. A _sessionUtils változóval karaktersorozat argumentum kerül feldolgozásra és az XHTML megtisztításra kerül, azaz az extra üres hely nem jelenik meg a kimenetben.

Példa: _sessionUtils.tidyXHTML(text);

A _sessionUtils változó használatakor az XHTML bemenet és az XHTML kimenet beállításokat is ki kell választani a Parancsfájl-kifejezés lapon.
Megjegyzés: Az ezt a változót tartalmazó sablonok betölthetők a Rational Publishing Engine a korábbi változataiba, de a parancsfájlok nem értékelhetők ki megfelelően.

Eljárás

  1. A sablontartalom-szerkesztőben kattintson duplán a szöveg elemre. Megnyílik a Tartalom beállítása az aktuális elemhez ablak.
  2. Adja meg a tartalmat a következő lehetőségek valamelyikével:
    • Egyszerű érték használatához kattintson az Egyszerű érték lapra, és írjon be egy értéket.
    • Adatkifejezés használatához kattintson az Adatkifejezés lapra, és tegye a következők egyikét:
      • Bontsa ki a Változók elemet, és válassza ki a használni kívánt változót.
      • Bontsa ki az Attribútumok elemet, és válassza ki a használni kívánt adatattribútumot.
    • Parancsfájl-kifejezés használatához kattintson a Parancsfájl-kifejezés lapra.
      • Bontsa ki a Változók elemet, válasszon ki egy változót, és írja be a JavaScript kódot, amely az aktuális kontextusban elérhető változókat használhatja.
      • Bontsa ki az Attribútumok elemet, válasszon ki egy attribútumot, és írja be a JavaScript kódot, amely az aktuális kontextusban elérhető attribútumokat használhatja.
      • Ha XHTML-ből másolta át a parancsfájlt, akkor jelölje be az XHTML bemenet jelölőnégyzetet, hogy a parancsfájlban található XHTML címkék szerkeszthetőek legyenek.
      • Ha XHTML kimenetbe állítja elő a sablont, akkor 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.
      Ha például abszolút szám, név és érték formájában akarja kiválasztani az attribútumokat, akkor a következőképp adja meg a JavaScript kódot:
      "object:"+Absolute Number+
      "attribute"+name+
      "value"+_value
      Tipp: Ha meglehetősen összetett a sablon, akkor minden egyes blokkot leírhat Név és Leírás tulajdonság használatával. A név és leírás mező alapértelmezésben üres, a név tartalma látható lesz a sablonban, a leírás tartalma pedig megjeleníthető a sablonelem tipp mezőjében. Ez segíthet abban, hogy mások újrafelhasználhassák a sablont.

      Lehetőség van arra is, hogy meglévő parancsfájlt importáljon vagy a Parancsfájl-kifejezés lap helyett a JavaScript-szerkesztőt használja:

    1. 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.
      Tipp: A JavaScript függvényeket újrahasználhatja a sablon különböző részein a 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.

      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.
    1. 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.
    2. Kattintson a Parancsfájl tesztelése gombra a kód érvényesítéséhez.
    3. Az OK gombra kattintva mentse a módosításokat és lépjen ki az ablakból.
  3. A módosítások mentéséhez kattintson az OK gombra.

Példa

Adatkifejezés használati példa
Az automatikusan előállított sorszámok megjelenítéséhez a táblázatokban:
  1. Húzzon egy táblázatelemet a szerkesztőbe.
  2. Adja meg a táblázat sorainak (3) és oszlopainak (3) számát és kattintson az OK gombra.
  3. Húzzon egy szöveges elemet minden cellába.
  4. Jelölje ki az első spr első celláját.
  5. A Tulajdonságok nézetben válassza ki a Tartalom lapot és kattintson a Konfiguráció ikon ikonra. Az elemre duplán kattintva ugyanaz az ablak nyílik meg.
  6. Kattintson az Adatkifejezés lapra és válassza ki a _row_number elemet. Ezután kattintson az OK gombra.
  7. Ismételje ezt meg a második és harmadik sor első cellája esetében.
  8. Távolítsa el a szegélyeket a sorszám cellákból:
    1. Tartsa lenyomva a Ctrl billentyűt és válassza ki minden sor első celláját. Ha több elem van kijelölve, akkor mindegyik tulajdonságait egyszerre szerkesztheti.
    2. A tulajdonságok nézetben válassza ki a Keret lapot.
    3. A Stílus tulajdonságnál válassza a nincs értéket.
  9. Mentse a sablont.
  10. Tesztelje a sablont a kimenet előállításával. Az első cella tartalmazza a sorszámot és nincs kerete:
    Kimenet példa
  11. A sablonban, fejezze be a táblázat kitöltését a megfelelő attribútumok hozzáadásával a maradék cellákhoz az adatforrásból.