A jelentéstervezők a Document Studio
alkalmazással importálhatnak adatforrássémákat és összeállíthatnak
jelentéssablonokat.
A Követelménykezelési alkalmazás (RM) által nyújtott képességek
az IBM® Rational DOORS Next
Generation nevű licenc hatálya alá tartoznak.
Az RM alkalmazás integrációjával kapcsolatos információk a Rational DOORS Next Generation termékre és
az IBM Rational Requirements Composer bizonyos változataira vonatkoznak.
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
REST
mintasablon létrehozása témakört.
Ismerje meg az
RM alkalmazás REST szolgáltatását és a különféle URL címeket, amelyek szükségesek az
adatok kinyeréséhez az RM alkalmazásból a
Rational Publishing Engine
használatakor.
A használt RM alkalmazás változathoz tartozó információs központ megkereséséhez tekintse meg az alábbi
részt:
Rational Requirements Composer
információs központ bemutatása.
Erről a feladatról
Az adatok kinyerése a REST API használatával történik.
Ezt a
felületet az alkalmazás telepíti és valósítja meg, és a
Rational Publishing Engine
terméktől függetlenül működik.
Az adatforrások REST alkalmazásprogramozási felületével kapcsolatos további
információkért tekintse meg az adatforrás dokumentációját.
Eljárás
- 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.
- A Document Studio alkalmazásban
hozzon
létre egy dokumentumsablont.
- Azonosítson be egy adatforrássémát az adatforrásból. Ha az RM alkalmazás
projektből csak bizonyos adatrészeket kíván hozzáadni, akkor az URL címet a
következő formátumban adja meg:
- https://kiszolgáló:port/rm/publish/artifact
Például:
- https://kiszolgáló:port/rm/publish/resources
- Adjon hozzá egy adatforrássémát a dokumentumsablonhoz. Az RM alkalmazás esetén tegye a következőket:
- A Document Studio alkalmazásban kattintson az
menüpontra.
- A Típus részben
válassza ki a séma típusát a listából. Az RM alkalmazás esetén válassza ki az Általános XML elemet.
- A Sémafájl mezőbe illessze be az adatforrássémaként
azonosított URL címet.
- Fűzze hozzá a ?metadata=schema utótagot az URL cím
végéhez.
- Például:
https://kiszolgáló:port/rm/publish/artifact?metadata=schema
- Ha az erőforrás biztonságos kiszolgáló, akkor adja meg a
Felhasználónevet.
- Ha az erőforrás biztonságos kiszolgáló, akkor adja meg a
Jelszót.
- Válassza ki a Hitelesítéstípust
a listából. Az RM alkalmazás esetén a hitelesítési típus OAuth.
Ha nem választja ki
az OAuth 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.
- 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áblázat elemek
- Amikor a táblázat adatait az RM alkalmazásból írja be, a szélességeket oszlopszinten kell
megadni, mindegyik cellához, és nem a táblázat szintjén, hogy a
Rational Publishing Engine
fel tudja dolgozni.
- 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.
- Az elemek megjelenését a kimenetben
formázás
és stílus hozzáadásával állíthatja be.
- 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. További információkért lásd:
Rational Requirements Composer
adatforrások.
- Rendezések
létrehozásával rendszerezze a jelentésben szereplő adatokat.