Utilisation de SAP BW Connector dans Power BI DesktopUse the SAP BW Connector in Power BI Desktop

Avec Power BI Desktop, vous pouvez accéder aux données SAP BusinessWarehouse (BW).With Power BI Desktop, you can access SAP Business Warehouse (BW) data.

Pour plus d’informations sur comment les clients SAP peuvent tirer profit de la connexion de Power BI à leurs systèmes SAP Business Warehouse (BW) existants, consultez le livre blanc Power BI et SAP BW.For information about how SAP customers can benefit from connecting Power BI to their existing SAP Business Warehouse (BW) systems, see the Power BI and SAP BW whitepaper.

À compter de la version de juin 2018 de Power BI Desktop, vous pouvez utiliser le connecteur SAP BW avec une implémentation qui présente des améliorations significatives au niveau des performances et des fonctionnalités.Starting with the June 2018 release of Power BI Desktop, you can use the SAP BW connector with an implementation that has significant improvements in performance and capabilities. Cette version mise à jour du connecteur SAP BW a été développée par Microsoft et s’appelle Implementation 2.0.This updated version of the SAP BW connector was developed by Microsoft and is called Implementation 2.0. Vous pouvez sélectionner la version 1 (v1) du connecteur SAP BW ou le connecteur SAP Implementation 2.0.You can select either version 1 (v1) of the SAP BW Connector, or the Implementation 2.0 SAP Connector. Les sections suivantes décrivent l’installation de chacune des versions.The following sections describe the installation of each version, in turn. Vous pouvez choisir l’un ou l’autre connecteur quand vous vous connectez à SAP BW à partir de Power BI Desktop.You can choose one or the other connector when connectint to SAP BW from Power BI Desktop.

Nous vous suggérons d’utiliser le connecteur SAP Implementation 2.0 autant que possible.We suggest you use the Implementation 2.0 SAP Connector whenever possible.

Installation de la version 1 du connecteur SAP BWInstallation of version 1 of the SAP BW Connector

Nous recommandons d’utiliser le connecteur SAP Implementation 2.0 autant que possible (voir les instructions dans la section suivante).We recommend using the Implementation 2.0 SAP Connector whenever possible (see instructions in the following section). Cette section décrit l’installation de la version 1 du connecteur SAP BW, que vous pouvez installer en effectuant les étapes d’installation suivantes :This section describes installation of version 1 of the SAP BW Connector, which you can install by taking the following installation steps:

  1. Installez la bibliothèque SAP NetWeaver sur votre ordinateur local.Install the SAP NetWeaver library on your local machine. Vous pouvez obtenir la bibliothèque SAP NetWeaver auprès de votre administrateur SAP ou directement depuis le Centre de téléchargement de logiciels SAP.You can get the SAP Netweaver library from your SAP administrator, or directly from the SAP Software Download Center. Étant donné que le Centre de téléchargement de logiciels SAP modifie sa structure fréquemment, des informations plus spécifiques sur la navigation dans ce site ne sont pas disponibles.Since the SAP Software Download Center changes its structure frequently, more specific guidance for navigating that site is not available. La bibliothèque SAP NetWeaver est généralement incluse dans l’installation des outils du client SAP.The SAP NetWeaver library is usually included also in the SAP Client Tools installation.

    Vous pouvez rechercher Note SAP n° 1025361 pour obtenir l’emplacement de téléchargement de la version la plus récente.You may be able to search for SAP Note #1025361 to get the download location for the most recent version. Vérifiez que l’architecture de la bibliothèque SAP NetWeaver (32 ou 64 bits) correspond à votre installation de Power BI Desktop, puis installez tous les fichiers inclus dans le Kit de développement logiciel (SDK) SAP NetWeaver RFC conformément à la note SAP.Make sure the architecture for the SAP NetWeaver library (32-bit or 64-bit) matches your Power BI Desktop installation, then install all files included in the SAP NetWeaver RFC SDK according to the SAP Note.

  2. La boîte de dialogue Obtenir des données comporte une entrée pour SAP Business Warehouse Application Server et SAP Business Warehouse Message Server dans la catégorie Base de données.The Get Data dialog includes an entry for SAP Business Warehouse Application Server and SAP Business Warehouse Message Server in the Database category.

    Obtenir les options de données pour SAP

