Aracılığıyla paylaş

Rapor görseli ekleme

  • Makale

Bahşiş

Power BI Embedded Analytics PlaygroundAPI'lerimizi keşfetme bölümünde bir rapor görseli eklemeyi veya istemci API'lerimizle deneme yapmayı deneyin.

Bu makale, uygulamanıza bir görsel ekleme adımlarını kapsar. Power BI'daki Görseller'deki görseller hakkında daha fazla bilgi edinin.

Görsel 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.

Görsel eklediğinizde, IVisualLoadConfigurationtüründe bir yapılandırma nesnesi kullanın:

interface IVisualLoadConfiguration {
    accessToken?: string;
    embedUrl?: string;
    id?: string;
    pageName: string;
    tokenType?: models.TokenType;
    type: string;
    visualName: string;
}

Bu arabirim şu ö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 görseli içeren raporun URL'si. Bu URL, eklenmiş görseli içeren HTML iframe öğesinin kaynağı olur. Özellikle, API URL'yi iframesrc özniteliğine atar. Bu URL'yi almak için Rapor API'si kullanabilirsiniz. İki örnek:

  • id - Eklediğiniz görseli içeren Power BI raporunun kimliği.

  • pageName - Eklediğiniz görseli içeren sayfanın adı. Rapordaki sayfaları almak için Rapor getPages yöntemini kullanabilirsiniz.

  • 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ü. Görsel için 'visual' kullanın.

  • visualName - Eklediğiniz görselin adı. Sayfadaki görselleri almak için Page getVisuals yöntemini kullanabilirsiniz.

Örnek

Aşağıdaki örnekte tek bir görselin 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,
    embedUrl: anEmbedUrl,
    id: aReportId,
    pageName: aPageName,
    tokenType: aTokenType,
    type: 'visual',
    visualName: aVisualName
};
 
// Get a reference to the HTML element that contains the embedded report.
let embedContainer = $('#embedContainer')[0];
 
// Embed the visual.
let visual = powerbi.embed(embedContainer, embedConfiguration);

Filtre

Varsayılan olarak updateFilters API'sinde tek bir rapor görseli eklenirken görsel düzeyi filtreleri uygulanır. Bunlar rapor düzeyinde uygulandığından, ekleme yapılandırma nesnesine uygulanan filtrelerle çakışmaya neden olabilir. Bu sorunu düzeltmek için API ile filtreler düzeyini ayarlayabilirsiniz:

await visual.updateFilters(FiltersOperations.Add, filters, FiltersLevel.Report);

Denetimi rapor filtrelerifiltreler hakkında daha fazla bilgi edinin.

İlgili içerik