Utilisation de paramètres dans les rapports

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Vous utilisez des paramètres dans les rapports pour contrôler les données récupérées en invitant l’utilisateur à indiquer une valeur ou un ensemble de valeurs lorsque l’utilisateur exécute le rapport. La requête d'ensemble de données récupère uniquement les données qui sont demandées par l'utilisateur. Vous pouvez également ajouter des paramètres masqués et spéciaux dans les rapports qui n'invitent pas l'utilisateur à indiquer des éléments, mais qui peuvent être utilisés pour des opérations comme le filtrage et l'extraction dynamique de données.

Contenu de la rubrique

Ajout de paramètres

Paramètres masqués

Ajout de paramètres

Vous pouvez ajouter des paramètres à un rapport pour définir les paramètres individuels d'un rapport, transmettre les informations via une requête, ou permettre l'accès aux paramètres utilisateur, notamment les paramètres CRM_CurrencySymbol et CRM_CurrencyPositivePattern.

<ReportParameter> est un élément dans le fichier de définition de rapport (RDL) utilisé pour décrire un paramètre individuel du rapport.<QueryParameter> contient des informations sur un paramètre individuel qui est transmis à la source de données dans le cadre d'une requête. Le code XML suivant provenant du fichier du RDL du rapport Résumé du compte montre comment utiliser les paramètres ReportParameter et QueryParameter.

<ReportParameter Name="CRM_FilteredAccount">
  <DataType>String</DataType>
    <Nullable>true</Nullable>
    <DefaultValue>
      <Values>
         <Value>select * from FilteredAccount</Value>
      </Values>
    </DefaultValue>
    <AllowBlank>true</AllowBlank>
    <Prompt>CRM_FilteredAccount</Prompt>
</ReportParameter>

<Query>
   <rd:UseGenericDesigner>true</rd:UseGenericDesigner>
   <CommandText>declare @sql as nVarchar(max)
      set @sql = '
      SELECT top 10 CAST(accountid as nvarchar(100)) as AccountID,
      name, '''' as None
      FROM (' + @FilteredAccount + ') as fa'
      exec(@sql)
   </CommandText>
   <QueryParameters>
      <QueryParameter Name="@FilteredAccount">
         <Value>=Parameters!FilteredAccount.Value</Value>
      </QueryParameter>
   </QueryParameters>
   <DataSourceName>CRM</DataSourceName>
</Query>

Les exemples suivants expliquent comment utiliser les paramètres QueryParameter et ReportParameter dans un rapport Fetch :

<ReportParameter Name="FilteredAccount">
      <DataType>String</DataType>
      <Prompt>Filtered Account</Prompt>
            <DefaultValue>
                  <Values>
                        <Value>
                              <fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">
                              <entity name="account">
                              <all-attributes/>
                              </entity>
                              </fetch>
                        </Value>
                  </Values>
            </DefaultValue>
    </ReportParameter>

<Query>
        <DataSourceName>DataSource1</DataSourceName>
        <CommandText>
                  <fetch> 
                  <entity name="account" enableprefiltering="true" prefilterparametername="FilteredAccount">
                  <attribute name="accountid" />
                  <attribute name="name" />
                  </entity>
                  </fetch>
            </CommandText>
        <QueryParameters>
          <QueryParameter Name="FilteredAccount">
            <Value>=Parameters!FilteredAccount.Value</Value>
          </QueryParameter>
        </QueryParameters>
        <rd:UseGenericDesigner>true</rd:UseGenericDesigner>
      </Query>

Paramètres masqués

Le concepteur de rapports dans Microsoft Visual Studio a une prise en charge intégrée des paramètres masqués. En outre, vous pouvez masquer les paramètres en ajoutant un CRM_ prefix au nom du paramètre dans un rapport Microsoft Dynamics 365. Par défaut, les paramètres avec un CRM_ prefix sont masqués lorsque le rapport est publié via Microsoft Dynamics 365. Lorsque vous exécutez ce rapport, vous n'êtes pas invité à entrer des valeurs de paramètre pour les paramètres masqués.

Paramètres spéciaux

Le tableau suivant montre les paramètres masqués spéciaux que vous pouvez utiliser dans vos rapports.

Vous devez créer tous les paramètres dans un rapport avant de pouvoir y faire référence. Les valeurs de ces paramètres spéciaux sont renseignées par Microsoft Dynamics 365 lorsque vous exécutez le rapport.

Paramètres de format supplémentaires

Le tableau suivant contient des paramètres supplémentaires que vous pouvez utiliser dans les rapports. Parmi ceux-ci se trouvent les paramètres qui permettent d'accéder aux informations des paramètres de nombre de l'utilisateur. Vous pouvez utiliser ces valeurs pour mettre en forme et afficher les valeurs numériques. Ces paramètres sont semblables aux valeurs spécifiées dans la classe NumberFormatInfo. Utilisez ces paramètres dans les rapports personnalisés pour mettre en forme les données en fonction des paramètres utilisateur.

Voir aussi

Création de rapports avec CRM 2015 local
Utilisation des rapports SQL (CRM local uniquement)
Publier les rapports

© 2016 Microsoft Corporation. Tous droits réservés. Copyright