Öğretici: Müşterilerinizin uygulaması için örnek ekleme kullanarak Power BI içeriği ekleme

  • Makale

UYGULANANLAR: Uygulama verilerin sahibidir Veriler Kullanıcıya aittir

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

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

  • Ekli ortamınızı ayarlayın.
  • Müşterileriniz için ekleme (verilerin sahibi uygulama olarak da bilinir) örnek uygulaması yapılandırın.

Uygulamanızı kullanmak için kullanıcılarınızın Power BI'da oturum açması veya Power BI lisansına sahip olması gerekmez.

Bağımsız bir yazılım satıcısı (ISV) veya üçüncü taraflar için uygulama oluşturmak isteyen bir geliştiriciyseniz, Power BI içeriğinizi eklemek için müşterileriniz için ekleme yöntemini kullanmanızı öneririz.

Önemli

Ulusal/bölgesel bir bulut için içerik ekliiyorsanız, bu öğreticinin ilk birkaç adımı farklıdır. Ayrıntılar için bkz . Ulusal/bölgesel bulutlar için içerik ekleme.

Kod örneği belirtimleri

Bu öğretici, aşağıdaki çerçevelerden birinde müşterileriniz için bir ekleme örneği uygulaması yapılandırma yönergelerini içerir:

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

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

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

Önkoşullar

Bu öğreticiye başlamadan önce, aşağıda hem Power BI hem de kod bağımlılıklarının listelendiğini doğrulayın:

Metot

Müşterileriniz için ekleme örneği uygulaması oluşturmak için şu adımları izleyin:

  1. Kimlik doğrulama yönteminizi seçin.

  2. Bir Microsoft Entra uygulaması kaydedin.

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

  4. Power BI raporu oluşturma ve yayımlama.

  5. Ekleme parametresi 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 - Kimlik doğrulama yönteminizi seçin

Katıştırılmış çözümünüz, seçtiğiniz kimlik doğrulama yöntemine bağlı olarak değişir. Bu nedenle, kimlik doğrulama yöntemleri arasındaki farkları anlamak ve çözümünüz için en uygun olanı belirlemek önemlidir.

Aşağıdaki tabloda hizmet sorumlusu ile ana kullanıcı kimlik doğrulama yöntemleri arasındaki birkaç önemli fark açıklanmaktadır.

Dikkat edilmesi gereken noktalar Hizmet sorumlusu Ana kullanıcı
Mekanizma Microsoft Entra uygulamanızın hizmet sorumlusu nesnesi, Microsoft Entra Id'nin katıştırılmış çözüm uygulamanızın kimliğini Power BI'da doğrulamasını sağlar. Microsoft Entra uygulamanız, Power BI'da kimlik doğrulaması yapmak için bir Power BI kullanıcısının kimlik bilgilerini (kullanıcı adı ve parola) kullanır.
Güvenlik Hizmet sorumlusu , Microsoft Entra Id tarafından önerilen yetkilendirme yöntemidir. Hizmet sorumlusu kullanıyorsanız, uygulama gizli dizisi veya sertifika kullanarak kimlik doğrulaması yapabilirsiniz.

Bu öğreticide yalnızca bir uygulama gizli dizisi ile hizmet sorumlusu kullanımı açıklanmaktadır. Hizmet sorumlusu ve sertifika kullanarak eklemek için, sertifika içeren hizmet sorumlusu makalesine bakın.		 Bu kimlik doğrulama yöntemi hizmet sorumlusu kadar güvenli değildir. Ana kullanıcı kimlik bilgileri (kullanıcı adı ve parola) ile dikkatli olmanız gerekir. Örneğin, bunları ekleme uygulamanızda kullanıma sunmayın ve parolayı sık sık değiştirin.
Microsoft Entra Id temsilci izinleri Gerekli değil. Ana kullanıcınızın veya yöneticinizin uygulamanızın Power BI REST API izinlerine (kapsamlar olarak da bilinir) erişmesine izin vermesi gerekir. Örneğin, Report.ReadWrite.All.
erişimi Power BI hizmeti Hizmet sorumlusuyla Power BI hizmeti erişemezsiniz. Power BI hizmeti ana kullanıcı kimlik bilgilerinizle erişebilirsiniz.
Lisans Pro lisansı gerektirmez. Üyesi veya yöneticisi olduğunuz herhangi bir çalışma alanındaki içeriği kullanabilirsiniz. Power BI Pro veya Kullanıcı Başına Premium (PPU) lisansı gerektirir.

2. Adım - Microsoft Entra uygulamasını kaydetme

Uygulamanızı Microsoft Entra ID ile kaydetmek şunları yapmanızı sağlar:

Uygulamanızı Microsoft Entra Id ile kaydetmek için Uygulamanızı kaydetme başlığındaki yönergeleri izleyin.

Dekont

Uygulamanızı kaydetmeden önce hangi kimlik doğrulama yöntemini kullanacağınıza , hizmet sorumlusuna veya ana kullanıcıya karar vermeniz gerekir.

3. Adım - Power BI çalışma alanı oluşturma

