Inserción de un informe paginado

SE APLICA A: Power BI Report Builder Power BI Desktop

En este artículo se proporciona información general sobre las diferencias entre insertar un informe de Power BI e insertar un informe paginado de Power BI. El artículo está dirigido a desarrolladores que usan análisis insertados de Power BI para insertar un informe paginado.

Consideraciones sobre el modelo semántico

Un informe de Power BI siempre está enlazado a un único origen de datos. Sin embargo, un informe paginado no requiere un modelo semántico de Power BI como origen de datos. Un informe paginado también puede crearse sobre múltiples modelos semánticos. Esto significa que no puede confiar en la propiedad datasetId de un objeto de informe al insertar un informe paginado.

Consideraciones sobre tokens

Hay algunas consideraciones especiales al generar un token de inserción para un informe paginado con una solución de Insertar para los clientes. Si el informe paginado tiene uno o más modelos semánticos de Power BI configurados como sus fuentes de datos, debe crear un objeto GenerateTokenRequestV2Dataset para cada modelo semántico, con los siguientes parámetros:

• xmlaPermissions se debe establecer en ReadOnly

• allowEdit se debe establecer en false

Características no admitidas

Antes de insertar un informe paginado, tenga en cuenta las siguientes características de Power BI que no se admiten:

• Modo de edición o cualquier tipo de creación de autoservicio

• Eventos del lado cliente, como loaded y rendered

• Enlace dinámico

• Leer o actualizar la configuración del filtro

• Navegación de páginas

• Recuperación de un valor de parámetro actualizado por el usuario mediante una API

Ejemplo de código

En la lista de código siguiente se muestra cómo generar un token de inserción para insertar un informe paginado basado en un modelo semántico de Power BI.

string datasetId = "11111111-1111-1111-1111-111111111111";
Guid reportId = new Guid("22222222-2222-2222-2222-222222222222");

// create semantic model request for embed token with XmlaPermissions.ReadOnly
var datasetRequests = new List<GenerateTokenRequestV2Dataset> {
  new GenerateTokenRequestV2Dataset(datasetId, xmlaPermissions: XmlaPermissions.ReadOnly)
};

// create report request for embed token with allowEdit set to false
var reportRequests = new List<GenerateTokenRequestV2Report>{
  new GenerateTokenRequestV2Report(reportId, allowEdit: false)
};

// create token request
var tokenRequest = new GenerateTokenRequestV2 {
  Datasets = datasetRequests,
  Reports = reportRequests,
};

// call GenerateToken to retrieve embed token from Power BI REST API
var EmbedTokenResult = pbiClient.EmbedToken.GenerateToken(tokenRequest);

// extract embed token for embed token result
var embedToken = EmbedTokenResult.Token;

Contenido relacionado

Uso de las API de REST de Power BI

API de cliente de análisis integrados de Power BI