Rehber: Kuruluşunuza ait uygulama için örnek bir gömme kullanarak Power BI içeriği gömme

Power BI tümleşik analizi, 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.
• Kuruluşunuz için yerleştirme (aynı zamanda kullanıcının verileri sahip olduğu olarak da bilinir) örnek uygulamasını yapılandırın.

Uygulamanızı kullanmak için kullanıcılarınızın Power BI'da oturum açması gerekir.

Kuruluşunuz için ekleme çözümü genellikle kuruluşlar ve büyük kuruluşlar tarafından kullanılır ve iç kullanıcılara yöneliktir.

Ö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, kuruluşunuzun örnek uygulamasını aşağıdaki çerçevelerden birinde yapılandırma talimatlarını içerir:

• .NET Çerçevesi
• .NET Çekirdeği
• React TypeScript

Not

.NET Core ve .NET Framework örnekleri, son kullanıcının Power BI hizmetinde erişimi olan tüm Power BI panolarını, kutucuğunu veya raporunu görüntülemesine olanak tanır. React TypeScript örneği, son kullanıcınızın Power BI hizmeti zaten erişimi olan tek bir rapor eklemenizi sağlar.

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

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

Önkoşullar

Bu öğreticiye başlamadan önce, hem aşağıdaki Power BI hem de kod bağımlılıklarına sahip olduğunuzu doğrulayın:

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

  • Kendi Microsoft Entra kiracınız.

  • Aşağıdaki lisanslardan biri:

    • Microsoft Fabric

    • Power BI Pro

    • Kullanıcı Başına Premium (PPU)

    Not

    Eklenmiş uygulamanızı üretim ortamına taşımak için aşağıdaki yapılandırmalardan birine ihtiyacınız vardır:

    • Pro lisansı olan tüm kullanıcılar.
    • PPU lisansı olan tüm kullanıcılar.
    • F64 SKU'su ile eşdeğer veya daha yüksek bir SKU. Bu yapılandırma, tüm kullanıcıların ücretsiz lisanslara sahip olmasını sağlar.

• Kod bağımlılıkları

  .NET Core

  • .NET Core 3.1 SDK (veya üzeri)

  • Tümleşik bir geliştirme ortamı (IDE). Aşağıdaki IDE'lerden birini kullanmanızı öneririz:

    • Visual Studio

    • Visual Studio Code

  .NET Framework

  • .NET Framework 4.8

  • Visual Studio

  React TypeScript

  • Metin düzenleyicisi

  • Komut satırı terminali (veya PowerShell)

---

Metot

Kuruluşunuz için bir örnek uygulama yerleştirme oluşturmak üzere şu adımları izleyin:

1. Microsoft Entra uygulaması kaydedin.
2. Power BI çalışma alanı oluşturun.
3. Power BI raporu oluşturma ve yayımlama.
4. Ekleme parametresi değerlerini alın.
5. İçeriğinizi ekleyin.

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

Uygulamanızı Microsoft Entra Id ile kaydetmek, uygulamanız için bir kimlik oluşturmanıza olanak tanır.

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

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

İpucu

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. Fabric'de 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ıp Uygula'yı seçin.

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

İpucu

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

