Compartir a través de


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

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

Análisis insertados y Power BI Embedded (la oferta de Azure) le permiten insertar contenido de Power BI, como informes, paneles e iconos, en la aplicación.

En este tutorial, aprenderá a:

  • Configurar el entorno integrado
  • Configurar una aplicación de ejemplo de inserción para los clientes (también conocida como app owns data)

Para usar la aplicación, los usuarios no necesitan iniciar sesión en Power BI ni tener 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.

Importante

Si va a insertar contenido para una nube nacional o regional, los primeros pasos de este tutorial son diferentes. Consulte Inserción de contenido para nubes nacionales o regionales para obtener más información.

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 iniciar este tutorial, compruebe que tiene las siguientes dependencias de código y Power BI:

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 varía en función del método de autenticación que 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.

Consideración Entidad de servicio Usuario maestro
Mechanism El objeto de entidad de servicio de la aplicación Azure AD permite a Azure AD autenticar en Power BI una aplicación de solución insertada. La aplicación de Microsoft Entra usa las credenciales (nombre de usuario y contraseña) de un usuario de Power BI para autenticarse en Power BI.
Seguridad La entidad de servicio es el método de autorización recomendado de Microsoft Entra ID. Si usa una entidad de servicio, puede autenticarse mediante un secreto de aplicación o un certificado.

En este tutorial solo se describe el uso de una entidad de servicio con un secreto de aplicación. Para realizar la inserción con una entidad de servicio y un certificado, consulte el artículo sobre el uso de una entidad de servicio con un certificado.
Este método de autenticación no es tan seguro como una entidad de servicio. Hay que tener cuidado con las credenciales de usuario maestro (nombre de usuario y contraseña). Por ejemplo, no exponga esos datos en la aplicación de inserción y cambie la contraseña con frecuencia.
Permisos delegados de Microsoft Entra ID No es necesario. El usuario maestro o un administrador deben dar su consentimiento para que la aplicación acceda a los permisos de la API REST de Power BI (también denominados ámbitos). Por ejemplo, Report.ReadWrite.All.
Acceso al servicio Power BI No se puede acceder al servicio Power BI con una entidad de servicio. Se puede acceder al servicio Power BI con las credenciales de usuario maestro.
Licencia No se requiere una licencia Pro. Puede usar el contenido de cualquier área de trabajo de la que sea miembro o administrador. Se requiere una licencia de Power BI Pro o Premium por usuario (PPU).

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.

Nota:

Antes de registrar la aplicación, deberá decidir qué método de autenticación usar, si una entidad de servicio o un usuario maestro.

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

Microsoft Fabric mantiene los informes, paneles e iconos en un área de trabajo. Para insertar estos elementos, debe crearlos y cargarlos en un área de trabajo.

Sugerencia

Si ya tiene un área de trabajo, puede omitir este paso.

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

  1. Inicie sesión en Fabric.

  2. Seleccione Áreas de trabajo.

  3. Seleccione + Nueva á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.

Sugerencia

Si ya tiene un área de trabajo con un informe, puede omitir este paso.

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

    Captura de pantalla que muestra la opción de descarga de ZIP en los ejemplos de Power BI de GitHub Desktop

  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 la tabla siguiente se muestran los valores necesarios e indica si son aplicables a la entidad de servicio de método de autenticación, el usuario maestro de método de autenticación o ambos.

Antes de insertar el contenido, asegúrese de que tiene todos los valores que figuran aquí. Algunos de los valores pueden diferir, en función del método de autenticación que use.

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

Id. de cliente

Sugerencia

Se aplica a: Se aplica a.Usuario maestro de entidad de Se aplica a.servicio

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

Sugerencia

Se aplica a: Se aplica a.Usuario maestro de entidad de Se aplica a.servicio

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

    Captura de pantalla que muestra el GUID del identificador del área de trabajo en la dirección URL de servicio Power BI

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.

