Adatok kinyerése natív szűrők használatával

Minden támogatott adatforrás esetén használhat natív szűrőket. A natív szűrők, amelyeket a Jelentéskészítési adatszolgáltatás illesztők értelmeznek, lehetővé teszik szűrők megadását az adatforrás-formátumban. A natív szűrőt a Rational Publishing Engine helyett a Jelentéskészítési adatszolgáltatás illesztők dolgozzák fel, így a natív szűrők használata javítja a Rational Publishing Engine teljesítményét.

Mielőtt elkezdené

Ha olyan termékkel integrálja a Rational Publishing Engine terméket, ami nem támogatja a Jelenthető REST adatforrásokat, akkor a teljes adathalmaz lehívásra kerül és nincs lehetőség szűrésre. Annak ellenőrzéséhez, hogy a termék támogatja a Jelenthető REST adatforrásokat, tesztelheti a szűrőfeltételt a natív adatforrásban, mielőtt használná azt a Rational Publishing Engine alkalmazásban.

A Jelenthető REST v1 szolgáltatás követelményeivel kapcsolatos információkért tekintse át az alábbi dokumentumot: Jelenthető Rest v1.

Erről a feladatról

A Jelenthető REST adatforrások támogatják a natív szűrőket, lehetővé téve a tulajdonságok szűrését, rendezését és szelektív támogatását. A natív szűrő lekér egy adathalmazt az adatforrásból, majd szűri és finomítja az adatokat a Rational Publishing Engine sablon kimenetének. Nem muszáj abban a termékben létrehoznia szűrőket, amelyből az adatok származnak, kivéve, ha tesztelni akarja a szűrők pontosságát. Lehetősége van szűrők létrehozására a Rational Publishing Engine sablonokban való kizárólagos használatra a Rational Publishing Engine termékből.

A korábbi Rational Publishing Engine kiadásokban csak statikus szűrőket lehetett meghatározni. A sablon tervezésekor ismernie kellett a szűrőket, és nem volt lehetősége módosítani azokat a futás során.

