Inserción de informes en un sitio web o portal seguroEmbed a report in a secure portal or website

Con la nueva opción Insertar para los informes de Power BI, puede insertar de forma fácil y segura informes en portales web internos.With the new Embed option for Power BI reports, you can easily and securely embed reports in internal web portals. Estos portales pueden estar basados en la nube u hospedados en un entorno local, como una instancia de SharePoint 2019.These portals can be cloud-based or hosted on-premises, such as SharePoint 2019. Los informes insertados de esta manera respetan todos los permisos del elemento y la seguridad de los datos mediante la seguridad de nivel de fila (RLS).Embedded reports respect all item permissions and data security through row-level security (RLS). Permiten realizar inserciones sin código en cualquier portal que acepte una dirección URL o un iFrame.They provide no-code embedding into any portal that accepts a URL or iFrame.

La opción Insertar también admite la configuración de direcciones URL y filtros de direcciones URL.The Embed option supports URL Filters and URL settings. Esto le permite realizar la integración con portales mediante un método en el que se usa código de forma limitada y para el que solo se necesitan conocimientos básicos de HTML y JavaScript.It allows you to integrate with portals using a low-code approach requiring only basic HTML and JavaScript knowledge.

Cómo insertar informes de Power BI en portalesHow to Embed Power BI reports into portals

  1. La nueva opción Insertar se encuentra disponible en el menú Archivo de informes del servicio Power BI.The new Embed option is available on the File menu for reports in the Power BI service.

    Opción de lista desplegable de opciones de inserción segura

  2. Seleccione la opción Insertar para abrir un cuadro de diálogo que proporciona un vínculo y un iFrame que puede usar para insertar el informe de forma segura.Select the Embed option to open a dialog that provides a link and an iFrame you can use to embed the report securely.

    Cuadro de diálogo con la opción Insertar

  3. Si un usuario abre directamente la URL de un informe, o bien una URL insertada en un portal web, tendrá que autenticarse para acceder al informe.Whether a user opens a report URL directly, or one embedded in a web portal, report access requires authentication. Se mostrará la pantalla siguiente si un usuario no ha iniciado sesión en Power BI en la sesión del explorador.The following screen appears if a user has not signed-in to Power BI in their browser session. Al seleccionar Iniciar sesión, puede que se abra una nueva pestaña o ventana del explorador.When they select Sign-In, a new browser window or tab could open. Si los usuarios no ven un mensaje de inicio de sesión, pídales que comprueben si hay bloqueadores de elementos emergentes activos.Have them check for pop-up blockers if they don't get prompted to sign in.

    Iniciar sesión para ver el informe

  4. Cuando el usuario inicie la sesión, se abrirá el informe con los datos y se permitirá la navegación de páginas y la configuración de filtros.After the user has signed in, the report opens, showing the data and allowing page navigation and filter setting. Solo los usuarios que tengan permiso de vista podrán ver el informe en Power BI.Only users who have view permission can see the report in Power BI. También se aplican todas las reglas de seguridad de nivel de fila (RLS).All row-level security (RLS) rules are also applied. Por último, el usuario debe tener la licencia correcta: necesita una licencia de Power BI Pro o el informe debe estar en un área de trabajo que tenga una capacidad de Power BI Premium.Lastly, the user needs to be correctly licensed – either they need a Power BI Pro license, or the report must be in a workspace that is in a Power BI Premium capacity. El usuario tendrá que iniciar sesión cada vez que abra una nueva ventana del explorador.The user needs to sign in each time they open a new browser window. Pero, después de iniciar la sesión, otros informes se cargarán automáticamente.However, once signed in, other reports load automatically.

    Informe de inserción

  5. Al usar un iFrame, puede que tenga que editar el alto y el ancho para que se adapte al tamaño de la página web del portal.When using an iFrame, you may need to edit the height and width to have it fit in your portal’s web page.

    Establecimiento del alto y ancho

Concesión de acceso a informesGranting report access

La opción Insertar no permite a los usuarios ver el informe automáticamente.The Embed option doesn't automatically permit users to view the report. Los permisos de vista se establecen en el servicio Power BI.View permissions are set in the Power BI service.

En el servicio Power BI, puede compartir informes insertados y solicitar que los usuarios inicien la sesión.In the Power BI service, you can share embedded reports with users requiring access. Si usa un grupo de Office 365, puede mostrar una lista al usuario como un miembro del área de trabajo.If you're using an Office 365 Group, you can list the user as a workspace member. Para más información, consulte cómo administrar el área de trabajo en Power BI y en Office 365.For more information, see how to manage your workspace in Power BI and Office 365.

LicenciasLicensing

Para ver el informe insertado, los usuarios necesitan tener una licencia de Power BI Pro, o bien el contenido tiene que estar en un área de trabajo con capacidad de Power BI Premium (SKU EM o P).To view the embedded report, users need either a Power BI Pro license or the content needs to be in a workspace that's in a Power BI Premium capacity (EM or P SKU).

Personalización de la experiencia de inserción con la configuración de direcciones URLCustomize your embed experience using URL settings

Puede personalizar la experiencia del usuario mediante la configuración de entrada de la URL de inserción.You can customize the user experience using the embed URL's input settings. En el iFrame especificado, puede actualizar la configuración de src de la URL.In the provided iFrame, you can update the URL's src settings.

