Compartir a través de

Inserción de un panel

  • Artículo

En este artículo se describen los pasos para insertar un panel en la aplicación. Obtenga más información sobre los paneles de Introducción a los paneles para diseñadores de Power BI.

Propina

Pruebe a insertar un panel o experimente con nuestras API de cliente en la sección Explorar nuestras API de la área de juegos de Análisis insertado de Power BI.

Cómo insertar un panel

Al insertar contenido de Power BI en una aplicación, se usa un objeto de configuración para definir el contenido que va a insertar y especificar la configuración del contenido. A continuación, pasa ese objeto a la API.

Al insertar un panel, use un objeto de configuración de tipo IDashboardLoadConfiguration:

interface IDashboardLoadConfiguration {
    accessToken: string;
    embedUrl?: string;
    id: string;
    pageView?: models.PageView 
    tokenType?: models.TokenType;
    type: string;
}

Esta interfaz contiene las siguientes propiedades:

  • accessToken: el token que proporciona acceso a los datos de Power BI que va a insertar. Consulte Descripción de las diferentes soluciones de inserción para obtener más información sobre los tokens de acceso.

  • embedUrl: la dirección URL del panel que va a insertar. Esta dirección URL se convierte en el origen del elemento html iframe que contiene el panel incrustado. En concreto, la API asigna la dirección URL al atributo src del iframe. Puede usar un api de paneles de para obtener esta dirección URL. Dos ejemplos son:

  • id: el identificador del panel que va a insertar. Use un API dashboards para obtener este identificador. Por ejemplo:

  • pageView: el formato que usa la API para el panel incrustado. Entre las posibilidades se incluyen:

    • fitToWidth: el ancho del panel incrustado coincide con el ancho del elemento div que contiene el panel.
    • oneColumn: el panel incrustado aparece en una columna.
    • actualSize: la API muestra el panel incrustado en tamaño completo.

  • tokenType: el tipo de token que proporciona acceso a los datos de Power BI que va a insertar.

    • Use models.TokenType.Aad para insertar para su organización (usuario posee datos).
    • Use models.TokenType.Embed para insertar para los clientes (aplicación posee datos).

    Consulte Comprender las diferentes soluciones de inserción para obtener más información.

  • type: el tipo de contenido que va a insertar. Use 'dashboard' para un panel.

Ejemplo

En el ejemplo siguiente se muestra cómo insertar un único panel:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    id: aDashboardId,
    pageView: 'fitToWidth',
    tokenType: aTokenType,
    type: 'dashboard'
};
 
// Get a reference to the HTML element that contains the embedded dashboard.
let dashboardContainer = $('#dashboardContainer')[0];
 
// Embed the dashboard.
let dashboard = powerbi.embed(dashboardContainer, embedConfiguration);

Consideraciones y limitaciones

  • No se admite la inserción de paneles en SKU EM

  • Al insertar contenido, la aplicación muestra el contenido en un elemento div. Si usa un valor de pageView de actualSize al insertar un panel:

    • Si el panel es más amplio que el elemento div, la API usa el ancho del elemento div como ancho del panel incrustado.
    • Si el panel es más estrecho que el elemento div, la API rellena el espacio sin usar con el fondo incrustado. De forma predeterminada, ese fondo es blanco, pero puede configurarlo para que sea transparente. En ese caso, el estilo del elemento div es visible en el espacio sin usar.

Contenido relacionado