Compartir a través de

Insertar un icono de panel

  • Artículo

Propina

Pruebe a insertar un icono de 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.

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

Inserción de un icono de 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 icono de panel, use un objeto de configuración de tipo ITileLoadConfiguration:

interface ITileLoadConfiguration {
    accessToken: string;
    dashboardId: string;
    embedUrl: string;
    id: string;
    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.

  • dashboardId: el identificador del panel que contiene el icono que va a insertar. Puede usar un Dashboards API para obtener este identificador. Dos ejemplos son:

  • embedUrl: la dirección URL del icono del panel que va a insertar. Esta dirección URL se convierte en el origen del elemento html iframe que contiene el icono del 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 icono del panel que va a insertar. Puede usar un Dashboards API para obtener este identificador. Dos ejemplos son:

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

    • Use models.TokenType.Aad si va a insertar para su organización (el usuario posee los datos).
    • Use models.TokenType.Embed si va a insertar para los clientes (la aplicación posee los 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 'tile' para un icono de panel.

Ejemplo

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

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

Contenido relacionado