Personnaliser les packs de contenu Power BI de Microsoft Dynamics 365
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics CRM Online
Microsoft Power BI est un ensemble complet de services et d'outils permettant de visualiser vos données d'entreprise. Les packs de contenu sont disponibles pour faciliter la visualisation et l'analyse des données Dynamics 365 avec Power BI selon un modèle de données standard. Les packs de contenu sont créés avec un ensemble d'entités et de champs Dynamics 365 qui sont utiles pour la plupart des scénarios de création de rapports pour la vente, les services ou le marketing.
Les instances de Dynamics 365 sont souvent étendues avec des champs personnalisés. Ces champs personnalisés n'apparaissent pas automatiquement dans le modèle Power BI. Cette rubrique décrit les différentes façons de modifier ou d'étendre les rapports inclus dans un pack de contenu pour inclure des champs personnalisés dans le modèle Power BI.
Contenu de la rubrique
Tâches à effectuer avant de personnaliser un pack de contenu Dynamics 365 pour les rapports Power BI
Personnaliser un pack de contenu Dynamics 365
Publier votre rapport dans le service Power BI
Tâches à effectuer avant de personnaliser un pack de contenu Dynamics 365 pour les rapports Power BI
Avant de personnaliser un pack de contenu, lisez les informations affichées ici et effectuez chaque tâche si nécessaire.
Configuration requise
Application Power BI Desktop pour modifier les rapports Power BI.
Fichier PBIX pour le pack de contenu à personnaliser.
Les packs de contenu Dynamics 365 (en ligne) ne sont actuellement pris en charge qu'en anglais américain.
Préparer un pack de contenu pour la personnalisation
Important
Pour connecter le flux OData à votre instance de Dynamics 365 (en ligne), vous devez suivre les étapes décrites ici avant de personnaliser le pack de contenu.
Démarrez Power BI Desktop.
Cliquez sur Fichier > Ouvrir, ouvrez un pack de contenu, tel que Sales Manager.bpix, puis cliquez sur Ouvrir.
Plusieurs pages de rapports dans le pack de contenu sont chargées et affichées dans Power BI Desktop.
Sur le ruban Power BI Desktop, cliquez sur Modifier les requêtes.
Dans le volet de navigation de gauche de la fenêtre Modifier les requêtes, sous Requêtes, cliquez sur la requête CRMServiceUrl, puis sur Éditeur avancé sur le ruban. Dans la définition source, remplacez base.crm.dynamics.com par l'URL de votre instance Dynamics 365 (en ligne). Par exemple, si le nom de l'organisation est Contoso, l'URL se présente comme suit :
Source = « https://contoso.crm.dynamics.com/api/data/v8.0/ »
Cliquez sur Terminé, puis sur Fermer et appliquer dans l'éditeur de requête.
Lorsque la boîte de dialogue Accéder à un flux OData s'affiche, cliquez sur Compte d'organisation, puis sur Se connecter.
Lorsque la page de connexion s'affiche, entrez vos informations d'identification pour vous authentifier auprès de votre instance de Dynamics 365 (en ligne).
Dans la boîte de dialogue Accéder à un flux Odata, cliquez sur Se connecter.
Les requêtes du pack de contenu sont mises à jour. Cette opération peut prendre plusieurs minutes.
Personnaliser un pack de contenu Dynamics 365
Convertir un champ Date/Heure en champ Date pour la création de rapports
Ajouter un champ personnalisé à un rapport
Ajouter un champ personnalisé à un rapport pour l'entité Compte
Ajouter un champ de groupe d'options personnalisé à un rapport
Augmenter le nombre de lignes faisant l'objet d'une requête
Convertir un champ Date/Heure en champ Date pour la création de rapports
Dans Microsoft Dynamics 365, certaines dates sont enregistrées au format Date/Heure/Fuseau horaire, qui n'est peut-être pas le format préféré pour regrouper des données dans un rapport. Vous pouvez convertir la date affichée dans les rapports pour un champ d'entité. Par exemple, le champ Date de création de l'opportunité peut être converti en une date indiquant les opportunités créées par jour.
Dans Power BI Desktop, cliquez sur Modifier les requêtes.
Dans le volet de navigation de gauche de l'éditeur de requête, sous Requêtes, cliquez sur la requête contenant le champ de date à modifier, par exemple Date de fermeture estimée dans la requête d'entité Opportunité.
Cliquez avec le bouton droit sur l'en-tête de colonne, par exemple Date de fermeture estimée, pointez sur Modifier le type, puis sélectionnez un autre type de date, par exemple Date.
Cliquez sur Fermer et appliquer pour fermer l'éditeur de requête.
Dans la page principale de Power BI, cliquez sur Appliquer les modifications pour mettre à jour les rapports associés.
Ajouter un champ personnalisé à un rapport
La procédure suivante explique comment ajouter un champ personnalisé représentant une date, une chaîne ou un nombre à un rapport pour toutes les entités disponibles à l'exception de l'entité Compte.
Notes
Pour ajouter un champ à l'entité Compte, voir Ajouter un champ personnalisé à un rapport pour l'entité Compte. Pour ajouter un champ représentant un type de groupe d'options, voir Ajouter un champ de groupe d'options personnalisé à un rapport.
Dans Power BI Desktop, cliquez sur Modifier les requêtes.
Dans le volet de navigation de gauche de l'éditeur de requête, sous Requêtes, cliquez sur la requête contenant le champ personnalisé à rendre disponible pour les rapports, par exemple la requête d'entité Opportunité.
Dans le volet de droite, sous ÉTAPES APPLIQUÉES, cliquez sur le bouton de paramètres en regard de Autres colonnes supprimées.
La liste Choisir des colonnes affiche tous les champs de l'entité, notamment les champs personnalisés. Sélectionnez le champ personnalisé de votre choix, puis cliquez sur OK.
La requête d'entité est mise à jour et une colonne est ajoutée à la table d'entités pour le champ personnalisé que vous avez sélectionné.
Dans le volet de droite, sous ÉTAPES APPLIQUÉES, cliquez sur Lang – Colonnes renommées, puis sur Éditeur avancé pour ajouter le mappage du champ à la requête d'entité. Par exemple, si le nom du champ personnalisé pour l'entité Opportunité est int_forecast et le nom complet est Prévision, l'entrée doit se présenter comme suit.
{"int_forecast","Forecast"}
Après avoir ajouté votre mappage de champ, vérifiez qu'aucune erreur de syntaxe ne s'affiche au bas de l'éditeur avancé. Vérifiez également que le nom du champ s'affiche tel qu'il apparaît dans l'en-tête de colonne, notamment la casse correcte des lettres. Si aucune erreur de syntaxe ou de table n'est détectée, cliquez sur Terminé.
Cliquez sur Fermer et appliquer dans l'éditeur de requête.
Le champ personnalisé est maintenant disponible dans le volet de droite sous Champs pour l'entité et peut être ajouté aux rapports nouveaux ou existants.
Ajouter un champ personnalisé à un rapport pour l'entité Compte
Comme la requête Compte utilise Fetch XML pour filtrer la requête, les étapes pour ajouter un champ sont différentes des autres requêtes d'entité qui utilisent OData. Pour ajouter un champ personnalisé aux entités OData, voir Ajouter un champ personnalisé à un rapport.
Copiez la requête Fetch XML codée pour l'entité Compte. Pour ce faire, procédez comme suit :
Dans Power BI Desktop, cliquez sur Modifier les requêtes.
Dans le volet de navigation de gauche de l'éditeur de requête, sous Requêtes, cliquez sur la requête d'entité Compte, puis sur Éditeur avancé sur le ruban.
À partir de la première ligne commençant par %3Cfetch et se terminant par fetch%3E, copiez l'intégralité de la requête Fetch XML codée.
La requête Fetch XML codée que vous copiez doit se présenter comme suit :
%3Cfetch%20version%3D%221.0%22%20output-format%3D%22xml-platform%22%20mapping%3D%22logical%22%20distinct%3D%22true%22%3E%3Centity%20name%3D%22account%22%3E%3Cattribute%20name%3D%22territorycode%22%20%2F%3E%3Cattribute%20name%3D%22customersizecode%22%20%2F%3E%3Cattribute%20name%3D%22owningbusinessunit%22%20%2F%3E%3Cattribute%20name%3D%22ownerid%22%20%2F%3E%3Cattribute%20name%3D%22originatingleadid%22%20%2F%3E%3Cattribute%20name%3D%22revenue%22%20%2F%3E%3Cattribute%20name%3D%22sic%22%20%2F%3E%3Cattribute%20name%3D%22marketcap%22%20%2F%3E%20%3Cattribute%20name%3D%22parentaccountid%22%20%2F%3E%3Cattribute%20name%3D%22owninguser%22%20%2F%3E%3Cattribute%20name%3D%22accountcategorycode%22%20%2F%3E%3Cattribute%20name%3D%22marketcap\_base%22%20%2F%3E%3Cattribute%20name%3D%22customertypecode%22%20%2F%3E%3Cattribute%20name%3D%22address1\_postalcode%22%20%2F%3E%3Cattribute%20name%3D%22numberofemployees%22%20%2F%3E%3Cattribute%20name%3D%22accountratingcode%22%20%2F%3E%3Cattribute%20name%3D%22address1\_longitude%22%20%2F%3E%3Cattribute%20name%3D%22revenue\_base%22%20%2F%3E%3Cattribute%20name%3D%22createdon%22%20%2F%3E%3Cattribute%20name%3D%22name%22%20%2F%3E%3Cattribute%20name%3D%22address1\_stateorprovince%22%20%2F%3E%3Cattribute%20name%3D%22territoryid%22%20%2F%3E%3Cattribute%20name%3D%22accountclassificationcode%22%20%2F%3E%3Cattribute%20name%3D%22businesstypecode%22%20%2F%3E%3Cattribute%20name%3D%22address1\_country%22%20%2F%3E%3Cattribute%20name%3D%22accountid%22%20%2F%3E%3Cattribute%20name%3D%22address1\_latitude%22%20%2F%3E%3Cattribute%20name%3D%22modifiedon%22%20%2F%3E%3Cattribute%20name%3D%22industrycode%22%20%2F%3E%3Clink-entity%20name%3D%22opportunity%22%20from%3D%22parentaccountid%22%20to%3D%22accountid%22%20alias%3D%22ab%22%3E%3Cfilter%20type%3D%22and%22%3E%3Ccondition%20attribute%3D%22opportunityid%22%20operator%3D%22not-null%22%20%2F%3E%3Ccondition%20attribute%3D%22modifiedon%22%20operator%3D%22last-x-days%22%20value%3D%22365%22%20%2F%3E%3C%2Ffilter%3E%3C%2Flink-entity%3E%3C%2Fentity%3E%3C%2Ffetch%3E
Décodez la requête Fetch XML codée. La requête Fetch XML codée doit être valide et se présenter comme suit une fois décodée :
\<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="true"\> \<entity name="account"\> \<attribute name="territorycode" /\> \<attribute name="customersizecode" /\> \<attribute name="owningbusinessunit" /\> \<attribute name="ownerid" /\> \<attribute name="originatingleadid" /\> \<attribute name="revenue" /\> \<attribute name="sic" /\> \<attribute name="marketcap" /\> \<attribute name="parentaccountid" /\> \<attribute name="owninguser" /\> \<attribute name="accountcategorycode" /\> \<attribute name="marketcap\_base" /\> \<attribute name="customertypecode" /\> \<attribute name="address1\_postalcode" /\> \<attribute name="numberofemployees" /\> \<attribute name="accountratingcode" /\> \<attribute name="address1\_longitude" /\> \<attribute name="revenue\_base" /\> \<attribute name="createdon" /\> \<attribute name="name" /\> \<attribute name="address1\_stateorprovince" /\> \<attribute name="territoryid" /\> \<attribute name="accountclassificationcode" /\> \<attribute name="businesstypecode" /\> \<attribute name="address1\_country" /\> \<attribute name="accountid" /\> \<attribute name="address1\_latitude" /\> \<attribute name="modifiedon" /\> \<attribute name="industrycode" /\> \<link-entity name="opportunity" from="parentaccountid" to="accountid" alias="ab"\> \<filter type="and"\> \<condition attribute="opportunityid" operator="not-null" /\> \<condition attribute="modifiedon" operator="last-x-days" value="365" /\> \</filter\> \</link-entity\> \</entity\> \</fetch\>
Conseil
De nombreux outils de codage et de décodage d'URL sont disponibles gratuitement sur le Web.
Dans la requête Fetch XML, ajoutez votre entité personnalisée en tant que nœud d'attribut entre les nœuds <entité>. Par exemple, pour ajouter un champ personnalisé nommé customclassificationcode, ajoutez le nœud après un autre nœud d'attribut, par exemple industrycode.
<attribute name="industrycode" /> <attribute name=" customclassificationcode "/> <link-entity name="opportunity" from="parentaccountid" to="accountid" alias="ab">
L'URL code la requête Fetch XML mise à jour. La requête Fetch XML incluant le nouvel attribut personnalisé doit être codée et utilisée pour remplacer la requête de flux OData existante incluse dans le pack de contenu. Pour ce faire, copiez la requête FetchXML mise à jour dans le Presse-papiers, puis collez-la dans un encodeur d'URL.
Collez l'URL Fetch XML codée dans le flux OData. Pour ce faire, collez l'URL codée entre guillemets après le texte Query= [fetchXml= pour remplacer la requête FetchXML codée existante, puis cliquez sur Terminé.
La capture d'écran ci-dessous indique l'emplacement du guillemet à l'extrémité gauche.
Dans le volet de droite, sous ÉTAPES APPLIQUÉES, cliquez sur le bouton de paramètres en regard de Autres colonnes supprimées.
La liste Choisir des colonnes affiche tous les champs de l'entité, notamment les champs personnalisés. Sélectionnez le champ personnalisé, par exemple customclassificationcode, que vous avez précédemment ajouté à la requête Fetch XML, puis cliquez sur OK.
Notes
Le nom de champ que vous sélectionnez dans la liste de sélection de colonne et le nom de champ que vous ajoutez à la requête FetchXML doivent correspondre.
La requête d'entité est mise à jour et une colonne est ajoutée à la table d'entités pour le champ personnalisé que vous avez sélectionné.
Cliquez sur Fermer et appliquer dans l'éditeur de requête.
Le champ personnalisé est maintenant disponible dans le volet de droite sous Champs pour l'entité et peut être ajouté aux rapports nouveaux ou existants.
Ajouter un champ de groupe d'options personnalisé à un rapport
Les champs de groupe d'options vous permettent de choisir parmi plusieurs valeurs. Parmi les exemples de champs de groupe d'options prêts à l'emploi, on peut citer les champs Évaluation et Phase de vente pour une opportunité. Imaginez que le formulaire principal Opportunité contienne un champ de groupe d'options personnalisé avec les valeurs et les étiquettes suivantes.
Pour ajouter le champ de groupe d'options personnalisé à un rapport, procédez comme suit.
Ajoutez la colonne du champ personnalisé.
Dans le volet de navigation de gauche de l'éditeur de requête, sous Requêtes, cliquez sur l'entité contenant le groupe d'options personnalisé associé, par exemple l'entité Opportunité.
Dans le volet de droite, sous ÉTAPES APPLIQUÉES, cliquez sur le bouton de paramètres en regard de Autres colonnes supprimées.
La liste Choisir des colonnes affiche tous les champs de l'entité, notamment les champs personnalisés. Sélectionnez le champ personnalisé, par exemple new_customoptionset, puis cliquez sur OK.
Cliquez sur Enregistrer, puis lorsque vous y êtes invité, cliquez sur Appliquer.
La colonne du champ personnalisé apparaît dans la table d'entités.
Créez la requête de groupe d'options.
Dans Power BI Desktop, cliquez sur Modifier les requêtes.
Dans le volet de navigation de gauche de l'éditeur de requête, sous Requêtes, cliquez sur la requête présente sous le groupe Créer des tables contenant le champ de groupe d'options qui ressemble le plus au groupe d'options que vous voulez ajouter à un rapport. Pour cet exemple, la requête SalesStageOptionSet contient quatre options qui conviennent.
Cliquez sur Éditeur avancé.
La requête de groupe d'options s'affiche.
Copiez l'intégralité de la requête dans le Presse-papiers. Vous pouvez la coller dans un éditeur de texte, tel que le Bloc-notes, pour une référence ultérieure.
Dans l'éditeur de requête, cliquez avec le bouton droit sur le groupe Créer des tables, cliquez sur Nouvelle requête, puis sur Requête vide.
Dans le volet de droite, sous Nom, entrez un nom, par exemple CustomOptionSet, puis appuyez sur Entrée.
Cliquez sur Éditeur avancé.
Dans l'éditeur avancé, collez la requête que vous avez copiée précédemment.
Remplacez les valeurs et options existantes par vos valeurs et options personnalisées. Dans cet exemple, vous remplacez :
let Source = #table({"Value","Option"},{{0,"Qualify"},{1,"Develop"},{2,"Propose"},{3,"Close"}}) in Source
Par :
let Source = #table({"Value","Option"},{{0,"A"},{1,"B"},{2,"C"},{3,"D"},{4,"E"}}) in Source
Vérifiez qu'aucune erreur de syntaxe ne s'affiche, puis cliquez sur Terminé pour fermer l'éditeur avancé. La table des valeurs et des options apparaît dans l'éditeur de requête.
Cliquez sur Enregistrer, puis lorsque vous y êtes invité, cliquez sur Appliquer.
Insérez une requête de fusion pour les tables d'entités et de groupes d'options personnalisés.
Dans le volet gauche de l'éditeur de requête, sous Entités, cliquez sur l'entité contenant le groupe d'options personnalisé. Pour cet exemple, la requête d'entité Opportunité est sélectionnée.
Sur le ruban, cliquez sur Fusionner les requêtes et, lorsque vous êtes invité à insérer une étape, cliquez sur Insérer.
Dans la boîte de dialogue Fusionner, cliquez sur l'en-tête de colonne du groupe d'options personnalisé, par exemple new_optionset. Dans la liste déroulante, sélectionnez la requête de groupe d'options correspondante que vous avez créée précédemment. Lorsque la table des groupes d'options s'affiche, cliquez sur l'en-tête de colonne Valeur pour le sélectionner.
Définissez le type de jointure sur Externe gauche (tous les enregistrements de la première table, correspondance à partir de la deuxième table), puis cliquez sur OK.
Conseil
Renommez la requête fusionnée. Sous ÉTAPES APPLIQUÉES, cliquez avec le bouton droit sur la requête fusionnée que vous avez créée, cliquez sur Renommer, puis entrez un nom descriptif, par exemple Fusionner CustomOptionSet.
Définissez la colonne de telle sorte que seules les étiquettes s'affichent.
Dans le volet gauche de l'éditeur de requête, sous Entités, cliquez sur l'entité contenant le groupe d'options personnalisé. Pour cet exemple, la requête d'entité Opportunité est sélectionnée.
Dans le volet de droite, sous ÉTAPES APPLIQUÉES, cliquez sur l'une des requêtes développées pour faire apparaître les colonnes fusionnées, par exemple SalesStage fusionné.
Recherchez et cliquez sur l'en-tête de la nouvelle colonne créée dans le cadre de la précédente étape de requête fusionnée.
Sous l'onglet Transformer, cliquez sur Développer.
Dans la boîte de dialogue Développer la nouvelle colonne, désactivez la colonne correspondant aux valeurs (car seules les étiquettes doivent figurer dans la colonne). Cliquez sur Terminé.
Cliquez sur Enregistrer, puis lorsque vous y êtes invité, cliquez sur Appliquer.
Modifiez le nom de la colonne pour la création de rapports.
Dans le volet gauche de l'éditeur de requête, sous Entités, cliquez sur l'entité contenant le groupe d'options personnalisé. Pour cet exemple, la requête d'entité Opportunité est sélectionnée.
Cliquez sur Éditeur avancé.
Ajoutez une ligne de colonne renommée, vérifiez qu'aucune erreur de syntaxe ne s'affiche, puis cliquez sur Terminé. Dans cet exemple, le nom de colonne du groupe d'options personnalisé que vous avez créé précédemment est NewColumn qui est renommé Groupe d'options personnalisé.
Cliquez sur Enregistrer, puis lorsque vous y êtes invité, cliquez sur Appliquer.
Cliquez sur Fermer et appliquer pour fermer l'éditeur de requête.
Le groupe d'options personnalisé peut maintenant être utilisé pour créer des rapports Power BI.
Augmenter le nombre de lignes faisant l'objet d'une requête
Par défaut, toutes les requêtes d'entité Power BI des packs de contenu Microsoft Dynamics 365 ne peuvent pas dépasser 100 000 lignes. Pour augmenter le nombre de lignes pouvant faire l'objet d'une requête, procédez comme suit.
Important
L'augmentation du nombre autorisé de lignes peut avoir un impact important sur la durée d'actualisation d'un rapport. En outre, le service Power BI a une limite de 30 minutes pour l'exécution des requêtes. Faites preuve de prudence lorsque vous augmentez le nombre autorisé de lignes.
Dans Power BI Desktop, cliquez sur Modifier les requêtes.
Dans le volet de navigation de gauche de l'éditeur de requête, sous Requêtes, cliquez sur la requête d'entité dont vous voulez augmenter le nombre autorisé de lignes, par exemple l'entité Prospect.
Dans le volet de droite, sous ÉTAPES APPLIQUÉES, cliquez sur Conserver les premières lignes.
Augmentez le nombre de lignes filtrées. Par exemple pour passer à 150 000 lignes, remplacez Table.FirstN(#"Filtered Rows",100001) par Table.FirstN(#"Filtered Rows",150000)
Dans le volet de droite, sous ÉTAPES APPLIQUÉES, cliquez sur Vérifier le nombre de lignes.
Recherchez la partie >100 000 de l'étape.
Augmentez la valeur, par exemple 150 000.
Cliquez sur Fermer et appliquer dans l'éditeur de requête.
Publier votre rapport dans le service Power BI
Publiez votre rapport pour permettre le partage au sein de l'organisation et l'accès depuis n'importe quel emplacement sur la plupart des appareils.
Sur le ruban de l'onglet Accueil de la page principale Power BI Desktop, cliquez sur Publier.
Si vous êtes invité à vous connecter au service Power BI, cliquez sur Se connecter.
Si plusieurs destinations sont disponibles, sélectionnez celle de votre choix, puis cliquez sur Publier.
Voir aussi
Utiliser Power BI avec Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright