OneStream

Замечание

Этот соединитель принадлежит и предоставляется OneStream.

Сводка

Item	Description
Статус релиза	Общая доступность
Products	Power BI (наборы данных) Power BI (потоки данных) Fabric (поток данных 2-го поколения)
Поддерживаемые типы проверки подлинности	Учетная запись организации

Предпосылки

Требуется платформа OneStream версии 8.2 или более поздней. Перед установкой Microsoft Power BI Desktop необходимо проверить системные требования .

Поддерживаемые возможности

Соединитель OneStream обеспечивает безопасный доступ к приложениям OneStream. С помощью соединителя можно:

Получите доступ к кубическим и реляционным данным из приложений OneStream непосредственно в Power BI.
Доступ к элементам метаданных и всем их свойствам в OneStream.
Легко воссоздайте структуры полной иерархии в Power BI.
Автоматизация загрузки данных в службу Power BI.

Подключение к OneStream из Power BI Desktop

Получение данных

Откройте Power BI Desktop и выберите "Получить данные из других источников".
Введите OneStream в поле поиска, чтобы найти настраиваемый соединитель OneStream .
Выберите OneStream.
Нажмите Подключиться.

Настройка соединителя

Введите URL-адрес среды OneStream. Убедитесь, что URL-адрес среды введен с префиксом https:// (как показано на следующем снимке экрана). В противном случае попытки подключения не работают должным образом.
Нажмите ОК.

Authenticate

Нажмите кнопку "Войти" , чтобы запустить процесс проверки подлинности.
Этот выбор перенаправляет и открывает сервер удостоверений OneStream в браузере по умолчанию для входа.
Войдите в учетную запись OneStream.
После успешного входа нажмите кнопку "Подключить".

Навигатор OneStream

После успешного входа соединитель OneStream отображает навигатор с доступными 4 типами вызовов:

Получить куб
Получить пользовательский адаптер
Получить измерение
Получение свойств элемента

Ознакомьтесь с рекомендациями , если вам нужна помощь по настройке функций.

Выбрав функцию, которую вы хотите использовать, выполните инструкции, чтобы загрузить данные.

Загрузка данных

В зависимости от требований укажите значения для данной функции. При необходимости можно переключить параметры только на необходимые или использовать все из них. Power BI отображает предварительный просмотр данных для возвращаемой таблицы.
После предоставления параметров загрузите или преобразуйте данные.
- Выберите "Загрузить ", чтобы загрузить таблицу в внутреннюю модель данных Power BI Desktop.
- Выберите "Преобразовать данные ", чтобы внести изменения в таблицу перед загрузкой в внутреннюю модель данных Power BI Desktop. Преобразование данных запускает редактор Power Query в новом окне с репрезентативным представлением таблицы.
Если необходимо загрузить дополнительные таблицы, повторите предыдущие шаги выбора функции, предоставления значений и загрузки или преобразования таблицы.
После загрузки модели данных Power BI Desktop вы сможете создавать связи между таблицами, а также создавать отчеты.

Сведения о пользовательском соединителе OneStream

Соединитель OneStream извлекает данные из экземпляра OneStream с помощью API передачи репрезентативного состояния (REST).

Соединитель OneStream выполняет все вызовы API в рамках границы разрешений текущего пользователя, вошедшего в систему, поэтому применяет безопасность, определенную для пользователя в OneStream.

Замечание

Соединитель использует только области доступа READ от имени пользователя отчета Power BI для выполнения всех операций. Соединитель OneStream не может выполнять операцию обновления.

Соединитель OneStream имеет ограничение в 2 миллиона строк на вызов. Выполнение запроса по этому ограничению вызывает ошибку.

Публикация отчетов Power BI в службе Power BI

Нажмите кнопку "Опубликовать " в Power BI Desktop, чтобы опубликовать данные, отчеты и модель данных в облачной службе Power BI.
Выберите соответствующую рабочую область Power BI и нажмите кнопку "Выбрать".
После успешной публикации отображается сообщение "Успешно" со ссылкой для перехода к службе Power BI.
Выберите ссылку, чтобы просмотреть все отчеты из Power BI Desktop в службе Power BI, а также создать панели мониторинга в службе Power BI.

Лучшие практики и функции: справка

Общие рекомендации

Загрузка только необходимых наборов данных. Это означает, что если вам нужны только агрегированные данные на уровне месяца, не загружайте данные на ежедневном уровне. Чем меньше модель, тем более производительной она всегда является.
Ограничение количества преобразований, которые вы делаете. Чем больше усложнять запрос, тем больше шансов на сбой запроса.
Используйте финансовую логику OneStream и представления кубов или адаптеры данных для создания таблиц, которые затем загружаются в Power BI.

Пример: Консолидации предполагают, что родительская сущность принимает только 40% значений одной из дочерних сущностей. Убедитесь, что эта логика выполняется в OneStream, и загрузите адаптер данных в Power BI, в котором уже заполнены значения.

Попытка репликации логики в Power BI будет чрезвычайно неэффективной и лучше выполняется в исходной системе.

Загрузка большого набора данных с помощью цикла для пользовательских запросов M

При загрузке больших объемов данных, которые могут привести к сбою из-за максимального ограничения на количество строк, рекомендуется создать настраиваемый запрос непосредственно в Power BI, чтобы выполнять цикл по измерению, разделив запрос на несколько частей и объединив данные из результатов запросов прямо в Power BI.

В следующем примере запроса адаптер данных CubeViewMD используется для получения данных несколько раз. Ниже перечислены 3 основных компонента:

GetCubeViewColumns: возвращает список всех столбцов из указанного адаптера, который вы пытаетесь загрузить. Столбцы задаются вручную, чтобы избежать динамического анализа их, что является дорогостоящим (требуется одно дополнительное выполнение запроса).
GetEntities: выполняет dataAdapter, настроенный в качестве метода — элементы (см. следующее изображение), чтобы получить все элементы, необходимые для измерения (в данном случае сущность). Это можно изменить, чтобы выполнять цикл по любому требуемому измерению или элементу.
GetCubeViewData: запускает адаптер CubeViewMD. CubeView содержит параметр с именем pbi_param_entity, который используется для передачи значений GetEntities при выполнении цикла.

Этот код можно использовать в пользовательском запросе для выполнения выбранного адаптера данных в цикле по указанному скрипту-члену для измерения.

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

Получите куб

Эта функция извлекает данные из куба OneStream.

Все параметры можно указать с помощью скрипта участника OneStream (например, 2023.Base для измерения времени), за исключением выборки и валюты, для которых требуется один элемент.
Валюта относится к измерению консолидации в OneStream, поэтому можно использовать локальную или агрегатную, например.

Получите пользовательский адаптер

Укажите имя рабочей области и адаптера (обязательные параметры).
Имя таблицы и параметры являются необязательными.
Перейдите к настроенного адаптеру панели мониторинга в OneStream, чтобы убедиться, что вы вставляете правильные значения.

Получите размерность и свойства элемента

Укажите тип измерения OneStream, который требуется извлечь.
Укажите тип сценария. Используйте значение default или All для использования выбранных измерений куба по умолчанию и получения свойств по умолчанию.
Включаемые описания могут иметь значение True или False.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-10-02