Installation du connecteur SAP Implementation 2.0Installation of Implementation 2.0 SAP Connector

Implementation 2.0 du connecteur SAP nécessite le connecteur SAP .NET 3.0.Implementation 2.0 of the SAP Connector requires the SAP .NET Connector 3.0. Vous pouvez télécharger le connecteur SAP .NET 3.0 depuis le site web de SAP via le lien suivant :You can download the SAP .NET Connector 3.0 from SAP’s website using the following link:

L’accès au téléchargement nécessite un superutilisateur valide.Access to the download requires a valid S-user. Les clients sont invités à contacter leur équipe SAP Basis pour obtenir le connecteur SAP .NET 3.0.Customers are encouraged to contact their SAP Basis team to get the SAP .NET Connector 3.0.

Le connecteur est fourni en version 32 bits et 64 bits, et les utilisateurs doivent choisir la version qui correspond à leur installation de Power BI Desktop.The connector comes in 32-bit and 64-bit versions, and users must choose the version that matches their Power BI Desktop installation. À l’heure où nous écrivons cet article, le site web liste deux versions (pour .NET Framework 4.0) :At the time of this writing, the website lists two versions (for .NET 4.0 framework):

  • Connecteur SAP pour Microsoft .NET 3.0.20.0 pour Windows 32 bits (x 86) en tant que fichier zip (6.896 Ko), 16 janvier 2018SAP Connector for Microsoft .NET 3.0.20.0 for Windows 32-bit (x86) as zip file (6.896 KB), January 16, 2018
  • Connecteur SAP pour Microsoft .NET 3.0.20.0 pour Windows 64 bits (x 64) en tant que fichier zip (7.180 Ko), 16 janvier 2018SAP Connector for Microsoft .NET 3.0.20.0 for Windows 64-bit (x64) as zip file (7.180 KB), January 16, 2018

Lors de l’installation, dans la fenêtre Étapes d’installation facultatives, veillez à sélectionner l’option Installer les assemblys dans le GAC comme indiqué dans l’image suivante.When installing, in the Optional setup steps window, make sure you select the Install assemblies to GAC option as shown in the following image.

Étapes d’installation SAP facultatives

Note

La première version de l’implémentation de SAP BW nécessitait les DLL Netweaver ; si vous utilisez le connecteur SAP Implementation 2.0, et pas la première version, les DLL Netweaver ne sont pas nécessaires.The first version of SAP BW implementation required Netweaver DLLs; if you're using Implementation 2.0 of the SAP Connector, and not using the the first version, the Netweaver DLLs are not required.

Fonctionnalités du connecteur SAP BW version 1Version 1 SAP BW Connector features

Le connecteur SAP BW version 1 dans Power BI Desktop vous permet d’importer des données à partir de vos cubes SAP Business Warehouse Server ou d’utiliser DirectQuery.The version 1 SAP BW Connector in Power BI Desktop let you import data from your SAP Business Warehouse Server cubes, or use DirectQuery.

Pour en savoir plus sur SAP BW Connector et sur son utilisation avec DirectQuery, consultez l’article DirectQuery et SAP Business Warehouse (BW).To learn more about the SAP BW connector and how to use it with DirectQuery, take a look at the DirectQuery and SAP Business Warehouse (BW) article.

Pour pouvoir vous connecter, vous devez spécifier un Serveur, un Numéro de système et un ID client.When connecting, you must specify a Server, System Number, and Client ID to establish the connection.

Paramètres de connexion du serveur SAP

Vous pouvez également spécifier deux autres options avancées : le code de langue et une instruction MDX personnalisée à exécuter sur le serveur spécifié.You can also specify two additional Advanced options: Language code, and a custom MDX statement to run against the specified server.