PropiedadProperty DescripciónDescription
pageNamepageName Puede usar el parámetro de cadena de consulta pageName para establecer la página en la que se abrirá el informe.You can use the pageName query string parameter to set which report page to open. Este valor aparece al final de la dirección URL de un informe al visualizarlo en el servicio Power BI, como se muestra a continuación.You can find this value at the report URL's end when viewing a report in the Power BI service, as shown below.
Filtros de direcciones URLURL Filters Puede usar filtros de direcciones URL en la dirección URL de inserción que ha recibido de la interfaz de usuario de Power BI para filtrar el contenido de la inserción.You can use URL Filters in the embed URL you received from the Power BI UI to filter the embed content. De este modo, puede compilar integraciones de código reducido con una experiencia básica de HTML y JavaScript.This way you can build low-code integrations with only basic HTML and JavaScript experience.

Configuración de la página en que se abrirá un informe insertadoSet which page opens for an embedded report

El valor de pageName aparece al final de la dirección URL de un informe al visualizarlo en el servicio Power BI.You can find the pageName value at the report URL's end when viewing a report in the Power BI service.

  1. Abra el informe del servicio Power BI en el explorador web y copie la dirección URL de la barra de direcciones.Open the report from the Power BI service in your web browser, and then copy the address bar URL.

    Sección del informe

  2. Anexe el valor de pageName a la dirección URL.Append the pageName setting to the URL.

    Anexión de pageName

Filtrado del contenido de informes con filtros de direcciones URLFilter report content using URL filters

Puede usar filtros de direcciones URL para proporcionar distintas vistas de informes.You can use URL Filters to provide different report views. Por ejemplo, la dirección URL siguiente filtra el informe para mostrar los datos del sector energético.For example, the URL below filters the report to show data for the Energy industry.

El uso de pageName con filtros de direcciones URL puede ser eficaz.Using the combination of pageName and URL Filters can be powerful. Puede crear experiencias con HTML y JavaScript básicos.You can build experiences using basic HTML and JavaScript.

Por ejemplo, puede agregar el siguiente botón a una página HTML:For example, here’s a button you can add to an HTML page:

<button class="textLarge" onclick='show("ReportSection", "Energy");' style="display: inline-block;">Show Energy</button>

Al seleccionar el botón, se llama a una función para actualizar el iFrame con una dirección URL actualizada, que incluye el filtro “Sector energético”.When selected, the button calls a function to update the iFrame with an updated URL, which includes the Energy industry filter.

function show(pageName, filterValue)

{

var newUrl = baseUrl + "&pageName=" + pageName;

if(null != filterValue && "" != filterValue)

{

newUrl += "&$filter=Industries/Industry eq '" + filterValue + "'";

}

//Assumes there’s an iFrame on the page with id=”iFrame”

var report = document.getElementById("iFrame")

report.src = newUrl;

}

Filtrar

Puede agregar tantos botones como quiera para crear una experiencia personalizada de código reducido.You can add as many buttons as you’d like to create a low-code custom experience.

Consideraciones y limitacionesConsiderations and limitations

  • Los informes paginados se admiten con escenarios de inserción seguros; también se admiten los informes paginados con parámetros de dirección URL.Paginated reports are supported with secure embed scenarios, and paginated reports with URL parameters are also supported. Obtenga más información sobre cómo pasar parámetros de informe en una dirección URL para un informe paginado.Read more about passing report parameters in a URL for a paginated report.

  • No admite usuarios invitados externos con Azure B2B (negocio a negocio).Doesn't support external guest users with Azure business to business (B2B).

  • La inserción segura funciona en informes publicados en el servicio Power BI.Secure embed works for reports published to the Power BI service.

  • El usuario tendrá que iniciar sesión para ver el informe cada vez que abra una nueva ventana del explorador.The user needs to sign in to view the report whenever they open a new browser window.

  • Algunos exploradores requieren que se actualice la página después de iniciar sesión, especialmente cuando se usan los modos InPrivate o Incognito.Some browsers require you to refresh the page after sign-in, especially when using InPrivate or Incognito modes.

  • Para lograr una experiencia de inicio de sesión único, use la opción “Insertar en SharePoint Online”, o bien cree una integración personalizada con el método de inserción el usuario es el propietario de los datos.To achieve a single sign-on experience, use the Embed in SharePoint Online option, or build a custom integration using the user owns data embedding method.

  • La funcionalidad de autenticación automática que se incluye con la opción Insertar no funciona con la API de JavaScript para Power BI.The automatic authentication capability provided with the Embed option doesn't work with the Power BI JavaScript API. Con la API de JavaScript para Power BI, use el método de inserción el usuario es el propietario de los datos.For the Power BI JavaScript API, use the user owns data embedding method.

  • La vigencia del token de autenticación depende de la configuración de AAD.The authentication token lifetime is controlled based on your AAD settings. Cuando expire el token de autenticación, el usuario tendrá que actualizar el explorador para obtener un token de autenticación actualizado.When the authentication token expires, the user will need to refresh their browser to get an updated authentication token. La vigencia predeterminada es de una hora, pero puede que en su organización sea más larga o corta.The default lifetime is one hour, but it could be shorter or longer in your organization.

Pasos siguientesNext steps