Sablonok tervezése Rational Quality Manager 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 REST mintasablon létrehozása témakört.
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ó.

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

  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.
    • Ha bizonyos adatrészeket (például teszteset részleteket vagy tesztparancsfájlt) kíván a Rational Quality Manager projektből hozzáadni vagy egyetlen, ismert URL című erőforrást kíván elérni, akkor hozzon létre feed argumentumot használó URL címet. Mindig használhatja ezt a sémát és dinamikusan konfigurálhatja azt bizonyos adatelemekhez a sablonban a Rational Quality Manager projektből.
      • Például: https://kiszolgáló:port/qm/service/com.ibm.rqm.integration.service.IIntegrationService/schema/feed.xsd
    • Ha bizonyos adatrészeket (például teszteset részleteket vagy tesztparancsfájlt) kíván a Rational Quality Manager projektből hozzáadni vagy egyetlen, ismert URL című erőforrást kíván elérni, akkor hozzon létre qm argumentumot használó URL címet:
      • Például: https://kiszolgáló:port/qm/service/com.ibm.rqm.integration.service.IIntegrationService/schema/qm.xsd
    • 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/repository/db/schema_repository/
  4. Adjon hozzá egy adatforrássémát a dokumentumsablonhoz. Rational Quality Manager esetén tegye a következőket:
    1. A Document Studio alkalmazásban kattintson az Adatok > Adatforrásséma felvétele menüpontra.
    2. A Séma típusa elemnél válassza ki a séma típusát a listából. Rational Quality Manager esetén válassza ki az Általános XML elemet.
    3. A Sémafájl mezőbe illessze be az adatforrássémaként azonosított URL címet.
    4. Fűzze hozzá a ?abbreviate=false utótagot az URL cím végéhez.
      • Például: https://kiszolgáló:port/qm/service/com.ibm.rqm.integration.service.IIntegrationService/resources/JKE Banking (Quality Management)/testcase?abbreviate=false
    5. Az Adatforrás azonosítója mezőbe írja be az adatforrásnak a sablonban szereplő nevét. Kattintson a Tovább gombra.
    6. Ha az erőforrás biztonságos kiszolgáló, akkor adja meg a Felhasználónevet.
    7. Ha az erőforrás biztonságos kiszolgáló, akkor adja meg a Jelszót.
    8. Válassza ki a Hitelesítéstípust a listából. Rational Quality Manager 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.
  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.
  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.
  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. További információkért lásd: Rational Quality Manager Reportable REST API.
  9. Rendezések létrehozásával rendszerezze a jelentésben szereplő adatokat.

Visszajelzés