Captura de pantalla que muestra cómo buscar el id. del área de trabajo desde la configuración del administrador.

Report ID (Id. de informe)

Sugerencia

Se aplica a: Se aplica a.Usuario maestro de entidad de Se aplica a.servicio

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.

    Captura de pantalla que muestra el GUID del identificador del informe en la dirección URL del servicio Power BI

Secreto del cliente

Sugerencia

Se aplica a: Se aplica a.Usuario maestro de entidad de No se aplica a.servicio

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.

Nota

Asegúrese de copiar el valor de secreto de cliente cuando aparezca por primera vez. Después de salir de esta página, el secreto de cliente se ocultará y no podrá recuperar su valor.

Id. de inquilino

Sugerencia

Se aplica a: Se aplica a.Usuario maestro de entidad de No se aplica a.servicio

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

Sugerencia

Se aplica a: No se aplica.Usuario maestro de entidad de Se aplica a.servicio

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

Sugerencia

Se aplica a: Se aplica a.Usuario maestro de entidad de No se aplica a.servicio

Este paso solo procede si usa el método de autenticación de entidad de servicio. Si usa un usuario maestro, omita este paso y avance al Paso 7: Permitir el acceso al área de trabajo.

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.

    Captura de pantalla en la que se muestra la opción de menú configuración de administración en el menú de configuración del servicio Power BI.

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

  3. Expanda Entidades de servicio puede usar las API de Fabric, y habilitar esta opción.

    Captura de pantalla en la que se muestra cómo habilitar la opción de configuración de desarrollador en la opción de menú de configuración de inquilinos del servicio Power BI.

Nota

Si usa una entidad de servicio, se recomienda limitar su acceso a la configuración de inquilinos por medio de un grupo de seguridad. Para obtener más información sobre esta característica, consulte estas secciones en el artículo relativo a la entidad de servicio:

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

  2. Desplácese hasta el área de trabajo para la que desea habilitar el acceso y seleccione Administrar acceso.

    Captura de pantalla en la que se muestra el botón de acceso al área de trabajo en el menú Más de un área de trabajo de Power BI.

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

    Captura de pantalla que muestra la opción de descarga de ZIP en los ejemplos de desarrollador de Power BI de GitHub

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

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

  2. Abra la carpeta Embed for your customers.

  1. Abra la aplicación de ejemplo de inserción para los clientes con uno de estos métodos:

  2. Abra appsettings.json.

  3. Según su método de autenticación, rellene los siguientes valores de parámetro:

    Parámetro Entidad de servicio Usuario maestro
    AuthenticationMode ServicePrincipal MasterUser
    ClientId El Identificador de cliente de la aplicación de Microsoft Entra El Identificador de cliente de la aplicación de Microsoft Entra
    TenantId El Identificador de inquilino de Microsoft Entra N/D
    PbiUsername N/D El nombre de usuario de su usuario maestro (consulte Nombre de usuario y contraseña de Power BI)
    PbiPassword N/D La contraseña de su usuario maestro (consulte Nombre de usuario y contraseña de Power BI)
    ClientSecret El secreto de cliente de Microsoft Entra ID N/D
    WorkspaceId El identificador del área de trabajo con el informe insertado (consulte Id. del área de trabajo) El identificador del área de trabajo con el informe insertado (consulte Id. del área de trabajo)
    ReportId El identificador del informe que está insertando (consulte Id. de informe) El identificador del informe que está insertando (consulte Id. de informe)
  4. Ejecute el proyecto seleccionando la opción que proceda:

    • Si usa Visual Studio, seleccione IIS Express (Reproducir).

    • Si usa Visual Studio Code, seleccione Ejecutar > Iniciar depuración.

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.

Importante

Si ha usado tokens de prueba de inserción gratuitos para el desarrollo, deberá comprar una capacidad para producción. El banner Versión de evaluación gratuita seguirá apareciendo en la parte superior del informe insertado hasta que compre una capacidad.

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