Mise en forme d'une demande de rapport

Les demandes de rapport contiennent des informations structurées qui affichent le rapport dans le Générateur de rapports et une ou plusieurs requêtes SQL qui extraient des informations depuis la base de données SQL.

Vous créez les requêtes dans un éditeur de texte tel que le Bloc-notes et vous les enregistrez dans des fichiers .crp au format Unicode.

Pour mettre en forme une demande de rapport:

  1. Ouvrez un éditeur de texte comme le Bloc-notes.
  2. Créez une demande de rapport en utilisant les éléments suivants:
    @[identificateur_demande]

    Exemple :@[GroupMembers]

    §Nom [nom_complet]

    Exemple: §Nom [Détails utilisateur des groupes sélectionnés]
    §Société [nom_société]

    Exemple: §Société [SOLIDWORKS]
    §Description [description]

    Exemple: §Description [Liste de tous les membres des groupes sélectionnés.]
    §Version [numéro_version]

    Exemple: §Version [1.1]

    		 
    §Arguments [ type
                                 nom[nombre] [instruction] ]

    Où:

    • type est un type d'argument prédéfini

    • nom est une variable utilisée dans l'élément WHERE de la requête SQL

    • [nombre] définit comment les valeurs sont retournées à la requête SQL

    • [instruction] apparaît dans le Générateur de rapports comme une instruction de l'utilisateur

    Une demande de rapport peut avoir plusieurs arguments.

    Tous les composantes de l'argument doit être sur une ligne.
    Exemple: 
    §Arguments [ GroupID TheGroupID[N] [Select groups] ]
    		 
    §Sql [ ]
    Exemple: 
    §Sql [ ]
  3. Dans Microsoft SQL Server Management Studio, créez une requête T-SQL pour extraire les informations de la base de données SQL.
  4. Copiez la requête SQL et collez-la dans la section §Sql [ ] de la demande de rapport.
  5. Facultatif : Modifiez l'élément WHERE de la requête SQL si vous souhaitez qu'un argument soit évalué de façon dynamique lors de l'exécution du rapport dans le générateur de rapports.
    A l'étape 2, l'argument correspond à [GroupID TheGroupID[N] [Select groups]]. Vous pouvez utiliser le nom de variable TheGroupID pour renvoyer des données en fonction du groupe sélectionné par l'utilisateur lors de l'exécution du rapport.

    Pour cela, dans la syntaxe de la requête T-SQL suivante, vous remplacez G.GroupID = 2 par {G.GroupID, TheGroupID, =, OR}.

    Syntaxe de la requête T-SQL
    WHERE G.GroupID = 2 AND G.GroupID = M.GroupID AND U.UserID = M.UserID
    Syntaxe de la demande de rapport
    WHERE {G.GroupID, TheGroupID, =, OR} AND G.GroupID = M.GroupID AND U.UserID = M.UserID]
  6. Enregistrez la requête au format de fichier .crp.
  7. Importez le fichier .crp dans le Générateur de rapports pour exécuter le rapport.

Exemple de demande de rapport

La requête de rapport suivante est extraite du fichier Report Examples 1.crp, installé dans dossier_installation. Par défaut, il s'agit de C:\Program Files\SOLIDWORKS PDM .

@[GroupMembers] §Nom [Détails utilisateur des groupes sélectionnés] §Société [SOLIDWORKS] §Description [Cette requête va lister tous les membres des groupes sélectionnés.] §Version [1.1] §Arguments [ GroupID	TheGroupID[N] [Select group(s)] ] §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 ]

Ce fichier contient d'autres demandes de rapport pouvant être importées vers le Générateur de rapport.