Découvrez les étapes à suivre pour incorporer du contenu Power BI dans votre application.

Microsoft a récemment annoncé Power BI Premium, un nouveau modèle de gestion des licences basé sur la capacité, qui augmente la flexibilité en ce qui concerne la manière dont les utilisateurs consultent, partagent et distribuent du contenu. L’offre renforce également l’extensibilité et les performances du service Power BI.

Avec l’introduction de Power BI Premium, Power BI Embedded et le service Power BI convergent pour faire progresser la manière dont le contenu Power BI est incorporé dans les applications. Cela signifie que vous disposez d’une surface d’API, d’un ensemble cohérent de fonctionnalités et de l’accès aux dernières fonctionnalités de Power BI telles que des tableaux de bord, des passerelles et des espaces de travail d’application lors de l’incorporation de votre contenu. Plus tard, vous pourrez commencer à utiliser Power BI Desktop et passer au déploiement avec Power BI Premium qui sera généralement disponible à la fin du deuxième trimestre 2017.

Cet article est consacré à l'incorporation de contenu Power BI pour les utilisateurs Power BI et les utilisateurs non-Power BI. Les étapes à suivre sont semblables pour les deux types d’utilisateur. Les étapes spécifiques à l’incorporation relative aux utilisateurs non-Power BI sont signalées.

Pour que cela soit possible, vous devez suivre quelques étapes avec votre application. Nous allons examiner les étapes à suivre pour créer et utiliser du contenu incorporé dans votre application.

Remarque :

Les API Power BI font encore référence aux espaces de travail d’application en tant que groupes. Toutes les références à des groupes indiquent que vous travaillez avec des espaces de travail d’applications.

Étape 1 : configurer votre environnement de développement d’analytique incorporée

Avant de commencer à incorporer des tableaux de bord et des rapports dans votre application, vous devez vérifier que votre environnement est configuré pour autoriser l’incorporation. Dans le cadre de la configuration, vous devez effectuer les opérations suivantes.

Remarque :

Power BI Premium n’est pas nécessaire pour le développement de votre application. Les développeurs de l’application doivent disposer d’une licence Power BI Pro.

Locataire Azure Active Directory

Pour incorporer des éléments à partir de Power BI, vous devez disposer d’un locataire Azure Active Directory (Azure AD). Au moins un utilisateur Power BI Pro doit être attribué à ce locataire. Vous devez également définir une application Azure AD au sein du locataire. Vous pouvez recourir à un locataire Azure AD existant ou créer un locataire dédié à l’incorporation.

Vous devez déterminer quel locataire utiliser.

  • Utiliser le locataire Power BI existant de votre entreprise ?
  • Utiliser un locataire distinct pour votre application ?
  • Utiliser un locataire distinct pour chaque client ?

Si vous décidez de créer un locataire pour votre application, ou pour chaque client, consultez Créer un locataire Azure Active Directory ou Obtenir un locataire Azure Active Directory.

Remarque :

Pour les incorporations relatives aux utilisateurs non-Power BI, nous vous recommandons de créer un locataire Azure AD.

Créer un compte d’utilisateur Power BI Pro

Un seul compte Power BI Pro suffit pour incorporer du contenu. Toutefois, vous pouvez créer plusieurs utilisateurs pour les accès spécifiques aux éléments. Vous pouvez par exemple attribuer les utilisateurs suivants à votre locataire.

Les comptes suivants doivent être disponibles dans votre locataire et une licence Power BI Pro doit leur être attribuée.

Remarque :

Ces comptes doivent disposer de licences Power BI Pro pour utiliser les espaces de travail d’applications.

Un utilisateur administrateur d’organisation ou de client

Si possible, le compte de votre application ne doit pas être l’utilisateur Administrateur général de votre organisation/locataire. L’accès dont dispose le compte de l’application au sein de votre organisation est ainsi minimisé. De préférence, l’utilisateur administrateur doit être membre de tous les espaces de travail d’applications créés à des fins d’incorporation.

Des comptes pour les analystes devant créer du contenu

Il se peut que vous ayez plusieurs utilisateurs qui créent du contenu pour Power BI. Un compte Power BI Pro est requis pour chaque analyste qui crée et déploie du contenu dans Power BI.

Un compte utilisateur principal d’application pour les utilisateurs non-Power BI

Il s’agit du compte à utiliser par votre application lors de l’incorporation de contenu pour des utilisateurs non-Power BI. C’est vraiment le seul compte requis dont vous avez besoin au sein de votre organisation. Il peut également être utilisé en tant que compte d’administrateur et d’analyste, mais cela n’est pas recommandé. Le serveur principal de votre application stocke les informations d’identification de ce compte et les utilise pour acquérir le jeton d’authentification Azure AD à utiliser avec les API de Power BI. Ce compte est utilisé afin de générer le jeton d’incorporation de l’application pour les utilisateurs non-Power BI.

Ce compte doit également être administrateur de l’espace de travail d’applications créé pour l’incorporation.

Inscription de l’application et octroi d’autorisations

Vous devez inscrire votre application avec Azure AD afin d’effectuer des appels d’API REST. Pour plus d’informations, consultez Inscrire une application Azure AD pour incorporer du contenu Power BI.

Créer des espaces de travail d’applications

Si vous incorporez des tableaux de bord et des rapports pour des utilisateurs non-Power BI (l’application possède les données), ces tableaux de bord et rapports doivent être placés dans un espace de travail d’applications. Pour plus d’informations sur la création d’un espace de travail d’applications, consultez Créer un espace de travail d’application.

Important :

Le compte principal mentionné précédemment doit être administrateur de l’espace de travail d’applications.

