OneStream

Zusammenfassung

Voraussetzungen

OneStream-Plattform, Version 8.2 oder höher, ist erforderlich. Es gibt Systemanforderungen , die vor der Installation von Microsoft Power BI Desktop überprüft werden müssen.

Unterstützte Funktionen

Der OneStream Connector ermöglicht sicheren Zugriff auf Ihre OneStream-Anwendungen. Mit dem Verbinder können Sie:

• Greifen Sie direkt in Power BI auf Cube- und relationale Daten aus OneStream-Anwendungen zu.
• Greifen Sie auf Metadatenelemente und alle ihre OneStream-Eigenschaften zu.
• Erstellen Sie ihre vollständigen Hierarchiestrukturen in Power BI ganz einfach neu.
• Automatisieren von Datenladevorgängen in den Power BI-Dienst.

Herstellen einer Verbindung mit OneStream über Power BI Desktop

Abrufen von Daten

1. Öffnen Sie Power BI Desktop, und wählen Sie " Daten aus anderen Quellen abrufen" aus.

   

2. Geben Sie OneStream in das Suchfeld ein, um den benutzerdefinierten OneStream-Connector zu finden.

   

3. Wählen Sie "OneStream" aus.

4. Wählen Sie Verbinden aus.

Konfigurieren des Connectors

1. Geben Sie Ihre OneStream-Umgebungs-URL ein. Stellen Sie sicher, dass die Umgebungs-URL mit einer führenden https:// eingegeben wird (wie im folgenden Screenshot dargestellt). Andernfalls funktionieren Verbindungsversuche nicht ordnungsgemäß.

   

2. Wählen Sie OK aus.

Authentifizieren

1. Wählen Sie "Anmelden" aus, um den Authentifizierungsprozess zu starten.

2. Diese Auswahl leitet um und öffnet OneStream Identity Server in Ihrem Standardbrowser für die Anmeldung.

3. Melden Sie sich bei Ihrem OneStream-Konto an.

   

4. Wählen Sie nach erfolgreicher Anmeldung "Verbinden" aus.

   

OneStream Navigator

Nach erfolgreicher Anmeldung zeigt der OneStream-Connector den Navigator mit vier verfügbaren Arten von Anrufen an:

• Cube abrufen
• Benutzerdefinierter Adapter abrufen
• Dimension abrufen
• Elementeigenschaften abrufen

Lesen Sie die bewährten Methoden , wenn Sie Hilfe beim Konfigurieren der Funktionen benötigen.

Nachdem Sie die funktion ausgewählt haben, die Sie verwenden möchten, führen Sie die Schritte aus, um die Daten zu laden.

Laden der Daten

1. Geben Sie basierend auf den Anforderungen die Werte für die angegebene Funktion an. Sie können die Parameter nur auf die erforderlichen Parameter umschalten oder bei Bedarf alle parameter verwenden. Power BI zeigt eine Vorschau der Daten für die Tabelle an, die zurückgegeben wird.

2. Nachdem Sie die Parameter angegeben haben, laden oder transformieren Sie die Daten.

   • Wählen Sie "Laden" aus, um die Tabelle in das interne Power BI Desktop-Datenmodell zu laden.
   • Wählen Sie "Daten transformieren " aus, um Änderungen an der Tabelle vorzunehmen, bevor Sie sie in das interne Power BI Desktop-Datenmodell laden. Transformieren von Daten startet den Power Query-Editor in einem neuen Fenster mit einer repräsentativen Ansicht der Tabelle.

3. Wenn Sie zusätzliche Tabellen laden müssen, wiederholen Sie die vorherigen Schritte zum Auswählen der Funktion, bereitstellen der Werte und Laden oder Transformieren der Tabelle.

4. Nachdem Sie das Power BI Desktop-Datenmodell geladen haben, können Sie Beziehungen zwischen Tabellen erstellen sowie Berichte erstellen.

Details zu benutzerdefiniertem OneStream-Connector

Der OneStream-Connector ruft Daten aus einer OneStream-Instanz mithilfe von REST-APIs (Representational State Transfer) ab.

Der OneStream-Connector führt alle APIs-Aufrufe unter der Berechtigungsgrenze des aktuellen angemeldeten Benutzers aus, wodurch die für den Benutzer in OneStream definierte Sicherheit angewendet wird.

Der OneStream-Connector hat eine Beschränkung von 2 Millionen Zeilen pro Anruf. Das Ausführen einer Abfrage über diesen Grenzwert löst einen Fehler aus.

Veröffentlichen von Power BI-Berichten im Power BI-Dienst

1. Wählen Sie die Schaltfläche " Veröffentlichen " in Power BI Desktop aus, um Daten, Berichte und Datenmodell im cloudbasierten Power BI-Dienst zu veröffentlichen.

