Intégrer Power BI
L’intégration Power BI vous permet de recevoir des notifications automatisées pour les modifications importantes effectuées sur des rapports dans Citrix Workspace.
Utilisez la procédure suivante pour activer l’intégration Power BI. Assurez-vous de remplir les conditions préalables et fournissez les détails de connexion. Une fois ce processus terminé, votre niveau de journalisation d’audit existant est conservé, y compris toute action effectuée par l’utilisation des micro-apps Citrix.
Pour obtenir une liste complète des micro-apps Power BI prêtes à l’emploi, consultez la section Utiliser les micro-apps Power BI.
Vérifier les conditions préalables
Vous devez disposer d’un compte de service Power BI. Pour plus d’informations, accédez à https://powerbi.microsoft.com/en-us/landing/signin/. Pour que tous les rapports soient partagés via les micro-apps Citrix, ils doivent être partagés avec le compte de service Power BI.
Selon votre configuration, deux comptes sont potentiellement nécessaires :
- Compte disposant des autorisations pour créer un enregistrement d’application dans Azure AD. Ce compte peut être problématique en fonction de l’abonnement/du locataire auquel il s’associe en premier.
- Compte de service utilisé pour authentifier l’intégration.
Ces conditions préalables supposent que vous gérez l’instance Power BI de votre organisation pour configurer l’intégration. Le compte de service doit disposer des autorisations d’API suivantes attribuées avec l’option Type : Délégué :
| Groupe | Nom de l’API ou des autorisations | Type | Description |
|---|---|---|---|
| Azure Active Directory Graph (1) | User.Read | Délégué | Se connecter et lire le profil utilisateur. |
| Service Power BI (18) | App.Read.All | Délégué | Afficher toutes les applications Power BI. |
| Capacity.Read.All | Délégué | Afficher toutes les capacités. | |
| Dashboard.Read.All | Délégué | Afficher tous les tableaux de bord. | |
| Dataflow.Read.All | Délégué | Afficher tous les flux de données. | |
| Dataset.Read.All | Délégué | Afficher tous les jeux de données. | |
| Gateway.Read.All | Délégué | Afficher toutes les passerelles. | |
| Report.Read.All | Délégué | Afficher tous les rapports. | |
| StorageAccount.Read.All | Délégué | Afficher tous les comptes de stockage. | |
| Workspace.Read.All | Délégué | Afficher tous les espaces de travail |
Une fois l’intégration dans Power BI configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace :
- ID client
- Clé secrète client
- Autorisation OAuth
Enregistrer l’application
Accédez à https://dev.powerbi.com/apps et enregistrez votre application auprès d’Azure AD pour lui permettre d’accéder aux API REST Power BI et définir des autorisations de ressources pour votre application. Grâce à ce processus d’enregistrement, vous créez l’ID du client et la clé secrète client.
Le premier rappel répertorié ne change pas. Le second rappel dépend de l’application cible et se trouve dans votre barre d’adresse URL lors de la création de l’intégration. La section {yourmicroappserverurl} est composée d’une partie locataire, d’une partie région et d’une partie environnement : https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.
Vous ne pouvez enregistrer qu’une seule URL dans le premier champ. Entrez une URL dans la page d’enregistrement de l’application Web côté serveur. Accédez ensuite à Azure AD App Registration pour ajouter la deuxième URL.
- Donnez un nom à votre application.
- Sélectionnez Server-side web application.
- Renseignez le champ Home Page URL avec l’URL de la page d’accueil de votre application.
-
Renseignez le champ Redirect URL avec une des URL de redirection suivantes :
https://{yourmicroappserverurl}/app/api/auth/serviceAction/callbackhttps://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.powerbi.PowerBiService/auth/serverContextRemarque :
il n’est pas possible d’entrer deux URL dans ce champ. Accédez à Azure AD App Registration pour ajouter la deuxième URL.
- Cochez toutes les cases Read-Only APIs.
- Sélectionnez Register.
-
Accédez à Azure App Registrations > Authentification et entrez la deuxième URL de rappel.
Ajouter l’intégration aux micro-apps Citrix Workspace
Ajoutez l’intégration Power BI aux micro-apps Citrix Workspace pour vous connecter à votre application. Des micro-apps prêtes à l’emploi sont proposées, ainsi que des notifications et des actions préconfigurées qui sont prêtes à être utilisées dans votre espace de travail.
Procédez comme suit :
-
Dans la page de vue d’ensemble, sélectionnez Démarrer.
La page Gérer les intégrations s’ouvre.
- Sélectionnez Ajouter une nouvelle intégration et Ajouter une nouvelle intégration à partir des modèles fournis par Citrix.
- Choisissez la vignette Power BI.
-
Donnez un nom à l’intégration.
- Renseignez la section Paramètres du connecteur avec les informations que vous avez obtenues dans les procédures précédentes.
- Entrez l’ID du client et la Clé secrète client.
- Entrez l’ID du locataire Office 365.
-
Sélectionnez Se connecter avec le compte Power BI pour activer l’autorisation OAuth. Une page de connexion Power BI s’ouvre dans un nouvel onglet. Vous êtes invité à entrer un nom de compte, un mot de passe, à confirmer l’accès et à accepter les autorisations demandées.
- Sélectionnez Ajouter.
La page Intégrations de micro-apps s’ouvre avec votre intégration ajoutée et ses micro-apps associées. À partir de là, vous pouvez ajouter une autre intégration, continuer à configurer vos micro-apps prêtes à l’emploi ou créer une micro-app pour cette intégration.
Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données.
Pour plus d’informations, consultez les sections Vérifier les entités requises et Définir la synchronisation des données dans l’article Configurer l’intégration.
Pour plus d’informations sur les points de terminaison d’API et les entités de table, consultez la section Spécifications du connecteur Power BI.
Utiliser les micro-apps Power BI
Les intégrations Web/SaaS existantes sont fournies avec des micro-apps prêtes à l’emploi. Commencez avec ces micro-apps et personnalisez-les en fonction de vos besoins.
L’intégration Power BI est fournie avec les micro-apps prêtes à l’emploi préconfigurées suivantes :
Tableaux de bord : permet d’afficher les détails des tableaux de bord Power BI.
| Notification ou Page | Workflows de cas d’utilisation |
|---|---|
| Page Tableaux de bord | Fournit une liste des tableaux de bord disponibles, y compris un lien vers la page des détails correspondants. |
| Page Détails du tableau de bord | Fournit une vue détaillée en lecture seule d’un tableau de bord, y compris un lien vers la source d’enregistrement cible pour une vue encore plus détaillée. |
Rapports : permet d’afficher les détails des rapports Power BI.
| Notification ou Page | Workflows de cas d’utilisation |
|---|---|
| Notification Nouveau rapport ajouté | Lorsqu’un nouveau rapport est ajouté à un compte, les abonnés reçoivent une notification. |
| Page Détails du rapport | Fournit une vue détaillée en lecture seule d’un rapport. |
| Page Rapports | Fournit une liste des rapports disponibles, y compris un lien vers la source d’enregistrement cible pour une vue encore plus détaillée. |