Share via

Rapor ekleme

  • Makale

İpucu

Power BI Embedded Analytics Oyun Alanı'nınAPI'lerimizi keşfedin 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 BI'daki Raporlar'da raporlar hakkında daha fazla bilgi edinin.

Rapor ekleme

Power BI içeriğini bir uygulamaya eklediğinizde, 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, IReportLoadConfiguration tü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ümlerini 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 özniteliğine srciframeatar. Bu URL'yi almak için Bir Rapor API'si kullanabilirsiniz. İki örnek şunlardır:

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

  • permissions - Ekli 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 içerik 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 .

  • type - Eklediğiniz içerik türü. Power BI raporu için kullanın 'report' .

Arabirim IReportLoadConfiguration 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, türünde IReportCreateConfigurationbir 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 arabirimdeki IReportLoadConfiguration özelliklere benzer:

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

Örnek

Aşağıdaki örnek, bir raporun nasıl eklenerek ekli olduğunu gösterir:

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

Sonraki adımlar

Rapor görseli ekleme

Sayfalandırılmış rapor ekleme

Rapor ayarlarını yapılandırma

Rapor oluşturma, düzenleme ve kaydetme

Daha iyi performans için bootstrap kullanma