Eljárás

  1. A Document Studio alkalmazásban jelölje ki a szűrni kívánt lekérdezést tartalmazó sablonelemet.
  2. A Tulajdonságok nézetben kattintson az Adatok lapra.
  3. A Szűrő mezőben kattintson a kihagyás elemre.
  4. A Natív szűrő lapon bontsa ki a Változók részt.
    Megjegyzés: A szűrőkben használt változókat addig módosíthatja, amíg nem használta az első lekérdezést az adott adatforráson.
  5. Válasszon ki egy változót, amelyre szűrni akar.
  6. A ${} szintaxissal határozza meg a szűrni kívánt lekérdezést. Például szűrhet terméknév alapján. Több termék munkacsoportja használhatja ezt a sablont és megadhat terméknevet a dokumentummeghatározásban a futás során.
    cq:Product{cq:Product"${terméknév}"
    Megjegyzés:
    • A natív szűrőkben nem használhatja az egyéni attribútumokat.
    • Ha átnevez egy változót, akkor a név nem frissül a parancsfájl-kifejezésben vagy natív szűrőben és hivatkozási hiba áll elő. Változó átnevezésekor mindenképpen nézze át a parancsfájl-kifejezésekben és natív szűrőkben szereplő nevet is.
    • Rational DOORS adatok kinyeréséhez használja a DXL parancsfájlt natív szűrőfeltételként. REST adatok kinyeréséhez használja az XPath szűrőfeltételt.
  7. Kattintson az OK gombra.

Jelenthető Rest v1 szintaxist használó adatforrások

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.

Design Management

A Design Management támogatja a natív szűrést a Jelenthető Rest v1 adatforrásokból. További információkért lásd: Jelenthető Rest v1.

IBM Rational ClearCase

A Rational ClearCase adapter támogatja a natív szűrést a Jelenthető Rest v1 adatforrásokból. További információkért lásd: Jelenthető Rest v1.

IBM Rational ClearQuest

A Rational ClearQuest adapter támogatja a natív szűrést a Jelenthető Rest v1 adatforrásokból. További információkért lásd: Jelenthető Rest v1.

IBM Rational DOORS Next Generation

A Rational DOORS Next Generation támogatja a natív szűrést a Jelenthető Rest v1 adatforrásokból. További információkért lásd: Rational Requirements Composer adatforrások. Ezek az információk a Rational DOORS Next Generation és a Rational Requirements Composer adatforrásokra egyaránt vonatkoznak.

IBM Rational Quality Manager

A Rational Quality Manager támogatja a natív szűrést a Jelenthető Rest v1 adatforrásokból. További információkért lásd: Rational Quality Manager Reportable REST API.

IBM Rational RequisitePro

Az alábbi Jelenthető Rest v1 natív szűrő példa kinyeri az Rational RequisitePro PRRequirements sémát a Stability='High' használatával.

Példa

Vegyen fel szűrőkifejezést az Eszközök alatti csomópontba, hogy csak egy adott gyártótól származó eszközök kerüljenek kiválasztásra.
fields=Project/Requirements/PRRequirement[Stability = 'High']/(Stability|FullTag|Priority|Status)

IBM Rational Rhapsody

A Rational Rhapsody támogatja a Jelenthető Rest v1 adatforrások használatát a natív szűrőkben. További információkért lásd: Jelenthető Rest v1.

IBM Rational Team Concert

A Rational Team Concert támogatja a Jelenthető Rest v1 adatforrások használatát a natív szűrőkben. További információkért lásd: Jelenthető REST API a Jazz.net oldalon.

Példa

[projectArea/name="JKESample"]/*
Feloldott kérés:
https://server:port/ccm/rpt/repository/workitem?fields=workitem/workItem[projectArea/name="JKESample"]/(@href|summary)

Követelménykezelési alkalmazás

A Követelménykezelési alkalmazás támogatja a natív szűrést a Jelenthető Rest v1 adatforrásokból. 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. További információkért lásd: Rational Requirements Composer adatforrások.

Jelenthető Rest v2 szintaxist használó adatforrások

Erről a feladatról

Megjegyzés:
  • A rendszer csak akkor intéz kéréseket az adatforrásokhoz, ha szükséges. Például tegyük fel, hogy feltételekkel beállította, hogy egy elem csak akkor jelenjen meg a kimenetben, ha tartalmaz adatokat. A tároló elemhez tartozó feltétel lehet a következő: változó == "true". Ha nem teljesül a feltétel és nincs a változófeltételnek megfelelő adat, akkor a rendszer nem intéz kéréseket az adatforráshoz.
  • A kérés előtt lehetősége van natív szűrők kiszámítására. A natív szűrők kiszámítására a lekérdezéskor kerül sor, az akkori változóértékek felhasználásával. Így lehetősége van számításokat végezni a sablonban, ami hatással van a natív szűrőkre.

IBM Rational ClearQuest

A Rational ClearQuest 8-as változata támogatja a natív szűrést a Jelenthető Rest v2 adatforrásokból. További információkért lásd: Rational ClearQuest OSLC CM REST API .

Példa

Minta változószűrő:
cq:Product{cq:Product="${productName}") 
Minta feloldott szűrő, ahol a productName: Rational Publishing Engine:
cq:Product{cq:Product="Rational Publishing Engine")

Zárt API szintaxist használó adatforrások

IBM Rational DOORS

A Rational DOORS támogat egy zárt alkalmazás programozási felületet, és a szűrő a Rational DOORS Nézet szintaxisával van kifejezve.

Példa

Az alábbi Rational DOORS natív szűrő példa kiszűri azokat az objektumokat, amelyek Objektumszöveg attribútumában szerepel a "Documentation" szó.
Attribute 'Object Text' contains 'Documentation' (case sensitive)
Natív szűrő szöveg előállítása Rational DOORS adatforráshoz:
  1. Nyisson meg egy Rational DOORS modult, majd kattintson az Eszközök > Szűrő > Menüpont meghatározása menüpontra.
  2. Szűrő szintaxis létrehozása:
    1. Válassza az Attribútumok lapot.
    2. Az Attribútum mezőben válassza az Objektumszöveg lehetőséget.
    3. A Feltétel mezőben válassza a Contains lehetőséget.
    4. Az Érték mezőbe írjon be egy értéket, amelyre szűrni akar. Ha például ki akarja szűrni azokat az objektumokat, amelyeknél szerepel a Documentationszó az Objektumszöveg attribútumban, akkor írja be a következőt: Documentation
    5. Kattintson a Hozzáadás gombra. A Speciális beállítások szakaszban létrehozásra kerül a szabályszintaxis.
  3. Kattintson a Leírás elemre, és másolja be a teljes leírást. Most már megvan a Rational DOORS szűrő, ami egy DXL parancsfájl.
A Rational DOORS szűrő felvétele a Rational Publishing Engine sablonelembe:
  1. Jelölje ki a szűrni kívánt lekérdezést tartalmazó sablonelemet.
  2. A Tulajdonságok lapon bontsa ki az Adatok részt.
  3. A Szűrő mezőben kattintson a kihagyás elemre. Megnyílik a Szűrőszerkesztő ablak.
  4. A Natív szűrő lapon illessze be a Rational DOORS szűrőt (DXL parancsfájlt), és kattintson az OK gombra.

IBM Rational Tau

A Rational Tau támogat egy zárt alkalmazás programozási felületet és a szűrő OCL alkalmazás programozási felületként van kifejezve.

Példa

Az alábbi Rational Tau natív szűrő példa kiszűri azokat a csomagokat, amelyek tartalmazzák az előre meghatározott neveket:
  • A model.predefinedPackage az aktuális sémaelemet ábrázolja.
  • A GetEntities(“predefinedPackage”).select(IsKindOf(“Package”) az alapul szolgáló Rational Tau lekérdezést ábrázolja.
  • A select(HasPropertyWithValue("Name", "Predefined")) a natív szűrő feltételét ábrázolja.
A Rational Tau lekérdezés-kiértékelő által végrehajtott lekérdezés:
GetEntities(“predefinedPackage”). select(IsKindOf(“Package”))
select(HasPropertyWithValue("Name", "Predefined"))

Visszajelzés