OneStream

Samenvatting

Vereiste voorwaarden

OneStream-platformversie 8.2 of hoger is vereist. Er zijn systeemvereisten om te controleren voordat u Microsoft Power BI Desktop installeert.

Ondersteunde mogelijkheden

De OneStream-connector maakt beveiligde toegang tot uw OneStream-toepassingen mogelijk. Met de connector kunt u het volgende doen:

• Toegang tot kubus- en relationele gegevens van OneStream-toepassingen, rechtstreeks in Power BI.
• Toegang tot metagegevensleden en al hun OneStream-eigenschappen.
• Maak eenvoudig uw volledige hiërarchiestructuren opnieuw in Power BI.
• Automatiseer het laden van gegevens in de Power BI-service.

Verbinding maken met OneStream vanuit Power BI Desktop

Gegevens ophalen

1. Open Power BI Desktop en selecteer Gegevens ophalen uit andere bronnen.

   

2. Typ OneStream in het zoekvak om de aangepaste OneStream-connector te vinden.

   

3. Selecteer OneStream.

4. Selecteer Maak verbinding met.

De connector configureren

1. Voer de URL van uw OneStream-omgeving in. Zorg ervoor dat de omgevings-URL wordt ingevoerd met 'https://' als voorvoegsel (zoals weergegeven in de volgende schermopname). Anders werken verbindingspogingen niet goed.

   

2. Kies OK.

Authenticate

1. Selecteer Aanmelden om het verificatieproces te starten.

2. Met deze selectie wordt OneStream Identity Server omgeleid en geopend in uw standaardbrowser voor aanmelding.

3. Meld u aan bij uw OneStream-account.

   

4. Nadat u zich hebt aangemeld, selecteert u Verbinding maken.

   

OneStream-navigator

Na een geslaagde aanmelding toont de OneStream-connector de navigator met vier soorten aanroepen die beschikbaar zijn:

• Kubus verkrijgen
• Aangepaste adapter ophalen
• Dimensie ophalen
• Ledeneigenschappen ophalen

Raadpleeg de aanbevolen procedures als u hulp nodig hebt bij het configureren van de functies.

Nadat u de functie hebt geselecteerd die u wilt gebruiken, voert u de stappen uit om de gegevens te laden.

Gegevens laden

1. Geef op basis van de vereisten de waarden voor de opgegeven functie op. U kunt de parameters in- of uitschakelen op alleen de vereiste parameters of ze allemaal gebruiken als dat nodig is. Power BI geeft een voorbeeld weer van gegevens voor de tabel die wordt geretourneerd.

2. Nadat u de parameters hebt opgegeven, laadt of transformeert u de gegevens.

   • Selecteer Laden om de tabel in het interne Power BI Desktop-gegevensmodel te laden.
   • Selecteer Gegevens transformeren om wijzigingen aan te brengen in de tabel voordat u deze in het interne Power BI Desktop-gegevensmodel laadt. Gegevens transformeren start de Power Query-editor in een nieuw venster met een representatieve weergave van de tabel.

3. Als u extra tabellen wilt laden, herhaalt u de vorige stappen voor het kiezen van de functie, het opgegeven van de waarden en het laden of transformeren van de tabel.

4. Nadat u het gegevensmodel van Power BI Desktop hebt geladen, kunt u relaties tussen tabellen maken en rapporten maken.

Details van de OneStream-aangepaste connector

De OneStream-connector haalt gegevens op uit een OneStream-exemplaar met behulp van REST-API's (Representational State Transfer).

De OneStream-connector voert alle API-aanroepen uit onder de machtigingsgrens van de huidige aangemelde gebruiker, waardoor de beveiliging wordt toegepast die is gedefinieerd voor de gebruiker in OneStream.

De OneStream-connector heeft een beperking van 2 miljoen rijen per aanroep. Wanneer een query deze limiet overschrijdt, veroorzaakt dit een fout.

Power BI-rapporten publiceren naar de Power BI-service

1. Selecteer de knop Publiceren in Power BI Desktop om gegevens, rapporten en gegevensmodellen te publiceren naar de Power BI-service in de cloud.

