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

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:

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.

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ğıdaki Power BI ve kod bağımlılıklarına sahip olduğunuzu doğrulayın:

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

  • Kendi Microsoft Entra kiracınız.

  • Power BI'da uygulamanızın kimliğini doğrulamak için aşağıdakilerden birine ihtiyacınız vardır:

    • Hizmet sorumlusu - Microsoft Entra Id'nin uygulamanızın kimliğini doğrulamasını sağlayan bir Microsoft Entra hizmet sorumlusu nesnesi .

    • Power BI Pro lisansı - Bu ana kullanıcınızdırve uygulamanız bunu Power BI'da kimlik doğrulaması yapmak için kullanır.

    • Kullanıcı Başına Power BI Premium (PPU) lisansı - Bu, ana kullanıcınızdırve uygulamanız bunu Power BI'da kimlik doğrulaması yapmak için kullanır.

    Not

    Üretime geçmek için bir kapasiteye ihtiyacınız vardır.

• Kod bağımlılıkları

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.

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.

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

Microsoft Fabric 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.

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

1. Doku'da oturum açın.
2. Çalışma Alanları'nı seçin.
3. + Yeni çalışma alanı'ı seçin.
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.

Örnek bir raporu indirmek (Direct Lake etkin değil) 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.

   

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österebilir.

Parametre	Hizmet sorumlusu	Ana kullanıcı
İstemci kimliği
Çalışma Alanı Kimliği
Rapor Kimliği
İstemci gizli anahtarı
Kiracı Kimliği		yalnızca Node JS için gereklidir
Power BI kullanıcı adı
Power BI parolası

Client ID

İ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

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

   

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.

Rapor Kimliği

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.

   

İstemci gizli anahtarı

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

Kiracı kimliği

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ı

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

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>

   

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

3. Hizmet sorumluları Doku API'lerini kullanabilir seçeneğini genişletin ve bu seçeneği etkinleştirin.

   

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. Doku'da oturum açın.

2. Erişimi etkinleştirmek istediğiniz çalışma alanına gidin ve Erişimi yönet'i seçin.

   

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.

   Not

   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.

   

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

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

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

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.

Dikkat edilmesi gerekenler ve sınırlamalar

Direct Lake modu için aşağıdaki sınırlamalar geçerlidir:

• V2 ekleme belirtecigereklidir.
• Hizmet ilkesi kullanıyorsanız, Sabit Kimlik bağlantısına (No-SSO) ihtiyacınız var.
• Şu anda hizmet sorumlusununSabit Kimlik bağlantısında kimlik doğrulama yöntemi olarak ayarlanması otomasyon aracılığıyla desteklenen tek seçenektir. Diğer yöntemler portal aracılığıyla el ile desteklenir.

İlgili içerik

• Üretime taşıma
• Kuruluşunuz için ekleme
• Sayfalandırılmış raporlar ekleme

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