informations de connexion supplémentaires

Si aucune instruction MDX n’a été spécifiée, la fenêtre Navigator qui s’affiche présente la liste des cubes disponibles sur le serveur, avec l’option d’accès et de sélection des éléments dans les cubes disponibles, notamment les dimensions et les mesures.If no MDX statement was specified you are presented with the Navigator window, which displays the list of cubes available in the server, with the option to drill down and select items from the available cubes, including dimensions and measures. Power BI expose les requêtes et les cubes exposés par les BAPI OLAP BW Open Analysis Interface.Power BI exposes queries and cubes exposed by the BW Open Analysis Interface OLAP BAPIs.

Lorsque vous sélectionnez un ou plusieurs éléments sur le serveur, un aperçu de la table de sortie est créé en conséquence.When you select one or more items from the server, a preview of the output table is created, based on their selection.

Aperçu de la table SAP

La fenêtre Navigator fournit également un certain nombre d’Options d’affichage qui vous permettent d’effectuer les opérations suivantes :The Navigator window also provides a few Display Options that allow you to do the following:

  • Affichage Uniquement les éléments sélectionnés ou Tous les éléments (affichage par défaut) : cette option est utile pour la vérification de l’ensemble final d’éléments sélectionnés.Display Only Selected Items versus All Items (default view): This option is useful for verifying the final set of items selected. Une approche alternative à cet affichage consiste à sélectionner les Noms de colonne dans la zone Aperçu.An alternative approach to viewing this is to select the Column Names in the Preview area.
  • Activer les aperçus de données (comportement par défaut) : Vous pouvez également contrôler si les aperçus de données doivent être affichés dans cette boîte de dialogue.Enable Data Previews (default behavior): You can also control whether data previews should be displayed in this dialog. La désactivation des aperçus de données réduit le nombre des appels serveur car les données jusqu’alors requises pour les aperçus deviennent inutiles.Disabling data previews reduces the amount of server calls, since it no longer requests data for the previews.
  • Noms techniques : SAP BW prend en charge la notion de noms techniques pour les objets d’un cube.Technical Names: SAP BW supports the notion of technical names for objects within a cube. Les noms techniques permettent à un propriétaire de cube d’exposer des noms conviviaux pour des objets du cube et non pas uniquement des noms physiques pour ces objets.Technical names allow a cube owner to expose user friendly names for cube objects, as opposed to only exposing the physical names for those objects in the cube.

Fenêtre du navigateur

Après avoir sélectionné tous les objets nécessaires dans le navigateur, vous pouvez décider quoi faire, en sélectionnant un des boutons suivants dans la partie inférieure de la fenêtre Navigator :After selecting all necessary objects in the Navigator, you can decide what to do next, by selecting one of the following buttons on the bottom of the Navigator window:

  • Charger déclenche le chargement de groupes de lignes pour la table de sortie vers le modèle de données Power BI Desktop, puis propose l’affichage Rapport pour vous permettre de visualiser les données ou d’apporter d’autres modifications à l’aide des affichages Données ou Relations.Selecting Load triggers loading the entire set of rows for the output table into the Power BI Desktop data model, then takes you to Report view where you can begin visualizing the data or making further modifications using the Data or Relationships views.
  • Modifier affiche l’éditeur de requête, dans lequel vous pouvez effectuer la transformation des données supplémentaires et le filtrage des étapes avant que l’ensemble de lignes soit inséré dans le modèle de données Power BI Desktop.Selecting Edit brings up Query Editor, where you can perform additional data transformation and filtering steps before the entire set of rows is brought into the Power BI Desktop data model.

Outre le fait que vous pouvez importer des données à partir de cubes SAP BW, n’oubliez pas que vous pouvez également importer des données à partir d’une large gamme d’autres sources de données dans Power BI Desktop, puis les combiner dans un rapport unique.In addition to importing data from SAP BW cubes, remember that you can also import data from a wide range of other data sources in Power BI Desktop, and then you can combine them into a single report. Cela présente toutes sortes de scénarios intéressant de génération de rapports et d’analyse sur les données SAP BW.This presents all sorts of interesting scenarios for reporting and analytics on top of SAP BW data.

