Wyodrębnianie danych za pomocą filtrów rodzimych

Istnieje możliwość użycia filtrów rodzimych dla wszystkich obsługiwanych źródeł danych. Filtry rodzime, które są interpretowane przez adaptery usług danych raportowania, umożliwiają wprowadzanie filtrów w formacie źródła danych. Filtr rodzimy jest przetwarzany przez adaptery usług danych raportowania, a nie przez produkt Rational Publishing Engine, więc użycie filtrów rodzimych zwiększa wydajność produktu Rational Publishing Engine.

Zanim rozpoczniesz

W przypadku integrowania produktu Rational Publishing Engine z produktem, który nie obsługuje źródeł danych usługi REST możliwości raportowania, pobierany jest cały zestaw danych i nie można przeprowadzić filtrowania. Aby sprawdzić, czy produkt obsługuje źródła danych usług REST możliwości raportowania, można przetestować warunek filtru w rodzimym źródle danych przed jego użyciem w produkcie Rational Publishing Engine.

Więcej informacji o definiowaniu wymagań usług REST możliwości raportowania w wersji 1 zawiera dokument Usługi REST możliwości raportowania - wersja 1.

O tym zadaniu

Filtry rodzime są obsługiwane przez źródła danych usług REST możliwości raportowania, które pozwalają na filtrowanie, sortowanie i selektywną obsługę właściwości. Filtr rodzimy żąda zestawu danych ze źródła danych, a następnie filtruje i zawęża dane wyprowadzane z poziomu szablonu produktu Rational Publishing Engine. Tworzenie filtrów w produkcie, z którego pochodzą dane, nie jest wymagane. Można to zrobić w celu przetestowania filtrów pod kątem dokładności, ale filtry można tworzyć do wyłącznego użytku w szablonach produktu Rational Publishing Engine z poziomu tego produktu.

W poprzednich wersjach produktu Rational Publishing Engine można było definiować tylko filtry statyczne. Podczas projektowania szablonu użytkownik musiał posiadać informacje o filtrach. Filtrów tych nie można było zmieniać w czasie wykonywania.

