Aracılığıyla paylaş


Veri kümelerini sayfalandırılmış rapora dinamik olarak bağlama

Power BI raporları ve sayfalandırılmış raporlar, mevcut bir veri kümesini temel alarak oluşturulur. Bu veri kümesi, rapor görsellerinin kullandığı veri şemasını tanımlar. Dinamik bağlamayı kullanarak, sayfalandırılmış rapor görseli eklerken anında bir veri kümesi seçebilirsiniz.

Seçtiğiniz veri kümelerinin aynı veri şemasını kullanması gerekir. Aynı veri şemasına sahip birden çok veri kümeniz varsa raporunuz bu veri kümelerinin her birine dinamik olarak bağlanabilir veya bağlanabilir. Ardından gereksinimlerinize bağlı olarak farklı içgörüler görüntüleyebilirsiniz.

Dinamik bağlama başka avantajlar da sunar. Her kullanıcı için farklı bir veri kümesiyle aynı raporun bir kopyasını oluşturmanız gerekmez. Bir rapor birden çok kullanıcıya hizmet verebilir. Bu özellik daha sonra bakım yapılan öğelerin sayısını azaltır ve uygulama yaşam döngüsü işlemesini iyileştirir. Sonuç olarak dinamik bağlama, yeni müşteriler için ekleme işlemini basitleştirir.

Bir raporu birden çok veri kümesine dinamik olarak bağlama

Raporlarınız ve veri kümelerinizayrı çalışma alanlarında olabilir, ancak her iki çalışma alanının da kapasitesi olmalıdır.

Müşteriler için ekleme yaptığınızda, ekleme belirtecinin hem rapor hem de dinamik olarak bağlı veri kümesi için izinleri içermesi gerekir. Raporlar ve panolar gibi Power BI öğelerini destekleyen bir ekleme belirteci oluşturmak için yeni API'yi kullanın.

Kuruluşunuz için eklediğinizde, kullandığınız kullanıcının Azure Active Directory (AD) belirtecinin tüm Power BI öğeleri için uygun izinlere sahip olması gerekir.

Örnek 1: Dinamik bağlama ile sayfalandırılmış rapor ekleme

Dinamik bağlama kullanarak katıştırılmış sayfalandırılmış rapor uygulamak için, aşağıdaki örnekte gösterildiği gibi datasetBindings özelliğini ekleme yapılandırma nesnesine ekleyin.

let config = {
    type: 'report',
    tokenType: models.TokenType.Embed,
    accessToken: accessToken,
    embedUrl: embedUrl,
    id: "reportId",
    permissions: permissions,
    datasetBindings: [{
            sourceDatasetId: "originalDatasetId",
            targetDatasetId: "notOriginalDatasetId"
        }]
};

// Get a reference to the embedded report HTML element.
let embedContainer = $('#embedContainer')[0];

// Embed the report and display it within the div container.
let report = powerbi.embed(embedContainer, config);

Örnek 2: Dinamik bağlama ile sayfalandırılmış rapor görseli ekleme

Sayfalandırılmış rapor görseli, Power BI raporuna eklenmiş sayfalandırılmış bir rapordur. Dinamik bağlama kullanarak katıştırılmış sayfalandırılmış rapor görseli uygulamak için, aşağıdaki örnekte gösterildiği gibi datasetBinding özelliğini ekleme yapılandırma nesnesine ekleyin.

let config = {
    type: 'report',
    tokenType: models.TokenType.Embed,
    accessToken: accessToken,
    embedUrl: embedUrl,
    id: "reportId",
    permissions: permissions,
    datasetBinding: {
        datasetId: "notOriginalDatasetId",
        paginatedReportBindings: [{
            sourceDatasetId: "originalDatasetId",
            targetDatasetId: "notOriginalDatasetId"
        }]
    }
};

// Get a reference to the embedded report HTML element.
let embedContainer = $('#embedContainer')[0];

// Embed the report and display it within the div container.
let report = powerbi.embed(embedContainer, config);

Dikkat edilmesi gerekenler ve sınırlamalar

  • Dinamik olarak seçilen veri kümesinin raporda aynı veri şemasını kullanması gerekir.
  • Müşteriler için ekleme yaparken, yeni API'yi kullanarak ekleme belirteci oluşturun.
  • Kuruluşunuz için ekleme yaparken, kullanıcının hem rapor hem de veri kümesi için izinlere sahip olduğundan emin olun.
  • datasetBinding özelliği boş olamaz. datasetId, paginatedReportBindingsveya her ikisini içermelidir.
  • datasetId ve targetDatasetId değerlerinin aynı olması gerekmez. Bağlama, .pbix ve sayfalandırılmış raporlar için bağımsız olarak çalışır.
  • datasetBinding özelliği birden çok nesne içerebilir.
  • Rapor ekleme
  • Ekleme belirteci oluştururken dikkat edilmesi gerekenler