2. Wählen Sie den entsprechenden Power BI-Arbeitsbereich und dann "Auswählen" aus.

   

3. Nach einer erfolgreichen Veröffentlichung wird eine Meldung "Erfolg" mit einem Link zum Power BI-Dienst angezeigt.

   

4. Wählen Sie den Link aus, um alle Berichte aus Power BI Desktop im Power BI-Dienst anzuzeigen und Dashboards im Power BI-Dienst zu erstellen.

   

Hilfe zu bewährten Methoden und Funktionen

Allgemeine bewährte Methoden

• Laden Sie nur den erforderlichen Datenanteil. Wenn Sie also nur aggregierte Daten auf Monatsebene benötigen, laden Sie keine Daten auf täglicher Ebene. Je kleiner das Modell, desto leistungser ist es immer.

• Beschränken Sie die Anzahl der transformationen, die Sie vornehmen. Je mehr Sie die Abfrage komplizierter machen, desto wahrscheinlicher ist, dass die Abfrage fehlschlägt.

• Nutzen Sie die Finanzlogik und Cubeansichten/Datenadapter von OneStream, um die Tabellen zu erstellen, die dann in Power BI geladen werden.

  Beispiel: Bei Konsolidierungen übernimmt die übergeordnete Entität nur 40% eines der Werte der untergeordneten Entitäten. Stellen Sie sicher, dass diese Logik in OneStream erfolgt, und laden Sie den Datenadapter in Power BI, der bereits die Werte aufgefüllt hat.

  Der Versuch, die Logik in Power BI zu replizieren, wäre extrem ineffizient und wird im Quellsystem besser ausgeführt.

Laden großer Datensätze mithilfe einer Schleife für benutzerdefinierte M-Abfragen

Beim Laden großer Datenmengen, die aufgrund des maximalen Zeilenlimits möglicherweise fehlschlagen könnten, empfehlen wir, eine benutzerdefinierte Abfrage direkt in Power BI zu erstellen, um eine Dimension zu durchlaufen, die Abfrage in mehrere Abfragen aufzuteilen und die Daten aus den Abfrageergebnissen direkt in Power BI zu verknüpfen.

Im folgenden Abfragebeispiel wird mehrmals ein CubeViewMD-Datenadapterabruf ausgeführt. Die drei Hauptkomponenten sind:

• GetCubeViewColumns: Gibt eine Liste aller Spalten aus dem angegebenen Adapter zurück, den Sie laden möchten. Die Spalten werden manuell festgelegt, um zu vermeiden, dass sie dynamisch analysiert werden müssen, was teuer ist (erfordert eine zusätzliche Abfrageausführung).

• GetEntities: Führt einen DataAdapter aus, der als Methode konfiguriert ist – Elemente (siehe folgende Abbildung), um alle Elemente abzurufen, die für eine Dimension (in diesem Fall Entität) erforderlich sind. Sie können dies ändern, um alle erforderlichen Dimensions-/Memberskripts zu durchlaufen.

  

• GetCubeViewData: Führt einen CubeViewMD-Adapter aus. Die CubeView enthält einen Parameter namens pbi_param_entity, der zum Übergeben der Werte von GetEntities beim Schleifen verwendet wird.

Sie können diesen Code in einer benutzerdefinierten Abfrage verwenden, um den ausgewählten Datenadapter in einer Schleife über das angegebene Memberskript für eine Dimension auszuführen.

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

Cube abrufen

Diese Funktion ruft Daten aus einem OneStream-Cube ab.

• Alle Parameter können über das OneStream-Memberskript (z. B. 2023.Base für die Zeit) angegeben werden, mit Ausnahme von Ansicht und Währung, die ein einzelnes Element erfordern.
• Währung bezieht sich auf die Konsolidierungsdimension in OneStream, sodass Sie beispielsweise "Lokal" oder "Aggregat" verwenden können.

Benutzerdefinierter Adapter abrufen

• Geben Sie den Arbeitsbereichs- und Adapternamen (obligatorische Parameter) an.
• Tabellenname und Parameter sind optional.
• Verweisen Sie auf einen konfigurierten Dashboardadapter in OneStream, um sicherzustellen, dass Sie die richtigen Werte einfügen.

Abrufen der Dimension und Abrufen von Membereigenschaften

• Geben Sie den OneStream-Dimensiontyp an, den Sie abrufen möchten.
• Geben Sie den Szenariotyp an. Verwenden Sie "Standard" oder "Alle", um die ausgewählten Cubestandardabmessungen zu verwenden und die Standardeigenschaften abzurufen.
• "Einbeziehen von Beschreibungen kann auf Wahr oder Falsch eingestellt werden."