Öğretici: Müşterilerinizin uygulaması için örnek ekleme 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.

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.

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 ekliiyorsanı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 öğretici, aşağıdaki çerçevelerden birinde müşterileriniz için örnek uygulama ekleme yapılandırma yönergelerini içerir:

  • .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 dizisi veya sertifika kullanarak kimlik doğrulaması yapabilirsiniz.

Bu öğreticide yalnızca uygulama gizlidizisiyle hizmet sorumlusu kullanımı açıklanmaktadır. Hizmet sorumlusu ve sertifika kullanarak eklemek için hizmet sorumlusu ve sertifika makalesine bakın.
Bu kimlik doğrulama yöntemi hizmet sorumlusu kadar güvenli değildir. Ana kullanıcı kimlik bilgilerine (kullanıcı adı ve parola) karşı dikkatli olmanız gerekir. Örneğin, bunları ekleme uygulamanızda kullanıma sunmayın ve parolayı sık sık değiştirin.
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. Power BI Pro veya Kullanıcı Başına Premium (PPU) 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.

    Power BI Desktop Samples GitHub klasöründeki ZIP'i indir seçeneğini gösteren ekran görüntüsü

  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ö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. 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 Şunun için geçerlidir: Şunun için geçerlidir:
Çalışma Alanı Kimliği Şunun için geçerlidir: Şunun için geçerlidir:
Rapor Kimliği Şunun için geçerlidir: Şunun için geçerlidir:
Gizli anahtar Şunun için geçerlidir: Geçerli değildir.
Kiracı Kimliği Şunun için geçerlidir: Geçerli değildir.
Power BI kullanıcı adı Geçerli değildir. Şunun için geçerlidir:
Power BI parolası Geçerli değildir. Şunun için geçerlidir:

İstemci Kimliği

İpucu

Şunlar için geçerlidir:Şunlar için geçerlidir. Hizmet sorumlusu Için geçerlidir. Ana kullanıcı

İ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. Power BI içeriğinizi eklemek için kullandığınız Azure AD uygulamasını seçin.

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

Çalışma Alanı Kimliği

İpucu

Şunlar için geçerlidir:Şunlar için geçerlidir. Hizmet sorumlusu Için geçerlidir. Ana kullanıcı

Ç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.

    Power BI hizmeti URL'sindeki çalışma alanı kimliği GUID değerini gösteren ekran görüntüsü

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.

Yönetici ayarlarından çalışma alanı I D'sinin nasıl bulunacağını gösteren ekran görüntüsü.

Rapor Kimliği

İpucu

Şunlar için geçerlidir:Şunlar için geçerlidir. Hizmet sorumlusu Için geçerlidir. Ana kullanıcı

Rapor kimliği GUID'sini 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.

    Power BI hizmeti URL'sindeki rapor kimliği GUID değerini gösteren ekran görüntüsü

Gizli anahtar

İpucu

Şunlar için geçerlidir:Şunlar için geçerlidir. Hizmet sorumlusu için geçerli değildir. Ana kullanıcı

İ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. Power BI içeriğinizi eklemek için kullandığınız Azure AD uygulamasını seçin.

  4. Yönet'in altında Sertifika gizli dizileri'ni &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

İ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

İpucu

Şunlar için geçerlidir:Şunlar için geçerlidir. Hizmet sorumlusu için geçerli değildir. Ana kullanıcı

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. Power BI içeriğinizi eklemek için kullandığınız Azure AD uygulamasını 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

Şunun için geçerlidir:Geçerli değildir. Hizmet sorumlusu Için geçerlidir. Ana kullanıcı

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

Şunlar için geçerlidir:Şunlar için geçerlidir. Hizmet sorumlusu için geçerli değildir. Ana kullanıcı

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 hizmetindeAyarlar>Ayarlar>Yönetici portalı'nı seçin.

    Power BI hizmet ayarları menüsündeki yönetici ayarları menü seçeneğini gösteren ekran görüntüsü.

  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.

    Power BI hizmetinde kiracı ayarları menü seçeneğindeki geliştirici ayarları seçeneğinin nasıl etkinleştirileceğine ilişkin ekran görüntüsü.

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

Azure AD uygulamanızın Power BI hizmeti raporlar, panolar ve veri kümeleri gibi nesnelere erişmesini sağlamak 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.

    Power BI çalışma alanının diğer menüsündeki çalışma alanına erişim düğmesini gösteren ekran görüntüsü.

  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.

    Power BI Developer Samples GitHub klasöründeki ZIP'i indir seçeneğini gösteren ekran görüntüsü

  3. İndirdiğiniz ZIP dosyasını ayıklayıp 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

    Not

    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. 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 Code kullanıyorsanız, Hata Ayıklamayı Başlat'ı çalıştır'ı >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.

Ö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ığı ekli raporun en üstünde görünmeye devam eder.

Sonraki adımlar