Öğretici: Örnek müşterileriniz için ekleme uygulamasını kullanarak Power BI içeriği ekleme

Tümleşik analiz ve Power BI Embedded (Azure teklifi) raporlar, panolar ve kutucuklar gibi Power BI içeriklerini uygulamanıza eklemenizi sağlar.

Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:

  • Tümleşik analiz ortamınızı ayarlama.
  • Örnek müşterileriniz için ekleme (veriler uygulamaya aittir) uygulamasını yapılandırma.

Kullanıcıların uygulamanızı kullanabilmek için Power BI'da oturum açmaları veya Power BI lisansına sahip olmaları gerekmez.

Müşterileriniz için ekleme yöntemi, üçüncü taraflar için oluşturdukları uygulamalara Power BI içeriği eklemek isteyen bağımsız yazılım satıcıları (ISV) veya geliştiriciler için önerilir.

Önemli

Ulusal bir bulut için içerik katıştırıyorsanız, bu öğreticinin ilk birkaç adımı farklıdır. Ayrıntılar için bkz. Ulusal bulutlar için içerik ekleme.

Kod örneği belirtimleri

Bu öğreticide, aşağıdaki çerçevelerden biri içinde müşterileriniz için örnek uygulama ekleme yapılandırmasına ilişkin yönergeler yer almaktadır:

  • .NET Framework
  • .NET Core
  • Java
  • Node JS
  • Python

Kod örneği aşağıdaki tarayıcıları destekler:

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

Önkoşullar

Bu öğreticiye başlamadan önce hem Power BI'a hem de aşağıda listelenen kod bağımlılıklarına sahip olduğunuzdan emin olun:

Yöntem

Örnek bir müşterileriniz için ekleme uygulaması oluşturmak için aşağıdaki adımları izleyin:

  1. Kullanacağınız kimlik doğrulama yöntemini seçin.

  2. Bir Azure AD uygulaması kaydedin.

  3. Power BI çalışma alanı oluşturun.

  4. Power BI raporu oluşturup yayımlayın.

  5. Ekleme parametrelerinin değerlerini alın.

  6. Hizmet sorumlusu API erişimi

  7. Çalışma alanı erişimini etkinleştirin.

  8. İçeriğinizi ekleyin.

1\. Adım: Kullanacağınız kimlik doğrulama yöntemini seçin

Tümleşik analiz çözümünüz, seçtiğiniz kimlik doğrulama yöntemine göre farklılık gösterecektir. Bu nedenle kimlik doğrulama yöntemleri arasındaki farkları anlamak ve çözümünüze en uygun olanı belirlemek önemlidir.

Aşağıdaki tabloda hizmet sorumlusu ile ana kullanıcı kimlik doğrulama yöntemleri arasındaki temel farklar listelenmiştir.

Değerlendirme Hizmet sorumlusu Ana kullanıcı
Mechanism Azure AD uygulamanızın hizmet sorumlusu nesnesi, Azure AD'nin tümleşik analiz çözümünüzü Power BI kimlik doğrulamasından geçirmesini sağlar. Azure AD uygulamanız, Power BI'da kimlik doğrulamasından geçmek için bir Power BI kullanıcısının kimlik bilgilerini (kullanıcı adı ve parola) kullanır.
Güvenlik Hizmet sorumlusu, Azure AD tarafından önerilen yetkilendirme yöntemidir. Hizmet sorumlusu kullanıyorsanız* uygulama gizli adı veya sertifika kullanarak kimlik doğrulaması sabilirsiniz. Bu öğreticide yalnızca bir uygulama gizli bilgisi ile hizmetsorumlusunun kullanımı açıkmektedir. Hizmet sorumlusu ve sertifika kullanarak eklemek için hizmet sorumlusu ve sertifika makalesine bakın. Bu kimlik doğrulama yöntemi, hizmet sorumlusu kullanmak kadar güvenli kabul edilmez. Bunun nedeni, ana kullanıcı kimlik bilgilerini (kullanıcı adı ve parola) korumak zorunda olmanızdır. Örneğin bu bilgileri tümleşik analiz uygulamanızda göstermemeniz ve parolayı sık sık değiştirmeniz gerekir.
Azure AD temsilci izinleri Gerekli değildir. Ana kullanıcınızın veya bir yöneticinin, uygulamanızın Power BI REST API izinlerine (kapsamlar olarak da bilinir) erişmesine onay vermesi gerekir. Örneğin, Report.ReadWrite.All.
Power BI hizmeti erişimi Hizmet sorumlusu ile Power BI hizmetine erişemezsiniz. Power BI hizmetine erişmek için ana kullanıcı kimlik bilgilerinizi kullanmanız gerekir.
Lisans Pro lisansı gerektirmez. Üye veya yönetici olduğunuz tüm çalışma alanlarında bulunan içerikleri kullanabilirsiniz. Kullanıcı Başına Power BI Pro (PPU) Premium lisans gerektirir.