Utilisation du connecteur SAP BW Implementation 2.0Using Implementation 2.0 SAP BW Connector

Vous devez créer une nouvelle connexion pour utiliser Implementation 2.0 du connecteur SAP BW.You must create a new connection to use Implementation 2.0 of the SAP BW Connector. Pour créer une nouvelle connexion, effectuez les étapes suivantes.To create a new connection, take the following steps.

  1. À partir de la fenêtre Obtenir les données, sélectionnez Serveur d’applications SAP Business Warehouse ou Serveur de messages SAP Business Warehouse.From the Get Data window, select either SAP Business Warehouse Application Server or SAP Business Warehouse Message Server.

  2. Vous est présentée la boîte de dialogue de nouvelle connexion, qui permet de sélectionner l’implémentation.You're presented with the new connection dialog, which allows selection of the implementation. La sélection de Implementation 2.0, comme montré dans l’image suivante, permet de bénéficier des options Mode d’exécution, Taille du lot et Activer les structures caractéristiques.Selecting Implementation 2.0, as shown in the following image, enables the Execution mode, Batch size and Enable characteristic structures options.

    Boîte de dialogue Connexion SAP

  3. Sélectionnez OK et l’expérience de Navigator devient tout de suite identique à celle décrite dans la section précédente pour le connecteur SAP BW version 1.Select OK, and subsequently, the Navigator experience is the same as described in the earlier section for the version 1 SAP BW Connector.

Nouvelles options pour Implementation 2.0New options for Implementation 2.0

Implementation 2.0 prend en charge les options suivantes :Implementation 2.0 supports the following options:

  1. ExecutionMode : Spécifie l’interface MDX utilisée pour exécuter des requêtes sur le serveur.ExecutionMode - Specifies the MDX interface used to execute queries on the server. Les options valides sont les suivantes :Valid options are the following:

     a. SapBusinessWarehouseExecutionMode.BasXml
     b. SapBusinessWarehouseExecutionMode.BasXmlGzip
     c. SapBusinessWarehouseExecutionMode.DataStream
    

    La valeur par défaut de cette option est SapBusinessWarehouseExecutionMode.BasXmlGzip.The default value for this option is SapBusinessWarehouseExecutionMode.BasXmlGzip.

    L’utilisation de SapBusinessWarehouseExecutionMode.BasXmlGzip peut améliorer les performances quand la latence est élevée pour les jeux de données volumineux.Using SapBusinessWarehouseExecutionMode.BasXmlGzip may improve performance when experiencing high latency for large datasets.

  2. BatchSize : Spécifie le nombre maximal de lignes qui seront récupérées à la fois lors de l’exécution d’une instruction MDX.BatchSize - Specifies the maximum number of rows that will be retrieved at a time when executing an MDX statement. Un petit nombre de lignes se traduit par plus d’appels au serveur lors de la récupération d’un jeu de données volumineux.A small number of rows will translate into more calls to the server while retrieving a large dataset. Un grand nombre de lignes peut améliorer les performances, mais peut entraîner des problèmes de mémoire sur le serveur SAP BW.A large number of rows may improve performance, but could cause memory issues on the SAP BW server. La valeur par défaut est 50 000 lignes.The default value is 50000 rows.

  3. EnableStructures : Valeur logique indiquant si les structures caractéristiques sont reconnues.EnableStructures - A logical value indicating whether characteristic structures are recognized. La valeur par défaut de cette option est false.The default value for this option is false. Affecte la liste des objets pouvant être sélectionnés.Affects the list of objects available for selection. Non pris en charge en mode de requête natif.Not supported in Native query mode.

L’option ScaleMeasures a été dépréciée dans cette implémentation.The ScaleMeasures option has been deprecated in this implementation. Le comportement est maintenant le même que la définition ScaleMeasures = false, qui affiche toujours des valeurs non ajustées.The behavior is now the same as setting ScaleMeasures = false, that is always showing unscaled values.

