Partager via

Créer un rapport à l’aide de SQL Server Data Tools

  • Article

SQL Server Data Tools est un environnement de création de rapports qui 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 rejette un rapport si la définition est non valide lorsque vous essayez de charger le rapport.

Note

Si le fichier .rdl contient une requête FetchXML, celle du RDL est validée par l'extension de création de rapports Microsoft Dynamics CRM 2016, qui la valide en interne par rapport au schéma FetchXML.

Création un rapport Fetch personnalisé

Pour créer un rapport Fetch personnalisé :

  1. Vérifiez que vous disposez d’une version prise en charge de Visual Studio, de SQL Server Data Tools, de l’extension de création de rapport de Microsoft Dynamics CRM 2016 et des privilèges nécessaires. Pour plus d’informations : Environnement de création de rapports avec SQL Server Data Tools

  2. Ouvrez Visual Studio, puis créez un projet Report Server.

  3. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le dossier Rapports, puis cliquez sur Ajouter un rapport.

  4. Sélectionnez Suivant.

  5. Sur la page Sélectionner la source de données, cliquez sur Nouvelle source de données, puis spécifiez les détails suivants :

    • Nom : Tapez un nom pour la source de données.

    • Type : Sélectionnez Microsoft Dynamics 365 Fetch.

    • Chaîne de connexion : Spécifiez la chaîne de connexion. La chaîne de connexion doit être spécifiée au format suivant :

      ServerURL;OrganizationName;HomeRealmURL

      Seul le paramètre ServerURL est obligatoire dans cette chaîne de connexion. Si OrganizationName n’est pas spécifié, la première organisation à laquelle appartient l’utilisateur exécutant cette requête est utilisée. HomeRealmURL représente l’URL d’accueil de domaine du fournisseur d’identité utilisé par votre organisation et est nécessaire si votre organisation utilise la fédération pour la gestion des entités. Contactez votre administrateur réseau pour déterminer l’URL d’accueil de domaine.

      Sélectionnez Identifiants pour spécifier les informations d’identification permettant de se connecter aux applications Dynamics 365 for Customer Engagement ou aux applications Dynamics 365 for Customer Engagement, puis sélectionnez Suivant.

  6. Dans la page Créer la requête, tapez la requête FetchXML dans la zone Requête. Pour obtenir cette requête, vous pouvez :

    • Obtenez la requête FetchXML à partir d’une requête Recherche avancée. Pour ce faire, ouvrez une application Customer Engagement (on-premises), cliquez sur Recherche avancée, créez la requête souhaitée, puis sous l'onglet Recherche avancée, cliquez sur Télécharger FetchXML. Copiez la requête FetchXML dans la zone Requête des propriétés d’ensemble de données dans Visual Studio.

    • Entrez manuellement la requête de FetchXML. L’exemple suivant explique comment créer un rapport qui affiche tous les comptes de 5 000 employés ou plus.

      <fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">  
  <entity name="account">  
    <attribute name="name" />      
    <attribute name="numberofemployees" />  
    <attribute name="accountnumber" />  
    <order attribute="name" descending="false" />  
    <filter type="and">  
      <condition attribute="numberofemployees" operator="gt" value="5000" />  
    </filter>  
  </entity>  
</fetch>

    Sélectionnez Suivant.

  7. Vérifiez les champs qui seront inclus au rapport, puis cliquez sur Suivant.

    • L’extension de création de rapports ajoute des champs supplémentaires en fonction du type de données. Les nombres, les dates, les recherches et les ensembles d’options ont un champ fieldNameValeur supplémentaire. Par exemple, si FetchXML inclut l’attribut createdon, deux champs sont disponibles : createdon et createdonValue.
      • fieldName (exemple : createdon)
        • Ce champ est une chaîne formatée selon les paramètres de format de l’utilisateur. Il est destiné à être affiché uniquement. La conversion de la valeur dans son type de données d’origine peut entraîner une erreur. Par exemple, une expression telle que =CDate(Fields!createdon.Value) peut échouer ou donner une date incorrecte si le format de date ne correspond pas aux paramètres régionaux du serveur de rapports.
        • Pour les champs de jeu d’options, la valeur est le texte affiché de la valeur du jeu d’options.
        • Pour les champs de recherche, la valeur est le champ de nom principal de l’enregistrement lié.
      • fieldNameValeur (exemple : createdonValue)
        • Ce champ est la valeur brute non formatée du champ en fonction du type de données. Les champs peuvent être ajustés et formatés pour un affichage spécifique à l’utilisateur à l’aide des paramètres de format CRM_ masqués.
        • Pour les champs datetime, il s’agit de la valeur UTC.
        • Pour les champs numériques ou monétaires, il s’agit de la valeur numérique non formatée.
        • Pour les champs d’ensemble d’options, il s’agit de la valeur du numéro d’option.
        • Pour les champs de recherche, il s’agit du Guid du champ de recherche.

  8. Sélectionnez un style à appliquer au rapport, puis cliquez sur Suivant.

  9. Vérifiez les champs qui seront inclus au rapport, puis entrez le nom du rapport, par exemple Comptes de plus de 5 000 employés. Cliquez sur Terminer.

  10. Pour visualiser la forme sous laquelle le rapport apparaîtra lorsqu'il sera exécuté, cliquez sur l'onglet Aperçu.

    Cela génère un fichier .rdl portant le nom de rapport spécifié. Vous pouvez utiliser ce fichier pour publier votre rapport personnalisé dans les applications Dynamics 365 for Customer Engagement à l’aide de l’Assistant Rapport. Plus d’informations : Publier des rapports

Voir aussi

Environnement de rédaction de rapports