Öğretici: Kuruluş uygulamanız için örnek ekleme kullanarak Power BI içeriği ekleme

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 ekleme (verilerin sahibi kullanıcı 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ı 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, aşağıdaki çerçevelerden birinde kuruluşunuzun örnek uygulaması için ekleme yapılandırma yönergelerini içerir:

• .NET Framework
• .NET Core
• React TypeScript

Not

.NET Core ve .NET Framework örnekleri, son kullanıcının Power BI hizmeti erişimi olan tüm Power BI panolarını, raporunu veya kutucuğunu görüntülemesini sağlar. 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:

      • Power BI Pro

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

    Not

    Üretime geçmek 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şunuzun örnek uygulamasına ekleme oluşturmak için şu adımları izleyin:

1. Bir 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. 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.

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

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 Core	.NET Framework	React TypeScript
İstemci kimliği
İstemci gizli anahtarı
Çalışma Alanı Kimliği
Rapor Kimliği

Client ID

İpucu

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

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

İstemci gizli anahtarı

İpucu

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

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

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.

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

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 ekleme Oluşturmanıza olanak tanır Power BI uygulaması.

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 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 aşağıdaki klasörlerden birini açın:

   • .NET Core
   • .NET Framework
   • 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 ekleyinhttps://localhost:5000/signin-oidc.

   Not

   Web platformlarınız yoksa Platform ekle'yi seçin ve 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. Aşağıdaki yöntemlerden birini kullanarak kuruluşunuz için ekleme örnek uygulamasını 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 dizisini kullanma

Ö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 Hata Ayıklamayı Çalıştır'ı > seçin.

2. Ekleme ö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, Yeniden Yönlendirme URI'leri bölümünde ekleyinhttps://localhost:44300/.

      Not

      Web platformlarınız yoksa Platform ekle'yi seçin ve 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 gizli dizisini kullanma

Örnek uygulamayı çalıştırma

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

2. Ekleme ö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'leri bölümünde yapılandır'ı ekleyin https://localhost:3000 ve seçin.

      Not

      Web platformlarınız 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 Ekle UserOwnsData>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 kullanma

   • reportId- Rapor kimliğini kullanma

3. Dosyayı kaydedin.

Örnek uygulamayı çalıştırma

1. Bir terminal açın ve Kuruluşunuz>için ekle UserOwnsData'ya 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 RefreshUser İzinleri REST API'sine açık bir çağrı yapın. Bu API çağrısı izinleri yeniler ve yeni izinleri olan 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

Power BI Topluluğu sorun