Öğretici: Müşterilerinizin uygulaması için örnek ekleme kullanarak Power BI içeriği ekleme
Tümleşik analiz ve Power BI Embedded (Azure teklifi) raporlar, panolar ve kutucuklar gibi Power BI içeriklerini uygulamanıza eklemenizi sağlar.
Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:
- Tümleşik analiz ortamınızı ayarlama.
- Örnek müşterileriniz için ekleme (veriler uygulamaya aittir) uygulamasını yapılandırma.
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.
Müşterileriniz için ekleme yöntemi, üçüncü taraflar için oluşturdukları uygulamalara Power BI içeriği eklemek isteyen bağımsız yazılım satıcıları (ISV) veya geliştiriciler için önerilir.
Önemli
Ulusal bir bulut için içerik ekliiyorsanız, bu öğreticinin ilk birkaç adımı farklıdır. Ayrıntılar için bkz . Ulusal bulutlar için içerik ekleme .
Kod örneği belirtimleri
Bu öğretici, aşağıdaki çerçevelerden birinde müşterileriniz için örnek uygulama ekleme yapılandırma yönergelerini içerir:
- .NET Framework
- .NET Core
- Java
- Node JS
- Python
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ı
Uygulamanızın Power BI kimlik doğrulamasından geçebilmesi için aşağıdakilerden birini kullanmanız gerekir:
Power BI Pro lisansı: Bu, ana kullanıcınız olur ve uygulamanız Power BI kimlik doğrulamasından geçmek için bunu kullanır.
Power BI Kullanıcı Başına Premium (PPU) lisansı: Bu, ana kullanıcınız olur ve uygulamanız Power BI kimlik doğrulamasından geçmek için bunu kullanır.
Kod bağımlılıkları
Yöntem
Örnek bir müşterileriniz için ekleme uygulaması oluşturmak için aşağıdaki adımları izleyin:
1\. Adım: Kullanacağınız kimlik doğrulama yöntemini seçin
Tümleşik analiz çözümünüz, seçtiğiniz kimlik doğrulama yöntemine göre farklılık gösterecektir. Bu nedenle kimlik doğrulama yöntemleri arasındaki farkları anlamak ve çözümünüze en uygun olanı belirlemek önemlidir.
Aşağıdaki tabloda hizmet sorumlusu ile ana kullanıcı kimlik doğrulama yöntemleri arasındaki temel farklar listelenmiştir.
|Değerlendirme||Hizmet sorumlusu||Ana kullanıcı|
|Mechanism||Azure AD uygulamanızın hizmet sorumlusu nesnesi, Azure AD'nin tümleşik analiz çözümünüzü Power BI kimlik doğrulamasından geçirmesini sağlar.||Azure AD uygulamanız, Power BI'da kimlik doğrulamasından geçmek için bir Power BI kullanıcısının kimlik bilgilerini (kullanıcı adı ve parola) kullanır.|
|Güvenlik||Hizmet sorumlusu, Azure AD tarafından önerilen yetkilendirme yöntemidir. Hizmet sorumlusu kullanıyorsanız, uygulama gizli dizisi veya sertifika kullanarak kimlik doğrulaması yapabilirsiniz. Bu öğreticide yalnızca uygulama gizlidizisiyle hizmet sorumlusu kullanımı açıklanmaktadır. Hizmet sorumlusu ve sertifika kullanarak eklemek için hizmet sorumlusu ve sertifika makalesine bakın.||Bu kimlik doğrulama yöntemi hizmet sorumlusu kadar güvenli değildir. Ana kullanıcı kimlik bilgilerine (kullanıcı adı ve parola) karşı dikkatli olmanız gerekir. Örneğin, bunları ekleme uygulamanızda kullanıma sunmayın ve parolayı sık sık değiştirin.|
|Azure AD temsilci izinleri||Gerekli değildir.||Ana kullanıcınızın veya bir yöneticinin, uygulamanızın Power BI REST API izinlerine (kapsamlar olarak da bilinir) erişmesine onay vermesi gerekir. Örneğin, Report.ReadWrite.All.|
|Power BI hizmeti erişimi||Hizmet sorumlusu ile Power BI hizmetine erişemezsiniz.||Power BI hizmetine erişmek için ana kullanıcı kimlik bilgilerinizi kullanmanız gerekir.|
|Lisans||Pro lisansı gerektirmez. Üye veya yönetici olduğunuz tüm çalışma alanlarında bulunan içerikleri kullanabilirsiniz.||Power BI Pro veya Kullanıcı Başına Premium (PPU) lisansı gerektirir.|
2\. Adım: Bir Azure AD uygulaması kaydedin
Uygulamanızı Azure AD'ye kaydederek şunları yapabilirsiniz:
Uygulamanızı Azure AD'ye kaydetmek için Uygulamanızı kaydetme bölümündeki yönergeleri izleyin.
Not
Uygulamanızı kaydetmeden önce kullanacağınız kimlik doğrulama yöntemini (hizmet sorumlusu veya ana kullanıcı) belirlemeniz gerekir.
3\. Adım: Power BI çalışma alanı oluşturun
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.
4\. Adım: Power BI raporu oluşturup yayımlayın
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.
5\. Adım: Ekleme parametrelerinin değerlerini alın
İç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. Bazı değerler kullandığınız kimlik doğrulama yöntemine göre farklılık gösterecektir.
|Parametre||Hizmet sorumlusu||Ana kullanıcı|
|İstemci Kimliği|
|Çalışma Alanı Kimliği|
|Rapor Kimliği|
|Gizli anahtar|
|Kiracı Kimliği|
|Power BI kullanıcı adı|
|Power BI parolası|
İstemci Kimliği
İpucu
Şunlar için geçerlidir: Hizmet sorumlusu Ana kullanıcı
İ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.
Çalışma Alanı Kimliği
İpucu
Şunlar için geçerlidir: Hizmet sorumlusu Ana kullanıcı
Ç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.
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
İpucu
Şunlar için geçerlidir: Hizmet sorumlusu Ana kullanıcı
Rapor kimliği GUID'sini 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.
Gizli anahtar
İpucu
Şunlar için geçerlidir: Hizmet sorumlusu Ana kullanıcı
İ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 Sertifika gizli dizileri'ni &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
İ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.
Kiracı Kimliği
İpucu
Şunlar için geçerlidir: Hizmet sorumlusu Ana kullanıcı
Kiracı kimliği GUID değerini 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 Dizin (kiracı) kimliği GUID değerini kopyalayın.
Power BI kullanıcı adı ve parolası
İpucu
Şunun için geçerlidir: Hizmet sorumlusu Ana kullanıcı
Ana kullanıcı olarak seçtiğiniz Power BI kullanıcısının kullanıcı adı ve parola değerlerini alın. Bu, Power BI hizmetinde çalışma alanı oluşturmak ve rapor yüklemek için kullandığınız kullanıcı hesabıdır.
6\. Adım: Hizmet sorumlusu API erişimi
İpucu
Şunlar için geçerlidir: Hizmet sorumlusu Ana kullanıcı
Bu adım yalnızca hizmet sorumlusu kimlik doğrulama yöntemini kullanıyorsanız geçerlidir. Ana kullanıcı yöntemini kullanıyorsanız bu adımı atlayıp 7. Adım: Çalışma alanı erişimini etkinleştirin ile devam edin.
Bir Azure AD uygulamasının Power BI içeriğine ve API’lerine erişebilmesi için, bir Power BI yöneticisinin Power BI yönetici portalında hizmet sorumlusu erişimini etkinleştirmesi gerekir. Kiracınızın yöneticisi siz değilseniz yöneticiden Kiracı ayarlarını sizin için etkinleştirmesini isteyin.
Power BI hizmetindeAyarlar>Ayarlar>Yönetici portalı'nı seçin.
Kiracı ayarları'nı seçtikten sonra açılan sayfada Geliştirici ayarları bölümüne inin.
Hizmet sorumlularının Power BI API'leri kullanmasına izin ver seçeneğini genişletip etkinleştirin.
Not
Hizmet sorumlusu kullanıyorsanız bir güvenlik grubu kullanarak erişimini kiracı ayarlarıyla sınırlandırmanız önerilir. Bu özellik hakkında daha fazla bilgi edinmek için hizmet sorumlusu makalesinin şu bölümlerine bakın:
7\. Adım: Çalışma alanı erişimini etkinleştirin
Azure AD uygulamanızın Power BI hizmeti raporlar, panolar ve veri kümeleri gibi nesnelere erişmesini sağlamak için hizmet sorumlusunu veya ana kullanıcıyı çalışma alanınıza üye veya yönetici olarak ekleyin.
Power BI hizmetinde oturum açın.
Erişimini etkinleştirmek istediğiniz çalışma alanına gidin ve Daha fazla menüsünden Çalışma alanı erişimini seçin.
Erişim bölmesinde kullandığınız kimlik doğrulama yöntemine göre hizmet sorumlusunu veya ana kullanıcıyıE-posta adresini girin metin kutusuna yapıştırın.
Not
Hizmet sorumlusu kullanıyorsanız Azure AD uygulamanıza verdiğiniz adı belirtmeniz gerekir.
Ekle’yi seçin.
8\. Adım: İçeriğinizi ekleyin
Power BI Embedded örnek uygulaması, müşterileriniz için ekleme yöntemiyle bir Power BI uygulaması oluşturmanızı sağlar.
Örnek Müşterileriniz için ekleme uygulamasını değiştirerek Power BI raporunuzu eklemek için aşağıdaki 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ı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.
Embed for your customers klasörünü açın.
Aşağıdaki yöntemlerden birini kullanarak örnek müşterileriniz için ekleme uygulamasını açın:
appsettings.json dosyasını açın.
Seçtiğiniz kimlik doğrulama yönteminize göre aşağıdaki parametre değerlerini girin:
Parametre Hizmet sorumlusu Ana kullanıcı
AuthenticationMode
ServicePrincipal MasterUser
ClientId
Azure AD uygulamanızın istemci kimliği Azure AD uygulamanızın istemci kimliği
TenantId
Azure AD kiracı kimliğiniz Yok
PbiUsername
Yok Ana kullanıcının kullanıcı adı; bkz. Power BI kullanıcı adı ve parolası
PbiPassword
Yok Ana kullanıcının parolası; bkz. Power BI kullanıcı adı ve parolası
ClientSecret
Azure AD istemci gizli diziniz Yok
WorkspaceId
Eklenmiş raporunuzun bulunduğu çalışma alanının kimliği; bkz. Çalışma alanı kimliği Eklenmiş raporunuzun bulunduğu çalışma alanının kimliği; bkz. Çalışma alanı kimliği
ReportId
Eklediğiniz raporun kimliği; bkz. Rapor kimliği Eklediğiniz raporun kimliği; bkz. Rapor kimliği
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, Hata Ayıklamayı Başlat'ı çalıştır'ı >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.
Hazır olduğunuzda üretime taşıma gereksinimlerini gözden geçirin. Ayrıca bir kapasiteye ihtiyacınız olacağından gereksinimlerinize en uygun SKU'yu belirleme amacıyla kapasite planlaması makalesini de incelemeniz gerekir.
Önemli
Geliştirme için ücretsiz ekleme deneme belirteçleri kullandıysanız üretim için bir kapasite satın almanız gerekir. Kapasite satın alınana kadar Ücretsiz deneme sürümü başlığı ekli raporun en üstünde görünmeye devam eder.