Compartir a través de

Enlazar conjuntos de datos dinámicamente a un informe paginado

  • Artículo

Los informes de Power BI y los informes paginados se crean en función de un conjunto de datos existente. Ese conjunto de datos define el esquema de datos que usan los objetos visuales del informe. Mediante el enlace dinámico, puede seleccionar un conjunto de datos sobre la marcha al insertar un objeto visual de informe paginado.

Los conjuntos de datos que seleccione deben usar el mismo esquema de datos. Si tiene varios conjuntos de datos con el mismo esquema de datos, el informe puede conectarse o enlazarse dinámicamente a cada uno de esos conjuntos de datos. A continuación, puede mostrar información diferente, en función de sus necesidades.

El enlace dinámico también ofrece otras ventajas. No es necesario crear una copia del mismo informe con un conjunto de datos diferente para cada usuario. Un informe puede servir a varios usuarios. A continuación, esta característica reduce el número de elementos mantenidos y mejora el control del ciclo de vida de la aplicación. Como resultado, el enlace dinámico simplifica la incorporación de nuevos clientes.

Conexión dinámica de un informe a varios conjuntos de datos

Los informes y los conjuntos de datos pueden estar en áreas de trabajo de independientes, pero ambas áreas de trabajo deben tener una capacidad.

Al insertar para los clientes, el token de inserción debe incluir permisos para el informe y el conjunto de datos enlazado dinámicamente. Use la nueva API para generar un token de inserción de que admita elementos de Power BI, como informes y paneles.

Al insertar para su organización, el token de Azure Active Directory (AD) del usuario que use debe tener los permisos adecuados para todos los elementos de Power BI.

Ejemplo 1: Inserción de un informe paginado con enlace dinámico

Para implementar un informe paginado incrustado mediante el enlace dinámico, agregue la propiedad datasetBindings al objeto de configuración de inserción, como se muestra en el ejemplo siguiente.

let config = {
    type: 'report',
    tokenType: models.TokenType.Embed,
    accessToken: accessToken,
    embedUrl: embedUrl,
    id: "reportId",
    permissions: permissions,
    datasetBindings: [{
            sourceDatasetId: "originalDatasetId",
            targetDatasetId: "notOriginalDatasetId"
        }]
};

// Get a reference to the embedded report HTML element.
let embedContainer = $('#embedContainer')[0];

// Embed the report and display it within the div container.
let report = powerbi.embed(embedContainer, config);

Ejemplo 2: Inserción de un objeto visual de informe paginado con enlace dinámico

Un objeto visual de informe paginado es un informe paginado incrustado en un informe de Power BI. Para implementar un objeto visual de informe paginado incrustado mediante el enlace dinámico, agregue la propiedad datasetBinding al objeto de configuración de inserción, como se muestra en el ejemplo siguiente.

let config = {
    type: 'report',
    tokenType: models.TokenType.Embed,
    accessToken: accessToken,
    embedUrl: embedUrl,
    id: "reportId",
    permissions: permissions,
    datasetBinding: {
        datasetId: "notOriginalDatasetId",
        paginatedReportBindings: [{
            sourceDatasetId: "originalDatasetId",
            targetDatasetId: "notOriginalDatasetId"
        }]
    }
};

// Get a reference to the embedded report HTML element.
let embedContainer = $('#embedContainer')[0];

// Embed the report and display it within the div container.
let report = powerbi.embed(embedContainer, config);

Consideraciones y limitaciones

  • El conjunto de datos seleccionado dinámicamente debe usar el mismo esquema de datos en el informe.
  • Al insertar para los clientes, genere un token de inserción de mediante la nueva API.
  • Al insertar para su organización, asegúrese de que el usuario tiene permisos para el informe y el conjunto de datos.
  • La propiedad datasetBinding no puede estar vacía. Debe contener, datasetId, paginatedReportBindingso ambos.
  • Los valores de datasetId y targetDatasetId no tienen que ser los mismos. El enlace funciona de forma independiente para .pbix e informes paginados.
  • La propiedad datasetBinding puede contener varios objetos.