Lehetősége van
Rational
Quality Manager
meghatározására adatforrásként a
Rational Publishing Engine
alkalmazásban.
Az adatok kinyerése a
Rational
Quality Manager
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.
Tipp: A
Rational Publishing Engine terméket
minta jelentések készletével együtt szállítjuk. Mielőtt megkezdené a
dokumentumok közzétételét, tekintse át ezt a példa dokumentumelőállítási
példahelyzetet. Lásd:
REST minta sablon létrehozása.
Mielőtt elkezdi
- Ismerje meg a
Rational
Quality Manager
REST szolgáltatást és a különféle URL címeket, amelyek szükségesek az
adatok kinyeréséhez a
Rational
Quality Manager
termékből a
Rational Publishing Engine
használatakor.
Lásd:
Rational
Quality Manager
REST API dokumentáció.
- Csatlakozzon egy adatforrássémához. Lásd:
Adatforrásséma felvétele.
- A séma a helyi fájlrendszeren lehet. Például a
https://kiszolgáló:port/jazz/service/com.ibm.rqm.integration.service.IntegrationService/schema/feed.xsd
olyan sémafájl, amely a feed argumentumot használja. Ezzel a sémával bizonyos adatdarabokat, például teszteset részleteket vagy
teszt parancsfájlokat vehet fel a
Rational
Quality Manager
projektből, vagy elérhet egy ismert URL címmel rendelkező egyedülálló
erőforrást.
- Ha a dokumentum előállításához a REST v2
alkalmazásprogramozási felületeket használja, akkor a szolgáltató
adatforrásséma URL címét kell megadnia, nem a gyökérbejegyzését. Például:
- Helytelen: https://kiszolgáló:port/qm/oslc_qm/catalog
- Helyes:
https://kiszolgáló:port/qm/oslc_qm/catalog/lerakat/db/séma_lerakat/
Az adatforrásséma elemeinek
felhasználásával lehetősége van lekérdezések felvételére a sablonba. Ezek a lekérdezések
határozzák meg, hogy milyen információk kerülnek be a jelentésbe.Annak biztosításához, hogy a visszaadott értékek teljes listáját
megkapja egy
Rational
Quality Manager
hírfolyam adatforrásból, állítsa a sématípust Általános XML-re és vegye
fel az ?abbreviate=false karaktersorozatot az URI
végére. Például: https://rqmserver:9443/qm/service/com.ibm.rqm.integration.service.IIntegrationService/resources/JKE
Banking (Quality Management)/testcase?abbreviate=false
- Miután csatlakozott az adatforrássémához, létrehozhat vagy importálhat
egy sablontervet. A
Rational Publishing Engine
Document Studio alkalmazásban összeállíthat egy jelentéssablon-tervet. Ez a terv határozza meg a
jelentés elrendezését. Lásd:
Sablonok készítése a Document Studio alkalmazással.
- Tervezze meg a dokumentum szerkezetét, és határozza meg a tartalmat az
adatok kinyeréséhez. A sablonfejlesztési folyamat áttekintéséről itt olvashat:
Dokumentumsablonok tervezése. Nagy dokumentumok esetén önálló sablonokat hozhat létre az egyes
dokumentumblokkokhoz.
- 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.
További részletek itt találhatók:
Sablonelemek a Paletta nézetben.
- Lekérdezések,
attribútumok
és
változók
használatával vehet fel adatokat a sablonba.
- Az Adatforrás-konfiguráció elemmel határozhat meg olyan
tulajdonságokat, amelyek nem ismeretesek a futás során. Lásd:
Adatforrás-konfiguráció elem hozzáadása. Például egy qm adatséma dinamikusan van beállítva a
feed adatséma alapján. Mindig használhatja ezt a sémát és
dinamikusan konfigurálhatja azt bizonyos adatelemekhez a sablonban a
Rational
Quality Manager
projektből.
- Használhat az általános adatforrás URI azonosítóknál specifikusabb
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 a
Rational
Quality Manager
lerakatbó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 az előállított jelentés hiányos adatokat tartalmaz. Nézze meg az alábbi részt:
Adatok kinyerése Rational Publishing Engine szűrővel.
- Miután létrehozta a jelentéssablont és feltöltötte
Rational
Quality Manager
adatpontokkal, különféle formátumú jelentéseket állíthat elő. Egy jelentés
előállításakor csatlakoznia kell az adatforráshoz, amely a jelentés
futtatásának alapjául szolgáló adatokat tartalmazza. Ezt úgy teheti meg,
hogy megad egy URI azonosítót, amely a releváns adatokat tartalmazó
Rational
Quality Manager
lerakatra mutat. Ahhoz, hogy a releváns adatokra mutasson, olvassa el az
alábbi részt:
Csatlakozás adatforráshoz.
Megjegyzés: Az
IBM
Rational Quality Manager
OSLC API esetén alapértelmezésben ha nincs megadva elfogadási fejléc a
dokumentummeghatározásban, akkor a
Rational
Quality Manager
az erőforrások HTML ábrázolását adja vissza. Az XML adatok lekéréséhez az
application/xml elfogadási fejlécet kell
beállítania.
- Ha az után vesz fel adatforrássémákat a sablonba, hogy a
sablont már hozzárendelte egy dokumentummeghatározáshoz, akkor a
dokumentummeghatározás nem lesz szinkronban a sablonnal. Lehetősége van a
dokumentummeghatározás
kézi szinkronizálására vagy egy beállítás megadására, mely
automatikusan szinkronizálja a dokumentummeghatározást az aktuális
sablonnal. A Szinkronban tartja a dokumentummeghatározást az
aktuális sablonnal? beállítás megadásával kapcsolatos
információkat itt talál:
Dokumentumterv beállításainak megadása.
- Mielőtt közzétenné a dokumentumot, az alábbi helyen tájékozódjon
arról, hogy milyen kimeneti beállítások érhetők el és melyiket
legcélszerűbb használni az adott sablonba található elemekhez:
Kimenet tulajdonságainak megadása.
- Most már készen áll a dokumentum közzétételére. Lásd: Dokumentum előállítása.