2\. Adım: Bir Azure AD uygulaması kaydedin

Uygulamanızı Azure AD'ye kaydederek şunları yapabilirsiniz:

Uygulamanızı Azure AD'ye kaydetmek için Uygulamanızı kaydetme bölümündeki yönergeleri izleyin.

Not

Uygulamanızı kaydetmeden önce kullanacağınız kimlik doğrulama yöntemini (hizmet sorumlusu veya ana kullanıcı) belirlemeniz gerekir.

3\. Adım: Power BI çalışma alanı oluşturun

Power BI'da raporlarınız, panolarınız ve kutucuklarınız bir çalışma alanında saklanır. Bu öğeleri eklemek için onları oluşturup bir çalışma alanına yüklemeniz gerekir.

İpucu

Çalışma alanınız varsa bu adımı atlayabilirsiniz.

Çalışma alanı oluşturmak için aşağıdakileri yapın:

  1. Power BI'da oturum açın.

  2. Çalışma alanları'nı seçin.

  3. Çalışma alanı oluştur'u seçin.

  4. Çalışma alanınıza bir ad verin ve Kaydet'i seçin.

4\. Adım: Power BI raporu oluşturup yayımlayın

Bir sonraki adım bir rapor oluşturup çalışma alanınıza yüklemektir. Power BI Desktop'ı kullanarak kendi raporunuzu oluşturabilir ve ardından çalışma alanınızda yayımlayabilirsiniz. Alternatif olarak çalışma alanınıza örnek raporlardan birini yükleyebilirsiniz.

İpucu

İçinde rapor bulunan bir çalışma alanınız varsa bu adımı atlayabilirsiniz.

Örnek raporu indirip çalışma alanınızda yayımlamak için şu adımları izleyin:

  1. GitHub'daki Power BI Desktop samples klasörünü açın.

  2. Kod'u ve ardından ZIP'i indir'i seçin.

    A screenshot showing the ZIP download option in the Power B I desktop samples GitHub

  3. İndirdiğiniz ZIP arşivini ayıklayıp Samples Reports klasörüne gidin.

  4. Eklemek istediğiniz raporu seçip çalışma alanınızda yayımlayın.

5\. Adım: Ekleme parametrelerinin değerlerini alın

İçeriğinizi eklemek için belirli parametre değerlerini almanız gerekir. Aşağıdaki tabloda gerekli değerler gösterilmiştir ve bunların hizmet sorumlusu kimlik doğrulama yöntemi, ana kullanıcı kimlik doğrulama yöntemi veya her ikisi için de geçerli olup değildir.

İçeriğinizi eklemeden önce aşağıda listelenen tüm değerlere sahip olduğunuzdan emin olun. Bazı değerler kullandığınız kimlik doğrulama yöntemine göre farklılık gösterecektir.

Parametre Hizmet sorumlusu Ana kullanıcı
İstemci Kimliği Applies to. Applies to.
Çalışma Alanı Kimliği Applies to. Applies to.
Rapor Kimliği Applies to. Applies to.
Gizli anahtar Applies to. Does not apply to.
Kiracı Kimliği Applies to. Does not apply to.
Power BI kullanıcı adı Does not apply to. Applies to.
Power BI parolası Does not apply to. Applies to.

İstemci Kimliği

İpucu

Aşağıdakiler için geçerlidir:Applies to. Hizmet sorumlusu Applies to. Ana kullanıcısı

İstemci kimliği GUID değerini (uygulama kimliği olarak da bilinir) almak için şu adımları izleyin:

  1. Microsoft Azure’da oturum açın.

  2. Uygulama kayıtlarını arayın ve Uygulama kayıtları bağlantısını seçin.

  3. Uygulama içeriğinizi eklemek için kullanmakta olduğu Azure AD Power BI seçin.

  4. Genel bakış bölümünde Uygulama (istemci) kimliği GUID değerini kopyalayın.

Çalışma Alanı Kimliği

İpucu

Aşağıdakiler için geçerlidir:Applies to. Hizmet sorumlusu Applies to. Ana kullanıcısı

