Compartir a través de

Inserción de un objeto visual de informe

  • Artículo

Propina

Pruebe a insertar un objeto visual de informe 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 objeto visual en la aplicación. Obtenga más información sobre los objetos visuales de objetos visuales en Power BI.

Cómo insertar un objeto visual

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 objeto visual, use un objeto de configuración de tipo IVisualLoadConfiguration:

interface IVisualLoadConfiguration {
    accessToken?: string;
    embedUrl?: string;
    id?: string;
    pageName: string;
    tokenType?: models.TokenType;
    type: string;
    visualName: string;
}

Esta interfaz incluye estas 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 informe que contiene el objeto visual que va a insertar. Esta dirección URL se convierte en el origen del elemento html iframe que contiene el objeto visual incrustado. En concreto, la API asigna la dirección URL al atributo src del iframe. Puede usar un de api de informes de para obtener esta dirección URL. Dos ejemplos son:

  • id: el identificador del informe de Power BI que contiene el objeto visual que va a insertar.

  • pageName: el nombre de la página que contiene el objeto visual que va a insertar. Puede usar el método report getPages para obtener las páginas de un informe.

  • 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 'visual' para un objeto visual.

  • visualName: el nombre del objeto visual que va a insertar. Puede usar el método page getVisuals para obtener los objetos visuales de una página.

Ejemplo

En el ejemplo siguiente se muestra cómo insertar un solo objeto visual:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    id: aReportId,
    pageName: aPageName,
    tokenType: aTokenType,
    type: 'visual',
    visualName: aVisualName
};
 
// Get a reference to the HTML element that contains the embedded report.
let embedContainer = $('#embedContainer')[0];
 
// Embed the visual.
let visual = powerbi.embed(embedContainer, embedConfiguration);

Filtros

De forma predeterminada, la API de updateFilters aplicará filtros de nivel visual al insertar un solo objeto visual de informe. Esto puede provocar un conflicto con los filtros aplicados en el objeto de configuración de inserción, ya que se aplican en el nivel de informe. Para corregir este problema, puede establecer el nivel de filtros con la API:

await visual.updateFilters(FiltersOperations.Add, filters, FiltersLevel.Report);

Obtenga más información sobre los filtros de Filtros de informe de control.

Contenido relacionado