Sablonok tervezése Rational DOORS adatforrással

A jelentéstervezők a Document Studio alkalmazással importálhatnak adatforrássémákat és összeállíthatnak jelentéssablonokat.

Mielőtt elkezdené

Tipp: A Rational Publishing Engine telepítés minta jelentések készletét tartalmazza. Mielőtt megkezdené a dokumentumok közzétételét, tekintse át ezt a példa dokumentumelőállítási példahelyzetet. Tekintse meg a Rational DOORS mintasablon létrehozása témakört.
Vizsgálja meg a használni kívánt Rational DOORS modult és annak tartalmát. Az adott Rational DOORS változathoz tartozó információs központ megkereséséhez lásd: Rational DOORS információs központ bemutatása.

Lehetősége van modultulajdonságok, objektumattribútumok és a modulokban tárolt nézetek kombinációjának használatára. Tekintse át, hogy milyen nézetek érhetők el a kiszámított oszlopok moduljában, beleértve a követhetőségi nézeteket és esetleg az Elrendezés DXL oszlopokat is. Ezek a nézetek nem felelnek a Rational DOORS attribútumoknak, de esetleg bele akarhatja foglalni őket a jelentésbe.

Eljárás

  1. A sablonfejlesztési folyamat áttekintéséről itt olvashat: Dokumentumsablonok tervezése. Kezdje meg a dokumentum és az esetleg tartalmazott adatok szerkezetének megtervezését. Döntse el például, hogy a végleges dokumentum egyetlen sablonból kerül előállításra vagy több olyan sablonfájlból, amelyek mindegyike újrafelhasználható tartalomrészeket tartalmaz.
  2. A Document Studio alkalmazásban hozzon létre egy dokumentumsablont.
  3. Azonosítson be egy adatforrássémát az adatforrásból. Adatforrás hozzáadására két módszer létezik: a DOORS sémafeltérképezés varázsló vagy az Adatforrás séma varázsló használata. Adatforrás hozzáadása az Adatforrás séma varázslóval:
    1. A Document Studio alkalmazásban kattintson az Adatok > Adatforrásséma felvétele menüpontra.
    2. Az Előre meghatározott mezőben válassza ki a Doors adatbázissémát.
    3. A Típus részben válassza ki a séma típusát a listából. Rational DOORS esetén válassza a DOORS lehetőséget.
    4. Szükség szerint szerkessze a Séma mezőt, vagy a Tallózás gombra kattintva válassza ki a sémafájl elérési útját.
    5. Ha az erőforrás biztonságos kiszolgáló, akkor adja meg a Felhasználónevet.
    6. Ha az erőforrás biztonságos kiszolgáló, akkor adja meg a Jelszót.
    7. Válassza ki a Hitelesítéstípust a listából. Rational DOORS esetén a hitelesítési típus: OAuth-OSLC. Ha nem választja ki az OAuth-OSLC típust, akkor minden egyes hitelesítési típus tesztelésre kerül, amíg a rendszer meg nem találja a helyes típust, ami megnövelheti a dokumentumok előállítási idejét.

    Adatforrás hozzáadása a DOORS sémafeltérképezés varázslóval:

    1. A Document Studio alkalmazásban kattintson az Adatok > Sémafeltérképezés > DOORS sémafeltérképezés menüpontra.
    2. Adja meg a kapcsolat részleteit:
      • A Rational DOORS futó példányának használatához válassza ki a Futó DOORS példány használata lehetőséget.
      • A Rational DOORS háttérben futtatásához válassza az Új háttér DOORS folyamat futtatása lehetőséget. Adja meg a felhasználónevet, a jelszót, az adatbázist és a doors.exe elérési útját.
    3. Válasszon ki egy nézetet:
      • Adatbázis nézet
      • Projekt nézet
    4. Kattintson a Tovább gombra.
    5. Válassza ki az attribútumtípust:
      • Ha a fő objektumokhoz, a Modul/Objektum sémaelemekhez akar felvenni attribútumokat, akkor válassza a Modul- és objektumattribútumok lehetőséget.
      • Ha hivatkozott objektumokhoz, a Modul/Objektum/Hivatkozás/Hivatkozott sémaelemhez akar attribútumokat felvenni, akkor válassza a Hivatkozott objektumok attribútumai lehetőséget.
    6. A DOORS modul kiválasztása ablakban válasszon ki egy modult a Rational DOORS adatbázisszerkezetből, és kattintson a Tovább gombra.
    7. A DOORS alapsor ablakban válasszon ki egy alapsort a modulhoz. A kiválasztott alapsor határozza meg a használt attribútumkészletet.
    8. A DOORS attribútumok ablakban az alábbi attribútuminformációk jelennek meg:
      • Attribútum neve: Felsorolja a kiválasztott alapsorban elérhető attribútumokat.
      • Hatókör: Megjeleníti az attribútum hatókörét modulként vagy objektumként.
      • Kiemelés neve: Az attribútum kiemelt neve a parancsfájl-kifejezésekben használt név. A rendszer a Rational DOORS attribútumnévből állít elő érvényes nevet, megakadályozva ezzel az érvénytelen név beírását. A kiemelt attribútum lehetővé teszi az attribútumérték közvetlen elérését a Module/Object kontextusból. A nem kiemelt attribútumok értéke csak a Module/Object/Attribute kontextusból érhető el.

      Jelölje be a jelölőnégyzetet egy attribútum megadásához, illetve kattintson az Összes kijelölése lehetőségre, ha az összes attribútumot ki akarja jelölni. A Kijelölések megszüntetése törli az összes attribútumot. Kattintson a Tovább gombra.

    9. A DOORS nézetek és oszlopok ablakban jelölje ki a nézetet. Majd jelöljön be egy oszlopnévhez tartozó jelölőnégyzetet az adott oszlop kijelöléséhez, illetve az Összes kijelölése lehetőséget az összes oszlopnév kijelöléséhez. Kattintson a Tovább gombra.
      Megjegyzés: Az oszlophoz tartozó kiemelés neve szerepel a Kiemelés neve oszlopban. Tetszőleges számú nézetből kiemelhet oszlopokat. Később, a sablon tervezése során is kiemelheti az attribútumokat. Az attribútumok deklaratív információkat adnak az elemekhez a szokásos, előre meghatározott kulcsszavakon túl. A felhasználó által megadott Rational DOORS attribútumok csak az Attribútum csomópontokon keresztül érhetők el a szabványos Rational DOORS sémafájlban. Az attribútumok használatához lehetősége van az attribútumértékek kiemelésére XML attribútumokként az XML sémafeltérképezés varázsló használatával. Lehet, hogy az attribútumnak csak egyetlen előfordulása van, például ilyen a Modul name és a Last Modified On tulajdonság. Lehetnek olyan objektumra vonatkozó attribútumok, amelyeknek több előfordulása van, mint például az Object Heading és az Object Text.
    10. A Sémabeállítások kiválasztása adja meg a részleteket az alábbi mezőkben:
      • Séma helyének kiválasztása: Kattintson a Tallózás gombra és válassza ki, hogy hová akarja menteni az adatforrássémát.
      • Adatforrásséma azonosítója: Adja meg az adatforrásséma azonosítóját.
      • Jelölje be az Adatforrásséma hozzáadása az aktuális sablonhoz jelölőnégyzetet a séma hozzáadásához a megnyitott sablonhoz. Kattintson a Tovább gombra.
      • Mentse a sémákat, hogy újrafelhasználhassa őket más sablonokban a Sémafeltérképezés varázslóújbóli futtatása nélkül.
    11. Tekintse át az Összegzés ablakban látható információkat, és kattintson a Befejezés gombra.
  4. Kezelje az attribútumokat. Megteheti azt is, hogy feltérképezi a Rational DOORS modulban jelen lévő attribútumokat, majd kiértékeli, hogy azoknak meg kell-e jelenniük a Rational Publishing Engine jelentésben. A Szerkesztés > Attribútumok menüponttal férhet hozzá a modulban található attribútumok listájához.
  5. Vegyen fel elemeket a sablonba. A Rational Publishing Engine a sablonelemek átfogó készletével rendelkezik a dokumentum szerkezetének kialakításához. Az elemeket húzással viheti a sablontartalom-szerkesztőbe. Felvehet például egy Tároló elemet, amely több bekezdést tárol. Minden egyes bekezdést egy-egy tesztfeltétel vezérelhet, amely csak bizonyos adatokhoz társítja azt. További információkért lásd: Sablonelemek a Paletta nézetben és Elemek hozzáadása sablonhoz.
    Tároló elemek
    Az 1x1-es táblázatokban található Rational DOORS elemzői diagramok táblázata helyett tároló elemeket is használhat.
    Kép elemek
    A képeket egy Rational DOORS modulból nyeri ki a rendszer az attribútum értékeivel. Nem lehetséges csak a képek lekérdezése.
    A kinyert képek méretének beállításához adja meg a kép maximális szélessége és a kép maximális magassága tulajdonságot. Ezek a tulajdonságok két helyen adhatók meg:
    • Az elemformátum-információk határozzák meg az adott sablonelemben található képek méretét. Ez csak szöveg sablonelemeknél érhető el.
    • A dokumentummeghatározás metaadatok határozzák meg a képek méretét az összes sablonban. Az elemformátum értékek felülbírálják ezeket a globális értékeket.
    Táblázat elemek
    Lehet, hogy egy Rational DOORS táblázat nem reprodukálható a Rational Publishing Engine termékben pontosan ugyanúgy, ahogyan az a Rational DOORS termékben kinéz; az elérhető Rational DOORS táblázat attribútumok felhasználásával új táblázatot kell előállítani.
    A Rational DOORS séma varázslóval nyerheti ki a Rational DOORS táblázatokkal kapcsolatos információkat. Például: TableCellWidthA cella szélessége képpontban a képernyőn. Kétféle módon nyerhet ki oszlopinformációkat a Rational DOORS termékből:
    • A module/object/column használatával megszerezheti az oszlopneveket és -értékeket egy objektumlekérdezésben. Ez akkor hasznos, amikor objektum szerint vannak iterálva a Rational DOORS adatok.
    • A module/view/column használatával megszeretheti az oszlopneveket a dokumentumelőállításhoz használt Rational DOORS nézetből. A Nézet szerinti iterálás akkor hasznos, amikor az aktuális nézetben meghatározott oszlopokra és a hozzájuk tartozó tulajdonságokra van szükség. A Rational Publishing Engine minta sablonokkal tesztelheti ezeket a módszereket.
      Megjegyzés: Az oszlopadatok elérése a module/object/column/(@Column Text) használatával lehetséges a lekérdezésben.

    Ha Rational DOORS táblázatokban több sorra kiterjedő cellái vannak, akkor a Rational Publishing Engine az első cellát állítja elő és a többi cella a kiterjedésben eltávolításra kerül.

    A táblázatokkal kapcsolatos további információkért lásd: Táblázat elem hozzáadása.

  6. lekérdezések, attribútumok és változók használatával vehet fel adatokat a sablonokba. Ezek az elemek határozzák meg. milyen információk kerülnek a jelentésben előállításra. A IBM® Rational DOORS alkalmazásban a lekérdezések a gyökér elemmel (modul) kezdődnek, annak utód elemével (Objektum), majd az objektum utód attribútumával folytatódnak. Például: Modul/Objektum/Attribútum/Név. További információkért lásd: Rational DOORSséma.
  7. Az elemek megjelenését a kimenetben formázás és stílus hozzáadásával állíthatja be.
  8. Szűrők létrehozásával szűkítse le a jelentésbe bekerülő adatokat. Használhat az általános adatforrás URI azonosítóknál részletesebb szűrőket az adatok egy adott részhalmazának megjelöléséhez, hogy a jelentés előállítása során a Rational Publishing Engine ne kíséreljen meg a szükségesnél több információt lekérni az adatforrásból. Ezeknek a szűrőknek elég tágaknak kell lenniük ahhoz, hogy a sablon által hivatkozott valamennyi szükséges adat lekérhető legyen, máskülönben nem tud teljes adatokat befoglalni az előállított jelentésbe. Lehetősége van natív szűrők meghatározására a hivatkozáslekérdezésekre. További információkért lásd: Példa: Rational DOORS beépített szűrők.
  9. Rendezések létrehozásával rendszerezze a jelentésben szereplő adatokat. Rational DOORS esetén a beépített rendezési szövegnek a Rational DOORS rendezés formátumában kell lennie. További információkért lásd: Példa: Beépített rendezések a Rational DOORS termékben.

Mi a következő lépés?

Ha előzetesen megtekinti a Document Studio alkalmazás adatait, akkor az adatok lekérése az alapértelmezett alapsor és nézet használatával történik.

Visszajelzés