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.

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ść zapytania i Wyczyść wszystko działają w różny sposób. Opcja Wyczyść zapytania jest dostępna tylko po wybraniu elementu z zapytaniem. Opcja Wyczyść wszystko 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. Strony główne, style i właściwości formatowania nie są usuwane.

Przykład: poziom rekurencji i segmenty rekurencyjne

Dla każdego zapytania nadrzędnego 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] zapytanie1/zapytanie2/zapytanie3, aby wyodrębnić zapytanie3.
  • [$2] $1/zapytanie4/zapytanie5/zapytanie6, aby wyodrębnić wymagania potomne każdego zapytania zapytanie3.
  • [$3] $2/zapytanie4/zapytanie5/zapytanie6, aby wyodrębnić wymagania potomne każdego wymagania potomnego każdego zapytania zapytanie3.
możliwe jest automatyczne utworzenie jednego zapytania dla tych wymagań:
  1. Dodaj zapytanie zapytanie1/zapytanie2/zapytanie3/zapytanie4/zapytanie5/zapytanie6 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 zapytanie4/zapytanie5/zapytanie6.
      Uwaga: Liczba wprowadzona dla właściwości Segmenty rekurencyjne nie może być większa niż liczba segmentów zawartych w zapytaniu. 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] – zapytanie1/zapytanie2/zapytanie3/zapytanie4/zapytanie5/zapytanie6
      Uwaga: Pierwsze zapytanie musi zawierać pełen kontekst zapytania.
    • [$2] – $1/zapytanie4/zapytanie5/zapytanie6
    • [$3] - $2/zapytanie4/zapytanie5/zapytanie6
    • [$4] – $3/zapytanie4/zapytanie5/zapytanie6
    Jeśli okaże się, że liczba wprowadzona dla właściwości Segmenty rekurencyjne jest większa niż liczba segmentów zawartych w zapytaniu, 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