öğ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:


Yöntem

Kuruluşunuzun örnek uygulamasına bir ekleme oluşturmak için aşağıdaki adımları izleyin:

  1. Bir Azure AD uygulaması kaydedin.

  2. Power BI çalışma alanı oluşturun.

  3. Power BI raporu oluşturup yayımlayın.

  4. Ekleme parametrelerinin değerlerini alın.

  5. İçeriğinizi ekleyin.

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:

  1. Power BI'da oturum açın.

  2. Çalışma alanları'nı seçin.

  3. Çalışma alanı oluştur'u seçin.

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

  1. GitHub'daki Power BI Desktop samples klasörünü açın.

  2. Kod'u ve ardından ZIP'i indir'i seçin.

    Power BI Desktop Samples GitHub klasöründeki ZIP'i indir seçeneğini gösteren ekran görüntüsü

  3. İndirdiğiniz ZIP arşivini ayıklayıp Samples Reports klasörüne gidin.

  4. 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 Şunun için geçerlidir: Şunun için geçerlidir: Şunun için geçerlidir:
Gizli anahtar Şunun için geçerlidir: Şunun için geçerlidir: Geçerli değildir.
Çalışma Alanı Kimliği Geçerli değildir. Geçerli değildir. Şunun için geçerlidir:
Rapor Kimliği Geçerli değildir. Geçerli değildir. Şunun için geçerlidir:

İstemci Kimliği

İpucu

Uygulama hedefi:  Uygulama hedefi. . NET Core  için geçerlidir. .NET Framework  İçin geçerlidir. React TypeScript

İstemci kimliği GUID değerini (uygulama kimliği olarak da bilinir) almak için şu adımları izleyin:

  1. Microsoft Azure’da oturum açın.

  2. Uygulama kayıtlarını arayın ve Uygulama kayıtları bağlantısını seçin.

  3. Power BI içeriğinizi eklemek için kullandığınız Azure AD uygulamasını seçin.

  4. Genel bakış bölümünde Uygulama (istemci) kimliği GUID değerini kopyalayın.

Gizli anahtar

İpucu

Uygulama hedefi:  Uygulama hedefi. . NET Core  için geçerlidir. .NET Framework  İçin geçerlidir. React TypeScript

İstemci gizli dizisini almak için şu adımları izleyin:

  1. Microsoft Azure’da oturum açın.

  2. Uygulama kayıtlarını arayın ve Uygulama kayıtları bağlantısını seçin.

  3. Power BI içeriğinizi eklemek için kullandığınız Azure AD uygulamasını seçin.

  4. Yönet’in altında Sertifikalar ve gizli diziler’i seçin.

  5. İstemci gizli dizileri bölümünde Yeni istemci gizli dizisi'ni seçin.

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

  7. İ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:  İçin geçerlidir. .. NET Core  için geçerlidir. .NET Framework  İçin geçerlidir. React TypeScript

Çalışma alanı kimliği GUID değerini almak için şu adımları izleyin:

  1. Power BI hizmetinde oturum açın.

  2. Eklemek istediğiniz raporu açın.

  3. URL'deki GUID değerini kopyalayın. GUID değeri, /groups/ ile /reports/ arasındaki sayıdır.

    Power BI hizmeti URL'sindeki çalışma alanı kimliği GUID değerini gösteren ekran görüntüsü

Rapor Kimliği

İpucu

Uygulama hedefi:  İçin geçerlidir. .. NET Core  için geçerlidir. .NET Framework  İçin geçerlidir. ReactTypeScript

Rapor kimliği GUID'lerini almak için şu adımları izleyin:

  1. Power BI hizmetinde oturum açın.

  2. Eklemek istediğiniz raporu açın.

  3. URL'deki GUID değerini kopyalayın. GUID değeri, /reports/ ile /ReportSection/ arasındaki sayıdır.

    Power BI hizmeti URL'sindeki rapor kimliği GUID değerini gösteren ekran görüntüsü

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.

  1. Power BI developer samples klasörünü açın.

  2. Kod'u ve ardından ZIP'i indir'i seçin.

    Power BI Developer Samples GitHub klasöründeki ZIP'i indir seçeneğini gösteren ekran görüntüsü

  3. İndirdiğiniz ZIP dosyasını ayıklayıp PowerBI-Developer-Samples-master klasörüne gidin.

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

  1. Azure portal oturum açın.

  2. Uygulama kayıtları’nı seçin. Bu seçeneği göremiyorsanız arama yapın.

    1. Adım - Azure AD uygulamasını kaydetme'de oluşturduğunuz Azure AD uygulamasını açın.
  3. Yönet menüsünden Kimlik Doğrulaması'ı seçin.

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

  2. Yaptığınız değişiklikleri kaydedin.

.NET Core uygulama örneği için Web yeniden yönlendirme U R ı dahil olmak üzere Azure AD uygulama kimlik doğrulama yapılandırmalarının gösterildiği ekran görüntüsü.

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

  1. Kuruluşunuz Için embed klasörünü açın.

  2. Aşağıdaki yöntemlerden birini kullanarak, Kuruluşunuz için ekleme örnek uygulamanızı açın:

  3. AppSettings. JSON ' u açın ve aşağıdaki parametre değerlerini girin:

Örnek uygulamayı çalıştırma

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

  1. Ekleme örnek uygulamasında oturum açma.

    Not

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

  2. Ekleme örnek uygulaması yüklenirken, eklemek istediğiniz Power BI ve ardından Ekle'yi seçin.

    Örnek uygulama Power BI gösteren ekran görüntüsü.

Uygulamanızı geliştirme

Örnek müşterileriniz için ekleme uygulamasını yapılandırdıktan sonra kendi uygulamanızı geliştirmeye başlayabilirsiniz.

Sonraki adımlar