OneStream

Uyarı

Bu bağlayıcı, OneStream'e aittir ve OneStream tarafından sağlanmaktadır.

Özet

Ürün	Description
Sürüm Durumu	Genel Kullanılabilirlik
Products	Power BI (Veri Kümeleri) Power BI (Veri Akışları) Fabric (Veri Akışı 2. Nesil)
Desteklenen Kimlik Doğrulama Türleri	Kuruluş Hesabı

Önkoşullar

OneStream platform sürümü 8.2 veya üzeri gereklidir. Microsoft Power BI Desktop'ı yüklemeden önce doğrulamanız gereken sistem gereksinimleri vardır.

Desteklenen özellikler

OneStream Bağlayıcısı, OneStream uygulamalarınıza güvenli erişim sağlar. Bağlayıcı ile aşağıdakileri yapabilirsiniz:

OneStream uygulamalarından doğrudan Power BI küp ve ilişkisel verilere erişin.
Meta veri üyelerine ve tüm OneStream özelliklerine erişin.
Power BI'da tam hiyerarşi yapılarınızı kolayca yeniden oluşturun.
Power BI hizmeti için veri yüklemelerini otomatikleştirme.

Power Query Desktop'tan bağlanma

Veri Al

Power BI Desktop'ı açın ve Diğer kaynaklardan veri al seçeneğini belirleyin.
Özel OneStream bağlayıcısını bulmak için arama kutusuna OneStream yazın.
OneStream'i seçin.
Bağlan seçeneğini seçin.

Bağlayıcıyı yapılandırma

OneStream ortamı URL'nizi girin. Ortam URL'sinin başında bir https:// bulunduğundan emin olun (aşağıdaki ekran görüntüsünde gösterildiği gibi). Aksi takdirde, bağlantı girişimleri düzgün çalışmaz.
Tamam'ı seçin.

Authenticate

Kimlik doğrulama işlemini başlatmak için Oturum Aç'ı seçin.
Bu seçim oturum açmak için varsayılan tarayıcınızda OneStream Identity Server'ı yeniden yönlendirir ve açar.
OneStream Hesabınızda oturum açın.
Oturum başarıyla açıldıktan sonra Bağlan'ı seçin.

OneStream Gezgin

Başarılı bir oturum açma işleminin ardından OneStream bağlayıcısı gezgine dört tür çağrıyla birlikte gösterilir:

Küpü Al
Özel Bağdaştırıcı Al
Boyut Getir
Üye Özelliklerini Alma

İşlevleri yapılandırma konusunda yardıma ihtiyacınız varsa en iyi yöntemlere bakın.

Kullanmak istediğiniz işlevi seçtikten sonra verileri yüklemeye devam edin.

Verileri yükleme

Gereksinimlere bağlı olarak, verilen işlev için değerleri sağlayın. Parametreleri yalnızca gerekli parametrelere değiştirebilir veya gerekirse tümünü kullanabilirsiniz. Power BI, döndürülecek tablo için verilerin önizlemesini görüntüler.
Parametreleri sağladıktan sonra verileri yükleyin veya dönüştürün.
- tabloyu iç Power BI Desktop veri modeline yüklemek için Load öğesini seçin.
- tablodaki değişiklikleri iç Power BI Desktop veri modeline yüklemeden önce yapmak için Transform data öğesini seçin. Transform data Power Query düzenleyicisini tablonun temsili bir görünümüyle yeni bir pencerede başlatır.
Diğer tabloları yüklemeniz gerekiyorsa, işlevi seçme, değerleri sağlama ve tabloyu yükleme veya dönüştürme adımlarını yineleyin.
Power BI Desktop veri modeline yükledikten sonra tablolar arasında ilişkiler oluşturabilir ve raporlar oluşturabilirsiniz.

Power Query Online'dan bağlanma

OneStream verilerine bağlanmak için:

Power Query Veri kaynağına bağlan sayfasından OneStream seçin.
OneStream iletişim kutusunda, OneStream örneğinizin Ortam URL'sini girin. https:// Ön eki ekleyin.
Kuruluş hesabınızla oturum açmak için Oturum aç'ı seçin. Kimlik bilgilerinizi girmek için OneStream Identity Sunucusu'na yönlendirilirsiniz.
Başarıyla oturum açtığınızda İleriöğesini seçin.
Koşu verileri sayfasında çalıştırmak istediğiniz işlevleri (Küp Al, Özel Bağdaştırıcı Al, Boyut Al veya Üye Özelliklerini Al gibi) seçin ve ardından Power Query Düzenleyicisi'da verileri dönüştürmek için Transform data öğesini seçin.

Ek bilgiler

En iyi yöntemler ve işlevlerin yardımı

Genel en iyi uygulamalar

Yalnızca gerekli veri dilimini yükleyin. Başka bir deyişle, yalnızca ay düzeyinde toplanan verilere ihtiyacınız varsa verileri günlük düzeyde yüklemeyin. Model ne kadar küçük olursa, her zaman o kadar yüksek performans gösterir.
Yaptığınız dönüştürme sayısını sınırlayın. Sorguyu ne kadar karmaşıklaştırırsanız, sorgunun başarısız olma olasılığı o kadar artar.
Daha sonra Power BI yüklenen tabloları oluşturmak için OneStream'in finansal mantığını ve Küp Görünümlerini/Veri Bağdaştırıcılarını uygulayın.

Örnek: Birleştirmeler, üst varlığın alt varlıkların değerlerinden yalnızca 40% almasını içerir. Bu mantığın OneStream'de yapıldığından ve veri bağdaştırıcısını değerlerin zaten doldurulmuş olduğu Power BI'a yüklediğinizden emin olun.

