Extrakce dat pomocí nativních filtrů

Se všemi podporovanými zdroji dat můžete použít nativní filtry. Nativní filtry, které jsou interpretovány adaptéry Reporting Data Services, umožňují zadat filtry ve formátu zdroje dat. Nativní filtr zpracovává adaptéry Reporting Data Services nikoli produkt Rational Publishing Engine, použití nativních filtrů proto zvyšuje výkon produktu Rational Publishing Engine.

Než začnete

Pokud provádíte integraci produktu Rational Publishing Engine s produktem, který nepodporuje zdroje dat typu Reportable REST, načte se celá datová sada a nelze ji filtrovat. Chcete-li ověřit, že váš produkt podporuje zdroje dat typu Reportable REST, můžete podmínku filtru před použitím v produktu Rational Publishing Engine otestovat v nativním zdroji dat.

Další informace o definování požadavků služeb typu Reportable REST v1 naleznete v dokumentu Vykazovatelný Rest v1.

Informace o této úloze

Nativní filtry jsou podporovány zdroji dat služeb typu Reportable REST, které umožňují filtrování, řazení a selektivní podporu vlastností. Nativní filtr si od zdroje dat vyžádá sadu dat a poté tato data filtruje a upřesňuje pro výstup ze šablony produktu Rational Publishing Engine. Pokud nechcete testovat přesnost filtrů, nemusíte je vytvářet v produktu, ze kterého data pocházejí, ale můžete vytvořit filtry výhradně pro použití v šablonách produktu Rational Publishing Engine z produktu Rational Publishing Engine.

V předchozích verzích produktu Rational Publishing Engine bylo možné definovat pouze statické filtry. Filtry bylo nutné znát při návrhu šablony, a nebylo je možné změnit za běhu.

