Aracılığıyla paylaş

Mobil düzende Power BI raporu ekleme

  • Makale

Mobil kullanıcılar herhangi bir Power BI rapor sayfasını yatay yönde görüntüleyebilir. Ancak rapor yazarları, mobil cihazlar için iyileştirilmiş ve dikey yönde görüntülenen ek bir görünüm oluşturabilir. Hem Power BI Desktop'ta hem de Power BI hizmetinde kullanılabilen bu tasarım seçeneği, yazarların hareket halindeyken mobil kullanıcılar için anlamlı olan görselleri seçmesine ve yeniden düzenlemesine olanak tanır.

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

Mobil düzeni kullanarak rapor ekleme

İlk olarak raporunuz için bir mobil düzen oluşturmanız gerekiyor, bu düzeni oluşturmak için Mobil uygulama için Power BI raporlarını iyileştirme göz atın.

Power BI raporunu raporun mobil düzenine eklemek için layoutType ayarlar nesnesinde models.LayoutType.MobilePortrait olarak ayarlamanız 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ş. 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 bakılmaksızın layoutType özelliği tarafından belirlenir.

Örneğin, aşağıdaki kodda raporun mobil düzende nasıl eklenerek ekli olduğu gösterilmektedir.

// 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 report.updateSettings yöntemini kullanın. 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 İstemcisi Page sınıfı, hasLayout yöntemini şu şekilde tanımlar:

hasLayout(layoutType: any): Promise<boolean>

sayfa belirtilen düzen türüne sahipse hasLayout yöntemi 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 hasLayout ile aşamalı ekleme kullanabilirsiniz.

Olayları çekme

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

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

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

Örneğin, sola çekme işlemini algılamak için swipeEnd olayını 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 olayları işleme bölümüne bakın.

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

Ayrıca özel düzen özelliğini kullanarak farklı cep telefonları veya tablet ekranları için iyileştirilmiş özelleştirilmiş düzenler oluşturabilirsiniz.

Dikkat edilmesi gerekenler ve 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, iframe'i kaldırmak için önce powerbi.reset(HTMLElement) çağırmanız gerekir. Ardından, eklenmiş yapılandırma nesnesinde tanımlanan mobil düzen ayarıyla aynı kapsayıcıyı kullanarak powerbi.embed(...) çağırmanız gerekir.

  • MobilePortrait düzenine sahip bir rapor sayfası eklemeye çalışırsanız ve sayfanın mobil düzeni yoksa, sayfa MobileLandscape düzeniyle yüklenir.

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

  • 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'

İlgili içerik