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 modulem Adaptéry služby Reporting Data Services, umožňují zadat filtry ve formátu zdroje dat. Nativní filtr zpracovává modul Adaptéry služby 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 Rozhraní typu Reportable 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. Na kartě Vlastnosti rozbalte položku 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.

IBM® Rational ClearCase

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

IBM Rational ClearQuest

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

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 Rozhraní typu Reportable Rest v1.

IBM Rational Software Architect Extension for Design Management

Produkt Rational Software Architect Extension for Design Management podporuje nativní filtrování ze zdrojů dat typu Reportable REST v1. Další informace viz Rozhraní typu Reportable 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 Rozhraní API typu Reportable REST na Jazz.net.

Příklad

projectArea/name="Rational Publishing Engine"  and target/name="1.2.0.1"
Vyřešený požadavek:
fields=workitem/workItem[projectArea/name="Rational Publishing Engine" and target.name="1.2.0.1"]/(@href|summary)

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. U verze RPE 1.1.2.2 a starší byly nativní filtry REST v2 počítány na začátku generování dokumentů s použitím hodnot proměnných, jak byly definovány v tomto bodě. V produktu Rational Publishing Engine verze 1.2 a novější se nativní filtr počítá v okamžiku, kdy je rozpoznán dotaz, a používá hodnoty proměnných v tomto okamžiku. Tato změna 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.

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 proprietárních rozhraní API

IBM Rational DOORS

Produkt Rational DOORS podporuje proprietární rozhraní API, 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 proprietární rozhraní API, 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