OneStream

Note

Tämän liittimen omistaa ja toimittaa OneStream.

Yhteenveto

Nimike Kuvaus
Julkaisutila Yleinen saatavuus
Products Power BI (Datasets)
Power BI (Dataflows)
Fabric (Dataflow Gen2)
Tuetut todennustyypit Organisaation tili

edellytykset

OneStream-alustan versio 8.2 tai uudempi vaaditaan. Ennen Microsoft Power BI Desktopin asentamista on tarkistettava järjestelmävaatimukset.

Tuetut toiminnot

OneStream Connector mahdollistaa turvallisen pääsyn OneStream-sovelluksiisi. Liittimen avulla voit:

  • Pääse käsiksi kuutioihin ja relaatiotietoihin OneStream-sovelluksista suoraan Power BI:hen.
  • Käytä metatietojäseniä ja kaikkia niiden OneStream-ominaisuuksia.
  • Luo helposti koko hierarkiarakenteesi uudelleen Power BI:ssä.
  • Automatisoi datan lataukset Power BI -palvelu:iin.

Yhdistä OneStreamiin Power BI Desktopista

Hanki tiedot

  1. Avaa Power BI työpöytä ja valitse Hae data muista lähteistä.

    Näyttökuva tietojen noutamisesta.

  2. Kirjoita hakukenttään OneStream löytääksesi mukautetun OneStream-liittimen.

    Kuvakaappaus hakuvalintaikkunasta, jossa OneStream on kirjoitettu hakukenttään.

  3. Valitse OneStream.

  4. Valitse Yhdistä.

Liittimen määrittäminen

  1. Kirjoita OneStream-ympäristön URL-osoite. Varmista, että Ympäristön URL-osoite on syötetty etu-https:// (kuten seuraavassa näyttökuvassa näkyy). Muuten yhteysyritykset eivät toimi oikein.

    Näyttökuva liittimen määritysvalintaikkunasta, jossa on ympäristön URL-osoite.

  2. Valitse OK.

Todentaa

  1. Aloita todennusprosessi valitsemalla Kirjaudu sisään .

  2. Tämä valinta ohjaa ja avaa OneStream Identity Serverin oletusselaimessasi kirjautumista varten.

  3. Kirjaudu sisään OneStream-tilillesi.

    Kuvakaappaus todennusikkunasta, jossa näkyy OneStream-kirjautumisikkuna.

  4. Kun kirjautuminen on onnistunut, valitse Yhdistä.

    Näyttökuva todennusikkunasta, jossa käyttäjä on kirjautunut sisään.

OneStream-navigaattori

Onnistuneen kirjautumisen jälkeen OneStream-liitin näyttää navigaattorille neljä erilaista puhelua:

Näyttökuva siirtymisikkunasta, jossa Hae dimensio on valittuna.

Katso parhaita käytäntöjä , jos tarvitset apua funktioiden konfiguroinnissa.

Kun olet valinnut toiminnon, jota haluat käyttää, lataa tiedot.

Lataa tiedot

  1. Anna vaatimusten perusteella arvot annetulle funktiolle. Voit vaihtaa parametrit vain vaadittuihin parametreihin tai käyttää niitä kaikkia tarvittaessa. Power BI näyttää esikatselun taulukon datasta, joka palautettaisiin.

  2. Kun olet antanut parametrit, lataa tai muunna tiedot.

    • Valitse Load ladataksesi taulukon sisäiseen Power BI Desktop-tietomalliin.
    • Valitse Muunna data tehdäksesi muutoksia taulukkoon ennen kuin lataat sen sisäiseen Power BI Desktop-tietomalliin. Muunna data käynnistää Power Query-editorin uudessa ikkunassa, jossa on edustava näkymä taululle.
  3. Jos sinun täytyy ladata muita taulukoita, toista aiemmat vaiheet: funktion valinta, arvojen antaminen sekä taulukon lataaminen tai muuntaminen.

  4. Kun lataat Power BI Desktopin tietomallin, voit luoda taulujen välisiä suhteita ja raportteja.

Tietoja OneStreamin mukautetusta liittimestä

OneStream-liitin noutaa tietoja OneStream-esiintymästä REST (Representational State Transfer) -ohjelmointirajapintojen avulla.

OneStream-liitin suorittaa kaikki API-kutsut nykyisen kirjautuneen käyttäjän käyttöoikeusrajan alaisuudessa, mikä soveltaa käyttäjälle OneStreamissa määritettyä suojausta.

Note

Liitin käyttää READ scopeja vain Power BI-raportin käyttäjän puolesta kaikkien toimintojen suorittamiseen. OneStream-liitin ei voi suorittaa mitään päivitystoimintoa.

OneStream-liittimen rajoitus on 2 miljoonaa riviä puhelua kohden. Tämän rajan ylittävän kyselyn suorittaminen laukaisee virheen.

Julkaise Power BI -raportit Power BI Serviceen

  1. Valitse Publish-painike Power BI Desktopista julkaistaksesi dataa, raportteja ja datamallia pilvipohjaiseen Power BI -palvelu.

  2. Valitse sopiva Power BI työtila ja valitse Select.

    Kuvakaappaus Power BI työpöydästä, jossa julkaise-painike, työtila ja julkaise-valintapainike korostettuna.

  3. Onnistuneen julkaisun jälkeen näytetään "Onnistunut"-viesti, jossa on linkki Power BI -palveluun siirtymiseen.

    Kuvakaappaus julkaisusta Power BI dialogiin, jossa on onnistumisviesti ja korostettu link.

  4. Valitse linkki nähdäksesi kaikki raportit Power BI Desktopista Power BI -palvelu:ssä, ja luo dashboardit Power BI -palvelu:ssä.

    Näyttökuva palvelun päivitystietomallista, jossa päivityskuvake on korostettuna.