Çalışma alanı kimliği GUID değerini almak için şu adımları izleyin:

  1. Power BI hizmetinde oturum açın.

  2. Eklemek istediğiniz raporu açın.

  3. URL'deki GUID değerini kopyalayın. GUID değeri, /groups/ ile /reports/ arasındaki sayıdır.

    A screenshot showing workspace ID GUID in the Power B I service U R L

Rapor Kimliği

İpucu

Aşağıdakiler için geçerlidir:Applies to. Hizmet sorumlusu Applies to. Ana kullanıcısı

Rapor kimliği GUID'lerini almak için şu adımları izleyin:

  1. Power BI hizmetinde oturum açın.

  2. Eklemek istediğiniz raporu açın.

  3. URL'deki GUID değerini kopyalayın. GUID değeri, /reports/ ile /ReportSection/ arasındaki sayıdır.

    A screenshot showing report ID GUID in the Power B I service U R L

Gizli anahtar

İpucu

Aşağıdakiler için geçerlidir:Applies to. Hizmet sorumlusu Does not apply to. Ana kullanıcısı

İstemci gizli dizisini almak için şu adımları izleyin:

  1. Microsoft Azure’da oturum açın.

  2. Uygulama kayıtlarını arayın ve Uygulama kayıtları bağlantısını seçin.

  3. Uygulama içeriğinizi eklemek için kullanmakta olduğu Azure AD Power BI seçin.

  4. Yönet'inaltında Sertifika gizli dizileri'ne seçin.

  5. İstemci gizli dizileri bölümünde Yeni istemci gizli dizisi'ni seçin.

  6. Açılan İstemci gizli dizisi ekle penceresinde uygulama gizli dizisi için bir açıklama girin, uygulama gizli dizisinin süre sonunu belirtin ve Ekle'yi seçin.

  7. İstemci gizli dizileri bölümünde yeni oluşturulan uygulama gizli dizisinin Değer sütunundaki dizeyi kopyalayın. İstemci gizli dizisi değeri, istemci kimliğidir.

Not

İlk görüntülendiğinde gizli istemci gizli değerini kopyalayıp kopyalamayı emin olun. Bu sayfadan uzaklaştıktan sonra istemci gizli adı gizlenir ve değerini alamayabilirsiniz.

Kiracı Kimliği

İpucu

Aşağıdakiler için geçerlidir:Applies to. Hizmet sorumlusu Does not apply to. Ana kullanıcısı

Kiracı kimliği GUID değerini almak için şu adımları izleyin:

  1. Microsoft Azure’da oturum açın.

  2. Uygulama kayıtlarını arayın ve Uygulama kayıtları bağlantısını seçin.

  3. Uygulama içeriğinizi eklemek için kullanmakta olduğu Azure AD Power BI seçin.

  4. Genel bakış bölümünde Dizin (kiracı) kimliği GUID değerini kopyalayın.

Power BI kullanıcı adı ve parolası

İpucu

Aşağıdakiler için geçerlidir:Does not apply to. Hizmet sorumlusu Applies to. Ana kullanıcısı

Ana kullanıcı olarak seçtiğiniz Power BI kullanıcısının kullanıcı adı ve parola değerlerini alın. Bu, Power BI hizmetinde çalışma alanı oluşturmak ve rapor yüklemek için kullandığınız kullanıcı hesabıdır.

6\. Adım: Hizmet sorumlusu API erişimi

İpucu

Aşağıdakiler için geçerlidir:Applies to. Hizmet sorumlusu Does not apply to. Ana kullanıcısı

Bu adım yalnızca hizmet sorumlusu kimlik doğrulama yöntemini kullanıyorsanız geçerlidir. Ana kullanıcı yöntemini kullanıyorsanız bu adımı atlayıp 7. Adım: Çalışma alanı erişimini etkinleştirin ile devam edin.

Bir Azure AD uygulamasının Power BI içeriğine ve API’lerine erişebilmesi için, bir Power BI yöneticisinin Power BI yönetici portalında hizmet sorumlusu erişimini etkinleştirmesi gerekir. Kiracınızın yöneticisi siz değilseniz yöneticiden Kiracı ayarlarını sizin için etkinleştirmesini isteyin.

  1. Power BI hizmeti' nde yönetici portalıAyarlar Ayarlar ' nı seçin.

    A screenshot showing the admin settings menu option in the Power B I service settings menu

  2. Kiracı ayarları'nı seçtikten sonra açılan sayfada Geliştirici ayarları bölümüne inin.

  3. Hizmet sorumlularının Power BI API'leri kullanmasına izin ver seçeneğini genişletip etkinleştirin.

    A screenshot showing how to enable the developer settings option, in the tenant settings menu option, in Power B I service

