Tutorial: Inserción de contenido de Power BI por medio de una aplicación de ejemplo de inserción para la organización

Los análisis insertados de Power BI le permiten insertar contenido de Power BI, como son los informes, los paneles y los iconos, en una aplicación.

En este tutorial, aprenderá a:

• Configurar el entorno integrado
• Configurar una aplicación de ejemplo de inserción para la organización (también conocida como datos en posesión del usuario)

Para usar esa aplicación, los usuarios tendrán que iniciar sesión en Power BI.

La solución de inserción para la organización suelen usarla empresas y organizaciones de gran tamaño, y está pensada para los usuarios internos.

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 la organización en uno de los siguientes marcos:

• .NET Framework
• .NET Core
• React TypeScript

Nota

Los ejemplos de .NET Core y .NET Framework permiten al usuario final ver cualquier panel, informe o icono de Power BI al que tenga acceso en el servicio Power BI. El ejemplo de React TypeScript solo le permite insertar un informe al que el usuario final ya tenga acceso en el servicio Power BI.

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.

    • Una de las siguientes licencias:

      • Power BI Pro

      • Prémium por usuario (PPU)

    Nota

    Para pasar a producción, necesitará una de las siguientes configuraciones:

    • Todos los usuarios con licencias Pro.
    • Todos los usuarios con licencias PPU.
    • SKU equivalente o superior a una SKU F64. Esta configuración permite que todos los usuarios tengan licencias gratuitas.

• Dependencias de código

  .NET Core

  • SDK de .NET Core 3.1 (o superior)

  • Un entorno de desarrollo integrado (IDE). Se recomienda usar uno de los siguientes entornos de desarrollo integrado:

    • Visual Studio

    • Visual Studio Code

  .NET Framework

  • .NET Framework 4.8

  • Visual Studio

  React TypeScript

  • Un editor de texto

  • Terminal de línea de comandos (o PowerShell)

---

Método

Para crear una aplicación de ejemplo de inserción para la organización, siga los siguientes pasos:

1. Registrar una aplicación de Microsoft Entra.

2. Crear un área de trabajo de Power BI

3. Crear y publicar un informe de Power BI

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

5. Insertar el contenido

Paso 1: Registrar una aplicación de Microsoft Entra

El registro de la aplicación con Microsoft Entra ID le permite establecer una identidad para la aplicación.

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

Paso 2: 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 3: 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).

   

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 4: Obtener los valores de parámetro de la inserción

Para insertar el contenido, debe obtener una serie de valores de parámetros. Los valores de parámetros dependen del lenguaje de la aplicación de ejemplo que quiera usar. En la siguiente tabla se enumeran los valores de parámetros necesarios para cada ejemplo.

Parámetro	.NET Core	.NET Framework	React TypeScript
Id. de cliente
Secreto de cliente
Id. del área de trabajo
Id. del informe

Id. de cliente

Sugerencia

Se aplica a: .NET Core .NET Framework React TypeScript

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

Secreto del cliente

Sugerencia

Se aplica a: .NET Core .NET Framework React TypeScript

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. del área de trabajo

Sugerencia

Se aplica a: .NET Core .NET Framework React TypeScript

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

   

Report ID (Id. de informe)

Sugerencia

Se aplica a: ReactTypeScript de .NET Core .NET Framework

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.

   

Paso 5: Inserción del contenido

La aplicación de ejemplo insertada de Power BI permite crear una aplicación de Power BI de inserción para la organización.

Siga estos pasos para modificar la aplicación de ejemplo de inserción para la organización con el fin de 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 las siguientes carpetas según el lenguaje que quiera que use la aplicación:

   • .NET Core
   • .NET Framework
   • React-TS

   Nota

   Las aplicaciones de ejemplo de inserción para la organización solo admiten los marcos previamente mostrados. Las aplicaciones de ejemplo de Java, Node JS y Python solo admiten la inserción para la solución de los clientes .

.NET Core

Configurar la aplicación Microsoft Entra

1. Inicie sesión en Azure Portal.

2. Seleccione App registrations (Registros de aplicaciones). Si no puede ver esta opción, búsquela.

3. Abra la aplicación Microsoft Entra que creó en el Paso 1: Registrar una aplicación de Microsoft Entra.

4. En el menú Administrar, seleccione Autenticación.

5. En Configuraciones de plataforma, abra la plataforma Web y, en la sección URI de redirección, agregue https://localhost:5000/signin-oidc.

   Nota

   Si no tiene una plataforma Web, seleccione Agregar una plataforma y, en la ventana Configurar plataformas, elija Web.

6. Guarde los cambios.

Configuración de la aplicación de inserción de ejemplo

1. Abra la carpeta Embed for your organization (Inserción para la organización).

2. Abra la aplicación de ejemplo Embed for your organization (Inserción para la organización) con uno de estos métodos:

   • Si usa Visual Studio, abra el archivo UserOwnsData.sln.

   • Si usa Visual Studio Code, abra la carpeta UserOwnsData.