Procedura

  1. W programie Document Studio wybierz element szablonu, który zawiera zapytanie do przefiltrowania.
  2. W widoku Właściwości wybierz kartę Dane.
  3. W polu Filtr kliknij wielokropek.
  4. Na karcie Filtr rodzimy rozwiń pozycję Zmienne.
    Uwaga: Zmienne używane w filtrach mogą być modyfikowane przed użyciem pierwszego zapytania dla tego źródła danych.
  5. Wybierz zmienną, dla której ma zostać przeprowadzone filtrowanie.
  6. Wprowadź składnię ${}, aby zdefiniować zapytanie do przefiltrowania. Na przykład można przeprowadzić filtrowanie według nazwy produktu. Ten szablon może być używany przez wiele zespołów zajmujących się produktem, które określają nazwę produktu w specyfikacji dokumentu w czasie wykonywania.
    cq:Product{cq:Product"${productName}"
    Uwaga:
    • Atrybuty niestandardowe nie mogą być używane w filtrach rodzimych.
    • W przypadku zmiany nazwy zmiennej nazwa nie jest aktualizowana w wyrażeniu skryptu ani w filtrze rodzimym, co powoduje błąd odwołania. Po zmianie nazwy zmiennej należy pamiętać, aby zmodyfikować również nazwę w wyrażeniach skryptu i filtrach rodzimych.
    • Aby wyodrębnić dane produktu Rational DOORS, należy użyć skryptu DXL jako warunku filtru rodzimego. W celu wyodrębnienia danych REST należy użyć warunku filtru XPath.
  7. Kliknij przycisk OK.

Źródła danych obsługujące składnię usług REST możliwości raportowania w wersji 1

W filtrach rodzimych usług REST możliwości raportowania w wersji 1 należy tylko wprowadzić tekst w nawiasach kwadratowych []. Pozostała część filtru jest generowana przez produkt Rational Publishing Engine.

Design Management

Produkt Design Management obsługuje filtrowanie rodzime ze źródeł danych usług REST możliwości raportowania w wersji 1. Więcej informacji na ten temat zawiera sekcja Usługi REST możliwości raportowania - wersja 1.

IBM® Rational ClearCase

Adapter produktu Rational ClearCase obsługuje filtrowanie rodzime ze źródeł danych usług REST możliwości raportowania w wersji 1. Więcej informacji na ten temat zawiera sekcja Usługi REST możliwości raportowania - wersja 1.

IBM Rational ClearQuest

Adapter produktu Rational ClearQuest obsługuje filtrowanie rodzime ze źródeł danych usług REST możliwości raportowania w wersji 1. Więcej informacji na ten temat zawiera sekcja Usługi REST możliwości raportowania - wersja 1.

IBM Rational RequisitePro

W następującym przykładzie filtru rodzimego usług REST możliwości raportowania w wersji 1 wyodrębniany jest schemat PRRequirements produktu Rational RequisitePro przy użyciu właściwości Stability='High'.

Przykład

Dodanie wyrażenia filtru do węzła w obszarze urządzeń (Appliances) w celu wyboru wyłącznie urządzeń wyprodukowanych przez konkretnego producenta.
fields=Project/Requirements/PRRequirement[Stability = 'High']/(Stability|FullTag|Priority|Status)

IBM Rational Rhapsody

Produkt Rational Rhapsody obsługuje źródła danych usług REST możliwości raportowania w wersji 1 w celu użycia w filtrach rodzimych. Więcej informacji na ten temat zawiera sekcja Usługi REST możliwości raportowania - wersja 1.

IBM Rational Team Concert

Produkt Rational Team Concert obsługuje źródła danych usług REST możliwości raportowania w wersji 1 w celu użycia w filtrach rodzimych. Więcej informacji na ten temat zawiera sekcja Interfejs API usług REST możliwości raportowania w serwisie Jazz.net.

Przykład

projectArea/name="Rational Publishing
Engine"  and target/name="1.2.1"
Rozstrzygnięte żądanie:
fields=workitem/workItem[projectArea/name="Rational Publishing Engine" and target.name="1.2.1"]/(@href|summary)

Źródła danych obsługujące składnię usług REST możliwości raportowania w wersji 2

O tym zadaniu

Uwaga:
  • Żądania są wysyłane do źródła danych tylko w razie potrzeby. Na przykład można użyć warunku określającego, że element będzie wyświetlany w danych wyjściowych tylko wtedy, gdy zawiera dane. Warunek w elemencie kontenera może mieć postać: zmienna == "true". Jeśli ten warunek nie zostanie spełniony i żadne dane nie spełniają warunku zmiennej, do źródła danych nie zostaną wysłane żadne żądania.
  • Przed wykonaniem żądania można obliczyć filtry rodzime. Filtr rodzimy jest obliczany w momencie, w którym napotkano zapytanie, i używane są wartości zmiennych z tego momentu. Oznacza to, że można wykonywać obliczenia w szablonie, co ma wpływ na filtry rodzime.

IBM Rational ClearQuest

Produkt Rational ClearQuest 8 obsługuje filtrowanie rodzime ze źródeł danych usług REST możliwości raportowania w wersji 2. Więcej informacji zawiera dokument Rational ClearQuest OSLC CM REST API (Interfejs API usług REST OSLC CM).

Przykład

Przykładowy filtr zmiennej:
cq:Product{cq:Product="${productName}") 
Przykładowy rozstrzygnięty filtr, w którym wartością zmiennej productName jest Rational Publishing Engine:
cq:Product{cq:Product="Rational Publishing Engine")

Źródła danych obsługujące składnię zastrzeżonego interfejsu API

IBM Rational DOORS

Produkt Rational DOORS obsługuje zastrzeżony interfejs API, a filtr jest wyrażany przy użyciu składni widoku produktu Rational DOORS.

Przykład

W następującym przykładzie filtru rodzimego produktu Rational DOORS filtrowane są obiekty zawierające słowo "Dokumentacja" w atrybucie Tekst obiektu.
Atrybut Tekst obiektu zawiera Dokumentacja (rozróżniana jest wielkość liter)
Aby wygenerować tekst filtru rodzimego dla źródła danych produktu Rational DOORS:
  1. Otwórz moduł produktu Rational DOORS, a następnie kliknij opcję Narzędzia > Filtr > Definiuj pozycję menu.
  2. Utwórz składnię filtru:
    1. Wybierz kartę Atrybuty.
    2. Dla atrybutu wybierz wartość Tekst obiektu.
    3. Dla warunku wybierz wartość Zawiera.
    4. Dla wartości wprowadź konkretną wartość, według której ma być przeprowadzane filtrowanie. Aby na przykład filtrować tylko te obiekty, które zawierają słowo Dokumentacja w atrybucie Tekst obiektu, wprowadź wartość: Dokumentacja
    5. Kliknij przycisk Dodaj. W sekcji Opcje zaawansowane zostanie utworzona składnia reguły.
  3. Kliknij opcję Opis i skopiuj pełny opis. Został w ten sposób utworzony filtr produktu Rational DOORS, który jest skryptem DXL.
Aby dodać filtr produktu Rational DOORS do elementu szablonu produktu Rational Publishing Engine:
  1. Wybierz element szablonu zawierający zapytanie do przefiltrowania.
  2. Na karcie Właściwości rozwiń pozycję Dane.
  3. W polu Filtr kliknij wielokropek. Zostanie otwarte okno Edytor filtrów.
  4. Na karcie Filtr rodzimy wklej filtr produktu Rational DOORS (skrypt DXL) i kliknij przycisk OK.

IBM Rational Tau

Produkt Rational Tau obsługuje zastrzeżony interfejs API, a filtr jest wyrażony jako zapytanie OCL.

Przykład

W poniższym przykładzie filtru rodzimego produktu Rational Tau filtrowane są pakiety zawierające predefiniowane nazwy:
  • model.predefinedPackage - bieżący element schematu.
  • GetEntities(“predefinedPackage”).select(IsKindOf(“Package”) - bazowe zapytanie produktu Rational Tau.
  • select(HasPropertyWithValue("Name", "Predefined")) - warunek filtru rodzimego.
Zapytanie wykonywane przez oceniacz zapytania produktu Rational Tau to:
GetEntities(“predefinedPackage”). select(IsKindOf(“Package”))
select(HasPropertyWithValue("Name", "Predefined"))

Opinia