Yhdistä OneStreamiin Power Query Onlinesta

Yhdistääksesi OneStream-dataan:

  1. Valitse OneStream sivulta Power Query Yhdistä datalähteeseen sivulta.

  2. OneStream-valintaikkunassa syötä OneStream-instanssi Environment URL. Sisällytä etuliite https:// .

  3. Valitse Kirjaudu sisään kirjautuaksesi organisaatiotililläsi. Sinut ohjataan OneStream Identity -palvelimelle syöttämään tunnuksesi.

  4. Kun olet kirjautunut sisään, valitse Seuraava.

  5. Valitse data-sivulla valitse haluamasi funktiot (kuten Get Cube, Get Custom Adapter, Get Dimension tai Get Member Properties), ja valitse sitten Transform data muuntaaksesi datan Power Query -editori.

Parhaat käytännöt ja toiminnot auttavat

Yleiset parhaat käytännöt

  • Lataa vain tarvittava tieto. Tämä tarkoittaa, että jos tarvitset vain koottua dataa kuukausitasolla, älä lataa dataa päivittäisellä tasolla. Mitä pienempi malli, sitä suorituskykyisempi se on aina.

  • Rajoita tekemiesi muutosten määrää. Mitä monimutkaisemmin kyselyä monimutkaistetaan, sitä suurempi on mahdollisuus, että kysely epäonnistuu.

  • Sovella OneStreamin talouslogiikkaa ja Cube Views/Data Adaptereita luodaksesi taulukot, jotka sitten ladataan Power BI:hen.

    Esimerkki: Konsolidoinnissa emoyksikkö ottaa vain 40% yhden aliyhteisön arvosta. Varmista, että tämä logiikka on tehty OneStreamissa, ja lataat datasovittimen Power BI:hen, jossa arvot on jo täytetty.

    Logiikan toistaminen Power BI:ssä olisi tehotonta ja toimii paremmin lähdejärjestelmässä.

Suuren tietojoukon lataaminen mukautetuissa M-kyselyissä silmukan avulla

Kun ladataan suuria määriä dataa, jotka voivat epäonnistua maksimirivirajan vuoksi, suosittelemme, että luot oman kyselyn suoraan Power BI:ssä, joka kiertää dimension läpi, jakamalla kyselyn useisiin kyselyihin ja yhdistämällä kyselyn tiedot saadaan suoraan Power BI:hen.

Seuraava kyselyesimerkki suorittaa CubeViewMD-tietosovittimen noudon useita kertoja. Kolme pääkomponenttia ovat:

  • GetCubeViewColumns: Palauttaa luettelon kaikista määritetyn sovittimen sarakkeista, joita yrität ladata. Sarakkeet asetetaan manuaalisesti, jotta niitä ei tarvitse jäsentää dynaamisesti, mikä on kallista (vaatii yhden ylimääräisen kyselyn suorituksen).

  • GetEntities: Suorittaa DataAdapterin, joka on määritetty Method - Members (katso seuraava kuva) noutaakseen kaikki dimension (tässä tapauksessa entiteetin) tarvitsemat jäsenet. Voit muuttaa tämän silmukkaan minkä tahansa tarvittavan ulottuvuuden/jäsenskriptin päälle.

    Näyttökuva jäsentietosovittimen kokoonpanosta.

  • GetCubeViewData: Suorittaa CubeViewMD-sovittimen. CubeView sisältää parametrin nimeltä pbi_param_entity, jota käytetään GetEntities-arvojen välittämiseen silmukan aikana.

Voit käyttää tätä koodia mukautetussa kyselyssä valitun tietosovittimen suorittamiseen silmukassa dimensiolle määritetyn jäsenkomentosarjan yli.

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

Hanki kuutio

Tämä funktio hakee tietoja OneStream-kuutiosta.

  • Kaikki parametrit voidaan määrittää OneStream Member Scriptillä (esimerkiksi 2023.Base ajalle), paitsi View ja Currency, jotka vaativat yhden jäsenen.
  • Valuutta viittaa OneStreamin konsolidointiulottuvuuteen, joten voit käyttää esimerkiksi Paikallista tai Kooste-ulottuvuutta.

Näyttökuva siirtymisikkunasta, jossa on korostettu Hae kuution tiedot -toimintoa.

Hanki mukautettu sovitin

  • Määritä työtila ja sovittimen nimi (pakolliset parametrit).
  • Taulukon nimi ja parametrit ovat valinnaisia.
  • Katso OneStreamin konfiguroitu dashboard-adapteri varmistaaksesi, että syötät oikeat arvot.

Näyttökuva siirtymisikkunasta, jossa on Hae mukautetut sovitintiedot -toiminto korostettuna.

Hae dimensio ja hae jäsenominaisuudet

  • Määritä noudettava OneStream-dimensiotyyppi.
  • Määritä skenaarion tyyppi. Käytä Oletus- tai Kaikki-funktioita käyttääksesi valittuja kuution oletusdimensioita ja noutaaksesi oletusominaisuudet.
  • Sisällytä kuvaukset -asetukseksi voidaan määrittää Tosi tai Epätosi.

Näyttökuva siirtymisikkunasta, jossa on korostettu Hae dimensio -toimintoa.