Aracılığıyla paylaş

Pano ekleme

  • Makale

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

Bahşiş

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

Pano 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 eklediğinizde, IDashboardLoadConfigurationtüründe bir yapılandırma nesnesi kullanın:

interface IDashboardLoadConfiguration {
    accessToken: string;
    embedUrl?: string;
    id: string;
    pageView?: models.PageView 
    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.

  • embedUrl - Eklediğiniz panonun URL'si. Bu URL, eklenmiş panoyu 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 panonun kimliği. Bu kimliği almak için Panolar API'si kullanın. Mesela:

  • pageView - API'nin eklenmiş pano için kullandığı biçim. Olasılıklar şunlardır:

    • fitToWidth - Eklenmiş panonun genişliği, panoyu içeren div öğesinin genişliğiyle eşleşir.
    • oneColumn - Eklenmiş pano tek bir sütunda görünür.
    • actualSize - API, eklenmiş panoyu tam boyutta görüntüler.

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

    • Kuruluşunuza eklemek için models.TokenType.Aad kullanın (kullanıcının verileri).
    • Müşterilerinize eklemek için models.TokenType.Embed kullanın (uygulama verisahip).

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

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

Örnek

Aşağıdaki örnekte, tek bir panonun nasıl eklenerek ekli olduğu gösterilmektedir:

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

Dikkat edilmesi gerekenler ve sınırlamalar

  • EM SKU'larına pano ekleme desteklenmez

  • İçerik eklediğinizde, uygulamanız içeriği bir div öğesinde görüntüler. Pano eklerken actualSizepageView değeri kullanıyorsanız:

    • Pano div öğesinden daha genişse API, eklenmiş panonun genişliği olarak div öğesinin genişliğini kullanır.
    • Pano div öğesinden daha darsa, API kullanılmayan alanı eklenmiş arka planla doldurur. Varsayılan olarak, bu arka plan beyazdır, ancak saydam olacak şekilde yapılandırabilirsiniz. Bu durumda, div öğesinin stili kullanılmayan alanda görünür.

İlgili içerik