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
REST
mintasablon létrehozása témakört.
Ismerje meg a
Design
Management
REST szolgáltatást és a különféle URL címeket, amelyek szükségesek az
adatok kinyeréséhez a
Design
Management
termékből a
Rational Publishing Engine
használatakor.
A használt
Design
Management
változatnak megfelelő információs központ megkereséséhez segítséget a következő helyen
talál:
Rational
Software Architect termékcsalád információs központjai.
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.
- Adjon hozzá adatforrássémát a dokumentumsablonhoz POX profil használatával (CLM 6.0.2 és későbbi változatoktól): A POX profilról további információkat talál itt: Követhetőségi dokumentum létrehozása CLM alkalmazásból POX profil használatával
- A
Design
Management
programban másolja le a műtermék URL címét a navigációs útvonalon az Állandó hivatkozás
(Permalink) ikonra kattintva.
- A Document Studio alkalmazásban kattintson az
menüpontra.
- Az Előre meghatározott mezőben válassza ki a DS1 adatforrást.
- A Típus mezőben válassza ki a REST elemet.
- Illessze be az URL-címet a Séma mezőbe, és fűzze
hozzá a &metadata=schema utótagot az URL-cím végéhez.
- A További fejlécek mezőben válassza ki a POX profil fejlécet.
- Kattintson a Tovább gombra, majd a Befejezés gombra. A kiválasztott adatforrásséma megjelenik az Adatforrás nézetben.
- Adjon hozzá adatforrássémát a dokumentumsablonhoz REST Sémafeltérképezés használatával (CLM 6.0.1 és korábbi változatok): A
Design
Management
esetében az adatforrássémát az alkalmazás alap URL címét beírva térképezheti
fel.
- A Document Studio alkalmazásban kattintson az
menüpontra.
- Adja meg az adatforrás Nevét.
- Adja meg az adatforrás Leírását.
- Adja meg az erőforrás Alap URL címét. A
Design
Management
alap URL címe a következő:
https://kiszolgáló:port/dm/reporting
- Válassza ki a Hitelesítéstípust
a listából.
Fontos: Design
Management
esetén meg kell adnia a jelentés adatainak eléréshez hasznát hitelesítési
típust. A hitelesítési típust a
Rational Publishing Engine
nem képes automatikusan felismerni.
- 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.
- Kattintson a
Tovább gombra. A beírt alap URL címhez a rendszer automatikusan hozzáfűzi a
?metadata=schema utótagot. Például:
https://server:port/dm/reporting?metadata=schema
- Kattintson a Befejezés gombra. A kiválasztott adatforrásséma megjelenik az Adatforrás nézetben.
- 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.
- 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. A
Design
Management
támogatja a natív szűrést a Jelenthető Rest v1
adatforrásokból. A Jelenthető Rest v1 natív szűrőkben csak a
szögletes zárójelek [] közötti szöveget kell megadnia. A
Rational Publishing Engine
előállítja a szűrő többi részét. További
információkért lásd:
Jelenthető Rest v1.
- Rendezések
létrehozásával rendszerezze a jelentésben szereplő adatokat.