Microsoft Dynamics 365 Customer Engagement (on-premises) inclut des rapports, des graphiques et des
tableaux de bord qui fournissent de précieuses informations commerciales et des visualisations utiles à
l'utilisateur.
NOTE
Ce guide s'applique également à Common Data Service. Vous pouvez suivre les informations de ce guide pour créer et
modifier les rapports Fetch compatibles avec Common Data Service. Les rubriques de création de rapports suivantes sont
disponibles dans la documentation de Common Data Service :
Ajouter des rapports à votre application basée sur un modèle
Créer un rapport à l'aide de l'Assistant Rapport
Utiliser les rapports
Rapports paginés
Customer Engagement (on-premises) inclut un Assistant Rapport qui permet de créer facilement des rapports en
quelques étapes sans utiliser les requêtes XML ou SQL. Pour plus d’informations sur l’Assistant Rapport, voir
Créer, modifier ou copier un rapport à l’aide de l’Assistant Rapport.
Toutefois, pour créer des rapports plus complexes, vous pouvez créer entièrement vos propres rapports
personnalisés ou utiliser un rapport existant comme modèle. Les rubriques de ce guide vous montrent comment
créer des rapports ou modifier des rapports existants en utilisant Visual Studio comme outil de création de
rapports et SQL Server Reporting Services comme moteur de rapport.
Tableaux de bord
Il existe deux types de tableaux de bord dans Customer Engagement (on-premises) : les tableaux de bord
utilisateur et les tableaux de bord système. Tout utilisateur peut créer un tableau de bord visible uniquement par
lui dans sa zone de travail telle que Ventes, Service ou Marketing. Un administrateur ou un personnalisateur crée
ou personnalise des tableaux de bord système qui, une fois publiés, sont visibles par toute personne de
l'organisation. Un utilisateur peut choisir de définir son tableau de bord utilisateur comme valeur par défaut et de
remplacer le tableau de bord système. Pour plus d'informations : Créer ou personnaliser des tableaux de bord
Vue d'ensemble des rapports
26/02/2020 • 4 minutes to read
Microsoft Dynamics 365 Customer Engagement (on-premises) peuvent inclure des rapports qui fournissent des
informations commerciales utiles à l'utilisateur. Ces rapports sont basés sur SQL Server Reporting Services et
fournissent le même ensemble de fonctionnalités disponibles pour les rapports SQL Server Reporting Services.
Types de rapports
Customer Engagement (on-premises) prend en charge deux types de rapport :
Rapports SQL Ser ver Repor ting Ser vices. Ces rapports utilisent des requêtes SQL et des vues filtrées
pour récupérer les données de rapport. Les vues filtrées restreignent les données aux données disponibles
au rôle de sécurité de la personne qui exécute le rapport. Tous les rapports par défaut inclus dans Customer
Engagement (on-premises) sont des rapports SQL.
Vous ne pouvez pas accéder aux vues filtrées dans Dynamics 365 Customer Engagement car l'accès à la base
de données SQL n'est pas pris en charge. Si vous avez un abonnement à Dynamics 365 (online) ou à Power
Apps, utilisez des rapports Fetch pour les rapports personnalisés.
Rappor ts Fetch Repor ting Ser vices. Ces rapports utilisent des requêtes FetchXML Customer
Engagement (on-premises) à la place de vues filtrées pour récupérer les données pour les rapports. Les
rapports créés à l’aide de l’Assistant Rapport sont des rapports Fetch.
Les autres rapports peuvent être :
Des liens vers des pages Web
Des fichiers statiques
des fichiers Office Excel dynamiques qui lisent les données depuis la base de données Customer
Engagement (on-premises).
Pour chaque rapport, vous pouvez modifier les propriétés suivantes :
Nom de fichier ou URL
Nom complet
Description
Informations sur l'emplacement d'affichage du rapport dans l'interface utilisateur
NOTE
Pour déterminer si un rapport est consultable par l'organisation : Dans la liste rapports, sélectionnez un rapport, puis cliquez
ou appuyez sur Modifier . Sous l'onglet Administration , voyez si Consultable par a la valeur Organisation .
Vous pouvez ajouter, importer ou exporter des captures instantanées de rapports dans le cadre d'une solution. Les
rapports, les sous-rapports, la catégorie de rapport, la zone d’affichage de rapport et le type d’enregistrement lié à
un rapport sont considérés comme les composants d’un jeu de rapports. Lorsque vous importez une mise à jour
de solution dans un mode n'autorisant pas les remplacements, toute mise à jour apportée par la solution à un
rapport est ignorée si un composant du jeu de rapports a été personnalisé.
NOTE
Vous ne pouvez pas utiliser le gestionnaire de rapports SQL Server Reporting Services pour créer des rapports FetchXML.
L'extension de création de rapports Dynamics 365 pour SQL Server Data Tools est utilisée pour créer des rapports FetchXML.
Voir aussi
Guide sur les rapports et analyses
Publier les rapports
Environnement de rédaction de rapports à l'aide de
SQL Server Data Tools
26/02/2020 • 3 minutes to read
Cette rubrique décrit les éléments nécessaires pour créer des rapports d'applications Dynamics 365 for Customer
Engagement.
Vous devez disposer des outils de développement requis et des privilèges appropriés dans les applications
Dynamics 365 for Customer Engagement pour créer et publier un rapport. En outre, vous devez être familier avec :
Visual Studio.
La création de rapports SQL Server Reporting Services avec SQL Server Data Tools (SSDT).
Pour créer des rapports Fetch, le langage FetchXML des applications Dynamics 365 for Customer
Engagement.
Outils requis
Les éléments suivants sont requis pour créer un rapport personnalisé pour les applications Dynamics 365 for
Customer Engagement :
Visual Studio . Pour les versions spécifiques, voir Configuration requise pour l'extension de création de
rapports Dynamics 365 Customer Engagement (on-premises).
SQL Ser ver Data Tools . Cet environnement de création de rapports est utilisé comme plug-in Visual
Studio.
Pour Microsoft Visual Studio 2015 vous avez besoin de SQL Server Data Tools dans Visual Studio
2015.
Pour Visual Studio 2013 : vous devez télécharger et installer Téléchargement : Microsoft SQL Server
Data Tools - Business Intelligence pour Visual Studio 2013.
Pour Visual Studio 2012 : vous devez télécharger et installer Téléchargement : Microsoft SQL Server
Data Tools - Business Intelligence pour Visual Studio 2012.
Pour Visual Studio 2010 : vous devez sélectionner et installer la fonctionnalité SQL Server Data Tools
(SSDT) fournie avec SQL Server 2012 ou SQL Server 2012 Express sur l’ordinateur exécutant Visual
Studio 2010. Téléchargement : Microsoft SQL Server 2012 Express.
Extension de création de rappor ts Dynamics 365 . Ceci est obligatoire si vous créez des rapports Fetch
personnalisés. Notez que les applications Dynamics 365 for Customer Engagement prennent uniquement
en charge les rapports Fetch. L'extension de création de rapports Dynamics 365 doit être installée sur
l'ordinateur où Visual Studio et SQL Server Data Tools sont installés. Télécharger : Extension de création de
rapports Dynamics 365 Pour obtenir des instructions d'installation, voir Installation de l'Extension de
création de rapports Dynamics 365.
NOTE
Vous ne pouvez pas utiliser le gestionnaire de rapports SQL Server Reporting Services pour créer des rapports FetchXML.
L'extension de création de rapports Dynamics 365 pour SQL Server Data Tools est utilisée pour créer des rapports
FetchXML.
L'Extension de création de rapports Dynamics 365 n'est disponible que pour une version 32 bits.
Privilèges requis
Pour déployer des rapports personnalisés sur les applications Dynamics 365 for Customer Engagement, vous
devez disposer d'un compte d'applications Dynamics 365 for Customer Engagement et un rôle de sécurité incluant
le privilège PublishRepor t doit vous être attribué. Par défaut, les rôles de sécurité Personnalisateur de système et
Administrateur système incluent ces privilèges.
L'Extension de création de rapports Dynamics 365 est requise pour créer et personnaliser les rapports Fetch à
l'aide de SQL Server Data Tools - Business Intelligence, un environnement de conception pour Visual Studio. Plus
d'informations : Exigences relatives aux rapports Microsoft Dynamics 365
S'ils ne sont pas déjà installés, les composants suivants sont installés au cours de l'installation de l'Extension de
création de rapports Dynamics 365 :
.NET Framework
Outil de signalement d'erreurs pour les applications Microsoft
Assistant de connexion Windows Live ID 6.5
WARNING
Les utilisateurs du contrôle Visionneuse de rapports intégré à Visual Studio peuvent afficher les informations provenant de
rapports auxquels ils ont accès. En utilisant ce contrôle, l'utilisateur peut afficher des données supplémentaires concernant les
rapports et les sessions qui ne s'affichent pas pendant l'exécution du rapport dans une application Microsoft Dynamics 365
Customer Engagement (on-premises). Pour réduire le risque d'exposition de données confidentielles, il est recommandé de
configurer l'URL SQL Server Reporting Services sur laquelle les Extensions de rapport Microsoft Dynamics 365 sont installées
de manière à n'utiliser que les connexions TLS (Transport Layer Security) ou SSL (Secure Sockets Layer), également appelées
connexions HTTP sécurisées. Pour plus d'informations : MSDN : configuration des connexions SSL sur un serveur de rapports
du mode natif.
IMPORTANT
Si votre organisation utilise Office 365, assurez-vous que l'Extension de création de rapports Dynamics 365 est installée sur
l'ordinateur où Assistant de connexion Microsoft Online Services est installé. Si l'Assistant de connexion Assistant de
connexion Microsoft Online Services est déjà installé, vérifiez la clé de Registre SOFTWARE\Microsoft\MSOIdentityCRL et
assurez-vous que la clé de Registre TargetDir figurant sous MSOIdentityCRL contient msoidcli.dll.
Installer le plug-in
L'Extension de création de rapports Dynamics 365 est un plug-in permettant d’obtenir les métadonnées et données
à partir de Customer Engagement (on-premises). Ces métadonnées sont nécessaires pour concevoir et afficher
l'aperçu des rapports Fetch dans SQL Server Data Tools. Vous pouvez utiliser l'Extension de création de rapports
Dynamics 365 avec Customer Engagement (on-premises).
1. Dans le dossier /BIDSExtensions/, double-cliquez sur SetupBIDSExtensions.exe . Téléchargement depuis le
Centre de téléchargement Microsoft
2. Dans la page Bienvenue dans le programme d'installation de l'Extension de création de rappor ts
Microsoft Dynamics 365 , il est recommandé de cliquer sur Récupérer les mises à jour pour
Microsoft Dynamics 365 , afin que le programme d'installation dispose des fichiers d'installation les plus
récents. Sélectionnez Suivant .
3. Dans la page Contrat de licence , lisez les informations de la page et, si vous acceptez les termes du contrat
de licence, activez la case à cocher J'accepte ce contrat de licence , puis sélectionnez J'accepte .
4. Si le programme d’installation détecte des composants requis manquants, la page Installer les
composants nécessaires s'affiche. Pour les installer, sélectionnez Installer . Une fois les composants
installés, la colonne d'état passe de Non installé à Installé . Sélectionnez Suivant pour continuer.
NOTE
ces composants sont nécessaires à l’installation de l'Extension de création de rapports Dynamics 365. Vous pouvez
quitter le programme d’installation et installer les composants manuellement ou sélectionner Installer . Le bouton
Suivant est désactivé dans cette page tant que le programme d’installation détecte que ses composants sont
manquants.
L’installation de ces composants peut nécessiter le redémarrage de l’ordinateur. Si vous êtes invité à redémarrer
l'ordinateur, faites-le, puis relancez le programme d’installation.
5. Dans la page Sélectionner les préférences Microsoft Update , nous vous recommandons de
sélectionner l'option Utiliser Microsoft Update pour chercher les mises à jour (recommandé) .
Microsoft Update vérifie que votre ordinateur dispose de la technologie la plus récente, ce qui peut
permettre de réduire le risque de vulnérabilités et de problèmes de sécurité.
6. Dans la page Sélectionner l’emplacement d’installation , acceptez l’emplacement par défaut ou entrez
un autre emplacement d’installation des fichiers, puis sélectionnez Suivant .
7. La page Vérifications système résume la configuration requise et les recommandations pour une
installation réussie. Les erreurs doivent être corrigées avant de poursuivre l'installation. Si aucune erreur ou
seuls des avertissements s'affichent, vous pouvez poursuivre l'installation. Pour ce faire, sélectionnez
Suivant .
8. Examinez la page Prêt à installer l'Extension de création de rappor ts Microsoft Dynamics 365 ,
puis sélectionnez Précédent pour corriger les erreurs. Lorsque vous êtes prêt à continuer, sélectionnez
Installer .
9. Une fois l'installation réussie, la page Installation de l'Extension de création de rappor ts Microsoft
Dynamics 365 terminée s'affiche. Sélectionnez Terminer .
Voir aussi
Créer un rapport à l'aide de SQL Server Data Tools
Créer un rapport à l'aide de SQL Server Data Tools
17/04/2020 • 3 minutes to read
SQL Server Data Tools est un environnement de création de rapports qui vous permet de créer ou de modifier des
rapports SQL Server Reporting Services dans Visual Studio. Le résultat final est un fichier .rdl de définition de
rapport contenant la définition de rapport que vous pouvez publier pour afficher des rapports.
Vous pouvez également créer des rapports à l'aide d'un éditeur de texte courant. Afin de réduire l’effort de
création d’un rapport personnalisé, modifiez un fichier .rdl existant qui fournit la plupart des fonctionnalités
souhaitées. Pour plus d'informations sur le format des éléments XML dans un fichier .rdl, voir Référence RDL. Le
rapport XML modifié peut être vérifié en utilisant le schéma XML spécifié. Reporting Services vérifie également la
définition du rapport et rejettera un rapport si la définition est non valide lorsque vous essayez de télécharger le
rapport.
NOTE
Si le fichier .rdl contient une requête FetchXML, celle du RDL est validée par l'Microsoft Dynamics CRM 2016Extension de
création de rapports, qui la valide en interne par rapport au schéma FetchXML.
Cette section décrit les différentes fonctionnalités disponibles pour déterminer l'affichage des rapports dans les
applications Microsoft Dynamics 365 Customer Engagement (on-premises).
Contenu de la section
Ajout d'une navigation de rapport
Catégoriser et afficher des rapports dans différentes langues
Utilisation de paramètres dans les rapports
Voir aussi
Guide sur les rapports et analyses
Publier les rapports
Ajout d'une navigation de rapport
01/11/2019 • 2 minutes to read
La navigation dans les rapports permet un environnement de création de rapports dynamique et interactive. À
l’aide de différents types d’actions, les rapports permettent à l’utilisateur d’accéder aux rapports détaillés, aux
enregistrements ou à d’autres sites Web.
NOTE
Pour plus d’informations sur la navigation dans les rapports, voir Extraction, exploration, sous-rapports et régions de
données imbriquées (Générateur de rapports et SSRS) dans la documentation de SQL Server. Cette rubrique décrit la
navigation dans les rapports spécifique aux rapports des applications Dynamics 365 for Customer Engagement.
Exploration dynamique
Vous pouvez explorer un rapport pour accéder à un formulaire Web d'application. Un rapport d'extraction est
implémenté de la façon suivante :
1. Un élément d'image ou de valeur (tel qu'une zone de texte) est ajouté à un rapport. La propriété Value de
cet élément contient un code qui génère une URL à l'aide de l'adresse de base de l'application, et des
paramètres qui font référence à un enregistrement spécifique.
2. Lorsque l’utilisateur sélectionne l’élément de rapport, une nouvelle fenêtre de navigateur est ouverte en
utilisant l’URL générée transmise comme l’adresse Web cible.
3. Customer Engagement (on-premises) charge les informations de l’entité spécifiée dans un formulaire Web
affiché dans la fenêtre du navigateur.
Configuration d’un rapport d’extraction dans Dynamics 365 Customer Engagement (on-premises)
1. Créez un paramètre de type chaîne masqué dans le rapport dont le nom est CRM_URL. Pour plus
d'informations sur l'ajout des paramètres, voir Utilisation de paramètres dans les rapports. Lors de
l'exécution du rapport, ce paramètre est automatiquement défini sur l'adresse Web des applications
Dynamics 365 for Customer Engagement.
2. Ajoutez un élément de rapport, tel que Zone de texte .
3. Cliquez avec le bouton droit sur l'élément de rapport d'extraction et sélectionnez Propriétés dans le menu
contextuel.
4. Cliquez sur Avancé .
5. Sous l’onglet Navigation , cliquez sur Accéder à l’URL et entrez une expression au format suivant :
L'entité GUID et le nom logique de l'entité doivent être ajoutés à l'URL pour pouvoir réaliser une extraction.
Exemple :
6. Cliquez sur OK .
Dans cet exemple de code, la valeur d'un champ d'ensemble de données qui contient le GUID d'un objet
Opportunity est convertie en chaîne et utilisée comme paramètre d'ID dans l'URL. Un paramètre qui
contient la valeur LogicalName pour une entité Opportunité est également ajouté.
Le GUID d'un enregistrement peut être obtenu à partir de la vue filtrée appropriée, par exemple,
FilteredOpportunity .
Voir aussi
Guide sur les rapports et analyses
Catégoriser et afficher des rapports dans différentes langues
Catégoriser et afficher des rapports dans différentes
langues
01/11/2019 • 2 minutes to read
Vous pouvez ajouter des langues supplémentaires dans vos applications en activant des modules linguistiques.
Cela vous permet d'afficher le texte de l'interface utilisateur, l'aide et des rapports dans différentes langues. Pour
plus d’informations sur l’activation des modules linguistiques, voir Activation des langues.
Pour classer les rapports par langue, utilisez l'attribut Report.LanguageCode . Vous pouvez paramétrer l'attribut sur
un ID de paramètre régional spécifique (par exemple, 1033 pour l'anglais (États-Unis)) pour rendre le rapport
visible aux utilisateurs de cette langue. Par exemple, le rapport Données de rapport prédéfini en anglais apparaît
dans la grille Rapports de l'interface utilisateur en anglais, mais pas dans les interfaces utilisateur espagnoles ou
allemandes de la même organisation.
Vous pouvez également définir l'attribut Report.LanguageCode sur -1 (moins un) pour rendre le rapport visible par
tous les utilisateurs de l'interface utilisateur en langue de base. Pour plus d’informations sur les valeurs d’ID de
paramètres régionaux, voir MSDN : Valeurs d’ID de paramètres régionaux Microsoft.
Vous pouvez utiliser les informations de langue de rapport en combinaison avec les informations contenues dans
l'entité du rapport, la catégorie de rapport, et les entités de visibilité du rapport pour déterminer les zones et les
catégories de votre application où le rapport est affiché dans différentes langues de l'interface utilisateur.
NOTE
L'élément Language du fichier RDL ne détermine pas où le rapport apparaît dans l'application. Il contient une expression qui
évalue un code de langue comme défini dans la spécification RFC1766 de l'Internet Engineering Task Force (IETF). Le code de
langue est principalement utilisé pour mettre en forme les nombres, dates et heures pour une langue spécifiée. Pour plus
d'informations : MSDN : Élément de langue (rapport) (RDL).
Voir aussi
Guide sur les rapports et analyses
Utilisation de paramètres dans les rapports
Utilisation de paramètres dans les rapports
01/11/2019 • 5 minutes to read
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.
NOTE
La longueur maximale des valeurs de paramètre qui sont transmises depuis les applications Microsoft Dynamics 365
Customer Engagement (on-premises) est de 2 000 caractères. Par exemple, si vous exécutez un rapport et créez un filtre de
données via l'interface utilisateur Recherche avancée , l'expression de filtre en résultant qui est transmise à un paramètre
de filtre ne doit pas dépasser 2 000 caractères. Il n'y a aucune limite maximale au nombre de paramètres que vous pouvez
spécifier. Cependant, il est possible que vous deviez limiter la longueur de la chaîne dans la ligne d'URL et le nombre de
paramètres pour satisfaire les besoins d'un navigateur particulier.
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 .
L'élément <ReportParameter> est un élément dans le fichier de définition de rapport (RDL) utilisé pour décrire un
paramètre individuel du rapport. L'élément <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 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 préfixe CRM_ au nom du paramètre dans un rapport. Par
défaut, les paramètres avec un préfixe CRM_ sont masqués lorsque le rapport est publié. 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.
PA RA M ÈT RE DESC RIP T IO N
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 Customer Engagement (on-premises) 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.
PA RA M ÈT RE DESC RIP T IO N
Voir aussi
Guide sur les rapports et analyses
Publier les rapports
Test et résolution des problèmes des rapports
01/11/2019 • 2 minutes to read
Après avoir créé un rapport, testez-le pour voir s'il produit les résultats escomptés.
Tester un rapport
1. Testez le rapport dans Visual Studio, sous l'onglet Aperçu .
2. Si des erreurs sont rapportées, corrigez l'origine des erreurs, puis réexécutez le test.
3. Lorsque le rapport fonctionne correctement, publiez-le sur le serveur de rapports. Pour ce faire, dans
Customer Engagement (on-premises), accédez à Ventes > Rappor ts . Cliquez sur Nouveau , puis entrez les
informations demandées.
4. Exécutez le rapport publié pour vérifier le fonctionnement du rapport.
CRM_FilterText
CRM_URL
NOTE
Votre rapport peut ne pas contenir tous les paramètres répertoriés ici.
Voir aussi
Guide sur les rapports et analyses
Publier les rapports
Utilisation de paramètres dans les rapports
Création de rapports personnalisés à l'aide de SQL Server Data Tools
Publier les rapports
01/11/2019 • 2 minutes to read
TIP
Pour mettre à jour le rapport ou mettre à jour les informations affichées dans votre application, telles que la
description, dans la liste Rappor ts disponibles , sélectionnez le rapport, puis cliquez sur Modifier dans la barre
de commandes.
Les recommandations suivantes peuvent vous aider à produire des rapports plus faciles à écrire, à vous conformer
aux normes établies, et à les exécuter avec une meilleure efficacité.
Recommandations générales
Cette section contient les meilleures pratiques pour créer des rapports Fetch personnalisés.
Utilisation d'un rapport existant pour créer des rapports personnalisés
Vérifiez s'il existe un rapport existant dans votre application qui soit proche de la conception que vous recherchez.
Téléchargez la définition de ce rapport, puis modifiez le fichier RDL au lieu d'en créer un nouveau entièrement.
Vous économisez ainsi le temps développement et réduisez les erreurs de rédaction de rapports.
Utilisation des formats Customer Engagement (on-premises) pour les devises, nombres, dates et heures et le
calendrier
La vue FilteredUserSettings contient des informations relatives aux formats des devises, de la date et de l'heure,
des nombres, des nombres négatifs, et du premier jour de la semaine, des calendriers, et à tout autre format.
Customer Engagement (on-premises) fournit la fonction de la base de données fn_GetFormatStrings pour
obtenir les formats de date, heure, nombres, devises, et calendriers à partir de la vue FilteredUserSettings .
Utilisez ces ressources pour mettre correctement en forme les valeurs des données dans vos rapports.
Définition de la taille de la page
Reporting Services ne comporte pas d'orientation de page explicite, tel que les modes Portrait et Paysage, ni de
tailles de page prédéfinies. Les rapports standard ont été conçus pour des tailles de page 21,6 × 27,9 cm (portrait)
ou 27,9 x 21,6 cm (paysage) qui fonctionnent pour les format Lettre US et A4.
Sauvegarde de vos rapports
Réalisez des copies de sauvegarde de vos rapports et enregistrez-les sur un ordinateur différent de celui du
serveur de rapports.
Définition de la troncation si nécessaire
L'habillage du texte est le comportement par défaut pour un élément de rapport de zone de texte dans Reporting
Services. Cela signifie que, sauf mention contraire, le texte sera habillé à la largeur définie de toute zone de texte
puis se développera verticalement. Si une troncation est spécifiée, une zone de texte tronquera du texte au niveau
de la largeur de la zone de texte dans les marges spécifiées (2 points à gauche et droite par défaut). Toute
troncation de longueur maximale au delà de ces spécifications nécessitera un codage personnalisé.
Les rapports standard sont configurés avec des info-bulles pour présenter le texte ou les valeurs statiques
provenant de champs de données lorsque l'utilisateur passe le pointeur de la souris sur l'élément de rapport. Si
vous utilisez une troncation, songez à définir la propriété ToolTip sur la valeur du champ pour que la totalité du
texte paraisse lorsque l'utilisateur passe le curseur sur le texte tronqué.
Meilleures pratiques lorsque vous créez des rapports qui contiennent les champs de date et heure
Lorsque vous créez des rapports qui utilisent des champs de date et heure, tenez compte de ce qui suit :
Pour être compatible avec les valeurs de date et d'heure dans Customer Engagement (on-premises), lorsque
vous créez des rapports qui utilisent un champ UTC (Coordinated Universal Time) (Sans fuseau horaire ou
Date uniquement), ne convertissez pas la valeur en une valeur (Heure locale de l'utilisateur) basée sur le
fuseau horaire régional.
Si vous modifiez le comportement de date et heure d'un champ dans une entité, vous devrez peut-être
régénérer les rapports qui utilisent cette date et heure pour que le rapport affiche le champ correctement.
Régénérez les rapports de l'Assistant Rapport. Modifiez le rapport à l'aide de l'Assistant Rapport avec
les mêmes paramètres pour régénérer le rapport.
Régénérez les rapports reposant sur une solution gérée. Pour les solutions gérées, au lieu de modifier
le rapport, réimportez la solution pour régénérer le rapport.
Régénérez les rapports personnalisés créés avec Visual Studio. Mettez à jour les champs de date et
heure dans Visual Studio selon les besoins et republiez le rapport.
Pour plus d'informations sur les champs de date et d'heure, voir Comportement du type de données Date et
Heure.
Voir aussi
Guide sur les rapports et analyses
Amélioration des performances des rapports
Amélioration des performances des rapports
01/11/2019 • 2 minutes to read
Voici des instructions qui vous permettent d'améliorer les performances du rapport.
Général
Ces instructions s'appliquent aux rapports Fetch.
Limitez un rapport pour afficher les informations relatives à une période spécifiée, au lieu d'afficher tous les
enregistrements dans la base de données des applications.
Préfiltrez un rapport afin que l'ensemble de données soit limité.
Calculez les totaux globaux à l'aide d'agrégations dans une requête FetchXML, au lieu de transmettre les
données brutes à Reporting Services et au groupement.
Limitez le nombre d'ensembles de données utilisés, si possible.
Lorsque vous comparez des dates, utilisez les champs de date UTC pour effectuer des comparaisons. Par
exemple, comparez les champs createdonutc et non les champs createdon dans la requête FetchXML ou
une vue filtrée.
Voir aussi
Guide sur les rapports et analyses
Améliorer les performances des rapports à l’aide de filtres
Améliorer les performances des rapports à l’aide de
filtres
01/11/2019 • 3 minutes to read
Les rapports qui renvoient de grands ensembles de données peuvent être difficiles à utiliser et peuvent entraîner
des problèmes de performances. Pour limiter les données présentées dans un rapport, appliquez des filtres de
données.
En plus du filtrage des données pris en charge par Reporting Services, Microsoft Dynamics 365 Customer
Engagement (on-premises) prend en charge le préfiltrage des données. Vous pouvez utiliser le préfiltrage des
données pour :
Rendre les rapports contextuels en réduisant l'étendue d'un rapport pour retourner des données plus
pertinentes ;
Extraire et afficher un ensemble de résultats plus rapidement car seules les données les plus pertinentes
sont renvoyées ;
Autoriser le filtrage du rapport à l'aide de la fonctionnalité Recherche avancée .
IMPORTANT
Actuellement, les requêtes de rapport contenant des opérateurs hiérarchiques, comme l’opérateur Under , ne peuvent pas
être utilisées avec le filtrage de rapport. Lorsque vous essayez d’exécuter un rapport qui utilise un opérateur hiérarchique,
celui-ci ne s’affiche pas.
<CommandText
<fetch distinct="false" mapping="logical">
<entity name="account" enableprefiltering="1" prefilterparametername="CRM_FilteredAccount">
<attribute name="name" />
<attribute name="accountid" />
</entity>
</fetch>
</CommandText>
<DataSourceName>CRM</DataSourceName>
De même, vous pouvez activer le préfiltrage pour l'entité liée. Vous pouvez spécifier une autre condition de
préfiltrage pour l'entité liée dans la requête FetchXML en spécifiant un nom différent et unique pour le nom du
paramètre dans la propriété prefilterparametername .
Si vous modifiez manuellement une définition de rapport Fetch sans utiliser l'Assistant Rapport ou SQL Server
Data Tools pour activer le préfiltrage pour les entités principales et liées, veillez à :
1. De même, vous pouvez activer le préfiltrage pour l'entité liée. Vous pouvez spécifier une autre condition de
préfiltrage pour l'entité liée dans la requête FetchXML en spécifiant un nom différent et unique pour le nom
du paramètre dans la propriété prefilterparametername .
Si vous modifiez manuellement une définition de rapport Fetch sans utiliser l'Assistant Rapport ou SQL
Server Data Tools pour activer le préfiltrage pour les entités principales et liées, veillez à :
2. Créez un paramètre de requête correspondant avec le même nom que celui spécifié pour la propriété
prefilterparametername . Assurez-vous que le nom du paramètre commence par CRM_ pour être spécifié
comme paramètre masqué.
<QueryParameters>
<QueryParameter Name="CRM_FilteredAccount">
<Value>=Parameters!CRM_FilteredAccount.Value</Value>
</QueryParameter>
<ReportParameters>
<ReportParameter Name="CRM_FilteredAccount">
<DataType>String</DataType>
<Prompt>CRM Filtered Account</Prompt>
</ReportParameter>
</ReportParameters>
Lors de l'exécution du rapport, la valeur du paramètre CRM_FilterText sera définie par le système sur le
texte du filtre actif.
Cette section contient des exemples de rapports montrant comment implémenter des techniques courantes dans
vos rapports.
Les rapports graphiques sont limités à 15 points de données. L'ensemble de données doit limiter l'ensemble de
résultats aux 15 premières lignes pour la valeur du graphique. En outre, une 16e « autre » valeur de point de
données est facultative. Cette valeur représente un regroupement de toutes les lignes du domaine. La 16e valeur
est toujours en bas de l'ensemble de résultats. Cela ajoute un niveau de complexité aux rapports contenant une
fonctionnalité d’extraction appropriée pour certains rapports.
NOTE
Le nombre de points de données et de longueur d'intitulé peut devoir être réduit pour afficher correctement le contenu du
graphique.
Exemple
L'exemple suivant montre comment limiter le nombre de points de données répertoriés dans une table à l'aide de
la requête FetchXML. Vous devez fournir deux ensembles de données avec une requête FetchXML par ensemble de
données. Les résultats de la requête du premier jeu de données sont passés via les paramètres à valeurs multiples
au deuxième jeu de données pour filtrer les résultats de la requête. Dataset1 récupère les 15 premiers
enregistrements classés par le revenu et Dataset2 récupère le « TotalRevenue » en agrégeant tous les comptes sauf
les comptes de DataSet1.
DataSet1:
<fetch count="15">
<entity name="account" >
<attribute name="accountid" />
<attribute name="name" />
<attribute name="revenue" />
<order attribute="revenue" descending="true" />
</entity>
</fetch>
DataSet2:
<fetch aggregate="true">
<entity name="account">
<attribute name="revenue" aggregate="sum" alias="TotalRevenue" />
<filter>
<condition attribute="accountid" operator="not-in" value="@TopAccountIds"/>
</filter>
</entity>
</fetch>
Report Parameter:
Voir aussi
Exemples de rapports
Exemple : Affichage des X premières valeurs
Guide sur les rapports et analyses
Exemple : Affichage des X premières valeurs
01/11/2019 • 2 minutes to read
Microsoft Dynamics 365 Customer Engagement (on-premises) inclut des rapports qui affichent les X premiers
articles d’une entité, où l’utilisateur peut spécifier la valeur de X .
Pour rechercher les premiers éléments, utilisez une instruction SQL dynamique. Attribuez la chaîne de requête SQL
qui inclut le paramètre défini par l'utilisateur à une variable. Cela résout le paramètre défini par l'utilisateur. La
chaîne de requête est ensuite transmise à la fonction SQL EXEC ainsi qu’au paramètre défini par l’utilisateur.
Exemple
Si vous créez un rapport FetchXML, la requête FetchXML correspondante se présente comme suit :
<fetch count="@TopCount">
<entity name="kbarticle" enableprefiltering="true" prefilterparametername="CRM_FilteredKbArticle" >
<attribute name="kbarticleid"/>
</entity>
</fetch>
Voir aussi
Création de rapports personnalisés à l'aide de SQL Server Data Tools
Exemples de rapports
Exemple : Rendre un rapport contextuel
Exemple : Rendre un rapport contextuel
01/11/2019 • 2 minutes to read
<fetch>
<entity name="activitypointer" enableprefiltering="1" >
<attribute name="activitytypecode" />
<attribute name="regardingobjectid" />
<attribute name="subject" alias="subject" />
<link-entity name="account" from="accountid" to="regardingobjectid" link-type='inner'
alias="accountLink">
<attribute name="name" alias="name" />
</link-entity>
</entity>
</fetch>
3. Si vous téléchargez le rapport via le formulaire Rappor t : Nouveau , sélectionnez toutes les entités dans la
catégorisation Types d'enregistrements associés auxquelles les vues filtrées font référence dans le code
SQL du rapport.
4. Dans le champ Afficher dans , choisissez Formulaires des types d’enregistrements associés ou
Listes des types d’enregistrements associés . La sélection des listes des types d'enregistrements
associés vous permet d'exécuter un rapport dans la grille de liste d'entités. La sélection des Formulaires
des types d’enregistrements associés vous permet d'exécuter un rapport depuis le formulaire d'entité.
Voir aussi
Exemples de rapports
Guide sur les rapports et analyses