Power BI raporlarınızı, panolarınızı ve kutucuklarınızı çalışma alanında tutar. Bu öğeleri eklemek için bunları oluşturmanız ve bir çalışma alanına yüklemeniz gerekir.

Bahşiş

Zaten bir ç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'te oturum açın.

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

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

  4. Çalışma alanınızı adlandırın ve Kaydet'i seçin.

4. Adım - Power BI raporu oluşturma ve yayımlama

Sonraki adımınız 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 bir rapor yükleyebilirsiniz.

Bahşiş

Rapor içeren bir çalışma alanınız zaten varsa bu adımı atlayabilirsiniz.

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

  1. GitHub Power BI Desktop örnekleri klasörünü açın.

  2. Kod'a ve ardından Zip indir'e tıklayın.

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

  3. İndirilen ZIP'i ayıklayın ve Örnekler Raporları klasörüne gidin.

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

5. Adım - Ekleme parametresi değerlerini alma

İçeriğinizi eklemek için belirli parametre değerlerini almanız gerekir. Aşağıdaki tabloda gerekli değerler gösterilir ve bunların hizmet sorumlusu kimlik doğrulama yöntemine, ana kullanıcı kimlik doğrulama yöntemine veya her ikisine de uygulanıp uygulanmadığını gösterir.

İçeriğinizi eklemeden önce, aşağıda listelenen tüm değerlere sahip olduğunuzdan emin olun. Kullandığınız kimlik doğrulama yöntemine bağlı olarak bazı değerler farklılık gösterir.

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.
İstemci gizli anahtarı Applies to. Does not apply to.
Kiracı Kimliği Applies to. yalnızca Node JS için gereklidir
Power BI kullanıcı adı Does not apply to. Applies to.
Power BI parolası Does not apply to. Applies to.

Client ID

Bahşiş

Şunlar için geçerlidir:Applies to.Hizmet sorumlusu Applies to.Ana kullanıcısı

İstemci kimliği GUID'sini (uygulama kimliği olarak da bilir) almak için şu adımları izleyin:

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

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

  3. Power BI içeriğinizi eklemek için kullandığınız Microsoft Entra uygulamasını seçin.

  4. Genel Bakış bölümünden Uygulama (istemci) Kimliği GUID'sini kopyalayın.

Çalışma Alanı Kimliği

Bahşiş

Şunlar için geçerlidir:Applies to.Hizmet sorumlusu Applies to.Ana kullanıcısı

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

  1. Power BI hizmetinde oturum açma.

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

  3. URL'den GUID'yi kopyalayın. GUID, /groups/ ve /reports/ arasındaki sayıdır.

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

Alternatif olarak, çalışma alanı adının yanındaki Ayrıntılar'ı seçerek çalışma alanı kimliğini Yönetici portalı ayarlarında bulabilirsiniz.

A screenshot showing how to find the workspace I D from the admin settings.

Rapor Kimliği

Bahşiş

Şunlar için geçerlidir:Applies to.Hizmet sorumlusu Applies to.Ana kullanıcısı

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

  1. Power BI hizmetinde oturum açma.

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

  3. URL'den GUID'yi kopyalayın. GUID, /reports/ ve /ReportSection arasındaki sayıdır.

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

İstemci gizli anahtarı

Bahşiş

Şunlar 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ı arayın ve Uygulama kayıtları bağlantısını seçin.

  3. Power BI içeriğinizi eklemek için kullandığınız Microsoft Entra uygulamasını seçin.

  4. Yönet'in altında Sertifikalar ve gizli diziler'i seçin.

  5. İstemci gizli dizileri'nin altında Yeni istemci gizli dizisi'ni seçin.

  6. İstemci gizli dizisi ekle açılır penceresinde, uygulama gizli diziniz için bir açıklama sağlayın, uygulama gizli dizisinin süresinin ne zaman doleceğini seçin ve Ekle'yi seçin.

  7. İstemci gizli dizileri bölümünden, yeni oluşturulan uygulama gizli dizisinin Value sütunundaki dizeyi kopyalayın. İstemci gizli anahtarı değeri, istemci kimliğinizdir.

Dekont

İstemci gizli anahtarı değerini ilk göründüğünde kopyaladığınızdan emin olun. Bu sayfadan uzaklaştıktan sonra gizli dizi gizlenir ve değerini alamazsınız.

Kiracı kimliği

Bahşiş

Şunlar için geçerlidir:Applies to.Hizmet sorumlusu Does not apply to.Ana kullanıcısı

Kiracı kimliği GUID'sini almak için şu adımları izleyin:

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

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

  3. Power BI içeriğinizi eklemek için kullandığınız Microsoft Entra uygulamasını seçin.

  4. Genel Bakış bölümünden Dizin (kiracı) Kimliği GUID'sini kopyalayın.

Power BI kullanıcı adı ve parolası

Bahşiş

Şunlar için geçerlidir:Does not apply to.Hizmet sorumlusu Applies to.Ana kullanıcısı

Ana kullanıcı olarak kullandığınız Power BI kullanıcısının kullanıcı adını ve parolasını alın. Bu, Power BI hizmeti'da çalışma alanı oluşturmak ve bir raporu karşıya yüklemek için kullandığınız kullanıcıyla aynıdır.

6. Adım - Hizmet sorumlusu API erişimi

Bahşiş

Şunlar 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ı kullanıyorsanız bu adımı atlayın ve 7. Adım - Çalışma alanı erişimini etkinleştirme ile devam edin.

Bir Microsoft Entra uygulamasının Power BI içeriğine ve API'lerine erişebilmesi için Power BI yöneticisinin Power BI yönetici portalında hizmet sorumlusu erişimini etkinleştirmesi gerekir. Kiracınızın yöneticisi değilseniz kiracının yöneticisinin Kiracı ayarlarını sizin yerinize etkinleştirmesini sağlayın.

  1. Power BI hizmeti Ayarlar Ayarlar Yönetici> portal'ı seçin>.

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

  2. Kiracı ayarları'nı seçin ve ardından aşağı kaydırarak Geliştirici ayarları bölümüne gidin.

  3. Hizmet sorumlularının Power BI API'lerini kullanmasına izin ver'i genişletin ve bu seçeneği etkinleştirin.

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

Dekont

Hizmet sorumlusu kullanırken, bir güvenlik grubu kullanarak kiracı ayarlarına erişimini sınırlamak önerilir. Bu özellik hakkında daha fazla bilgi edinmek için hizmet sorumlusu makalesindeki şu bölümlere bakın:

7. Adım - Çalışma alanı erişimini etkinleştirme

Power BI hizmeti raporlar, panolar ve anlam modelleri gibi Microsoft Entra uygulama erişim nesnelerinizi 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çma.

  2. Erişimi etkinleştirmek istediğiniz çalışma alanına gidin ve Diğer menüsünde Çalışma alanı erişimi'ni seçin.

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

  3. Erişim bölmesinde, kullandığınız kimlik doğrulama yöntemine bağlı olarak, hizmet sorumlusunuveya ana kullanıcıyıE-posta adresini girin metin kutusuna kopyalayın.

    Dekont

    Hizmet sorumlusu kullanıyorsanız, adı Microsoft Entra uygulamanıza vermiş olduğunuz addır.

  4. Ekle'yi seçin.

8. Adım : İçeriğinizi ekleme

Power BI embedded örnek uygulaması, müşterileriniz için bir ekleme Power BI uygulaması oluşturmanıza olanak tanır.

Power BI raporunuzu eklemek üzere müşterileriniz için ekleme örnek uygulamasını değiştirmek için bu adımları izleyin.

  1. Power BI geliştirici örnekleri klasörünü açın.

  2. Kod'a ve ardından Zip indir'e tıklayın.

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

  3. İndirilen ZIP'i ayıklayın ve PowerBI-Developer-Samples-master klasörüne gidin.

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

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

    Dekont

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

  2. Müşterileriniz için ekle klasörünü açın.

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

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

  3. Kimlik doğrulama yönteminize bağlı olarak aşağıdaki parametre değerlerini doldurun:

    Parametre Hizmet sorumlusu Ana kullanıcı
    AuthenticationMode ServicePrincipal MasterUser
    ClientId Microsoft Entra uygulama istemci kimliğiniz Microsoft Entra uygulama istemci kimliğiniz
    TenantId Microsoft Entra kiracı kimliğiniz Geçersiz
    PbiUsername Geçersiz Ana kullanıcı kullanıcı adınız, bkz. Power BI kullanıcı adı ve parolası
    PbiPassword Yok Ana kullanıcı parolanız, bkz. Power BI kullanıcı adı ve parolası
    ClientSecret Microsoft Entra Id istemci gizli anahtarınız Yok
    WorkspaceId Eklenmiş raporunuzun olduğu çalışma alanının kimliği, bkz . Çalışma Alanı Kimliği Eklenmiş raporunuzun olduğ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 (oynat) seçeneğini belirleyin.

    • Visual Studio Code kullanıyorsanız Hata Ayıklamayı Çalıştır'ı > seçin.

Uygulamanızı geliştirme

Müşterileriniz için ekleme örnek uygulamasını yapılandırdıktan ve çalıştırdıktan sonra kendi uygulamanızı geliştirmeye başlayabilirsiniz.

Geliştirmeye başlamak ve tüm yeni Power BI Embedded özelliklerine ve güncelleştirmelerine ayak uydurmak için Power BI tümleşik analiz oyun alanı'nı deneyin.

Hazır olduğunuzda üretim gereksinimlerine taşımayı gözden geçirin. Ayrıca bir kapasiteye ihtiyacınız olacak ve gereksinimlerinize en uygun SKU'yu oluşturmak için kapasite planlama makalesini gözden geçirmeniz gerekir.

Önemli

Geliştirme için ücretsiz ekleme deneme belirteçleri kullandıysanız üretim için bir kapasite satın almanız gerekir. Kapasite satın alınana kadar Ücretsiz deneme sürümü başlığı eklenen raporun en üstünde görünmeye devam eder.

İlgili içerik

Başka sorunuz var mı? Power BI Topluluğu sor.