Tutorial: Inserción de contenido de Power BI mediante una aplicación de ejemplo de inserción para los clientes

SE APLICA A: La aplicación es la propietaria de los datos El usuario es el propietario de los datos

Los análisis insertados y Power BI Embedded (la oferta de Azure) permiten insertar contenido de Power BI (como, por ejemplo, informes, paneles e iconos) en una aplicación.

En este tutorial, aprenderá a:

Para usar la aplicación, los usuarios no tendrán que iniciar sesión en Power BI ni disponer de una licencia de Power BI.

Si es un fabricante de software independiente o un desarrollador que quiere crear aplicaciones para terceros, se recomienda usar el método de inserción para los clientes para insertar contenido de Power BI.

Especificaciones de ejemplos de código

En este tutorial se incluyen instrucciones para configurar una aplicación de ejemplo de inserción para los clientes en uno de los siguientes marcos:

• .NET Framework
• .NET Core
• Java
• Node.js
• Python

Los ejemplos de código admiten los siguientes exploradores:

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

Requisitos previos

Antes de comenzar este tutorial, compruebe que tiene las siguientes dependencias de código y de Power BI:

• Dependencias de Power BI

  • Su propio inquilino de Microsoft Entra.

  • Para autenticar la aplicación en Power BI, necesitará uno de los siguientes elementos:

    • Entidad de servicio: un objeto entidad de servicio de Microsoft Entra que permite a Microsoft Entra ID autenticar una aplicación.

    • Licencia de Power BI Pro: actuará como usuario maestro y la aplicación la usará para autenticarse en Power BI.

    • Licencia de Power BI Premium por usuario (PPU): actuará como usuario maestro y la aplicación la usará para autenticarse en Power BI.

    Nota

    Para pasar a producción, necesitará una capacidad.

• Dependencias de código

Método

Para crear una aplicación de ejemplo de inserción para los clientes, realice estos pasos:

1. Seleccionar el método de autenticación

2. Registrar una aplicación de Microsoft Entra.

3. Crear un área de trabajo de Power BI

4. Crear y publicar un informe de Power BI

5. Obtener los valores de parámetro de la inserción

6. Habilitar el acceso a la API de la entidad de servicio

7. Permitir el acceso al área de trabajo

8. Insertar el contenido

Paso 1: Seleccionar el método de autenticación

La solución insertada variará según el método de autenticación que se seleccione. Por lo tanto, es importante comprender las diferencias entre los métodos de autenticación y decidir cuál se adapta mejor a su solución.

En la siguiente tabla se describen algunas diferencias clave entre los métodos de autenticación de entidad de servicio y de usuario maestro.

Paso 2: Registrar una aplicación de Microsoft Entra

El registro de una aplicación en Microsoft Entra ID permite:

Para registrar una aplicación en Microsoft Entra ID, siga las instrucciones de Registro de una aplicación.

Paso 3: Crear un área de trabajo de Power BI

Power BI mantiene los informes, paneles e iconos en un área de trabajo. Para insertar estos elementos, hay que crearlos y cargarlos en un área de trabajo.

Para crear un área de trabajo, haga lo siguiente:

1. Inicie sesión en Power BI.

2. Seleccione Áreas de trabajo.

3. Seleccione Crear un área de trabajo.

4. Asigne un nombre al área de trabajo y seleccione Guardar.

Paso 4: Crear y publicar un informe de Power BI

El siguiente paso consiste en crear un informe y cargarlo en el área de trabajo. Puede crear su propio informe usando Power BI Desktop y, después, publicarlo en el área de trabajo. Otra opción sería cargar un informe de ejemplo en el área de trabajo.

Para descargar un informe de ejemplo y publicarlo en el área de trabajo, haga lo siguiente:

1. Abra la carpeta de ejemplos de Power BI Desktop de GitHub.

2. Seleccione Code (Código) y, después, Download ZIP (Descargar ZIP).

   

3. Extraiga el archivo ZIP descargado y vaya a la carpeta Samples Reports.

4. Seleccione un informe para insertarlo y publíquelo en su área de trabajo.

Paso 5: Obtener los valores de parámetro de la inserción

Para insertar el contenido, debe obtener una serie de valores de parámetro. En esta tabla se muestran los valores necesarios y se señala si se corresponden con el método de autenticación de entidad de servicio, con el método de autenticación de usuario maestro o con ambos.

Antes de insertar el contenido, asegúrese de que tiene todos los valores que figuran aquí. Algunos de los valores variarán según el método de autenticación que use.

Parámetro	Entidad de servicio	Usuario maestro
Id de cliente
Id. del área de trabajo
Id. del informe
Secreto de cliente
Id. de inquilino		obligatorio solo para Node JS
Nombre de usuario de Power BI
Contraseña de Power BI

Id. de cliente

Para obtener el GUID del identificador de cliente (también conocido como id. de la aplicación), haga lo siguiente:

1. Inicie sesión en Microsoft Azure.

2. Busque Registros de aplicaciones y seleccione el vínculo Registros de aplicaciones.

3. Seleccione la aplicación de Microsoft Entra que usa para insertar el contenido de Power BI.

4. En la sección Información general, copie el GUID del identificador de la aplicación (cliente) .

Id. del área de trabajo

Para obtener el GUID del identificador del área de trabajo, haga lo siguiente:

1. Inicie sesión en el servicio Power BI.

2. Abra el informe que quiera insertar.

3. Copie el GUID de la dirección URL. El GUID es el número que hay entre /groups/ y /reports/ .

   

Como alternativa, puede encontrar el id. del área de trabajo en la configuración del Portal de administración seleccionando Detalles junto al nombre del área de trabajo.

Report ID (Id. de informe)

Para obtener el GUID del id. del informe, haga lo siguiente:

1. Inicie sesión en el servicio Power BI.

2. Abra el informe que quiera insertar.

3. Copie el GUID de la dirección URL. El GUID es el número que hay entre /reports/ y /ReportSection.

   

Secreto del cliente

Para obtener el secreto de cliente, haga lo siguiente:

1. Inicie sesión en Microsoft Azure.

2. Busque Registros de aplicaciones y seleccione el vínculo Registros de aplicaciones.

3. Seleccione la aplicación de Microsoft Entra que usa para insertar el contenido de Power BI.

4. En Administrar, seleccione Certificados y secretos.

5. En Secretos de cliente, seleccione Nuevo secreto de cliente.

6. En la ventana emergente Agregar un secreto de cliente, escriba una descripción del secreto de la aplicación, seleccione cuándo expira el secreto de la aplicación y seleccione Agregar.

7. En la sección Secretos de cliente, copie la cadena de la columna Valor del secreto de aplicación recién creado. El valor del secreto de cliente es el identificador de cliente.

Id. de inquilino

Para obtener el GUID del identificador del inquilino, haga lo siguiente:

1. Inicie sesión en Microsoft Azure.

2. Busque Registros de aplicaciones y seleccione el vínculo Registros de aplicaciones.

3. Seleccione la aplicación de Microsoft Entra que usa para insertar el contenido de Power BI.

4. En la sección Información general, copie el GUID de Id. de directorio (inquilino) .

Nombre de usuario y contraseña de Power BI

Obtenga el nombre de usuario y la contraseña del usuario de Power BI que esté usando como usuario maestro. Se trata del mismo usuario que usó para crear un área de trabajo y cargar un informe en el servicio Power BI.

Paso 6: Habilitar el acceso a la API de la entidad de servicio

Para que una aplicación de Microsoft Entra pueda acceder al contenido y a las API de Power BI, es preciso que un administrador de Power BI habilite el acceso de entidad de servicio en el portal de administración de Power BI. Si no es el administrador de su inquilino, pida al administrador del inquilino que habilite Configuración de inquilinos.

1. En Servicio Power BI, seleccione Configuración>Configuración>Portal de administración.

   

2. Seleccione Configuración de inquilinos y desplácese hacia abajo hasta la sección Configuración de desarrollador.

3. Expanda Concesión de permisos a las entidades de servicio para utilizar las API de Power BI y habilite esta opción.

   

Paso 7: Permitir el acceso al área de trabajo

Para habilitar los objetos de acceso a una aplicación de Microsoft Entra como informes, paneles y modelos semánticos en el servicio Power BI, agregue al área de trabajo la entidad de servicio o el usuario maestro, ya sea como miembro o como administrador.

1. Inicie sesión en el servicio Power BI.

2. Desplácese hasta el área de trabajo para el que desea habilitar el acceso y, en el menú Más, seleccione Acceso al área de trabajo.

   

3. En función del método de autenticación que use, en el panel Acceso, copie la entidad de servicio o el usuario maestro en el cuadro de texto Escribir la dirección de correo electrónico.

   Nota:

   Si usa una entidad de servicio, su nombre es el nombre que dio a la aplicación de Microsoft Entra.

4. Seleccione Agregar.

Paso 8: Insertar el contenido

La aplicación de ejemplo insertada de Power BI permite crear una aplicación de Power BI de inserción para los clientes.

Siga estos pasos para modificar aplicación de ejemplo de inserción para los clientes para insertar su informe de Power BI.

1. Abra la carpeta Power BI developer samples.

2. Seleccione Code (Código) y, después, Download ZIP (Descargar ZIP).

   

3. Extraiga el archivo ZIP descargado y vaya a la carpeta PowerBI-Developer-Samples-master.

4. Abra una de estas carpetas según el lenguaje que quiera que use la aplicación:

   • .NET Core
   • .NET Framework
   • Java
   • Node.js
   • Python

   Nota

   Las aplicaciones de ejemplo de inserción para los clientes solo admiten los marcos que figuran arriba. La aplicación de ejemplo React solo admite la solución de inserción para la organización .

5. Abra la carpeta Embed for your customers.

Desarrollo de la aplicación

Tras configurar y ejecutar la aplicación de ejemplo de inserción para los clientes, puede empezar a desarrollar su propia aplicación.

Pruebe el área de juegos de análisis integrados de Power BI para empezar a desarrollar y mantenerse al día con todas las nuevas características y actualizaciones de Power BI Embedded.

Cuando esté listo, revise los requisitos necesarios para pasar a producción. También necesitará una capacidad y debería revisar el artículo Planificación de la capacidad para determinar cuál es la SKU que mejor se adapta a las necesidades.

Contenido relacionado

• Paso a producción
• Insertar para la organización
• Insertar informes paginados

¿Tiene más preguntas? Pregunte a la Comunidad de Power BI.