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és 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 befoglalásakor kattintson a Parancsfájl befoglalása 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 Központi felügyelet összetevőből. Kattintson az OK gombra és zárja be az ablakot, majd kattintson duplán az elemre a Kód bevitele a JavaScript kód elemhez ablak újbóli megnyitásához.
    2. 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. Itt szerkesztheti a JavaScript kódot.
      Megjegyzés: Ha megkezdi a gépelést és értékként pont vagy egyéb karaktert ír be, akkor Hiba a JavaScript fájl elérésekor üzenet jelenhet meg. Ez egy Problémák a tartalomsegéd használatakor üzenet követheti. Ha megjelennek ezek az üzenetek, akkor az üzenetekben található utasításokat követve tiltsa le az Egyéb JavaScript ajánlások beállítást:
      1. Kattintson az Ablak > Beállítások > JavaScript > Szerkesztő > Tartalomsegéd > Speciális lehetőségre.
      2. A Tartalomsegéd ciklusok részen szüntesse meg az Egyéb JavaScript ajánlások beállítás kiválasztását.
      3. Az ablak bezárásához kattintson az OK gombra.
    3. A beállításokkal kezelje a parancsfájlt a Vázlat nézetben.
    4. Mentse a módosításokat.
    5. Zárja be az ideiglenes JavaScript szerkesztőlapot. Visszatér a JavaScript kódelem bemeneti kódja ablakba.
    6. Kattintson a Parancsfájl tesztelése gombra a kód érvényesítéséhez.
    7. 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.

Visszajelzés