Incorporare un report incorporato

Suggerimento

Provare a incorporare un report impaginato o provare a usare le API client nella sezione Esplorare le API di Power BI Embedded Analytics Playground.

Questo articolo illustra i passaggi per incorporare un report impaginato nell'applicazione. Altre informazioni sui report impaginati in Che cosa sono i report impaginati in Power BI Premium?.

Come incorporare un report impaginato

Quando si incorpora il contenuto di Power BI in un'app, si definisce il contenuto e si specificano le relative impostazioni in un oggetto di configurazione. Passare quindi l'oggetto all'API.

Quando si incorpora un report impaginato, usare un oggetto di configurazione di tipo IPaginatedReportLoadConfiguration:

export interface IPaginatedReportLoadConfiguration {
    accessToken: string;
    id: string;
    embedUrl?: string;
    settings?: IPaginatedReportSettings;
    tokenType?: TokenType;
    type?: string;
    parameterValues?: IPaginatedReportParameter[];
}

Questa interfaccia contiene le proprietà seguenti:

• accessToken : token che consente di accedere ai dati di Power BI da incorporare. Per altre informazioni sui token di accesso, vedere Informazioni sulle diverse soluzioni di incorporamento .

• embedUrl : URL del report da incorporare. Questo URL diventa l'origine dell'elemento iframe HTML che contiene il report incorporato. In particolare, l'API assegna l'URL all'attributo dell'iframe src . È possibile usare un'API report per ottenere questo URL. Di seguito sono riportati due esempi:

  • Report - Ottenere report in gruppo
  • Report - Ottenere report in gruppo

  È consigliabile passare i parametri del report al report usando la parameterValues proprietà descritta di seguito. È tuttavia possibile passare parametri al report aggiungendo la stringa di query alla fine dell'URL di incorporamento. Altre informazioni sul passaggio dei parametri URL nei report impaginati. Vedere esempi di passaggio di parametri a un URL.

• id : ID del report di Power BI che si sta incorporando.

• hostname : il valore predefinito hostname è app.powerbi.com. Se si usa un cloud sovrano, specificare l'URL qui. Se è stato specificato un valore per embedURL, l'oggetto hostname verrà ignorato.

• settings : oggetto di configurazione di tipo IPaginatedReportSettings. Questo oggetto specifica informazioni sull'aspetto del pannello dei parametri del report. Il pannello dei parametri è la barra sotto la barra delle azioni che può essere espansa o nascosta.

  

  • È possibile visualizzare o nascondere il pannello dei parametri facendo clic sul pulsante Parametri sulla barra delle azioni. Il pulsante è disponibile per impostazione predefinita. Tuttavia, se si configura la proprietà del enabled pannello come false, il pulsante Parametri non è disponibile.

  • Per impostazione predefinita, l'API comprime il pannello dei parametri. Se si imposta la proprietà del expanded pannello su true, l'API carica il report con questo pannello espanso.

  • Questo codice mostra un modo per configurare la settings proprietà:

    settings: {
        commands: {
            parameterPanel: {
                enabled: true,
                expanded: true
            }
        }
    }
    

• tokenType : tipo di token che consente di accedere ai dati di Power BI incorporati.

  • Usare models.TokenType.Aad se si esegue l'incorporamento per l'organizzazione (i dati sono di proprietà dell'utente).
  • Usa models.TokenType.Embed se stai incorporando i tuoi clienti (i dati sono di proprietà dell'app).

  Per altre informazioni, vedere Informazioni sulle diverse soluzioni di incorporamento .

• parameterValues : oggetto di configurazione di tipo IPaginatedReportParameter. Impostare i parametri del report usando questa proprietà. Questo metodo usa JavaScript SDK ed è il metodo preferito per passare i parametri del report. Ad esempio:

  parameterValues: [
        {name: "State", value: "WA"},
        {name: "City", value: "Seattle"},
        {name: "City", value: "Bellevue"},
        {name: "City", value: "Redmond"}
  ]
  

  Questo metodo può essere usato solo per passare i parametri del report (i parametri con prefisso rp:URL ) e non i parametri rdl (con il prefisso rdl:URL ).

Esempio

L'esempio seguente illustra come incorporare un report impaginato:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    uniqueId: aReportId,
    tokenType: aTokenType,
    type: 'report',
    datasetBindings: [{
      sourceDatasetId: "originalDatasetId",
      targetDatasetId: "notOriginalDatasetId"
    }]
};
 
// 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);

Assicurarsi di includere tutti gli ID set di dati usati per l'associazione nel token di incorporamento a più risorse.

Considerazioni e limitazioni

• Per usare l'associazione dinamica, vedere Associare dinamicamente i set di dati a un oggetto visivo del report impaginato.
• Il metodo bootstrapped non è supportato per i report impaginati.
• I parametri multivalore non sono supportati durante l'incorporamento di un report impaginato.
• La parameterValues proprietà può essere utilizzata solo per i parametri del report. Non può essere usato per i parametri rdl.
• L'incorporamento di un report impaginato con un set di dati in tempo reale (set di dati push) non è supportato.

Passaggi successivi

• Incorporare un report
• Che cosa sono i report impaginati?
• Esplorare le API