Formatowanie zapytania raportowego

Zapytania raportowe zawierają usystematyzowane informacje, które powodują wyświetlanie raportu w Generatorze raportów, oraz co najmniej jedno zapytanie SQL, które powoduje pobieranie informacji z bazy danych SQL.

Zapytania tworzy się w edytorze tekstu, takim jak Notatnik, i zapisuje jako pliki .crp w formacie Unicode.

Aby sformatować zapytanie raportowe:

  1. Uruchomić edytor tekstu, np. Notatnik.
  2. Utworzyć zapytanie raportowe przy użyciu następujących elementów:
    @[identyfikator_zapytania]

    Przykład:@[GroupMembers]

    §Name [nazwa_wyświetlana]

    Przykład: §Name [szczegóły użytkowników należących do wybranych grup]
    §Company [nazwa_firmy]

    Przykład: §Company [SOLIDWORKS]
    §Description [opis]

    Przykład: §Description [Wyświetla listę wszystkich członków wybranych grup.]
    §Version [numer_wersji]

    Przykład: §Version [1.1]

    		 
    §Arguments [ typ 
                                 nazwa[liczba] [instrukcja] ]

    Gdzie:

    • typ jest uprzednio zdefiniowanym typem argumentu.

    • nazwa jest zmienną używaną w elemencie WHERE zapytania SQL.

    • [liczba] definiuje sposób, w jaki wartości są zwracane do zapytania SQL.

    • [instruct] pojawia się w Generatorze raportów jako instrukcja użytkownika.

    Zapytanie raportowe może mieć wiele argumentów.

    Wszystkie składniki argumentu muszą mieścić się w jednym wierszu.
    Przykład: 
    §Arguments [ GroupID TheGroupID[N] [Wybrane grupy] ]
    		 
    §Sql [ ]
    Przykład: 
    §Sql [ ]
  3. Utworzyć w programie Microsoft SQL Server Management Studio zapytanie języka T-SQL w celu pobrania informacji z bazy danych SQL.
  4. Skopiować zapytanie SQL i wkleić je w sekcji §Sql [ ] zapytania raportowego.
  5. Opcjonalne: Można zmodyfikować element WHERE zapytania SQL, aby argument był dynamicznie obliczany podczas wykonywania raportu w Generatorze raportów.
    W kroku 2 argument to [GroupID TheGroupID[N] [Wybrane grupy]]. Można użyć nazwy zmiennej TheGroupID, aby zwracać dane na podstawie grupy wybranej przez użytkownika podczas wykonywania raportu.

    W tym celu w poniższej składni zapytania T-SQL należy zastąpić fragment G.GroupID = 2 fragmentem {G.GroupID, TheGroupID, =, OR}.

    Składnia zapytania w języku T-SQL
    WHERE G.GroupID = 2 AND G.GroupID = M.GroupID AND U.UserID = M.UserID
    Składnia zapytania raportowego
    WHERE {G.GroupID, TheGroupID, =, OR} AND G.GroupID = M.GroupID AND U.UserID = M.UserID]
  6. Zapisać zapytanie jako plik .crp.
  7. Zaimportować plik .crp do Generatora raportów, aby uruchomić raport.

Przykład zapytania raportowego

Poniższe zapytanie raportowe pochodzi z pliku Report Examples 1.crp, który jest umieszczany w katalogu_instalacyjnym, domyślnie w lokalizacji C:\Program Files\SOLIDWORKS PDM .

@[GroupMembers] §Name [szczegóły użytkowników należących do wybranych grup] §Company [SOLIDWORKS] §Description [to zapytanie wyświetli listę wszystkich członków wybranych grup.] §Version [1.1] §Arguments [ GroupID	TheGroupID[N] [wybrane grupy] ] §Sql [ SELECT U.Username, G.Groupname, G.Description FROM Users U, Groups G, GroupMembers M WHERE {G.GroupID, TheGroupID, =, OR} AND G.GroupID = M.GroupID AND U.UserID = M.UserID ]

Plik zawiera dodatkowe zapytania raportowe, które użytkownik może zaimportować do Generatora raportów.