Sablonok tervezése Design Management 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 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

  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. 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
    1. 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.
    2. A Document Studio alkalmazásban kattintson az Adatok > Adatforrásséma felvétele menüpontra.
    3. Az Előre meghatározott mezőben válassza ki a DS1 adatforrást.
    4. A Típus mezőben válassza ki a REST elemet.
    5. 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.
    6. A További fejlécek mezőben válassza ki a POX profil fejlécet.
    7. Kattintson a Tovább gombra, majd a Befejezés gombra. A kiválasztott adatforrásséma megjelenik az Adatforrás nézetben.
  4. 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.
    1. A Document Studio alkalmazásban kattintson az Adatok > Sémafeltérképezés > REST sémafeltérképezés menüpontra.
    2. Adja meg az adatforrás Nevét.
    3. Adja meg az adatforrás Leírását.
    4. 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
    5. 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.
    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. 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
    9. Kattintson a Befejezés gombra. A kiválasztott adatforrásséma megjelenik az Adatforrás nézetben.
  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. 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.
  9. Rendezések létrehozásával rendszerezze a jelentésben szereplő adatokat.