Améliorations supplémentaires pour Implementation 2.0Additional improvements for Implementation 2.0

La liste à puces ci-dessous décrit quelques-unes des améliorations supplémentaires qui accompagnent la nouvelle implémentation :The following bulleted list describes some of the additional improvements that come with the new implementation:

  • Amélioration des performancesImproved performance
  • Possibilité de récupérer plusieurs millions de lignes de données et d’ajuster le paramètre de la taille de lot.Ability to retrieve several million rows of data, and fine tuning through the batch size parameter.
  • Possibilité de basculer entre les modes d’exécution.Ability to switch execution modes.
  • Prise en charge pour le mode compressé.Support for compressed mode. Particulièrement utile pour les connexions à latence élevée ou les jeux de données volumineux.Especially beneficial for high latency connections or large datasets.
  • Amélioration de la détection des variables de dateImproved detection of Date variables
  • [Expérimental] Exposer la date (ABAP type DAT) et les dimensions de temps (ABAP type TIM) respectivement comme dates et heures, au lieu de valeurs texte.[Experimental] Expose Date (ABAP type DATS) and Time (ABAP type TIMS) dimensions as dates and times respectively, instead of text values.
  • Meilleure gestion des exceptions.Better exception handling. Les erreurs qui se produisent dans les appels BAPI sont maintenant signalées.Errors that occur in BAPI calls are now surfaced.
  • Pliage de colonnes dans les modes BasXml et BasXmlGzip.Column folding in BasXml and BasXmlGzip modes. Par exemple, si la requête MDX générée récupère 40 colonnes, alors que la sélection actuelle n’en a besoin que de 10, cette demande passe au serveur pour récupérer un jeu de données plus petit.For example, if the generated MDX query retrieves 40 columns but the current selection only needs 10, this request will be passed onto the server to retrieve a smaller dataset.

Changement des rapports existants pour utiliser Implementation 2.0Changing existing reports to use Implementation 2.0

Le changement des rapports existants pour utiliser Implementation 2.0 est possible uniquement en mode Importation et nécessite les étapes manuelles suivantes.Changing existing reports to use Implementation 2.0 is only possible in Import mode, and requires the following manual steps.

  1. Ouvrez un rapport existant, sélectionnez Modifier les requêtes dans le ruban, puis sélectionnez la requête SAP Business Warehouse que vous souhaitez mettre à jour.Open an existing report, select Edit Queries in the ribbon, and then select the SAP Business Warehouse query you would like to update.

  2. Cliquez avec le bouton droit sur la requête et sélectionnez Éditeur avancé.Right-click the query and select Advanced Editor.

  3. Dans l’Éditeur avancé, changez l’appel de SapBusinessWarehouse.Cubes comme suit :In the Advanced Editor change the SapBusinessWarehouse.Cubes call as follows:

    a.a. Déterminez si la requête contient déjà un enregistrement d’option, tel que ce qui est montré dans l’exemple suivant :Determine whether the query already contains an option record, such as what's shown in the following example:

    extrait de la requête

    b.b. Dans ce cas, ajoutez l’option Implementation 2.0 et supprimez l’option ScaleMeasures, le cas échéant, comme indiqué :If so, add the Implementation 2.0 option, and remove the ScaleMeasures option, if present, as shown:

    extrait de la requête

    c.c. Si la requête n’inclut pas déjà un enregistrement d’options, ajoutez-en un.If the query does not already include an options record, just add it. Par exemple, si elle a :For example, if it has the following:

    extrait de la requête

    d.d. Remplacez simplement par :Just change it to:

    extrait de la requête

  4. Nous avons fait tout notre possible pour rendre le connecteur SAP BW Implementation 2.0 compatible avec la version 1 du connecteur SAP BW.Every effort has been made to make Implementation 2.0 of the SAP BW Connector compatible with version 1 of the SAP BW Connector. Toutefois, il peut y avoir des différences en raison des différents modes d’exécution MDX SAP BW.However, there may be some differences due to the different SAP BW MDX execution modes being used. Pour résoudre les incohérences, essayez de basculer entre les modes d’exécution.To resolve any discrepancies, try switching between execution modes.

