Przypisywanie zapytań

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

  1. Przypisz zapytania.
    1. W programie Document Studio otwórz widok Schemat źródła danych.
    2. Dodaj elementy do szablonu.
    3. 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.
  2. Ustaw limit elementu zapytania.
    Uwaga: Użytkownik może przetwarzać podzbiór elementów szablonu przez ustawienie limitu elementów zapytania.
    1. W programie Document Studio wybierz element szablonu, który zawiera zapytanie.
    2. W widoku Właściwości wybierz kartę Dane.
    3. 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.
  3. 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.
    1. Wybierz element, który zawiera zapytanie.
    2. W widoku Właściwości dla właściwości Poziom rekurencji wprowadź liczbę określającą poziom głębokości zapytania.
    3. 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.
  4. 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
Element komórki z zastosowanym zapytaniem
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ń:
  1. Dodaj zapytanie Project/Requirements/PRRequirement/Children/Relationship/RelatedReq do elementu.
  2. Dodaj wartości do właściwości Poziom rekurencji i Segmenty rekurencyjne:
    • Dla właściwości Poziom rekurencji wprowadź wartość 4.

      Poziom rekurencji reprezentuje liczbę poziomów głębokości zapytania. Jeśli wprowadzono wartość 1 lub większą, konieczne jest również ustawienie wartości 1 lub większej dla właściwości Segmenty rekurencyjne.

    • Dla właściwości Segmenty rekurencyjne wprowadź wartość 3.
      Segmenty rekurencyjne reprezentują liczbę powtórzeń segmentów w zapytaniu. Segmenty w tym przykładzie to Children/Relationship/RelatedReq.
      Uwaga: Liczba wprowadzona dla właściwości Segmenty rekurencyjne nie może być większa niż liczba segmentów, które zawiera zapytanie. Zapytanie nadrzędne nie jest dołączane jako segment.
  3. Uruchom raport, aby przeprowadzić test.
    Podczas uruchamiania raportu dołączane są następujące zapytania:
    • [$1] – Project/Requirements/PRRequirement/Children/Relationship/RelatedReq
      Uwaga: Pierwsze zapytanie musi zawierać pełen kontekst zapytania.
    • [$2] – $1/Children/Relationship/RelatedReq
    • [$3] - $2/Children/Relationship/RelatedReq
    • [$4] – $3/Children/Relationship/RelatedReq
    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ę Szukaj > Odwołania do danych w elemencie. 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ę Szukaj > Wszystkie odwołania w elemencie. 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ę Szukaj > Idź do schematu. Zostanie wyświetlony widok Schemat źródła danych, a zapytanie lub atrybut zostanie podświetlone.


Opinia