Sayfalandırılmış rapor ekleme

  • Makale

İpucu

sayfalandırılmış rapor eklemeyi deneyin veya Power BI Embedded Analytics Oyun Alanı'nınAPI'lerimizi keşfedin bölümünde istemci API'lerimizle denemeler yapın.

Bu makalede, uygulamanıza sayfalandırılmış rapor ekleme adımları ele alınıyor. Sayfalandırılmış raporlar hakkında daha fazla bilgi için bkz. Power BI Premium sayfalandırılmış raporlar nelerdir?.

Sayfalandırılmış rapor ekleme

Bir uygulamaya Power BI içeriği eklediğinizde, içeriği tanımlar ve bir yapılandırma nesnesinde ayarlarını belirtirsiniz. Ardından bu nesneyi API'ye geçirirsiniz.

Sayfalandırılmış rapor eklerken, türünde IPaginatedReportLoadConfigurationbir yapılandırma nesnesi kullanın:

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

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ümlerini anlama .

  • embedUrl - Eklediğiniz raporun URL'si. Bu URL, eklenmiş raporu içeren HTML iframe öğesinin kaynağı olur. Özellikle API, URL'yi iframe özniteliğine src atar. Bu URL'yi almak için Bir Rapor API'si kullanabilirsiniz. İki örnek şunlardır:

    Aşağıda açıklanan özelliği kullanarak rapor parametrelerini rapora parameterValues geçirmenizi öneririz. Bununla birlikte, ekleme URL'sinin sonuna sorgu dizesini ekleyerek de parametreleri rapora geçirebilirsiniz. Sayfalandırılmış raporlarda URL parametrelerini geçirme hakkında daha fazla bilgi edinin. Parametreleri URL'ye geçirme örneklerine bakın.

  • id - Eklediğiniz Power BI raporunun kimliği.

  • hostname - Varsayılan hostname değer app.powerbi.com. Bağımsız bir bulut kullanıyorsanız URL'yi burada sağlayın. için embedURLhostname bir değer sağladıysanız, değeri yoksayılır.

  • settings - IPaginatedReportSettings türünde bir yapılandırma nesnesi. Bu nesne, raporun parametre panelinin görünümüyle ilgili bilgileri belirtir. Parametre paneli, eylem çubuğunun altındaki çubuk olup genişletilebilir veya gizlenebilir.

    Eklenmiş bir Power BI sayfalandırılmış raporunu gösteren ekran görüntüsü. Parametre paneli en üste yakın ve kırmızı renkle vurgulanmış.

    • Eylem çubuğundaki Parametreler düğmesine tıklayarak parametre panelini gösterebilir veya gizleyebilirsiniz. Bu düğme varsayılan olarak kullanılabilir. Ancak panelin enabled özelliğini olacak falseşekilde yapılandırdığınızda Parametreler düğmesi kullanılamaz.

    • Varsayılan olarak, API parametre panelini daraltıyor. Panelin expanded özelliğini trueolarak ayarlarsanız, API raporu bu panel genişletilmiş olarak yükler.

    • Bu kod, özelliğini yapılandırmanın settings bir yolunu gösterir:

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

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

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

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

  • parameterValues – türünde IPaginatedReportParameterbir yapılandırma nesnesi. Bu özelliği kullanarak rapor parametrelerini ayarlayın. Bu yöntem JavaScript SDK'sını kullanır ve rapor parametrelerini geçirmek için tercih edilen yöntemdir. Örnek:

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

    Bu yöntem yalnızca rapor parametrelerini (URL öneki rp:olan parametreler) geçirmek için kullanılabilir; rdl parametrelerini (URL ön eki rdl:ile) geçirmek için kullanılamaz.

Örnek

Aşağıdaki örnekte sayfalandırılmış rapor ekleme işleminin nasıl yapıldığını gösterilmektedir:

// 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);

Çok kaynaklı ekleme belirtecinde bağlama için kullanılan tüm DatasetId'leri eklediğinizden emin olun.

Önemli noktalar ve sınırlamalar

  • Dinamik bağlamayı kullanmak için bkz. Veri kümelerini sayfalandırılmış rapora dinamik olarak bağlama.
  • Önyüklenen yöntem sayfalandırılmış raporlar için desteklenmez.
  • Sayfalandırılmış rapor eklenirken çok değerli parametreler desteklenmez.
  • parameterValues özelliği yalnızca rapor parametreleri için kullanılabilir. Rdl parametreleri için kullanılamaz.
  • Gerçek zamanlı veri kümesi (gönderim veri kümesi) ile sayfalandırılmış rapor eklemek desteklenmez.

Sonraki adımlar