Aracılığıyla paylaş

Eklenmiş rapor oluşturma, düzenleme ve kaydetme

  • Makale

Power BI tümleşik analizi, ekli raporlar oluşturmanıza, düzenlemenize ve kaydetmenize olanak tanır. Mevcut bir veri kümesini temel alan bir rapor oluşturulabilir veya mevcut bir raporu düzenleyebilirsiniz. Raporu oluşturulduktan veya düzenlendikten sonra da kaydedebilirsiniz.

Rapor oluşturma

Mevcut bir veri kümesinden yeni, boş bir rapor oluşturmayı öğrenin.

Rapor oluşturmak için gerekli erişim belirteci izinleri

Veri kümesine erişimi olan bir ekleme belirteci oluşturun. ana kullanıcı kimlik doğrulama yöntemini kullanıyorsanız, uygulamanızın şu kapsamlara sahip olduğundan emin olun: Dataset.Read.All, Content.Createve Workspaces.ReadWrite.all. Daha fazla bilgi için bkz. Ekleme Belirteci - Belirteç Oluşturma.

Rapor oluşturmak için gerekli istemci tarafı izinleri

Rapor oluşturmak için aşağıdaki istemci tarafı izinleri gereklidir:

  • oluşturma - Kullanıcılar yeni bir rapor oluşturabilir.

  • Tüm - Kullanıcılar raporun bir kopyasını oluşturabilir, görüntüleyebilir, düzenleyebilir, kaydedebilir ve kaydedebilir.

Yeni rapor oluşturma

Mevcut bir veri kümesinden yeni, boş bir rapor oluşturun. Bir veri kümesi kimliğine ve ekleme URL'sine ihtiyacınız olacaktır. Örneğin, getDatasetsInGroup REST API'sini kullanabilir ve CreateReportEmbedURLalabilirsiniz. Daha fazla bilgi için bkz. Veri Kümeleri - Grup Veri Kümeleri Alma.

Not

Yeni bir rapor oluşturmak için veri kümesinde oluşturma veya yazma izinlerinizin olması gerekir.

let embedCreateConfiguration = {
    tokenType: tokenType,
    accessToken: accessToken,
    embedUrl: embedURL,
    datasetId: datasetId,
    settings: settings,
    theme: theme, // optional
};

// Grab the reference to the div HTML element that will host the report
let embedContainer = $('#embedContainer')[0];

// Create report
let report = powerbi.createReport(embedContainer, embedCreateConfiguration);

Ayrıca, tema uygulanmış bir rapor oluşturma seçeneğiniz de vardır. Rapora eklenen yeni görseller tema stiline saygı gösterir. Daha fazla bilgi için bkz. rapor temalarını uygulama .

Raporu düzenleme

Mevcut bir raporu düzenlemeyi ve Görüntüleme ve Düzenleme modları arasında geçiş yapmayı öğrenin.

Düzenleme için gerekli erişim belirteci izinleri

Rapora erişimi olan bir ekleme belirteci oluşturun. ana kullanıcı kimlik doğrulama yöntemini kullanıyorsanız, uygulamanızın şu kapsamlara sahip olduğundan emin olun: Dataset.ReadWrite.All ve Report.ReadWrite.All. Son kullanıcının düzenlemesi gereken her rapor için allowEdit: true bayrağını da ayarlamanız gerekir. Daha fazla bilgi için bkz. Ekleme Belirteci - Belirteç Oluşturma.

Düzenleme için gerekli istemci tarafı izinleri

Raporu düzenlemek için aşağıdaki istemci tarafı izinleri gereklidir:

  • Kopyala - Kullanıcılar Farklı Kaydetkullanarak raporun bir kopyasını kaydedebilir.

  • ReadWrite - Kullanıcılar raporu görüntüleyebilir, düzenleyebilir ve kaydedebilir.

  • Tüm - Kullanıcılar raporun bir kopyasını oluşturabilir, görüntüleyebilir, düzenleyebilir, kaydedebilir ve kaydedebilir.

Raporu düzenleme

Mevcut raporunuzu Düzenleme modunda yükleyin. Rapor, uygulamanın normal bir raporu katıştırmasıyla aynı şekilde eklenmelidir ve görünüm modu Düzenle'de olmalıdır. viewMode parametresini models.ViewMode.Editolarak ayarladığınızdan ve doğru istemci izinlerine sahip olduğunuzdan emin olun.

