Formátování dotazu pro vytvoření zprávy

Dotazy pro vytváření zpráv obsahují strukturované informace, které zprávu zobrazí v Generátoru zpráv, a jeden nebo více dotazů SQL pro načtení informací z databáze SQL.

Dotaz můžete vytvořit v textovém editoru (např. Poznámkový blok) a uložit jako soubor .crp ve formátu Unicode.

Formátování zprávy se provádí takto:

  1. Otevřete textový editor, například Poznámkový blok.
  2. Vytvořte dotaz pro vytvoření zprávy s použitím následujících prvků:
    @[identifikátor dotazu]

    Příklad:@[GroupMembers]

    §Name [zobrazené_jméno]

    Příklad: §Name [detaily o uživatelích ve vybraných skupinách]
    §Company [název_společnosti]

    Příklad: §Company [SOLIDWORKS]
    §Description [popis]

    Příklad: §Description [seznam všech členů vybraných skupin.]
    §Version [číslo_verze]

    Příklad: §Version [1.1]

    		 
    §Arguments [ typ 
                                 název[počet] [příkaz] ]

    Kde:

    • typ je předem definovaný typ argumentu

    • název je proměnná použitá v části WHERE dotazu SQL

    • [počet] definuje způsob, kterým jsou hodnoty vraceny do dotazu SQL

    • [příkaz] se zobrazí v Generátoru zpráv jako pokyn pro uživatele

    Dotaz pro vytvoření zprávy může mít více argumentů.

    Všechny části daného argumentu musí být na jednom řádku.
    Příklad: 
    §Arguments [ GroupID IDskupiny[N] [Vyberte skupiny] ]
    		 
    §Sql [ ]
    Příklad: 
    §Sql [ ]
  3. Vytvořte v nástroji Microsoft SQL Server Management Studio dotaz T-SQL, který bude načítat informace z databáze SQL.
  4. Zkopírujte dotaz SQK a vložte jej do části dotazu označené §Sql [ ].
  5. Volitelné: Upravte část WHERE dotazu SQL, pokud chcete, aby byl argument vyhodnocován dynamicky při spuštění zprávy v Generátoru zpráv.
    V kroku 2 je argument [GroupID IDskupiny[N] [Select groups]]. Název proměnné IDskupiny můžete použít k načtení dat na základě skupiny vybrané uživatelem při spuštění zprávy.

    Provedete to tak, že v následujícím dotazu T-SQL nahradíte výraz G.GroupID = 2 výrazem {G.GroupID, IDskupiny, =, OR}.

    Syntaxe dotazu T-SQL
    WHERE G.GroupID = 2 AND G.GroupID = M.GroupID AND U.UserID = M.UserID
    Syntaxe dotazu pro vytvoření zprávy
    WHERE {G.GroupID, IDskupiny, =, OR} AND G.GroupID = M.GroupID AND U.UserID = M.UserID]
  6. Poté dotaz uložte jako soubor .crp.
  7. Importujte soubor .crp do Generátoru zpráv a spusťte zprávu.

Příklad dotazu pro vytvoření zprávy

Následující dotaz pro vytvoření zprávy je ze souboru Report Examples 1.crp, který se nachází v instalační_složce, tj. ve výchozím stavu ve složce C:\Program Files\SOLIDWORKS PDM .

@[GroupMembers] §Name [Detaily o uživatelích ve vybraných skupinách] §Company [SOLIDWORKS] §Description [Tento dotaz vrátí všechny členy vybraných skupin.] §Version [1.1] §Arguments [ GroupID	IDskupiny[N] [Vybrat skupiny] ] §Sql [ SELECT U.Username, G.Groupname, G.Description FROM Users U, Groups G, GroupMembers M WHERE {G.GroupID, IDskupiny, =, OR} AND G.GroupID = M.GroupID AND U.UserID = M.UserID ]

Tento soubor obsahuje ještě další dotazy pro vytvoření zprávy, které může uživatel importovat do Generátoru zpráv.