öğretici: kuruluş uygulamanız için örnek bir ekleme kullanarak Power BI içerik ekleme
Power BI ekli analiz, raporlar, panolar ve kutucuklar gibi Power BI içerikleri uygulamanıza eklemenize olanak tanır.
Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:
- Tümleşik analiz ortamınızı ayarlama.
- Kuruluşunuz için bir ekleme ( veri sahibi olan Kullanıcı olarak da bilinir) örnek uygulama yapılandırın.
Uygulamanızı kullanmak için kullanıcılarınızın Power BI oturum açması gerekir.
Kuruluşunuz için ekleme çözümü genellikle kurumsal şirketler ve büyük kuruluşlar tarafından kullanılır ve şirket içi kullanıcılara yöneliktir.
Kod örneği belirtimleri
Bu öğreticide, aşağıdaki çerçevelerden birinde kuruluş örnek uygulamanız için bir ekleme yapılandırma yönergeleri yer almaktadır:
- .NET Framework
- .NET Core
- React TypeScript
Not
.net Core ve .NET Framework örnekleri, son kullanıcının Power BI hizmetinde erişimi olan Power BI pano, rapor veya kutucuk görüntülemesine olanak tanır. React TypeScript örneği, son kullanıcılarınızın Power BI hizmette zaten erişimi olan tek bir rapor eklemenizi sağlar.
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ı
Aşağıdaki lisanslardan biri:
Not
Üretime gitmek için aşağıdaki yapılandırmalardan birine ihtiyacınız olacaktır:
- Pro lisansa sahip tüm kullanıcılar.
- PPU lisanslarına sahip tüm kullanıcılar.
- Bir P veya em kapasitesi. Bu yapılandırma, tüm kullanıcıların ücretsiz lisansa sahip olmasını sağlar.
Kod bağımlılıkları
.NET Core 3.1 SDK (veya üzeri)
Bir tümleşik geliştirme ortamı (IDE). Aşağıdakilerden birini kullanmanız önerilir:
Yöntem
Kuruluşunuzun örnek uygulamasına bir ekleme oluşturmak için aşağıdaki adımları izleyin:
1. adım-bir Azure AD uygulamasını kaydetme
Uygulamanızı Azure AD 'ye kaydetmek, uygulamanız için bir kimlik ayarlamanıza olanak sağlar.
Uygulamanızı Azure AD'ye kaydetmek için Uygulamanızı kaydetme bölümündeki yönergeleri izleyin.
2. adım-Power BI çalışma alanı oluşturma
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:
Power BI'da oturum açın.
Çalışma alanları'nı seçin.
Çalışma alanı oluştur'u seçin.
Çalışma alanınıza bir ad verin ve Kaydet'i seçin.
3. adım-Power BI raporu oluşturma ve yayımlama
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:
GitHub'daki Power BI Desktop samples klasörünü açın.
Kod'u ve ardından ZIP'i indir'i seçin.
İndirdiğiniz ZIP arşivini ayıklayıp Samples Reports klasörüne gidin.
Eklemek istediğiniz raporu seçip çalışma alanınızda yayımlayın.
4. adım-ekleme parametre değerlerini al
İçeriğinizi eklemek için birkaç parametre değeri edinmeniz gerekir. İhtiyacınız olan parametre değerleri, kullanmak istediğiniz örnek uygulamanın diline bağlı olarak değişir. Aşağıdaki tabloda her örnek için hangi parametre değerlerinin gerekli olduğu listelenmektedir.
| Parametre | .NET Core | .NET Framework | React TypeScript |
|---|---|---|---|
| İstemci Kimliği | ![]() |
![]() |
![]() |
| Gizli anahtar | ![]() |
![]() |
![]() |
| Çalışma Alanı Kimliği | ![]() |
![]() |
![]() |
| Rapor Kimliği | ![]() |
![]() |
![]() |
İstemci Kimliği
İpucu
Uygulama hedefi:
. NET Core
.NET Framework
React TypeScript
İstemci kimliği GUID değerini (uygulama kimliği olarak da bilinir) almak için şu adımları izleyin:
Microsoft Azure’da oturum açın.
Uygulama kayıtlarını arayın ve Uygulama kayıtları bağlantısını seçin.
Power BI içeriğinizi eklemek için kullandığınız Azure AD uygulamasını seçin.
Genel bakış bölümünde Uygulama (istemci) kimliği GUID değerini kopyalayın.
Gizli anahtar
İpucu
Uygulama hedefi:
. NET Core
.NET Framework
React TypeScript
İstemci gizli dizisini almak için şu adımları izleyin:
Microsoft Azure’da oturum açın.
Uygulama kayıtlarını arayın ve Uygulama kayıtları bağlantısını seçin.
Power BI içeriğinizi eklemek için kullandığınız Azure AD uygulamasını seçin.
Yönet’in altında Sertifikalar ve gizli diziler’i seçin.
İstemci gizli dizileri bölümünde Yeni istemci gizli dizisi'ni seçin.
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.
İ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
İlk göründüğünde, istemci gizli değerini kopyalamadığınızdan emin olun. Bu sayfadan uzaklaşdıktan sonra, istemci gizli anahtarı gizlenir ve değerini elde edemeyeceksiniz.
Çalışma Alanı Kimliği
İpucu
Uygulama hedefi:
.. NET Core
.NET Framework
React TypeScript
Çalışma alanı kimliği GUID değerini almak için şu adımları izleyin:
Power BI hizmetinde oturum açın.
Eklemek istediğiniz raporu açın.
URL'deki GUID değerini kopyalayın. GUID değeri, /groups/ ile /reports/ arasındaki sayıdır.
Rapor Kimliği
İpucu
Uygulama hedefi:
.. NET Core
.NET Framework
ReactTypeScript
Rapor kimliği GUID'lerini almak için şu adımları izleyin:
Power BI hizmetinde oturum açın.
Eklemek istediğiniz raporu açın.
URL'deki GUID değerini kopyalayın. GUID değeri, /reports/ ile /ReportSection/ arasındaki sayıdır.
5. Adım: İçeriğinizi ekleme
Power BI ekli örnek uygulama, kuruluşunuz Power BI uygulamanız için bir ekleme oluşturmanıza olanak sağlar.
Power BI raporunuzu eklemek için, kuruluşunuzun örnek uygulamasına yönelik ekleme 'yı değiştirmek üzere bu adımları izleyin.
Power BI developer samples klasörünü açın.
Kod'u ve ardından ZIP'i indir'i seçin.
İndirdiğiniz ZIP dosyasını ayıklayıp PowerBI-Developer-Samples-master klasörüne gidin.
Uygulamanızda kullanmak istediğiniz dile bağlı olarak şu klasörlerden birini açın:
- .NET Core
- .NET Framework
- React-TS
Not
Kuruluşunuz için ekleme örnek uygulamalar yalnızca yukarıda listelenen çerçeveleri destekler. Java, node js ve Python örnek uygulamaları, yalnızca müşterileriniz için embed çözümünü destekler.
Azure AD uygulamanızı yapılandırma
Azure portal oturum açın.
Uygulama kayıtları’nı seçin. Bu seçeneği göremiyorsanız arama yapın.
Yönet menüsünden Kimlik Doğrulaması'ı seçin.
Platform yapılandırmalarında Web platformunuzu açın ve yeniden yönlendirme URI 'leri bölümüne ekleyin
https://localhost:5000/signin-oidc.Not
Web platformunuz yoksa Platform Ekle ' yi seçin ve platformları Yapılandır penceresinde Web' i seçin.
Yaptığınız değişiklikleri kaydedin.
Örnek ekleme uygulamasını yapılandırma
Kuruluşunuz Için embed klasörünü açın.
Aşağıdaki yöntemlerden birini kullanarak, Kuruluşunuz için ekleme örnek uygulamanızı açın:
Visual Studiokullanıyorsanız userownsdata. sln dosyasını açın.
Visual Studio Codekullanıyorsanız userownsdata klasörünü açın.
AppSettings. JSON ' u açın ve aşağıdaki parametre değerlerini girin:
ClientId- ISTEMCI kimliği GUID 'sini kullanClientSecret- İstemci gizliliğini kullanın
Örnek uygulamayı çalıştırma
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 Çalıştır > Hata Ayıklamayı Başlat'ı seçin.
Ekleme örnek uygulamasında oturum açma.
Not
İlk oturum açma sırasında, uygulama için Azure AD izinlerine izin vermeniz istenir.
Ekleme örnek uygulaması yüklenirken, eklemek istediğiniz Power BI ve ardından Ekle'yi 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.