2. Kies de juiste Power BI-werkruimte en selecteer Selecteren.

   

3. Na een geslaagde publicatie wordt een bericht 'Geslaagd' met een koppeling weergegeven om naar de Power BI-service te navigeren.

   

4. Selecteer de koppeling om alle rapporten uit Power BI Desktop in de Power BI-service weer te geven en maak dashboards in de Power BI-service.

   

Aanbevolen procedures en functies helpen

Algemene aanbevolen procedures

• Laad alleen de benodigde gegevens. Dus als u alleen geaggregeerde gegevens op maandniveau nodig hebt, laadt u geen gegevens op dagelijks niveau. Hoe kleiner het model, hoe beter het altijd presteert.

• Beperk het aantal transformaties dat u maakt. Hoe ingewikkelder de query, hoe groter de kans is dat de query mislukt.

• Maak gebruik van de financiële logica en kubusweergaven/gegevensadapters van OneStream om de tabellen te maken die vervolgens in Power BI worden geladen.

  Voorbeeld: Consolidaties betrekken enkel 40% van een van de waarden van de dochterentiteiten. Zorg ervoor dat deze logica wordt uitgevoerd in OneStream en laadt de gegevensadapter in Power BI, waarin de waarden al zijn ingevuld.

  Het repliceren van de logica in Power BI zou zeer inefficiënt zijn en wordt beter uitgevoerd in het bronsysteem.

Grote gegevensset laden met behulp van een lus voor aangepaste M-query's

Bij het laden van grote hoeveelheden gegevens die mogelijk kunnen mislukken door de maximale rijlimiet, raden we u aan om rechtstreeks in Power BI een aangepaste query te maken om een dimensie te doorlopen, deze query op te splitsen in meerdere queries en de gegevens uit de queryresultaten direct in Power BI samen te voegen.

In het volgende queryvoorbeeld wordt meerdere keren een CubeViewMD-gegevensadapter opgehaald. De drie belangrijkste onderdelen zijn:

• GetCubeViewColumns: retourneert een lijst met alle kolommen van de opgegeven adapter die u probeert te laden. De kolommen worden handmatig ingesteld om te voorkomen dat ze dynamisch moeten worden geparseerd, wat duur is (hiervoor is een extra queryuitvoering vereist).

• GetEntities: Hiermee wordt een DataAdapter uitgevoerd die is geconfigureerd als methode - Leden (zie de volgende afbeelding) om alle leden op te halen die nodig zijn voor een dimensie (in dit geval entiteit). Dit kunt u wijzigen om een dimensie-/lidscript naar keuze te doorlopen dat nodig is.

  

• GetCubeViewData: voert een CubeViewMD-adapter uit. De CubeView bevat een parameter die wordt aangeroepen pbi_param_entity. Dit is de parameter die wordt gebruikt voor het doorgeven van de waarden van GetEntities bij het herhalen.

U kunt deze code gebruiken in een aangepaste query om de gekozen gegevensadapter in een lus uit te voeren over het opgegeven lidscript voor een dimensie.

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

Kubus ophalen

Met deze functie worden gegevens opgehaald uit een OneStream-kubus.

• Alle parameters kunnen worden opgegeven via OneStream Member Script (bijvoorbeeld 2023.Base for time), behalve View en Currency waarvoor één lid is vereist.
• Currency verwijst naar de dimensie Consolidatie in OneStream, waarbij u bijvoorbeeld Lokaal of Geaggregeerd kunt gebruiken.

Aangepaste adapter ophalen

• Geef de naam van de werkruimte en de adapter op (verplichte parameters).
• Tabelnaam en parameters zijn optioneel.
• Raadpleeg een geconfigureerde dashboardadapter in OneStream om ervoor te zorgen dat u de juiste waarden invoegt.

Dimensie ophalen en ledeneigenschappen ophalen

• Geef het OneStream-dimensietype op dat u wilt ophalen.
• Geef het scenariotype op. Gebruik Standaard of Alles om de geselecteerde kubusstandaarddimensies te gebruiken en de standaardeigenschappen op te halen.
• Beschrijvingen kunnen worden ingesteld op Ja of Nee.