let config = {
    type: 'report',
    tokenType: models.TokenType.Aad or models.TokenType.Embed,
    accessToken: YourAccessToken,
    embedUrl: YourEmbedUrl,
    id: YourEmbedReportId,
    permissions: models.Permissions.All,
    viewMode: models.ViewMode.Edit,
};

// Grab the reference to the div HTML element that will host the report
let embedContainer = $('#embedContainer')[0];

// Embed report
let report = powerbi.embed(embedContainer, config);

Artık kullanıcınız, etkinleştirilen izinlerine göre raporu düzenleyebilir.

Rapor yüklendikten sonra Düzenleme ve Görüntüleme modları arasında da geçiş yapabilirsiniz.

report.switchMode("view");

Düzenleme moduna geçmek için:

report.switchMode("edit");

Rapor kaydetme

Raporun kopyasını kaydetme ve raporu başka bir çalışma alanına kaydetme gibi ek seçenekler de dahil olmak üzere raporu kaydetmeyi öğrenin.

Kaydetmek için gerekli erişim belirteci izinleri

Rapora ve veri kümesine erişimi olan bir ekleme belirteci oluşturun. Raporu başka bir çalışma alanına kaydetmek istiyorsanız belirtecin hedef çalışma alanına erişimi olmalıdır. ana kullanıcı kimlik doğrulama yöntemini kullanıyorsanız, uygulamanızın şu kapsamlara sahip olduğundan emin olun: Report.ReadWrite.Allve Workspaces.ReadWrite.all. Ayrıca, müşterinin düzenlemesi gereken her rapor için allowEdit: true bayrağını ayarlamanız gerekir. Daha fazla bilgi için bkz. Ekleme Belirteci - Belirteç Oluşturma.

Kaydetmek için gerekli istemci tarafı izinleri

Raporu kaydetmek için aşağıdaki istemci tarafı izinleri gereklidir:

  • ReadWrite - Kullanıcılar raporu görüntüleyebilir, düzenleyebilir ve kaydedebilir.

  • oluşturma - Kullanıcılar yeni bir rapor oluşturabilir.

  • Kopyala - Kullanıcılar Farklı Kaydetkullanarak raporun bir kopyasını kaydedebilir.

  • Tüm - Kullanıcılar raporun bir kopyasını oluşturabilir, görüntüleyebilir, düzenleyebilir, kaydedebilir ve kaydedebilir.

Raporu kaydetme

Rapor oluştururken, dosya menüsünden veya JavaScript'ten save işlemini çağırana kadar rapor kaydedilmez.

report.save();

Raporun kopyasını kaydetme

Farklı bir adla ek bir kopya kaydedin. Raporun kopyası, raporun veri kümesiyle aynı çalışma alanına kaydedilir.

let saveAsParameters = {
    name: "newReport"
};

report.saveAs(saveAsParameters);

Raporunuzu başka bir çalışma alanına da kaydedebilirsiniz. Hedef çalışma alanı için doğru izinlere sahip olduğunuzdan emin olun.

let saveAsParameters = {
    name: "newReport"
    targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};

report.saveAs(saveAsParameters);

Raporun kaydedildiğini doğrulama

Raporun kaydedildiğinden emin olmak için report.isSaved'ı arayın. Bu yöntem kaydedilmemiş değişiklikleri kaybetmeyi önlemeye yardımcı olabilir.

let isReportSaved = await report.isSaved();

Özel saveAs deneyimi oluşturma

Yapılandırma nesnesine useCustomSaveAsDialog: true rapor ayarını ekleyerek özel bir saveAs iletişim kutusu oluşturabilirsiniz. Bu ayar varsayılan kullanıcı arabirimi iletişim kutusunu gizler.

kullanıcı kullanıcı arabiriminde Farklı Kaydet tıkladığında olayı oluşturulur. Özel iletişim kutunuzu göstermek için bu bilgileri kullanın.

report.on("saveAsTriggered", function (event) {
    console.log(event);
});

Farklı kaydetme işlemi gerçekleştirmek için özel iletişim kutunuzdan report.saveAs çağırabilirsiniz. Daha fazla bilgi için bkz. Rapor kopyasını kaydetme.

let saveAsParameters = {
    name: "newReport"
    targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};

report.saveAs(saveAsParameters);

Kaydetme ve kaydetmeAs olaylarını dinleme

saved olayı, kullanıcı arabirimindeki bir save veya saveAs eylemi tarafından ya da API'ler kullanılarak bir kaydetme tetiklendiğinde oluşturulur. Daha fazla bilgi için bkz. Olayları işleme.

report.on("saved", function (event) {
    console.log(event);
});

İlgili içerik