Aracılığıyla paylaş


Pano kutucuğu ekleme

Bahşiş

Power BI Embedded Analytics PlaygroundAPI'lerimizi keşfetme bölümünde bir pano kutucuğu eklemeyi deneyin veya istemci API'lerimizle denemeler yapın.

Bu makale, uygulamanıza pano kutucuğu ekleme adımlarını kapsar. Power BI tasarımcıları için pano kutucuklarına giriş pano kutucukları hakkında daha fazla bilgi edinin.

Pano kutucuğu ekleme

Bir uygulamaya Power BI içeriği eklerken, eklediğiniz içeriği tanımlamak ve içeriğin ayarlarını belirtmek için bir yapılandırma nesnesi kullanırsınız. Ardından bu nesneyi API'ye geçirirsiniz.

Pano kutucuğunu eklerken, ITileLoadConfigurationtüründe bir yapılandırma nesnesi kullanın:

interface ITileLoadConfiguration {
    accessToken: string;
    dashboardId: string;
    embedUrl: string;
    id: string;
    tokenType?: models.TokenType;
    type: string;
}

Bu arabirim aşağıdaki özellikleri içerir:

  • accessToken - Eklediğiniz Power BI verilerine erişmenizi sağlayan belirteç. Erişim belirteçleri hakkında daha fazla bilgi edinmek için bkz. Farklı ekleme çözümleri anlama.

  • dashboardId - Eklediğiniz kutucuğu içeren panonun kimliği. Bu kimliği almak için Panolar API'si kullanabilirsiniz. İki örnek:

  • embedUrl - Eklediğiniz pano kutucuğunun URL'si. Bu URL, eklenmiş pano kutucuğunu içeren HTML iframe öğesinin kaynağı olur. Özellikle, API URL'yi iframesrc özniteliğine atar. Bu URL'yi almak için Panolar API'si kullanabilirsiniz. İki örnek:

  • id - Eklediğiniz pano kutucuğunun kimliği. Bu kimliği almak için Panolar API'si kullanabilirsiniz. İki örnek:

  • tokenType - Eklediğiniz Power BI verilerine erişmenizi sağlayan belirteç türü.

    • Kuruluşunuz için ekleniyorsanız (verilerin sahibi kullanıcıdır) models.TokenType.Aad kullanın.
    • Müşterileriniz için ekleniyorsanız models.TokenType.Embed kullanın (verilerin sahibi uygulamadır).

    Daha fazla bilgi için bkz. Farklı ekleme çözümleri anlama.

  • type - Eklediğiniz içerik türü. Pano kutucuğu için 'tile' kullanın.

Örnek

Aşağıdaki örnekte, tek bir pano kutucuğunun nasıl ekli olduğu gösterilmektedir:

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