mantığın Power BI çoğaltılması verimsiz olur ve kaynak sistemde daha iyi gerçekleştirilir.

Özel M sorgularında döngü kullanarak büyük veri kümesini yükleme

En yüksek satır sınırı nedeniyle başarısız olabilecek büyük miktarlardaki verileri yüklerken, doğrudan Power BI içinde bir boyut arasında döngü yapmak, sorguyu birden çok sorguya bölmek ve sorgudaki verileri birleştirmek doğrudan Power BI sonuç veren özel bir sorgu oluşturmanızı öneririz.

Aşağıdaki sorgu örneği bir CubeViewMD Veri Bağdaştırıcısı alma işlemini birden çok kez yürütür. Üç ana bileşen şunlardır:

GetCubeViewColumns: Yüklemeye çalıştığınız belirtilen bağdaştırıcıdaki tüm sütunların listesini döndürür. Sütunlar, dinamik ayıklamadan kaçınmak için manuel olarak ayarlanır; bu da fazladan bir sorgu yürütülmesi gerektiği için maliyetlidir.
GetEntities: Bir boyut (bu durumda varlık) için ihtiyaç duyulan tüm üyeleri almak amacıyla, Yöntem - Üyeler olarak biçimlendirilmiş bir DataAdapter'ı (aşağıdaki görüntüde görüldüğü gibi) çalıştırır. Bunu, gereken herhangi bir boyut veya üye betiği üzerinde döngü yapacak şekilde değiştirebilirsiniz.
GetCubeViewData: Bir CubeViewMD bağdaştırıcısı çalıştırır. CubeView, döngü sırasında GetEntities değerlerini geçirmek için kullanılan adlı pbi_param_entitybir parametre içerir.

Seçilen veri bağdaştırıcısını bir boyut için belirtilen üye betiği üzerinde döngü halinde yürütmek için özel bir sorguda bu kodu kullanabilirsiniz.

let
   GetCubeViewColumns = () as list =>
      let 
            Source = {"Cube","Entity","Parent","Cons","Scenario","Time","StartDate","EndDate","View","Account","Flow","Origin","IC","UD1","UD2","UD3","UD4","UD5","UD6","UD7","UD8","CalcScript","Amount"}
      in
            Source,

   GetEmptyTable = () as table =>
      let
            Source = #table(
               GetCubeViewColumns(),
               {
               }
            )
      in 
            Source,

   GetEntities = () as table =>
      let
            Source = OneStream.Navigation("https://your-environment.onestreamcloud.com"),
            YourApp = Source{[Key="YourApp"]}[Data],
            YourCube = YourApp{[Key="YourCube"]}[Data],
            #"Get Custom Adapter" = YourCube{[Key="Get Custom Adapter"]}[Data],
            MemberList = #"Get Custom Adapter"("zzz_PBI_EntityMembers", "Default", null, null),
            MemberListNoDuplicates = Table.Distinct(#"Invoked FunctionGet Custom Adapter1", {"MemberId"}),
            MemberListNamesOnly = Table.RemoveColumns(MemberListNoDuplicates,{"DimTypeId", "DimId", "MemberId", "Description", "SupportsChildren", "IndentLevel"})
      in
            MemberListNamesOnly,


   GetCubeViewData = (EntityName) as table =>
      let
            Source = OneStream.Navigation("https://your-environment.onestreamcloud.com"),
            YourApp = Source{[Key="YourApp"]}[Data],
            YourCube = YourApp{[Key="YourCube"]}[Data],
            #"Get Custom Adapter" = YourCube{[Key="Get Custom Adapter"]}[Data],
            CubeView = try #"Get Custom Adapter"("zzz_PBI_CubeViewAdapter", "Default", null, "pbi_param_entity="& EntityName),
            CubeViewOrDefault = if CubeView[HasError] then GetEmptyTable() else CubeView[Value]
      in
            CubeViewOrDefault,

   List = GetCubeViewColumns(),
   Source = GetEntities(),
   Data = Table.AddColumn(Source, "LoopCubeViewData", each GetCubeViewData([Name])),
   Expand = Table.ExpandTableColumn(Data, "LoopCubeViewData", List),
   Rows = Table.SelectRows(Expand, each [Cube] <> null)
in
   Rows

Küpü al

Bu işlev bir OneStream Küpü'nden veri alır.

Tek bir üye gerektiren Görünüm ve Para Birimi dışında tüm parametreler OneStream Üye Betiği (örneğin, zaman için 2023.Base) aracılığıyla belirtilebilir.
Para birimi, OneStream'deki Birleştirme boyutuna karşılık gelir, bu nedenle örneğin Yerel veya Toplama kullanabilirsiniz.

Özel bağdaştırıcı edinin

Çalışma Alanı ve Bağdaştırıcı Adı'nı (zorunlu parametreler) belirtin.
Tablo Adı ve Parametreler isteğe bağlıdır.
Doğru değerleri eklediğinizden emin olmak için OneStream içinde yapılandırılmış bir pano bağdaştırıcısına bakın.

Boyut alma ve üye özelliklerini alma

Almak istediğiniz OneStream Boyut Türünü belirtin.
Senaryo Türünü belirtin. Seçili küp varsayılan boyutlarını kullanmak ve varsayılan özellikleri almak için Varsayılan veya Tümü'ne tıklayın.
Açıklama Ekle, True veya False olarak ayarlanabilir.

Bağlayıcı ayrıntıları

OneStream bağlayıcısı, Temsili Durum Aktarımı (REST) API'lerini kullanarak bir OneStream örneğinden veri getirir.

OneStream bağlayıcısı tüm API çağrılarını geçerli oturum açmış kullanıcının izin sınırı altında gerçekleştirir ve bu nedenle OneStream'de kullanıcı için tanımlanan güvenliği uygular.