Configurer la sécurité au niveau des lignes dans les rapports paginés Power BI

2023-12-06

S’APPLIQUE À : Générateur de rapports Power BI Power BI Desktop

Cet article explique comment configurer la sécurité au niveau des lignes (RLS) pour les rapports paginés dans Power BI. Si votre rapport paginé est basé sur un modèle sémantique Power BI, l'article Sécurité au niveau des lignes (RLS) avec Power BI fournit une base solide pour la configuration de RLS à utiliser dans votre rapport paginé.

Pour utiliser la sécurité au niveau des lignes dans un rapport paginé, vous devez d’abord créer des paramètres dans ce rapport. Ensuite, vous tirez parti du champ intégré UserID :

Utiliser UserID dans un filtre
Utiliser UserID dans une requête

Notes

La valeur de l’expression UserID pendant l’aperçu du rapport dans le Générateur de rapports Power BI peut être dans un format différent de la valeur de l’expression UserID lors de l’exécution dans un rapport sur le service Power BI. Cela varie selon que l’ordinateur exécutant Power BI Report Builder utilise Active Directory ou Microsoft Entra ID.

Prérequis

Les exigences de licence pour les rapports paginés Power BI (fichiers .rdl) sont les mêmes que pour les rapports Power BI (fichiers .pbix).

Vous n’avez pas besoin de licence pour télécharger Power BI Report Builder gratuitement sur le Centre de téléchargement Microsoft.
Avec une licence gratuite, vous pouvez publier des rapports paginés dans Mon espace de travail dans le service Power BI. Pour plus d’informations, consultez Disponibilité des fonctionnalités pour les utilisateurs disposant de licences gratuites dans le service Power BI.
Avec une licence Power BI Pro ou une licence PPU, vous pouvez publier des rapports paginés dans d’autres espaces de travail. Vous avez également besoin au minimum du rôle Contributeur dans l’espace de travail.
Vous devez avoir l’autorisation Générer pour le jeu de données.

Pour que la sécurité au niveau des lignes (RLS) fonctionne dans Power BI Report Builder, vous avez besoin au minimum du rôle Lecteur dans l’espace de travail du jeu de données et de l’autorisation Générer pour le jeu de données. En savoir plus sur les rôles dans les espaces de travail.
Vous créez des rapports paginés à l’aide du moteur SQL Server Reporting Services, et non avec le moteur Power BI (Analysis Services) ; ainsi, vous configurez le filtrage RLS dans Power BI Report Builder.

Créer un paramètre à l’aide de UserID

Pour appliquer la sécurité au niveau des lignes à un rapport paginé Power BI, la première étape consiste à créer un paramètre et à affecter le champ intégré UserID. Consultez l’article Créer des paramètres si vous avez besoin d’aide pour les créer.

Ensuite, vous utilisez ce paramètre avec UserId dans un filtre ou dans une requête vers la source de données.

Utiliser UserID dans un filtre

Dans le volet gauche de la fenêtre Propriétés du jeu de données, sélectionnez Filtre.
Dans le menu déroulant Expression, sélectionnez le paramètre que vous voulez utiliser pour le filtrage des données.
Sélectionnez le bouton de fonction Valeur.
Dans la fenêtre Expression, dans la liste Catégorie, sélectionnez Champs prédéfinis.
Dans la liste Élément, sélectionnez UserID>OK.
Dans la fenêtre Propriétés du jeu de données, vérifiez que l’expression est votre paramètre sélectionné = UserID
Sélectionnez OK.

Utiliser UserID dans une requête

Dans le volet de navigation gauche de la fenêtre Propriétés du jeu de données, sélectionnez Paramètres, puis Ajouter.
Dans le champ Nom du paramètre, entrez @UserID puis, dans Valeur du paramètre, ajoutez [&UserID].
Dans le volet gauche, sélectionnez Requête. Dans Requête, ajoutez le paramètre UserID dans le cadre de votre requête.

Cette capture d’écran utilise le paramètre de couleur comme exemple *(WHERE FinalTable.Color = @UserID)*. Si nécessaire, vous pouvez créer une requête plus complexe.
Cliquez sur OK.