Micro-apps

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.

  1. Donnez un nom à votre application.
  2. Sélectionnez Server-side web application.
  3. Renseignez le champ Home Page URL avec l’URL de la page d’accueil de votre application.
  4. Renseignez le champ Redirect URL avec une des URL de redirection suivantes : https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.powerbi.PowerBiService/auth/serverContext

    Remarque :

    il n’est pas possible d’entrer deux URL dans ce champ. Accédez à Azure AD App Registration pour ajouter la deuxième URL.

  5. Cochez toutes les cases Read-Only APIs.
  6. Sélectionnez Register.
  7. Accédez à Azure App Registrations > Authentification et entrez la deuxième URL de rappel.

    Rappel dans Azure

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 :

  1. Dans la page de vue d’ensemble, sélectionnez Démarrer.

    La page Gérer les intégrations s’ouvre.

  2. Sélectionnez Ajouter une nouvelle intégration et Ajouter une nouvelle intégration à partir des modèles fournis par Citrix.
  3. Choisissez la vignette Power BI.
  4. Donnez un nom à l’intégration.

    Paramètres du connecteur Power BI : ID du client, Clé secrète client, Locataire, Autorisation OAuth

  5. 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.
  6. 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.

  7. 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.

Intégrer Power BI