Zapytanie definiuje, które dane są wyodrębniane ze źródła danych i
przyjmuje formę ścieżki w schemacie źródła danych. Użytkownik może przypisać
zapytanie do elementu szablonu, aby zdefiniować kontekst danych dla tego
elementu i jego elementów potomnych.
O tym zadaniu
Zapytania w produkcie
IBM® Rational DOORS
rozpoczynają się od elementu głównego (moduł), po którym znajduje się jego
element potomny (obiekt), a po nim atrybut potomny obiektu. Na przykład
Module/Object/Attribute/Name.
Zapytania w produkcie
IBM Rational Tau
mają składnię podobną do składni wyrażeń XPath. Jednak w przeciwieństwie do
wyrażeń XPath zapytanie produktu
Rational Publishing Engine
nie określa filtru. Filtr i klauzule sortowania są oddzielone od zapytania. Każdy element schematu, z wyjątkiem zapytania, jest definiowany za pomocą
zapytania rodzimego produktu
Rational Tau. To zapytanie, które jest wyrażone w języku OCL, pobiera dane produktu
Rational Tau.
Na przykład element główny w ramach elementu modelu model.rootResource ma
przyłączone zapytanie
GetModelRoots() produktu
Rational Tau.
Procedura
- Przypisz zapytania.
- W programie Document Studio otwórz widok Schemat źródła
danych.
- Dodaj elementy do szablonu.
- Przeciągnij zapytania z widoku Schemat źródła
danych do elementów.
Zapytanie jest przypisywane do elementu szablonu. Atrybutów typu
zapytania, elementu przeciągniętego z widoku Schemat źródła
danych, można użyć w dowolnym miejscu w elemencie szablonu i jego
elementach potomnych.
- Ustaw limit elementu zapytania.
Uwaga: Użytkownik może przetwarzać podzbiór elementów szablonu przez ustawienie
limitu elementów zapytania.
- W programie Document Studio wybierz element szablonu, który
zawiera zapytanie.
- W widoku Właściwości wybierz kartę
Dane.
- Dla właściwości Limit wprowadź liczbę obiektów ze
źródła danych, które ma zostać użyte w odpowiednim zapytaniu. Wartość 0 (zero) oznacza brak limitu dla
zapytania.
- Przypisz właściwości rekurencji do zapytań. Rekurencji danych należy użyć do wyodrębnienia wszystkich wymagań
potomnych z głównego wymagania źródłowego w schemacie.
- Wybierz element, który zawiera zapytanie.
- W widoku Właściwości dla właściwości Poziom
rekurencji wprowadź liczbę określającą poziom głębokości zapytania.
- Dla właściwości Segmenty rekurencyjne
wprowadź liczbę powtórzeń segmentów w zapytaniu.
Poniższy przykład dotyczy poziomów rekurencji
i segmentów rekurencyjnych.
- Zapisz zmiany.
Wyniki
Po zastosowaniu zapytania do elementu istnieją
trzy wizualne indykatory, które domyślnie są wyświetlane w kolorze niebieskim
w edytorze treści szablonu:
- Nazwa schematu źródła danych
- Kontekst wyświetlany ze znakiem dolara ($)
- Nazwa zapytania
Wskazówka: W
przypadku czyszczenia informacji z zapytań opcje Wyczyść
odwołania i Wyczyść dane działają w różny
sposób. Opcja Wyczyść odwołania jest dostępna tylko po
wybraniu elementu z zapytaniem. Opcja Wyczyść odwołania
powoduje usunięcie wszystkich zapytań, atrybutów, filtrów, sortowań i warunków
w wybranym elemencie i jego elementach podrzędnych, jeśli przypisano im również
zapytania lub atrybuty. Opcja Wyczyść dane powoduje
usunięcie wszystkich zapytań, atrybutów, filtrów, sortowań i warunków w
wybranym elemencie i jego elementach podrzędnych. Strony główne, style i
właściwości formatowania nie są usuwane.
Przykład: poziom rekurencji i segmenty rekurencyjne
Użytkownik może wyświetlić listę wymagań programowych przy użyciu zapytania
PRRequirement w schemacie produktu
IBM Rational RequisitePro
dostępnym w katalogu przykładów zainstalowanych z produktem
Rational Publishing Engine:
%RPE_HOME%\source\XML\examples\RequisitePro.xsd.
Dla
każdej wartości zapytania PRRequirement można wyodrębnić wszystkie wymagania
potomne, a dla każdego wymagania potomnego można wyodrębnić jego wymagania potomne
bez dodawania każdego zapytania do szablonu.
Zamiast dodawać
poszczególne z następujących zapytań:
- [$1] Project/Requirements/PRRequirement w celu
wyodrębnienia zapytań PRRequirement
- [$2] $1/Children/Relationship/RelatedReq w celu
wyodrębnienia wymagań potomnych każdego zapytania PRRequirement
- [$3] $2/Children/Relationship/RelatedReq w celu
wyodrębnienia wymagań potomnych każdego wymagania potomnego poszczególnych zapytań PRRequirement
możliwe jest automatyczne utworzenie jednego zapytania dla tych wymagań:
- Dodaj zapytanie
Project/Requirements/PRRequirement/Children/Relationship/RelatedReq
do elementu.
- Dodaj wartości do właściwości Poziom rekurencji i Segmenty rekurencyjne:
- Uruchom raport, aby przeprowadzić test.
Podczas uruchamiania raportu dołączane są następujące zapytania:
Jeśli okaże się, że liczba wprowadzona dla właściwości
Segmenty rekurencyjne jest większa niż liczba segmentów, które zawiera zapytanie, można użyć jednej z tych dwóch opcji, aby rozwiązać problem:
- Wybierz element, do którego zastosowano właściwość Segmenty rekurencyjne. W widoku właściwości wybierz kartę Dane i zmniejsz wartość właściwości segmentów rekurencyjnych.
- Możesz również zmienić projekt zapytania, aby rozpoczynało się od innego zapytania nadrzędnego. Jeśli wartość właściwości Segmenty rekurencyjne jest za duża o jeden segment, utwórz element kontenera i dodaj zapytanie, które znajduje się o jeden poziom wyżej niż zapytanie nadrzędne istniejącego elementu. Następnie przenieś istniejący element do elementu kontenera.
Co dalej
Wskazówka: Użytkownik może wyszukiwać
listę zapytań i atrybutów, klikając prawym przyciskiem myszy element
i wybierając opcję . Zostanie otwarty widok
Wyszukiwanie i zostanie wyświetlona lista zapytań i atrybutów. Zapytanie lub
atrybut w wynikach można kliknąć dwukrotnie, aby dokonać edycji treści danego
elementu.
Listę
przypisań zmiennych, atrybutów i zapytań używanych w elemencie można
przeszukiwać, klikając element prawym przyciskiem myszy i wybierając opcję
. Zostanie otwarty widok Wyszukiwanie z
wyświetloną listą. Dwukrotne kliknięcie pozycji w wynikach umożliwia jej edycję.
W widoku Schematy źródeł danych można znaleźć zapytanie lub
atrybut z poziomu elementu, do którego to zapytanie lub atrybut zostało
zastosowane. W tym celu należy kliknąć prawym przyciskiem myszy element i
wybrać opcję . Zostanie wyświetlony widok Schemat źródła
danych, a zapytanie lub atrybut zostanie podświetlone.