Postup

  1. V produktu Document Studio vyberte prvek šablony obsahující dotaz, který se má filtrovat.
  2. V pohledu Vlastnosti vyberte kartu Data.
  3. V poli Filtr klepněte na tři tečky.
  4. Na kartě Nativní filtr rozbalte položku Proměnné.
    Poznámka: Proměnné ve filtrech lze upravit před použitím prvního dotazu na daný zdroj dat.
  5. Vyberte proměnnou k filtrování.
  6. Zadáním syntaxe ${} definujte dotaz, který se má filtrovat. Můžete například filtrovat podle názvu produktu. Tuto šablonu může používat více produktových týmů, které mohou zadat název produktu ve specifikaci dokumentu za běhu.
    cq:Product{cq:Product"${název_produktu}"
    Poznámka:
    • Vlastní atributy nelze použít v nativních filtrech.
    • Pokud přejmenujete proměnnou, název se neaktualizuje ve výrazu skriptu nebo nativním filtru a bude vytvořen chybný odkaz. Při přejmenovávání proměnné nezapomeňte upravit název také ve výrazu skriptu a nativních filtrech.
    • Chcete-li extrahovat data produktu Rational DOORS, použijte jako podmínku nativního filtru skript DXL. Chcete-li extrahovat data služby REST, použijte podmínku filtru XPath.
  7. Klepněte na tlačítko OK.

Zdroje dat, které podporují syntaxi typu Reportable REST v1

V nativních filtrech typu Reportable REST v1 je třeba pouze zadat text do hranatých závorek []. Zbytek filtru vygeneruje produkt Rational Publishing Engine.

Design Management

Produkt Design Management podporuje nativní filtrování ze zdrojů dat typu Reportable REST v1. Další informace viz téma Vykazovatelný Rest v1.

IBM Rational ClearCase

Adaptér produktu Rational ClearCase podporuje nativní filtrování ze zdrojů dat typu Reportable Rest v1. Další informace viz téma Vykazovatelný Rest v1.

IBM Rational ClearQuest

Adaptér produktu Rational ClearQuest podporuje nativní filtrování ze zdrojů dat typu Reportable Rest v1. Další informace viz téma Vykazovatelný Rest v1.

IBM Rational DOORS Next Generation

Produkt Rational DOORS Next Generation podporuje nativní filtrování ze zdrojů dat typu Reportable REST v1. Další informace viz téma Zdroje dat produktu Rational Requirements Composer. Tyto informace platí pro zdroje dat Rational DOORS Next Generation a Rational Requirements Composer.

IBM Rational Quality Manager

Produkt Rational Quality Manager podporuje nativní filtrování ze zdrojů dat typu Reportable REST v1. Další informace viz Rational Quality Manager Přiznatelné rozhraní API REST .

IBM Rational RequisitePro

Následující příklad nativního filtru typu Reportable REST v1 extrahuje schéma produktu Rational RequisitePro PRRequirements pomocí výrazu Stability='High'.

Příklad

Výraz filtru přidejte do uzlu pod Appliances, aby se vybrala pouze zařízení vyrobená specifickým výrobcem.
fields=Project/Requirements/PRRequirement[Stability = 'High']/(Stability|FullTag|Priority|Status)

IBM Rational Rhapsody

Produkt Rational Rhapsody podporuje použití zdrojů dat typu Reportable REST v1 v nativních filtrech. Další informace viz téma Vykazovatelný Rest v1.

IBM Rational Team Concert

Produkt Rational Team Concert podporuje použití zdrojů dat typu Reportable REST v1 v nativních filtrech. Další informace viz téma Vykazovatelné rozhraní API REST na Jazz.net.

Příklad

[projectArea/name="JKESample"]/*
Vyřešený požadavek:
https://server:port/ccm/rpt/repository/workitem?fields=workitem/workItem[projectArea/name="JKESample"]/(@href|summary)

Aplikace Requirements Management

Aplikace Requirements Management podporuje nativní filtrování ze zdrojů dat typu Reportable Rest v1. Funkce poskytované aplikací Requirements Management (RM) jsou licencovány jako produkt IBM® Rational DOORS Next Generation. Informace o integraci aplikace RM platí pro produkty Rational DOORS Next Generation a pro specifické verze produktu IBM Rational Requirements Composer. Další informace viz Rational Requirements Composer: Zdroje dat.

Zdroje dat, které podporují syntaxi typu Reportable REST v2

Informace o této úloze

Poznámka:
  • Požadavky na zdroj dat jsou vznášeny pouze podle potřeby. Pomocí podmínek například můžete zobrazit prvek ve výstupu pouze, pokud obsahuje data. Podmínka na kontejnerovém prvku může vypadat takto: proměnná == "true". Není-li tato podmínka splněna a podmínku proměnné nesplňují žádná data, na zdroj dat nejsou vzneseny žádné požadavky.
  • Před provedením požadavku můžete vypočítat nativní filtry. Nativní filtr se počítá v okamžiku, kdy je rozpoznán dotaz a používá hodnoty proměnných v tomto okamžiku. To znamená, že výpočty můžete provádět v šabloně, což má dopad na nativní filtry.

IBM Rational ClearQuest

Produkt Rational ClearQuest verze 8 podporuje nativní filtrování ze zdrojů dat typu Reportable REST v2. Chcete-li získat další informace, viz Rational ClearQuest OSLC CM REST API .

Příklad

Ukázka filtru s proměnnou:
cq:Product{cq:Product="${název_produktu}") 
Ukázka vyřešeného filtru, kde název_produktu je Rational Publishing Engine:
cq:Product{cq:Product="Rational Publishing Engine")

Zdroje dat, které podporují syntaxi chráněných rozhraní API

IBM Rational DOORS

Produkt Rational DOORS podporuje chráněné rozhraní API a filtr se vyjadřuje pomocí syntaxe pohledu produktu Rational DOORS.

Příklad

Následující ukázka nativního filtru produktu Rational DOORS filtruje objekty, které v atributu Text objektu obsahují slovo "Dokumentace".
Attribute 'Text objektu' contains 'Dokumentace' (case sensitive)
Vygenerování textu nativního filtru pro zdroj dat produktu Rational DOORS:
  1. Otevřete modul produktu Rational DOORS, poté klepněte na volbu Nástroje > Filtr > Definovat položku nabídky.
  2. Vytvořte syntaxi filtru:
    1. Vyberte kartu Atributy.
    2. Jako atribut vyberte Text objektu.
    3. Jako podmínku vyberte Obsahuje.
    4. Jako hodnotu zadejte specifickou hodnotu k filtrování. Chcete-li například filtrovat pouze objekty, které v atributu Text objektu obsahují slovo Dokumentace, zadejte: Dokumentace.
    5. Klepněte na tlačítko Přidat. V sekci rozšířených voleb se vytvoří syntaxe pravidla.
  3. Klepněte na volbu Popis a zkopírujte úplný popis. Nyní máte filtr produktu Rational DOORS, což je skript DXL.
Přidání filtru produktu Rational DOORS do prvku šablony produktu Rational Publishing Engine:
  1. Vyberte prvek šablony obsahující dotaz, který se má filtrovat.
  2. Na kartě Vlastnosti rozbalte položku Data.
  3. V poli Filtr klepněte na tři tečky. Otevře se okno Editor filtrů.
  4. Na kartě Nativní filtr vložte filtr produktu Rational DOORS (skript DXL) a klepněte na tlačítko OK.

IBM Rational Tau

Produkt Rational Tau podporuje chráněné rozhraní API a filtr se vyjadřuje jako dotaz OCL.

Příklad

Následující ukázka nativního filtru produktu Rational Tau filtruje balíky, které obsahují předdefinované názvy:
  • model.predefinedPackage představuje prvek aktuálního schématu.
  • GetEntities(“predefinedPackage””).select(IsKindOf(“Package”) představuje základní dotaz produktu Rational Tau.
  • select(HasPropertyWithValue("Name", "Predefined")) představuje podmínku nativního filtru.
Dotaz provedený hodnotícím mechanizmem dotazů produktu Rational Tau:
GetEntities(“predefinedPackage”). select(IsKindOf(“Package”))
select(HasPropertyWithValue("Name", "Predefined"))

Zpětná vazba