Örnek bir raporu indirmek (Direct Lake özellikli 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 İndir'e tıklayın.

   

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

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

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

İçeriğinizi eklemek için birkaç parametre değeri almanız gerekir. Parametre değerleri, kullanmak istediğiniz örnek uygulamanın diline bağlıdır. Aşağıdaki tabloda her örnek için hangi parametre değerlerinin gerekli olduğu listelenmiştir.

Parametre	.NET Çekirdeği	.NET Çerçevesi	React TypeScript
İstemci kimliği
İstemci gizli anahtarı
Çalışma Alanı Kimliği
Rapor Kimliği

Müşteri Kimliği

İpucu

Şunlar için geçerlidir: .NET Core .NET Framework React TypeScript

İstemci kimliği GUID'sini ( uygulama kimliği olarak da bilinir) 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.

İstemci sırrı

İpucu

Şunlar için geçerlidir: .NET Core .NET Framework React TypeScript

İstemci gizli anahtarını/anahtar bilgisini 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 altında, Sertifikalar ve gizli diziler'i seçin.

5. İstemci gizli anahtarları altında Yeni istemci gizli anahtarı'nı 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.

Not

İstemci gizli anahtarı değerini ilk kez göründüğünde kopyaladığınızdan emin olun. Bu sayfadan uzaklaştıktan sonra istemci sırrı gizlenecek ve değerini geri alamayacaksınız.

Çalışma Alanı Kimliği

İpucu

Şunlar için geçerlidir: .NET Core .NET Framework React TypeScript

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

   

Rapor Kimliği

İpucu

Şunlar için geçerlidir: .NET Core .NET Framework React TypeScript

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.

   

5. Adım - İçeriğinizi ekleme

Power BI embedded örnek uygulaması, kuruluşunuz için bir Power BI uygulaması yerleştirmenize olanak tanır.

Power BI raporunuzu eklemek üzere kuruluşunuzun örnek uygulamasının ekleme işlemini 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 İndir'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 aşağıdaki klasörlerden birini açın:

   • .NET Çekirdeği
   • .NET Çerçevesi
   • React-TS

   Not

   Kuruluşunuzun örnek uygulamalarına yönelik ekleme yalnızca daha önce listelenen çerçeveleri destekler. Java, Node JS ve Python örnek uygulamaları yalnızca müşterileriniz için ekleme çözümünü destekler.

.NET Core

Microsoft Entra uygulamanızı yapılandırma

1. Azure portal oturum açın.
2. Uygulama kayıtları’nı seçin. Bu seçeneği göremiyorsanız bu seçeneği arayın.
3. 1. Adım - Microsoft Entra uygulamasını kaydetme bölümünde oluşturduğunuz Microsoft Entra uygulamasını açın.
4. Yönet menüsünden Kimlik Doğrulaması'nı seçin.

5. Platform yapılandırmaları bölümünde Web platformunuzu açın ve Yeniden Yönlendirme URI'leri bölümünde https://localhost:5000/signin-oidc ekleyin.

   Not

   Web platformlarınız yoksa Platform ekle'yi seçin. Ardından , Platformları yapılandır penceresinde Web'i seçin.

6. Değişikliklerinizi kaydedin.

Örnek ekleme uygulamasını yapılandırma

1. Kuruluşunuz için ekle klasörünü açın.

2. Kuruluşunuz için gömme örnek uygulamasını aşağıdaki yöntemlerden birini kullanarak açın:

   • Visual Studio kullanıyorsanız UserOwnsData.sln dosyasını açın.

   • Visual Studio Code kullanıyorsanız UserOwnsData klasörünü açın.

3. appsettings.json açın ve aşağıdaki parametre değerlerini doldurun:

   • ClientId - İstemci kimliği GUID'sini kullanın

   • ClientSecret - İstemci gizli anahtarını kullan

Örnek uygulamayı çalıştırma

1. 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, ÇalıştırDebug Hata Ayıklamayı Başlat seçeneğini seçin.

2. Gömme örnek uygulamasında oturum açın.

   Not

   İlk oturum açma sırasında, uygulama için Microsoft Entra izinlerine izin vermeniz istenir.

3. Ekleme örnek uygulaması yüklendiğinde, eklemek istediğiniz Power BI içeriğini seçin ve ardından Ekle'yi seçin.

   

.NET Framework

Microsoft Entra uygulamanızı yapılandırma

1. Azure portal oturum açın.
2. Uygulama kayıtları’nı seçin. Bu seçeneği göremiyorsanız bu seçeneği arayın.
3. 1. Adım - Microsoft Entra uygulamasını kaydetme bölümünde oluşturduğunuz Microsoft Entra uygulamasını açın.
4. Yönet menüsünden Kimlik Doğrulaması'nı seçin.

5. Platform yapılandırmalarında aşağıdaki seçenekleri yapılandırın:

   1. Web platformunuzda, Yönlendirme URI'leri bölümüne https://localhost:44300/ ekleyin.

      Not

      Web platformlarınız yoksa Platform ekle'yi seçin. Ardından , Platformları yapılandır penceresinde Web'i seçin.

   2. Örtük verme ve karma akışlarda, Kimlik Belirteçleri seçeneğini etkinleştirin.

6. Değişikliklerinizi kaydedin.

Örnek ekleme uygulamasını yapılandırma

1. Kuruluşunuz için ekle klasörünü açın.

2. Visual Studio'yu kullanarak UserOwnsData.sln dosyasını açın.

3. Web.config dosyasını açın ve aşağıdaki parametre değerlerini doldurun:

   • clientId - İstemci kimliği GUID'sini kullanın.

   • clientSecret - İstemci sırrını kullanın.

Örnek uygulamayı çalıştırma

1. IIS Express (oynat) seçeneğini belirleyerek projeyi çalıştırın.

2. Gömme örnek uygulamasında oturum açın.

   Not

   İlk oturum açma sırasında, uygulama için Microsoft Entra izinlerine izin vermeniz istenir.

3. Ekleme örnek uygulaması yüklendiğinde, eklemek istediğiniz Power BI içeriğini seçin ve ardından Ekle'yi seçin.

   

React TypeScript

Microsoft Entra uygulamanızı yapılandırma

1. Azure portal oturum açın.
2. Uygulama kayıtları’nı seçin. Bu seçeneği göremiyorsanız bu seçeneği arayın.
3. 1. Adım - Microsoft Entra uygulamasını kaydetme bölümünde oluşturduğunuz Microsoft Entra uygulamasını açın.
4. Yönet menüsünden Kimlik Doğrulaması'nı seçin.

5. Platform yapılandırmalarında Web platformunuzu aşağıdaki gibi yapılandırın:

   1. Yeniden yönlendirme URI'lerine ekleyin ve Yapılandır'ı seçin.

      Not

      Eğer bir Web platformunuz yoksa, Platform ekle'yi seçin ve Platformları Yapılandır penceresinde Web'i seçin.

   2. Örtük izin ve karma akışlarda her iki seçeneği de etkinleştirin:

      • Erişim belirteçleri
      • Kimlik belirteçleri

6. Değişikliklerinizi kaydedin.

Örnek ekleme uygulamasını yapılandırma

1. Kuruluşunuz için Gömme>KullanıcıVerileriSahip>src klasörünü açın.

2. Metin düzenleyicisi kullanarak Config.ts dosyasını açın ve aşağıdaki parametre değerlerini doldurun:

   • clientId - İstemci kimliği GUID'sini kullanın.

   • workspaceId - Çalışma alanı kimliğini kullanın.

   • reportId - Rapor kimliğini kullanın.

3. Dosyayı kaydedin.

Örnek uygulamayı çalıştırma

1. Bir terminal açın ve Kuruluşunuz için Gömü>KullanıcıVerileriSahip konumuna gidin.

2. Aşağıdaki komutu girerek gerekli bağımlılıkları yükleyin:

   npm install

3. Aşağıdaki komutu girerek uygulamayı çalıştırın:

   npm run start

   Not

   İlk oturum açma sırasında, uygulama için Microsoft Entra izinlerine izin vermeniz istenir.

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.

Kullanıcı izinlerini güncelleştirme

Kullanıcıların raporun içinde yer alan Power BI klasörüne erişme iznine sahip olması gerekir. Bir kullanıcıya bir klasöre erişim izni verdiğinizde, değişiklik genellikle yalnızca kullanıcı Power BI Portalı'nda oturum açtığında geçerli olur. Yeni izinlerin hemen geçerli olması için, Katıştırılmış senaryoda başlangıçta Kullanıcı İzinlerini Yenile REST API'sine açık bir çağrı yapın. Bu API çağrısı izinleri yeniler ve yeni verilen izinlere sahip kullanıcılar için yetkilendirme hatalarını önler.

İlgili içerik

• Öğretici: Müşterilerinizin uygulaması için örnek ekleme kullanarak Power BI içeriği ekleme
• Sayfalandırılmış raporlar ekleme
• Başka sorunuz var mı? Power BI Topluluğu'na sormayı deneyin