Not

Hizmet sorumlusu kullanıyorsanız bir güvenlik grubu kullanarak erişimini kiracı ayarlarıyla sınırlandırmanız önerilir. Bu özellik hakkında daha fazla bilgi edinmek için hizmet sorumlusu makalesinin şu bölümlerine bakın:

7\. Adım: Çalışma alanı erişimini etkinleştirin

Power BI hizmetindeki raporlar, panolar ve veri kümeleri gibi Azure AD uygulama erişim yapıtlarınızı etkinleştirmek için hizmet sorumlusunu veya ana kullanıcıyı çalışma alanınıza üye veya yönetici olarak ekleyin.

  1. Power BI hizmetinde oturum açın.

  2. Erişimini etkinleştirmek istediğiniz çalışma alanına gidin ve Daha fazla menüsünden Çalışma alanı erişimini seçin.

    Screenshot showing the workspace access button in the more menu of a Power BI workspace.

  3. Erişim bölmesinde kullandığınız kimlik doğrulama yöntemine göre hizmet sorumlusunu veya ana kullanıcıyıE-posta adresini girin metin kutusuna yapıştırın.

    Not

    Hizmet sorumlusu kullanıyorsanız Azure AD uygulamanıza verdiğiniz adı belirtmeniz gerekir.

  4. Ekle’yi seçin.

8\. Adım: İçeriğinizi ekleyin

Power BI Embedded örnek uygulaması, müşterileriniz için ekleme yöntemiyle bir Power BI uygulaması oluşturmanızı sağlar.

Örnek Müşterileriniz için ekleme uygulamasını değiştirerek Power BI raporunuzu eklemek için aşağıdaki adımları izleyin.

  1. Power BI developer samples klasörünü açın.

  2. Kod'u ve ardından ZIP'i indir'i seçin.

    A screenshot showing the ZIP download option in the Power B I developer samples GitHub

  3. İndirdiğiniz ZIP dosyasını ayıklayıp PowerBI-Developer-Samples-master klasörüne gidin.

  1. Uygulamanızda kullanmak istediğiniz dile bağlı olarak şu klasörlerden birini açın:

    • .NET Core
    • .NET Framework
    • Java
    • Node JS
    • Python

    Not

    Müşterileriniz için ekleme örnek uygulamalar yalnızca yukarıda listelenen çerçeveleri destekler. React örnek uygulama yalnızca kuruluş çözümünüz için ekleme 'yi destekler.

  2. Embed for your customers klasörünü açın.

  1. Aşağıdaki yöntemlerden birini kullanarak örnek müşterileriniz için ekleme uygulamasını açın:

  2. appsettings.json dosyasını açın.

  3. Seçtiğiniz kimlik doğrulama yönteminize göre aşağıdaki parametre değerlerini girin:

    Parametre Hizmet sorumlusu Ana kullanıcı
    AuthenticationMode ServicePrincipal MasterUser
    ClientId Azure AD uygulamanızın istemci kimliği Azure AD uygulamanızın istemci kimliği
    TenantId Azure AD kiracı kimliğiniz Yok
    PbiUsername Yok Ana kullanıcının kullanıcı adı; bkz. Power BI kullanıcı adı ve parolası
    PbiPassword Yok Ana kullanıcının parolası; bkz. Power BI kullanıcı adı ve parolası
    ClientSecret Azure AD istemci gizli diziniz Yok
    WorkspaceId Eklenmiş raporunuzun bulunduğu çalışma alanının kimliği; bkz. Çalışma alanı kimliği Eklenmiş raporunuzun bulunduğu çalışma alanının kimliği; bkz. Çalışma alanı kimliği
    ReportId Eklediğiniz raporun kimliği; bkz. Rapor kimliği Eklediğiniz raporun kimliği; bkz. Rapor kimliği
  4. Uygun seçeneği belirleyerek projeyi çalıştırın:

    • Visual Studio kullanıyorsanız IIS Express (yürüt) öğesini seçin.

    • Visual Studio Codekullanıyorsanız, hata ayıklamayı başlat' ı seçin.

Uygulamanızı geliştirme

Örnek müşterileriniz için ekleme uygulamasını yapılandırdıktan sonra kendi uygulamanızı geliştirmeye başlayabilirsiniz.

Hazır olduğunuzda üretime taşıma gereksinimlerini gözden geçirin. Ayrıca bir kapasiteye ihtiyacınız olacağından gereksinimlerinize en uygun SKU'yu belirleme amacıyla kapasite planlaması makalesini de incelemeniz gerekir.

Sonraki adımlar