OneStream

Resumo

Pré-requisitos

A plataforma OneStream versão 8.2 ou superior é necessária. Há requisitos do sistema para verificar antes de instalar o Microsoft Power BI Desktop.

Capacidades suportadas

O OneStream Connector permite acesso seguro aos seus aplicativos OneStream. Com o conector, você pode:

• Acesse dados de cubo e relacionais de aplicativos OneStream diretamente no Power BI.
• Acesse os membros de metadados e todas as suas propriedades relacionadas ao OneStream.
• Recrie facilmente suas estruturas de hierarquia completas no Power BI.
• Automatizar cargas de dados para o serviço do Power BI.

Conectar-se ao OneStream do Power BI Desktop

Obter dados

1. Abra o Power BI Desktop e selecione Obter dados de outras fontes.

   

2. Digite OneStream na caixa de pesquisa para localizar o conector personalizado do OneStream.

   

3. Selecione OneStream.

4. Selecione Conectar.

Configurar o conector

1. Insira a URL do ambiente do OneStream. Certifique-se de que a URL do Ambiente é inserida começando com https:// (conforme mostrado no screenshot a seguir). Caso contrário, as tentativas de conexão não funcionarão corretamente.

   

2. Selecione OK.

Authenticate

1. Selecione Entrar para iniciar o processo de autenticação.

2. Essa seleção redireciona e abre o OneStream Identity Server no navegador padrão para logon.

3. Faça logon em sua conta do OneStream.

   

4. Após o logon bem-sucedido, selecione Conectar.

   

Navegador OneStream

Após o logon bem-sucedido, o conector do OneStream mostra o navegador com quatro tipos de chamadas disponíveis:

• Obter Cubo
• Obter adaptador personalizado
• Obter Dimensão
• Obter propriedades de membro

Consulte as práticas recomendadas se precisar de ajuda para configurar as funções.

Depois de selecionar a função que você deseja usar, siga para carregar os dados.

Carregar dados

1. Com base nos requisitos, forneça os valores para a função fornecida. Você pode alternar os parâmetros apenas para os necessários ou usar todos eles, se necessário. O Power BI exibe uma visualização dos dados da tabela que seriam retornados.

2. Depois de fornecer os parâmetros, carregue ou transforme os dados.

   • Selecione Carregar para carregar a tabela no modelo de dados interno do Power BI Desktop.
   • Selecione Transformar dados para fazer alterações na tabela antes de carregá-los no modelo de dados interno do Power BI Desktop. Transformar dados lança o editor do Power Query em uma nova janela com uma exibição representativa da tabela.

3. Se você precisar carregar tabelas adicionais, repita as etapas anteriores de escolher a função, fornecer os valores e carregar ou transformar a tabela.

4. Depois de carregar o modelo de dados do Power BI Desktop, você poderá criar relações entre tabelas, bem como criar relatórios.

Detalhes sobre o conector personalizado do OneStream

O conector do OneStream busca dados de uma instância do OneStream usando APIs REST (Transferência de Estado Representacional).

O conector do OneStream executa todas as chamadas de APIs sob o limite de permissão do usuário conectado atual, aplicando, portanto, a segurança definida para o usuário no OneStream.

O conector do OneStream tem uma limitação de 2 milhões de linhas por chamada. A execução de uma consulta sobre esse limite dispara um erro.

Publicar relatórios do Power BI no serviço do Power BI

1. Selecione o botão Publicar no Power BI Desktop para publicar dados, relatórios e modelo de dados no serviço do Power BI baseado em nuvem.

2. Escolha o workspace apropriado do Power BI e clique em Selecionar.

   

3. Após uma publicação bem-sucedida, uma mensagem "Êxito" com um link para navegar até o Serviço do Power BI é exibida.

   

4. Selecione o link para exibir todos os relatórios do Power BI Desktop no serviço do Power BI, bem como criar painéis no serviço do Power BI.

   

As práticas recomendadas e as funções ajudam

Práticas recomendadas gerais

• Carregue apenas a granulação de dados necessária. Ou seja, se você precisar apenas de dados agregados no nível do mês, não carregue dados no nível diário. Quanto menor o modelo, mais performante ele sempre é.

• Limite o número de transformações que você faz. Quanto mais você complicar a consulta, maior a chance de a consulta falhar.

• Aproveite a lógica financeira do OneStream e as visões de cubo/adaptadores de dados para criar as tabelas que são, então, carregadas no Power BI.

  Exemplo: as consolidações envolvem a entidade pai levando apenas 40% de um dos valores de uma das entidades filho. Verifique se essa lógica é feita no OneStream e carregue o adaptador de dados no Power BI, que já tem os valores preenchidos.

  Tentar replicar a lógica no Power BI seria extremamente ineficiente e é melhor executado no sistema de origem.

Carregando um conjunto de dados grande usando loop em consultas M personalizadas

Ao carregar grandes quantidades de dados que podem falhar devido ao limite máximo de linhas, recomendamos que você crie uma consulta personalizada diretamente no Power BI para percorrer uma dimensão, dividindo a consulta em várias consultas e unindo diretamente no Power BI os dados dos resultados das consultas.

O exemplo de consulta a seguir executa várias vezes uma recuperação usando o Adaptador de Dados CubeViewMD. Os três componentes principais são:

• GetCubeViewColumns: retorna uma lista de todas as colunas do adaptador especificado que você está tentando carregar. As colunas são definidas manualmente para evitar a necessidade de analisá-las dinamicamente, o que é caro (requer uma execução de consulta adicional).

• GetEntities: executa um DataAdapter configurado como Método – Membros (veja a imagem a seguir) para recuperar todos os membros necessários para uma dimensão (neste caso, entidade). Você pode alterá-lo para fazer loop sobre qualquer dimensão/script de membro necessário.

  

• GetCubeViewData: executa um adaptador CubeViewMD. O CubeView contém um parâmetro chamado pbi_param_entity, que é o usado para passar os valores de GetEntities ao fazer loop.

Você pode usar esse código em uma consulta personalizada para executar o adaptador de dados escolhido em loop sobre o script de membro especificado para uma dimensão.

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

Obter cubo

Essa função recupera dados de um Cubo OneStream.

• Todos os parâmetros podem ser especificados pelo Script de Membro do OneStream (por exemplo, 2023.Base para o tempo), exceto Visão e Moeda que exigem um único membro.
• A moeda refere-se à dimensão Consolidação no OneStream, para que você possa usar Local ou Aggregate, por exemplo.

Obter adaptador personalizado

• Especifique o Workspace e o Nome do Adaptador (parâmetros obrigatórios).
• O nome da tabela e os parâmetros são opcionais.
• Consulte um adaptador de painel configurado dentro do OneStream para verificar se você está inserindo os valores corretos.

Obtenha a dimensão e as propriedades do membro

• Especifique o Tipo de Dimensão do OneStream que você deseja recuperar.
• Especifique o tipo de cenário. Use Padrão ou Tudo para usar as dimensões padrão do cubo selecionado e recuperar as propriedades padrão.
• As descrições de inclusão podem ser definidas como True ou False.