À propos des invites de rapport

S'applique à: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

Dans Configuration Manager 2007, une invite est une propriété de rapport qui peut être configurée lors de la création ou de la modification d'un rapport. Les invites sont créées dans le but de limiter ou de cibler les données extraites par un rapport. Un rapport peut contenir plusieurs invites, tant que celles-ci portent un nom unique et qu'elles contiennent uniquement des caractères alphanumériques conformes aux règles SQL pour les identificateurs.

Lorsque vous exécutez un rapport, l'invite appelle la valeur d'un paramètre requis et, en fonction de cette valeur, récupère les données du rapport. Par exemple, le rapport Informations concernant un ordinateur spécifique récupère les informations concernant un ordinateur spécifique et invite l'utilisateur à entrer un nom d'ordinateur. La visionneuse de rapports transmet ensuite la valeur spécifiée à une variable définie dans l'instruction SQL du rapport. Si l'instruction SQL est configurée correctement, le rapport renvoie les informations concernant l'ordinateur spécifié uniquement.

Propriétés de l'invite

Il est possible de configurer une valeur par défaut qui renseigne automatiquement l'invite dès que celle-ci s'affiche. Il est également possible de configurer une liste à partir de laquelle l'utilisateur choisit une valeur appropriée, en utilisant une instruction SQL distincte de l'instruction SQL principale du rapport. Par exemple, si un rapport invite l'utilisateur à entrer le nom d'un ordinateur et si vous souhaitez que l'utilisateur sélectionne ce nom dans une liste au lieu de l'entrer manuellement de mémoire, une instruction SQL peut être configurée. Pour afficher la liste des éléments renvoyés par l'instruction SQL parmi lesquels l'utilisateur peut choisir une valeur, cliquez sur Valeurs dans la boîte de dialogue Invite. Pour autoriser l'utilisation du caractère générique représentant un pourcentage (%) afin de limiter le nombre de valeurs renvoyées, utilisez la variable @_filterwildcard dans l'instruction SQL.

Exemple d'instruction SQL d'une invite

L'exemple ci-dessous présente l'instruction SQL d'une invite qui prend en charge l'utilisation du caractère générique % et qui renvoie une liste des noms d'ordinateurs, filtrés ou non, en fonction de la valeur d'invite spécifiée :

begin if (@__filterwildcard = '')  SELECT DISTINCT SYS.Netbios_Name0 from v_R_System SYS ORDER By SYS.Netbios_Name0 else  SELECT DISTINCT SYS.Netbios_Name0 from v_R_System SYS   WHERE SYS.Netbios_Name0 like @__filterwildcard  ORDER By SYS.Netbios_Name0end

L'instruction SQL est constituée de deux sections principales. Si l'utilisateur clique sur Valeurs et n'entre aucune donnée dans la zone de texte, l'instruction if (@__filterwildcard = '') est vraie et tous les noms d'ordinateurs sont renvoyés. Dans le cas contraire, l'ordinateur correspondant à la valeur de l'invite est récupéré ou, si un caractère générique est spécifié, les ordinateurs dont le nom contient le texte de la valeur de l'invite sont récupérés et apparaissent dans la liste des valeurs.

Utilisation des caractères génériques pour les valeurs d'invites

Les caractères génériques permettent de réduire le nombre des valeurs qui s'affichent lorsque vous cliquez sur Valeurs dans la boîte de dialogue Invite. Utilisez le symbole du signe de pourcentage (%) pour remplacer plusieurs caractères, le symbole du caractère de soulignement (_) pour remplacer un seul caractère et les symboles des crochets ([ ]) pour rechercher des caractères littéraux. Bien que les caractères génériques permettent de réduire le nombre des valeurs qui s'affichent lorsque vous cliquez sur Valeurs, ils ne permettent pas de réduire le nombre de résultats renvoyés lorsque vous cliquez sur Afficher pour exécutez un rapport. Si vous entrez un caractère générique, puis cliquez sur Afficher, le rapport recherche les valeurs littérales correspondant à ce caractère générique. Par exemple, si vous entrez %m% lorsque vous êtes invité à saisir un nom d'ordinateur, puis cliquez sur Afficher, le rapport recherche tous les ordinateurs dont le nom est %m%.

Nombre maximal de lignes renvoyées pour les valeurs d'invites

Le nombre de valeurs pouvant être renvoyées lorsque vous cliquez sur Valeurs peut être très élevé, mais est limité par défaut à 1 000. Pour plus d'informations sur les procédures de modification de cette valeur par défaut, consultez Comment configurer le nombre maximal de lignes renvoyées dans la liste des valeurs.

Voir aussi

Tâches

Comment configurer le nombre maximal de lignes renvoyées dans la liste des valeurs
Comment créer un rapport
Comment créer ou modifier des invites de rapport

Pour plus d'informations, consultez Informations et prise en charge de Configuration Manager 2007.
Pour contacter l'équipe de documentation, envoyez un e-mail à SMSdocs@microsoft.com.