3. Abra appsettings.json y rellene los siguientes valores de parámetros:

   • ClientId: use el GUID de id. de cliente.

   • ClientSecret: use el secreto de cliente.

Ejecutar la aplicación de ejemplo

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

2. Inicie sesión en la aplicación de ejemplo para la inserción.

   Nota:

   La primera vez que inicie sesión, se le pedirá que acepte los permisos de Microsoft Entra para la aplicación.

3. Cuando la aplicación de ejemplo de inserción se cargue, seleccione el contenido de Power BI que quiera insertar y, luego, Insertar.

   

.NET Framework

Configurar la aplicación Microsoft Entra

1. Inicie sesión en Azure Portal.

2. Seleccione App registrations (Registros de aplicaciones). Si no puede ver esta opción, búsquela.

3. Abra la aplicación Microsoft Entra que creó en el Paso 1: Registrar una aplicación de Microsoft Entra.

4. En el menú Administrar, seleccione Autenticación.

5. En Configuraciones de plataforma, configure las opciones siguientes:

   1. En la sección URI de redirección de la plataforma Web, agregue https://localhost:44300/.

      Nota

      Si no tiene una plataforma Web, seleccione Agregar una plataforma y, en la ventana Configurar plataformas, seleccione Web.

   2. Habilite la opción Tokens de id. en Implicit grant and hybrid flows (Flujos híbridos y concesión implícita).

6. Guarde los cambios.

Configuración de la aplicación de inserción de ejemplo

1. Abra la carpeta Embed for your organization (Inserción para la organización).

2. Si usa Visual Studio, abra el archivo UserOwnsData.sln.

3. Abra Web.config y rellene los siguientes valores de parámetros:

   • clientId: use el GUID de id. de cliente.

   • clientSecret: use el secreto de cliente.

Ejecutar la aplicación de ejemplo

1. Ejecute el proyecto seleccionando IIS Express (Reproducir).

2. Inicie sesión en la aplicación de ejemplo para la inserción.

   Nota:

   La primera vez que inicie sesión, se le pedirá que acepte los permisos de Microsoft Entra para la aplicación.

3. Cuando la aplicación de ejemplo de inserción se cargue, seleccione el contenido de Power BI que quiera insertar y, luego, Insertar.

   

React TypeScript

Configurar la aplicación Microsoft Entra

1. Inicie sesión en Azure Portal.

2. Seleccione App registrations (Registros de aplicaciones). Si no puede ver esta opción, búsquela.

3. Abra la aplicación Microsoft Entra que creó en el Paso 1: Registrar una aplicación de Microsoft Entra.

4. En el menú Administrar, seleccione Autenticación.

5. En Configuraciones de plataforma, configure la plataforma Web de la siguiente manera:

   1. En URI de redirección, agregue https://localhost:3000 y seleccione Configurar.

      Nota

      Si no tiene una plataforma Web, seleccione Agregar una plataforma y, en la ventana Configurar plataformas, elija Web.

   2. Habilite ambas opciones en Implicit grant and hybrid flows (Flujos híbridos y concesión implícita).

      • Tokens de acceso
      • Tokens de identificador

6. Guarde los cambios.

Configuración de la aplicación de inserción de ejemplo

1. Abra la carpeta Embed for your organization>UserOwnsData>src.

2. Con un editor de texto, abra el archivo Config.ts y rellene los siguientes valores de parámetros:

   • clientId: use el GUID de id. de cliente.

   • workspaceId: use el id. de área de trabajo.

   • reportId: use el id. de informe.

3. Guarde el archivo.

Ejecutar la aplicación de ejemplo

1. Abra un terminal y navegue a Insertar para la organización>UserOwnsData.

2. Instale las dependencias necesarias escribiendo el siguiente comando:

   npm install

3. Ejecute la aplicación escribiendo el siguiente comando:

   npm run start

   Nota:

   La primera vez que inicie sesión, se le pedirá que acepte los permisos de Microsoft Entra para la aplicació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.

Actualización de permisos de usuario

Los usuarios necesitan permiso para acceder a la carpeta de Power BI en la que se encuentra el informe. Cuando se concede permiso a un usuario para acceder a una carpeta, el cambio suele surtir efecto solo después de que el usuario inicie sesión en el portal de Power BI. Para que los nuevos permisos surtan efecto inmediatamente, en el escenario insertado, realice una llamada explícita a la API REST RefreshUser Permissions al iniciarse. Esta llamada API actualizará los permisos y evitará errores de autorización para los usuarios con permisos recién concedidos.

Contenido relacionado

• Tutorial: Inserción de contenido de Power BI por medio de una aplicación de ejemplo de inserción para los clientes
• Insertar informes paginados

Pregunte a la comunidad de Power BI