Résolution des problèmesTroubleshooting

Cette section décrit des scénarios de dépannage (et des solutions) lors de l’utilisation du connecteur SAP BW.This section provides troubleshooting situations (and solutions) for working with th SAP BW connector.

  1. Les données numériques de SAP BW retournent des décimales au lieu de virgules.Numeric data from SAP BW returns decimal points instead of commas. Par exemple, 1,000,000 est retourné en tant que 1.000.000.For example, 1,000,000 is returned as 1.000.000.

    SAP BW retourne des données décimales avec un caractère , (virgule) ou . (point)SAP BW returns decimal data with either a , (comma) or a . comme séparateur décimal.(dot) as the decimal separator. Pour spécifier l’option que SAP BW doit utiliser comme séparateur décimal, le pilote utilisé par Power BI Desktop effectue un appel à BAPI_USER_GET_DETAIL.To specify which of those SAP BW should use for the decimal separator, the driver used by Power BI Desktop makes a call to BAPI_USER_GET_DETAIL. Cet appel retourne une structure appelée DEFAULTS, qui a un champ appelé DCPFM qui stocke Decimal Format Notation.This call returns a structure called DEFAULTS, which has a field called DCPFM that stores Decimal Format Notation. Elle prend l’une des trois valeurs suivantes :It takes one of the following three values:

    ‘ ‘ (space) = Decimal point is comma: N.NNN,NN
    'X' = Decimal point is period: N,NNN.NN
    'Y' = Decimal point is N NNN NNN,NN
    

    Les clients qui ont signalé ce problème ont constaté que l’appel à BAPI_USER_GET_DETAIL échoue pour un utilisateur particulier (qui affiche des données incorrectes), avec un message d’erreur semblable au suivant :Customers who have reported this issue found that the call to BAPI_USER_GET_DETAIL is failing for a particular user (the user who is showing the incorrect data), with an error message similar to the following:

    You are not authorized to display users in group TI:
        <item>
            <TYPE>E</TYPE>
            <ID>01</ID>
            <NUMBER>512</NUMBER>
            <MESSAGE>You are not authorized to display users in group TI</MESSAGE>
            <LOG_NO/>
            <LOG_MSG_NO>000000</LOG_MSG_NO>
            <MESSAGE_V1>TI</MESSAGE_V1>
            <MESSAGE_V2/>
            <MESSAGE_V3/>
            <MESSAGE_V4/>
            <PARAMETER/>
            <ROW>0</ROW>
            <FIELD>BNAME</FIELD>
            <SYSTEM>CLNTPW1400</SYSTEM>
        </item>
    

    Pour résoudre cette erreur, les utilisateurs doivent demander à leur administrateur SAP d’accorder à l’utilisateur SAPBW utilisé dans Power BI le droit d’exécuter BAPI_USER_GET_DETAIL.To solve this error, users must ask their SAP admin to grant the SAPBW user being used in Power BI the right to execute BAPI_USER_GET_DETAIL. Il est également important de vérifier que l’utilisateur a la valeur DCPFM requise, comme décrit précédemment dans cette solution de dépannage.It’s also worth verifying that the user has the required DCPFM value, as described earlier in this troubleshooting solution.

  2. Connectivité pour les requêtes SAP BExConnectivity for SAP BEx queries

    Vous pouvez effectuer des requêtes BEx dans Power BI Desktop en activant une propriété spécifique, comme illustré dans l’image suivante :You can perform BEx queries in Power BI Desktop by enabling a specific property, as shown in the following image:

Étapes suivantesNext steps

Pour plus d’informations sur SAP et DirectQuery, consultez les ressources suivantes :For more information about SAP and DirectQuery, check out the following resources: