Öğ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:

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.

Kod örneği belirtimleri

Bu öğretici, aşağıdaki çerçevelerden birini temel alan örnek müşterileriniz için ekleme uygulaması 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:

• Power BI bağımlılıkları

  • Kendi Azure Active Directory kiracınız.

  • Uygulamanızın Power BI kimlik doğrulamasından geçebilmesi için aşağıdakilerden birini kullanmanız gerekir:

    • Hizmet sorumlusu: Azure AD'nin uygulamanızın kimlik doğrulamasından geçmesini sağlayan bir Azure Active Directory (Azure AD) hizmet sorumlusu nesnesi.

    • Power BI Pro lisansı: Bu, ana kullanıcınız olur ve uygulamanız Power BI kimlik doğrulamasından geçmek için bunu kullanır.

    • Power BI Kullanıcı Başına Premium (PPU) lisansı: Bu, ana kullanıcınız olur ve uygulamanız Power BI kimlik doğrulamasından geçmek için bunu kullanır.

  Not

  Üretim ortamına geçmek için bir kapasiteye ihtiyacınız olacaktır.

• Kod bağımlılıkları

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

  • .NET Core 3.1 SDK (veya üzeri)

  • Bir tümleşik geliştirme ortamı (IDE). Aşağıdakilerden birini kullanmanız önerilir:

    • Visual Studio

    • Visual Studio Code

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.

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.

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.

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

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

   

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öntemine, ana kullanıcı kimlik doğrulama yöntemine veya her iki yönteme de uygulanarak uygulananın bir durum olduğu gösterilmiştir.

İç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
Çalışma Alanı Kimliği
Rapor Kimliği
Gizli anahtar
Kiracı Kimliği
Power BI kullanıcı adı
Power BI parolası

İstemci Kimliği

İ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

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

   

Rapor Kimliği

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.

   

Gizli anahtar

İ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 Sertifikalar ve gizli diziler’i 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.

Kiracı Kimliği

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ı

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

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

   

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.

   

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.

   

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.

   

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

4. 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. Örnek React uygulaması yalnızca kuruluş çözümünüz için eklemeyi destekler.

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

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 kapasiteyeihtiyacınız vardır ve hangi SKU 'nun gereksinimlerinizi en iyi şekilde paketlemesinin belirlemek için Kapasite planlama makalesini gözden geçirmeniz gerekir.

Sonraki adımlar