Mobil düzende Power BI raporu ekleme

  • Makale

Mobil kullanıcılar bir Power BI rapor sayfasını yatay yönlendirmede görüntüleyebilir. Ancak rapor yazarları, mobil cihazlar için iyileştirilmiş ek bir görünüm oluşturabilir ve dikey yönlendirmede görüntüleyebilirler. Hem Power BI Desktop’ta hem de Power BI hizmetinde kullanılabilir olan bu tasarım seçeneği, yazarların yalnızca hareket halindeki mobil kullanıcılar için anlamlı olan bu görselleri seçip yeniden düzenlemesine olanak verir.

Raporunuzun Power BI Desktop veya Power BI hizmeti oluşturulmuş mobil düzeni varsa, raporu web uygulamanıza bu düzende ekleyebilirsiniz.

Mobil düzeni kullanarak rapor ekleme

Öncelikle raporunuz için bir mobil düzen oluşturmanız gerekir. Bu düzeni oluşturmak için Mobil uygulama için Power BI raporlarını iyileştirme konusuna göz atın.

Power BI raporunu raporun mobil düzenine eklemek için ayarlar nesnesinde olarak ayarlamanız layoutTypemodels.LayoutType.MobilePortrait gerekir:

let embedConfig = {
    ...
    settings: {
        layoutType: models.LayoutType.MobilePortrait
    }
};

Rapor ayarları hakkında daha fazla bilgi için bkz . Rapor ayarlarını yapılandırma.

Mobil cihazlara ayrılmış iki düzen türü vardır:

  • MobilePortrait - Dikey görünüm için iyileştirilmiştir. Bu, raporunuz için oluşturduğunuz mobil düzendir.

  • MobileLandscape - Yatay görünüm için iyileştirilmiş. Bu, raporunuzun normal düzenidir.

Not

Rapor düzeni, cihazın gerçek yönlendirmesine layoutType bakılmaksızın özelliği tarafından belirlenir.

Örneğin, aşağıdaki kod raporun mobil düzende nasıl eklenerek eklenerek yapıldığını gösterir.

// Get models. models contains enums that can be used.
var models = window['powerbi-client'].models;

var embedConfiguration = {
    type: 'report',
    id: reportId,
    embedUrl: embedUrl,
    tokenType: tokenType,
    accessToken: accessToken,
    settings: {
        layoutType: models.LayoutType.MobilePortrait
    }
};

Rapor zaten yüklendiğinde rapor düzenini güncelleştirmek için yöntemini kullanın report.updateSettings . Daha fazla bilgi için bkz . Çalışma zamanında rapor ayarlarını güncelleştirme.

const newSettings = {
    layoutType: models.LayoutType.MobileLandscape
};

report.updateSettings(newSettings);

Rapor sayfasının mobil düzeni olup olmadığını denetleme

Power BI İstemci Sayfası sınıfı, yöntemini şu şekilde tanımlar hasLayout :

hasLayout(layoutType: any): Promise<boolean>

Sayfa hasLayout belirtilen düzen türüne sahipse yöntemi bir boole döndürür.

let pages = await report.getPages();
let mobileLayout = pages[0].hasLayout(models.LayoutType.MobilePortrait);

Raporu işlemeden önce sayfanın mobil düzeni olup olmadığını denetlemek için ile aşamalı eklemehasLayout özelliğini kullanabilirsiniz.

Olayları çekme

Bir raporu mobil düzene eklerken çekme olaylarını dinleyebilir ve web uygulamanızda özel bir kod çalıştırabilirsiniz. İki çekme olayı swipeStart vardır ve swipeEnd her ikisi de aşağıdaki biçimi döndürür:

interface ISwipeEvent {
  currentPosition: IPosition;
  startPosition: IPosition;
}

interface IPosition {
  x: number;
  y: number;
}

Örneğin, sola çekmeyi swipeEnd algılamak için olayı kullanabilirsiniz:

report.on("swipeEnd", function(event) {
    const swipeEndEvent = event.detail.swipeEvent;
    if (swipeEndEvent.currentPosition.x < swipeEndEvent.startPosition.x) {
        console.log("Swipe left detected");
    }
});

Olayları işleme hakkında daha fazla bilgi için bkz. Olayları işleme.

Uygulamanızı özel düzenlerle iyileştirme

Farklı cep telefonları veya tablet ekranları için iyileştirilmiş özelleştirilmiş düzenler oluşturmak için özel düzen özelliğini de kullanabilirsiniz.

Sınırlamalar

  • Raporun ilk yüklenmesinden sonra, rapor mobil düzenine geçiş yalnızca mobil düzen (dikey/yatay) ilk ekleme yapılandırma nesnesine ayarlandıysa desteklenir. Aksi takdirde, önce iframe'i kaldırmak için aramanız powerbi.reset(HTMLElement) gerekir. Ardından, eklenmiş yapılandırma nesnesinde tanımlanan mobil düzen ayarıyla aynı kapsayıcıyı kullanarak çağırmanız powerbi.embed(...) gerekir.

  • Düzen içeren MobilePortrait bir rapor sayfası eklemeye çalışırsanız ve sayfanın mobil düzeni yoksa, sayfa düzeniyle birlikte MobileLandscape yüklenir.

  • Kullanıcılarınızın mobil düzenleri kullanırken sayfalar arasında gezinmesine izin vermek için kendi gezintinizi kullanabilir report.setPage ve uygulayabilirsiniz. Daha fazla bilgi için bkz . Sayfa gezintisi.

  • Yukarıdaki yapılandırmalar, power BI raporunu mobil görünüme eklemeye yöneliktir.
    Pano ekleme, pageView yapılandırmasıyla mobil düzende yapılandırılabilir: pageView: 'oneColumn'

Sonraki adımlar