Aracılığıyla paylaş

Rapor ekleme

  • Makale

Bahşiş

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

Bu makalede, uygulamanıza Power BI raporu ekleme adımları ele alınıyor. Power BIRaporları'nda raporlar hakkında daha fazla bilgi edinin.

Rapor 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. Daha fazla bilgi için bkz. Rapor ayarlarını yapılandırma.

Var olan bir raporu ekleme

Zaten var olan bir raporu eklediğinizde, IReportLoadConfigurationtüründe bir yapılandırma nesnesi kullanın.

interface IReportLoadConfiguration {
    accessToken: string;
    bookmark?: models.IApplyBookmarkRequest;
    contrastMode?: models.ContrastMode;
    datasetBinding?: models.IDatasetBinding;
    embedUrl?: string;
    filters?: models.ReportLevelFilters[];
    id: string;
    pageName?: string;
    permissions?: models.Permissions;
    settings?: models.IEmbedSettings;
    slicers?: models.ISlicer[];
    theme?: models.IReportTheme;
    tokenType?: models.TokenType;
    type: string;
    viewMode?: models.ViewMode;
}

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.

  • datasetBinding - Eklenmiş raporun kullandığı veri şemasını tanımlayan veri kümesi. Veri kümeleri hakkında daha fazla bilgi için bkz. Veri kümelerini bir rapora dinamik olarak bağlama.

  • embedUrl - Eklediğiniz raporun URL'si. Bu URL, eklenmiş raporu 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 Power BI raporunun kimliği.

  • permissions - Eklenen rapor için kullanıcılara atadığınız işlemler. Bu değerler kullanılabilir:

    • Read - Kullanıcılar raporu görüntüleyebilir.
    • ReadWrite - Kullanıcılar raporu görüntüleyebilir, düzenleyebilir ve kaydedebilir.
    • Copy - Kullanıcılar Farklı Kaydet'i kullanarak raporun bir kopyasını kaydedebilir.
    • Create - Kullanıcılar yeni bir rapor oluşturabilir.
    • All - Kullanıcılar raporun bir kopyasını oluşturabilir, görüntüleyebilir, düzenleyebilir, kaydedebilir ve kaydedebilir.

  • 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ü. Power BI raporu için 'report' kullanın.

IReportLoadConfiguration arabirimi diğer özellikleri de içerir. Bu özellikler hakkında bilgi için bkz. Rapor ayarlarını yapılandırma:

  • bookmark
  • contrastMode
  • filters
  • pageName
  • settings
  • slicers
  • theme
  • viewMode

Yeni rapor ekleme

Bir veri kümesinden oluşturduğunuz yeni bir raporu eklediğinizde, IReportCreateConfigurationtüründe bir yapılandırma nesnesi kullanın.

interface IReportCreateConfiguration {
    accessToken: string;
    datasetId: string;
    embedUrl?: string;
    settings?: models.IEmbedSettings;
    theme?: IReportTheme;
    tokenType?: models.TokenType;
    type: string;
}

Bu arabirimdeki özellikler, aşağıdaki özel durumlar dışında IReportLoadConfiguration arabirimindeki özelliklere benzer:

  • datasetId - Yeni raporun kullandığı veri şemasını tanımlayan veri kümesinin kimliği.

  • embedUrl - Yeni raporun kullandığı veri şemasını tanımlayan veri kümesinin URL'si. Bu URL, eklenmiş raporu içeren HTML iframe öğesinin kaynağı olur. Özellikle, API URL'yi iframesrc özniteliğine atar. Bu URL'yi almak için Veri Kümeleri API'si kullanabilirsiniz. İki örnek:

Raporları düzenleme ve oluşturma hakkında bilgi için bkz. Eklenmiş rapor oluşturma, düzenleme ve kaydetme.

Örnek

Aşağıdaki örnekte raporun 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,
    permissions: somePermissions,
    tokenType: aTokenType,
    type: 'report'
};
 
// 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);

İlgili İçerik

  • sayfalandırılmış rapor ekleme