Power BI® Report aracı ile Microsoft Power BI® raporlarınızı Xpoda formlarınıza gömebilirsiniz ve zengin raporlar hazırlayabilirsiniz. Raporlarınızı öncelikle Power BI arayüzünde tasarladıktan sonra araç takımından formunuza sürükleyin.
|
Araç Kutusundaki Görünümü |
Free Formda Görünümü |
Responsive Formda Görünümü |
|
|
Uyumluluk
| Free Form | Responsive Form | Mobile |
Power BI Report aracının özellikleri
Type (Alan Türü): Eklenilen form aracının alan türünü gösterir. Burada yer alan değer değiştirilemez.
Name (Alan İsmi): Bileşenin ismi yazılır. Otomatik olarak oluşturulacaktır ancak değiştirilebilir.
Help Text (Yardım Metni): Form aracı üzerine fare ile gelindiğinde açıklama çıkması için girilen metindir.
Height: Rapor bileşeninin formdaki yüksekliğini belirler. Px cinsinden yazınız. Örn : 300
Width: Rapor bileşeninin formdaki genişliğini belirler. Px cinsinden yazınız. Örn : 300.
From Left / Top: Bileşenin soldan ve üstten konumunu belirler.
|
Width ve From Left / Top özellikleri yalnızca Free Form tipindeki formlarda geçerlidir. Responsive kullanımda bileşen uygun genişliği ve konumu otomatik olarak kullanacaktır. |
SQL Query : Power BI raporlarını formlarınıza gömebilmek için beş farklı parametreye ihtiyaç vardır:
- Application Id
- Report Id
- Workspace Id
- Application Secret
- Tenant Id
Bu değerleri ister SQL sorgunuzdan sabit değer olarak dönerek isterseniz de veri tabanından okuyarak sağlayabilirsiniz. Application Secret bilgisinin güvenli olarak saklanması gerektiğini unutmayınız.
SQL query alanına aşağıdaki şekilde veri sağlayabilirsiniz.
select '98cf3121-1332-4b35-ba73-081ff1a69ffx','AppId'
union
select 'e3e5270d-b531-4aa6-9542-322bd2111c12','WorkspaceId'
union
select '1072542e-d9b7-5617-acef-dddfce330557c','ReportId'
union
select 'b8Sjh2X~NTSCBX-Wxybp6cRGQVyf5QVkoPNB9CSKC','AppSecret'
union
select '65b7cb2f-c294-55fc-c04c-bc79c95c97e3','Tenant'
Alan isimlerinin AppId, WorkspaceId, ReportId, AppSecret ve Tenant şeklinde olduğuna dikkat ediniz.
Verinin sıralaması ise önemli değildir.
|
Power BI elemanında herhangi bir aksiyon kullanımı yoktur! |
Power BI Gömme Kimliklerini (ID) ve Uygulama Sırrını Bulma Rehberi
Bu doküman, Power BI raporlarınızı kendi uygulamanıza gömmek için gerekli olan beş temel kimliği ve uygulamanızın sırrını (secret) nerede bulacağınızı adım adım açıklamaktadır.
1. App ID (Uygulama Kimliği) ve Tenant ID (Kiracı Kimliği)
AppId, uygulamanızın Azure'daki benzersiz kimliğidir. TenantId ise kuruluşunuzun (kiracınızın) Azure Active Directory (şimdiki adıyla Microsoft Entra ID) içindeki benzersiz kimliğidir.
-
Azure Portal'a Giriş Yapın:
- Tarayıcınızda portal.azure.com adresine gidin.
- Power BI raporlarınıza erişim sağladığınız Azure hesabınızla oturum açın.
-
Microsoft Entra ID'ye Gidin:
- Sol menüde "Microsoft Entra ID" seçeneğini bulun ve tıklayın. (Eğer bulamazsanız, arama çubuğunu kullanın.)
-
App ID (Uygulama Kimliği) Bulma:
- Microsoft Entra ID genel bakış sayfasında, sol menüden "App registrations" (Uygulama kayıtları) seçeneğine tıklayın.
- Uygulamanızın adını (Xpoda Power BI veya projeye özel olarak adlandırdığınız) listeden bulun ve üzerine tıklayın.
- Açılan genel bakış sayfasında, "Application (client) ID" (Uygulama (istemci) Kimliği) etiketinin yanındaki değeri kopyalayın. Bu sizin AppId'nizdir.
Yukarıdaki kısma ek olarak
- Yukarıdaki uygulama ekranında Manage(Yönet) Api Permissions sekmesine geçerek uygulama izinlerinizi kontrol edebilirsiniz. Bu ekranda herhangi bir izin bulunmuyorsa gerekli read yetkilerinin verilmesi gerekir.
Gerekli izinleri aşağıdaki adımları izleyerek ekleyebilirsiniz.
- Microsoft Entra ID > App registrations > Uygulamanız yolunu izleyin.
- Sol menüden "API permissions"'a tıklayın.
- "+ Add a permission" düğmesine tıklayın, "Power BI Service"'i seçin.
- "Application permissions" (Uygulama izinleri) sekmesini seçin.
-
Report.Read.All
- Ne yapar: Power BI'daki tüm raporları okuma izni verir. Uygulamanızın bir raporu görüntülemesi için bu gereklidir.
- Neden önemli: Raporlarınızı gömmek için en temel izindir.
-
Dataset.Read.All
- Ne yapar: Power BI'daki tüm veri kümelerini okuma izni verir.
- Neden önemli: Raporlar genellikle veri kümeleriyle ilişkilidir ve raporun doğru şekilde yüklenmesi için temel veri kümesi bilgilerine erişim gerekebilir.
-
Dashboard.Read.All
- Ne yapar: Power BI'daki tüm panoları okuma izni verir.
- Neden önemli: Eğer uygulamanızda Power BI panolarını da gömmeyi planlıyorsanız bu izne ihtiyacınız olacaktır. Sadece raporlar için şart değildir, ancak genellikle genel bir erişim için eklenir.
-
Content.Read.All
- Ne yapar: Power BI'daki tüm içeriği (raporlar, panolar, veri kümeleri, veri akışları, çalışma alanları vb.) okuma izni verir.
- Neden önemli: Bu, yukarıdaki Report.Read.All, Dataset.Read.All, Dashboard.Read.All izinlerini kapsayıcı daha geniş bir izindir. Genellikle, tüm Power BI içeriğine salt okunur erişim sağlamak için tercih edilir.
- Yukarıda belirtilen izinleri işaretleyin ve "Add permissions" düğmesine tıklayın.
- EN ÖNEMLİSİ: Listeye eklediğiniz izinlerin yanında "Not Granted" yazıyorsa, mutlaka "Grant admin consent for düğmesine tıklayarak yönetici onayı verin. İzinlerin durumunun "Granted" olarak değiştiğinden emin olun.
- Power BI Service dışında Microsoft Graph'i seçerek User.Read yetkisini uygulamanızın içeriğine göre eklemeniz gerekebilir.
- Eğer uygulamanız Power BI gömme işlevselliğinin yanı sıra, kullanıcıların kendi profil bilgilerini göstermek, Power BI'daki kişisel ayarlarını değiştirmek veya diğer Microsoft 365 servisleriyle (Outlook, OneDrive gibi) etkileşim kurmak gibi ek işlevlere sahipse, o zaman User.Read veya diğer Microsoft Graph izinleri gerekli olabilir.
-
Tenant ID (Kiracı Kimliği) Bulma:
- Yine Microsoft Entra ID ana genel bakış sayfasına geri dönün (tarayıcınızın geri düğmesini kullanabilir veya sol menüden tekrar "Microsoft Entra ID"ye tıklayabilirsiniz).
- Genel bakış sayfasında "Tenant ID" (Kiracı Kimliği) etiketinin yanındaki değeri kopyalayın. Bu sizin TenantId'nizdir.
2. App Secret (Uygulama Sırrı/Değeri)
App Secret, uygulamanızın Power BI API'lerinde kimlik doğrulaması yaparken kullandığı gizli anahtardır. Bu değer sadece oluşturulduğu anda görünür olduğundan dikkatle kopyalanmalıdır.
-
Azure Portal'da Uygulama Kaydınıza Gidin:
- Önceki adımda yaptığınız gibi, Azure Portal'a giriş yapın ve Microsoft Entra ID > App registrations > Uygulamanız (Xpoda Power BI) yolunu izleyin.
-
Certificates & secrets Bölümüne Gidin:
- Uygulama kaydınızın sol menüsünden "Certificates & secrets" (Sertifikalar ve gizli diziler) seçeneğine tıklayın.
- Yeni Client Secret Oluşturun:
Aşağıdaki görselde aktif olan bir secret bulunmaktadır. Bu secret uygulama listesinde süresi dolmuşsa “Expired” görünecektir. Bu şekilde görünen uygulama adına tıklayarak aşağıdaki adımlardan yeni secret oluşturmalısınız. İlk kez oluşturulan uygulamada da aynı şekilde yeni secret oluşturulmalıdır.
- "Client secrets" (İstemci gizli dizileri) sekmesi altında "+ New client secret" (Yeni istemci gizli anahtarı) düğmesine tıklayın.
- Açılan pencerede sırrınız için bir açıklama girin (örn: "PowerBI Embed Secret") ve bir geçerlilik süresi seçin (örneğin "24 months").
- "Add" (Ekle) düğmesine tıklayın.
- Secret Değerini Kopyalayın:
- Sır oluşturulduktan hemen sonra, "Value" (Değer) sütununda tam metin olarak görünen değeri kopyalayın. Bu sizin AppSecret'inizdir.
- ÖNEMLİ: Bu değeri şimdi kopyalamazsanız, bu sayfadan ayrıldıktan sonra bir daha göremezsiniz ve yeni bir sır oluşturmanız gerekir. Kopyaladığınız değeri projenizin yapılandırma dosyasına veya güvenli bir yere yapıştırın.
3. Workspace ID (Çalışma Alanı Kimliği) ve Report ID (Rapor Kimliği)
WorkspaceId, Power BI raporlarınızın bulunduğu çalışma alanının kimliğidir. ReportId ise belirli bir Power BI raporunun kimliğidir.
-
Power BI Hizmetine Giriş Yapın:
- Tarayıcınızda app.powerbi.com adresine gidin ve Power BI hesabınızla oturum açın.
-
Çalışma Alanınıza Gidin:
- Sol menüde "Çalışma alanları" (Workspaces) seçeneğine tıklayın.
- Raporunuzun bulunduğu çalışma alanının adını (örneğin, "Xpoda Demo Raporlar" veya projenize özel adlandırdığınız) tıklayarak içine girin.
-
Workspace ID (Çalışma Alanı Kimliği) Bulma:
- Çalışma alanına girdikten sonra, tarayıcınızın adres çubuğundaki URL'ye bakın. URL şu formatta olacaktır: https://app.powerbi.com/groups/{WorkspaceId}/...
- groups/ kelimesinden sonra gelen / işaretine kadar olan kısmı kopyalayın. Bu sizin WorkspaceId'nizdir.
-
Raporunuzu Açın:
- Çalışma alanınızdaki raporlar listesinden gömmek istediğiniz raporun adına tıklayarak onu açın.
NOT: Eğer raporu görüntülemede yetki sorunu yaşıyorsanız aşağıdaki gibi workspace yetkilerini kontrol edebilirsiniz.
Uygulamanıza (Service Principal) Çalışma Alanı İzni Verin:
- Çalışma alanındayken, çalışma alanı adının yanındaki üç nokta menüsüne (...) tıklayın.
- Açılan seçeneklerden "Çalışma alanı erişimini yönet" (Manage workspace access) seçeneğini seçin.
- Açılan pencerede "Kişi veya grup ekle" düğmesine tıklayın.
- Arama kutusuna Azure'da kaydettiğiniz uygulamanızın adını (Xpoda Power BI Web App veya verdiğiniz adı) yazın. Uygulamanız bir Servis Asıl Nesnesi (Service Principal) olarak görünmelidir.
- Uygulamanızı seçin ve ona bir rol atayın. Raporları sadece görüntülemek için "Görüntüleyici (Viewer)" rolü yeterlidir.
- "Ekle" düğmesine tıklayın.
-
Report ID (Rapor Kimliği) Bulma:
- Rapor açıldıktan sonra, tarayıcınızın adres çubuğundaki URL'ye tekrar bakın. URL şu formatta olacaktır: https://app.powerbi.com/groups/{WorkspaceId}/reports/{ReportId}/ReportSection...
- reports/ kelimesinden sonra gelen / işaretine kadar olan kısmı kopyalayın. Bu sizin ReportId'nizdir.
Ek ayarlamalar için Microsoft'un dokümantasyonundan faydalanabilirsiniz.
Bu doküman, Power BI raporlarınızı uygulamanıza entegre etmek için gereken tüm kimlik bilgilerini adım adım bulmanıza yardımcı olacaktır. Bu bilgileri doğru bir şekilde alıp uygulamanızın yapılandırma dosyalarına eklediğinizden emin olun.