Compartir a través de

Inserción de un informe

  • Artículo

Propina

Pruebe a insertar un informe o experimento con nuestras API de cliente en la sección Explore 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 informe de Power BI en la aplicación. Obtenga más información sobre los informes de informes en Power BI.

Inserción de un informe

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. Consulte Configuración de las opciones de informe para obtener más información.

Inserción de un informe existente

Cuando inserte un informe que ya existe, use un objeto de configuración de tipo IReportLoadConfiguration.

interface IReportLoadConfiguration {
    accessToken: string;
    bookmark?: models.IApplyBookmarkRequest;
    contrastMode?: models.ContrastMode;
    datasetBinding?: models.IDatasetBinding;
    embedUrl?: string;
    filters?: models.ReportLevelFilters[];
    id: string;
    pageName?: string;
    permissions?: models.Permissions;
    settings?: models.IEmbedSettings;
    slicers?: models.ISlicer[];
    theme?: models.IReportTheme;
    tokenType?: models.TokenType;
    type: string;
    viewMode?: models.ViewMode;
}

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.

  • datasetBinding: conjunto de datos que define el esquema de datos que usa el informe incrustado. Consulte Enlazar conjuntos de datos dinámicamente a un informe para obtener más información sobre los conjuntos de datos.

  • embedUrl: la dirección URL del informe que va a insertar. Esta dirección URL se convierte en el origen del elemento HTML iframe que contiene el informe 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 va a insertar.

  • permissions: operaciones que concede a los usuarios para el informe insertado. Estos valores están disponibles:

    • Read: los usuarios pueden ver el informe.
    • ReadWrite: los usuarios pueden ver, editar y guardar el informe.
    • Copy: los usuarios pueden guardar una copia del informe mediante Guardar como.
    • Create: los usuarios pueden crear un nuevo informe.
    • All: los usuarios pueden crear, ver, editar, guardar y guardar una copia del 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 'report' para un informe de Power BI.

La interfaz IReportLoadConfiguration también contiene otras propiedades. Consulte Configuración de las opciones de informe para obtener información sobre estas propiedades:

  • bookmark
  • contrastMode
  • filters
  • pageName
  • settings
  • slicers
  • theme
  • viewMode

Inserción de un nuevo informe

Al insertar un nuevo informe que cree a partir de un conjunto de datos, use un objeto de configuración de tipo IReportCreateConfiguration.

interface IReportCreateConfiguration {
    accessToken: string;
    datasetId: string;
    embedUrl?: string;
    settings?: models.IEmbedSettings;
    theme?: IReportTheme;
    tokenType?: models.TokenType;
    type: string;
}

Las propiedades de esta interfaz son similares a las propiedades de la interfaz IReportLoadConfiguration, con las siguientes excepciones:

  • datasetId: el identificador del conjunto de datos que define el esquema de datos que usa el nuevo informe.

  • embedUrl: la dirección URL del conjunto de datos que define el esquema de datos que usa el nuevo informe. Esta dirección URL se convierte en el origen del elemento HTML iframe que contiene el informe incrustado. En concreto, la API asigna la dirección URL al atributo src del iframe. Puede usar una api de conjuntos de datos de para obtener esta dirección URL. Dos ejemplos son:

Consulte Crear, editar y guardar un informe incrustado para obtener información sobre cómo editar y crear informes.

Ejemplo

En el ejemplo siguiente se muestra cómo insertar un informe:

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

Contenido relacionado