Créer et charger vos rapports

Vous pouvez créer vos rapports et jeux de données à l’aide de Power BI Desktop, puis publier ces rapports dans un espace de travail d’applications. Pour publier les rapports dans un espace de travail d’applications, l’utilisateur final doit disposer d’une licence Power BI Pro.

Étape 2 : incorporer votre contenu

Dans votre application, vous devez vous authentifier auprès de Power BI. Si vous incorporez du contenu pour des utilisateurs non-Power BI, vous devez stocker les informations d’identification du compte principal dans votre application. Pour plus d’informations, consultez Authentifier des utilisateurs et obtenir un jeton d’accès Azure AD pour votre application Power BI.

Une fois que vous êtes authentifié, dans votre application, utilisez les API Power BI et JavaScript pour incorporer des tableaux de bord et des rapports dans votre application.

Pour en savoir plus sur l’incorporation avec des utilisateurs Power BI (les utilisateurs possèdent les données), consultez les rubriques suivantes :

Pour en savoir plus sur l’incorporation avec des utilisateurs non-Power BI (l’application possède les données), qui est généralement utilisée pour les scénarios ISV, consultez les rubriques suivantes :

Si l’incorporation s’adresse à des utilisateurs non-Power BI (l’application possède les données), un jeton d’incorporation est requis. Pour plus d’informations, consultez Générer des jetons.

Étape 3 : promouvoir votre solution en mode de production

Lorsque vous êtes prêt à passer à la production, vous devez procéder comme suit.

Utilisateurs Power BI (l’utilisateur possède les données)

Si votre incorporation s’adresse à des utilisateurs Power BI, vous devez simplement leur indiquer comment accéder à votre application.

Les utilisateurs de la version gratuite peuvent consommer du contenu incorporé à partir d’un groupe (espace de travail d’application), si cet espace de travail est soutenu par une capacité Premium. Chaque utilisateur de la version gratuite doit être répertorié en tant que membre du groupe (espace de travail d’application). Sinon, le système génère une erreur « (401) Non autorisé ».

Utilisateurs non-Power BI (l’application possède les données)

Si votre incorporation s’adresse à des utilisateurs non-Power BI, vous devez effectuer les opérations suivantes.

  • Vous pouvez utiliser le locataire de production de votre organisation, mais il est préférable de créer un nouvel environnement d’analytique incorporée pour la production. Pour plus d’informations, reportez-vous à l’étape 1 ci-dessus.

  • Si vous utilisez un locataire distinct pour le développement, veillez à ce que vos espaces de travail d’applications ainsi que vos tableaux de bord et rapports soient disponibles dans votre environnement de production. Vérifiez également que vous avez créé l’application dans Azure AD pour votre locataire de production et attribué les autorisations d’application appropriées comme indiqué à l’étape 1.

  • Achetez une capacité adaptée à vos besoins. Vous pouvez utiliser le tableau ci-dessous pour identifier la référence SKU de la capacité Premium dont vous avez besoin. Pour plus d’informations, consultez le livre blanc Planification d’une capacité d’analytique incorporée. Lorsque vous êtes prêt, vous pouvez procéder à l’achat à partir du Centre d’administration Office 365.

Nœud de capacité Nombre total de cœurs
(Serveur principal + serveur frontal)
Cœurs du serveur principal Cœurs du serveur frontal Limites de connexions actives/DirectQuery Rendus de pages au maximum aux heures de pointe Disponibilité
EM1 1 cœur virtuel .5 cœurs, 3 Go de RAM .5 cœurs 1-300 Juillet 2017
EM2 2 cœurs virtuels 1 cœur, 5 Go de RAM 1 cœur 301-600 Juillet 2017
EM3 4 cœurs virtuels 2 cœurs, 10 Go de RAM 2 cœurs 601-1 200 Juillet 2017
P1 8 cœurs virtuels 4 cœurs, 25 Go de RAM 4 cœurs 30 par seconde 1 201-2 400 Disponibilité
P2 16 cœurs virtuels 8 cœurs, 50 Go de RAM 8 cœurs 60 par seconde 2 401-4 800 Disponibilité
P3 32 cœurs virtuels 16 cœurs, 100 Go de RAM 16 cœurs 120 par seconde 4 801-9 600 Disponibilité
Remarque :

Pour acheter Power BI Premium, vous devez être Administrateur général ou Administrateur de facturation de votre locataire. Pour plus d’informations sur l’achat de Power BI Premium, consultez Acheter Power BI Premium.

  • Modifiez l’espace de travail d’applications et attribuez-le à une capacité Premium sous Avancé.

  • Déployez votre application mise à jour en production, puis commencez à incorporer des rapports à partir du service Power BI.

Paramètres d’administrateur

Les administrateurs globaux ou les administrateurs de service Power BI peuvent activer ou désactiver la possibilité d’utiliser les API REST. Les administrateurs peuvent définir ce paramètre pour toute l’organisation ou pour certains groupes de sécurité. Il est activé par défaut pour toute l’organisation. Son réglage s’effectue au moyen du Portail d’administration Power BI.

Étapes suivantes

Incorporation avec Power BI
Comment migrer le contenu d’une collection d’espaces de travail Power BI Embedded vers Power BI
Qu’est-ce que Power BI Premium ?
Acheter Power BI Premium
Dépôt Git d’API JavaScript
Dépôt Git de C# pour Power BI
Exemple de JavaScript incorporé
Livre blanc Planification d’une capacité d’analytique incorporée
Livre blanc sur Power BI Premium

D’autres questions ? Essayez d’interroger la communauté Power BI