OneStream

Sammendrag

Forutsetning

OneStream-plattformversjon 8.2 eller nyere kreves. Det finnes systemkrav som må verifiseres før du installerer Microsoft Power BI Desktop.

Funksjoner som støttes

OneStream Connector gir sikker tilgang til OneStream-programmene dine. Med kontakten kan du:

• Få tilgang til kuben og relasjonsdata fra OneStream-applikasjoner, direkte inn i Power BI.
• Få tilgang til metadatamedlemmer og alle OneStream-egenskapene deres.
• Gjenskap enkelt hele hierarkistrukturen i Power BI.
• Automatiser datainnlasting til Power Bi-tjeneste.

Koble til OneStream fra Power BI Desktop

Hent data

1. Åpne Power BI Desktop og velg Hent data fra andre kilder.

   

2. Skriv inn OneStream i søkeboksen for å finne den egendefinerte OneStream-koblingen.

   

3. Velg OneStream.

4. Velg Koble til.

Konfigurere koblingen

1. Skriv inn URL-adressen til OneStream-miljøet. Kontroller at URL-adressen for miljøet er angitt med en innledende https:// (som vist i skjermbildet nedenfor). Ellers fungerer ikke tilkoblingsforsøk som de skal.

   

2. Velg OK.

Godkjenne

1. Velg Logg på for å starte godkjenningsprosessen.

2. Dette valget omdirigerer og åpner OneStream Identity Server i standard nettleser for pålogging.

3. Logg på OneStream-kontoen din.

   

4. Etter vellykket pålogging velger du Koble til.

   

OneStream-navigator

Etter vellykket innlogging viser OneStream-koblingen navigatøren med fire typer samtaler tilgjengelig:

• Skaff deg kube
• Skaff deg tilpasset adapter
• Skaff deg Dimension
• Få medlemsegenskaper

Se på beste praksis hvis du trenger hjelp med å konfigurere funksjonene.

Etter å ha valgt funksjonen du vil bruke, følg med for å laste inn dataene.

Last inn data

1. Basert på kravene, oppgi verdiene for den gitte funksjonen. Du kan bytte parametrene til bare de nødvendige eller bruke alle om nødvendig. Power BI viser en forhåndsvisning av data for tabellen som skal returneres.

2. Når du har angitt parameterne, kan du enten laste inn eller transformere dataene.

   • Velg Load for å laste tabellen inn i den interne Power BI Desktop-datamodellen.
   • Velg Transform data for å gjøre endringer i tabellen før du laster den inn i den interne Power BI Desktop-datamodellen. Transform data starter Power Query-editoren i et nytt vindu med en representativ visning av tabellen.

3. Hvis du må laste inn andre tabeller, gjenta de forrige trinnene med å velge funksjonen, gi verdiene, og laste eller transformere tabellen.

4. Etter at du laster inn i Power BI Desktop-datamodellen, kan du opprette relasjoner mellom tabeller og lage rapporter.

Detaljer om egendefinert OneStream-kobling

OneStream-koblingen henter data fra en OneStream-forekomst ved hjelp av REST-API-er (Representational State Transfer).

OneStream-koblingen utfører alle API-kall under tillatelsesgrensen til gjeldende påloggede bruker, og bruker derfor sikkerheten som er definert for brukeren i OneStream.

OneStream-koblingen har en begrensning på 2 millioner rader per samtale. Kjøring av en spørring over denne grensen utløser en feil.

Publiser Power BI-rapporter til Power BI-tjenesten

1. Velg knappen Publiser i Power BI Desktop for å publisere data, rapporter og datamodell til den skybaserte Power Bi-tjeneste.

2. Velg riktig Power BI arbeidsområde og velg Velg.

   

3. Etter en vellykket publisering vises en "Suksess"-melding med en lenke for å navigere til Power BI-tjenesten.

   

4. Velg lenken for å se alle rapporter fra Power BI Desktop i Power Bi-tjeneste, og opprett dashbord i Power Bi-tjeneste.

   

Koble til OneStream fra Power Query Online

For å koble til OneStream-data:

1. Velg OneStream fra siden Power Query Connect to data source.

2. I OneStream-dialogen skriver du inn Miljø-URL-en for din OneStream-instans. Inkluder prefikset https:// .

3. Velg Logg inn for å logge inn med din organisasjonskonto. Du blir omdirigert til OneStream Identity Server for å legge inn dine legitimasjoner.

4. Når du har logget på, velger du Neste.

5. På siden Velg data velger du funksjonene du vil kjøre (for eksempel Get Cube, Get Custom Adapter, Get Dimension eller Get Member Properties), og velg deretter Transform data for å transformere dataene i Power Query-redigering.

Anbefalte fremgangsmåter og funksjoner hjelper

Generelle anbefalte fremgangsmåter

• Last bare inn det nødvendige datakornet. Det betyr at hvis du bare trenger aggregerte data på månedsnivå, må du ikke laste inn data på daglig nivå. Jo mindre modellen er, jo mer effektiv er den alltid.

• Begrens antall transformasjoner du gjør. Jo mer du kompliserer spørringen, jo større sjanse er det for at spørringen mislykkes.

• Bruk OneStreams finansielle logikk og Cube Views/Data Adapters for å lage tabellene som deretter lastes inn i Power BI.

  Eksempel: Konsolideringer innebærer at den overordnede enheten bare tar 40% av en av verdiene til en av de underordnede enhetene. Sørg for at denne logikken gjøres i OneStream, og du laster dataadapteren i Power BI, som allerede har verdiene fylt ut.

  Å forsøke å replikere logikken i Power BI ville vært ineffektivt og fungerer bedre i kildesystemet.

Laste inn stort datasett ved hjelp av løkke på egendefinerte M-spørringer

Når du laster inn store mengder data som potensielt kan feile på grunn av maksimal radgrense, anbefaler vi at du oppretter en egendefinert spørring direkte i Power BI for å gå gjennom en dimensjon, deler spørringen opp i flere spørringer og kobler dataene direkte fra spørringsresultatene i Power BI.

Følgende spørringseksempel kjører en CubeViewMD-datakorthenting flere ganger. De tre hovedkomponentene er:

• GetCubeViewColumns: Returnerer en liste over alle kolonnene fra det angitte kortet du prøver å laste inn. Kolonnene settes manuelt for å unngå å måtte analysere dem dynamisk, noe som er kostbart (krever én ekstra spørringsutførelse).

• GetEntities: Kjører en DataAdapter konfigurert som Metode – Medlemmer (se bildet nedenfor) for å hente alle medlemmene som trengs for en dimensjon (i dette tilfellet enhet). Du kan endre dette for å sløyfe over alle dimensjons-/medlemsskript som trengs.

  

• GetCubeViewData: Kjører en CubeViewMD-adapter. CubeView inneholder en parameter kalt pbi_param_entity, som er den som brukes til å sende verdiene til GetEntities når du sløyfer.

Du kan bruke denne koden i en egendefinert spørring til å kjøre det valgte datakortet i loop over det angitte medlemsskriptet for en dimensjon.

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

Hent kube

Denne funksjonen henter data fra en OneStream-kube.

• Alle parameterne kan spesifiseres via OneStream Member Script (for eksempel 2023.Base for tid), unntatt View og Currency, som krever ett enkelt medlem.
• Valuta refererer til konsolideringsdimensjonen i OneStream, slik at du for eksempel kan bruke Local eller Aggregat.

Få tilpasset adapter

• Angi arbeidsområde og kortnavn (obligatoriske parametere).
• Tabellnavn og parametere er valgfrie.
• Se på en konfigurert dashbordadapter inne i OneStream for å forsikre deg om at du legger inn riktige verdier.

Hent dimensjon og få medlemsegenskaper

• Angi OneStream-dimensjonstypen du vil hente.
• Angi scenariotypen. Bruk Standard eller Alle til å bruke de valgte kubestandarddimensjonene og hente standardegenskapene.
• Inkluder beskrivelser kan settes til Sant eller Usann.