Power BI
Power BI — это набор средств бизнес-аналитики для анализа данных и обмена аналитическими сведениями. Подключитесь, чтобы получить простой доступ к данным на панелях мониторинга, отчетах и наборах данных Power BI.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Стандарт | Все регионы Power Automate |
| Логические приложения | Стандарт | Все регионы Logic Apps |
| Power Apps | Стандарт | Все регионы Power Apps |
| Power Automate | Стандарт | Все регионы Power Automate |
| Контакт | |
|---|---|
| Имя | Microsoft |
| URL | https://powerbi.microsoft.com/en-us/support/ |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Website | https://powerbi.microsoft.com/ |
| Политика конфиденциальности | https://privacy.microsoft.com/privacystatement |
| Категории | Бизнес-аналитика; Сайт |
Чтобы использовать эту интеграцию, вам потребуется доступ к учетной записи Power BI. Чтобы сделать подключение, нажмите кнопку "Войти". Вам будет предложено указать учетную запись, следуйте остальным экранам, чтобы создать подключение.
При использовании подключения может потребоваться наличие определенных конфигураций в учетной записи Power BI. Например, чтобы использовать триггеры оповещений на основе данных, необходимо настроить оповещение на основе данных.
Теперь вы готовы начать использовать эту интеграцию.
Известные проблемы и ограничения
Соединитель Power BI не поддерживается для национальных облачных кластеров Power BI (т. е. для кластеров Китая, Германии и государственных организаций США).
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Выполнение запроса JSON к набору данных |
Используйте REST API Power BI для выполнения запроса в формате JSON. |
| Выполнение запроса к набору данных |
Используйте REST API Power BI для выполнения запроса. |
| Добавление заметки к регистрации (предварительная версия) |
Добавляет новую заметку к входу цели Power BI. |
| Добавление строк в набор данных |
Используйте REST API Power BI для добавления строк в набор данных. |
| Обновление набора данных |
Используйте REST API Power BI для обновления набора данных PowerBI. |
| Обновление регистрации (предварительная версия) |
Обновляет проверку цели Power BI. |
| Обновление цели (предварительная версия) |
Обновляет состояние цели Power BI. |
| Получение контрольных точек (предварительная версия) |
Получите все входы в цель Power BI. |
| Получение нескольких целей (предварительная версия) |
Получите список целей Power BI в указанной системе показателей. |
| Получение проверки цели (предварительная версия) |
Получите проверку на цель Power BI. |
| Получение систем показателей (предварительная версия) |
Возвращает список систем показателей Power BI в указанной рабочей области. |
| Получение цели (предварительная версия) |
Возвращает указанную цель Power BI в системе показателей. |
| Создание регистрации (предварительная версия) |
Создает проверку цели Power BI. |
| Создание системы показателей (предварительная версия) |
Создает систему показателей для целей Power BI. |
| Создание цели (предварительная версия) |
Создает цель Power BI для указанной системы показателей. |
| Экспорт в файл для отчетов Power BI |
Использование REST API Power BI для инициализации экспорта для отчетов Power BI |
| Экспорт в файл для отчетов с разбивкой на страницы |
Использование REST API Power BI для инициализации экспорта для отчетов с разбивкой на страницы |
Выполнение запроса JSON к набору данных
Используйте REST API Power BI для выполнения запроса в формате JSON.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Dataset
|
datasetid | True | string |
Уникальный идентификатор набора данных. |
Возвращаемое значение
- response
- object
Выполнение запроса к набору данных
Используйте REST API Power BI для выполнения запроса.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Dataset
|
datasetid | True | string |
Уникальный идентификатор набора данных. |
|
Текст запроса
|
query | True | string |
Текст запроса. Может быть многострочного текста. |
|
Включенные значения NULL
|
includeNulls | boolean |
Значение NULL должно быть включено в результаты. Значение по умолчанию — Нет. |
|
|
Олицетворения пользователя
|
impersonatedUserName | string |
Удостоверение пользователя в формате имени участника-пользователя для выполнения запроса от имени другого пользователя. |
Возвращаемое значение
Результаты выполнения запроса.
Добавление заметки к регистрации (предварительная версия)
Добавляет новую заметку к входу цели Power BI.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Идентификатор цели
|
goalId | True | string |
Уникальный идентификатор цели. |
|
Дата регистрации
|
goalCheckin | True | date |
Пример: 2021-07-21 |
|
Замечание
|
note | True | string |
Может быть многострочного текста |
Добавление строк в набор данных
Используйте REST API Power BI для добавления строк в набор данных.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Dataset
|
datasetid | True | string |
Уникальный идентификатор набора данных. |
|
Таблица
|
tablename | True | string |
Название таблицы. |
|
Полезные данные для отправки
|
Payload | dynamic |
Обновление набора данных
Используйте REST API Power BI для обновления набора данных PowerBI.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Dataset
|
datasetid | True | string |
Уникальный идентификатор набора данных. |
Обновление регистрации (предварительная версия)
Обновляет проверку цели Power BI.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Идентификатор цели
|
goalId | True | string |
Уникальный идентификатор цели. |
|
Дата регистрации
|
goalCheckin | True | date |
Пример: 2021-07-21 |
|
Ценность
|
value | number | ||
|
Состояние
|
status | string |
Состояние цели. |
Обновление цели (предварительная версия)
Обновляет состояние цели Power BI.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Идентификатор цели
|
goalId | True | string |
Уникальный идентификатор цели. |
|
Имя
|
name | string |
При условии, новое имя цели. |
|
|
Владелец
|
owner |
Если он указан, адрес электронной почты нового владельца цели. |
||
|
Текущее значение
|
value | number |
При условии задает новое значение цели. |
|
|
Целевое значение
|
target | number |
При условии задает новый целевой объект цели. |
|
|
Состояние
|
status | string |
При условии задает новое состояние цели. |
|
|
Начальная дата
|
startDate | date |
Если это указано, новая дата начала цели. Пример: 2021-07-15. |
|
|
Дата завершения
|
completionDate | date |
Если это указано, новая дата завершения цели. Пример: 2021-07-29. |
Получение контрольных точек (предварительная версия)
Получите все входы в цель Power BI.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Идентификатор цели
|
goalId | True | string |
Уникальный идентификатор цели. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Входы
|
value | array of object |
Список входов. |
|
Date
|
value.timestamp | datetime |
Дата, в которую была выполнена регистрация. |
|
Ценность
|
value.value | number |
Значение во время регистрации. |
|
Состояние
|
value.status | string |
Состояние цели во время регистрации. |
|
Примечания.
|
value.notes | GoalNotes |
Список заметок. |
Получение нескольких целей (предварительная версия)
Получите список целей Power BI в указанной системе показателей.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
Возвращаемое значение
Весь текст ответа.
- Получить
- FetchedGoals
Получение проверки цели (предварительная версия)
Получите проверку на цель Power BI.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Идентификатор цели
|
goalId | True | string |
Уникальный идентификатор цели. |
|
Дата регистрации
|
goalCheckin | True | date |
Пример: 2021-07-21 |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Date
|
timestamp | date |
Дата, в которую была выполнена регистрация. |
|
Ценность
|
value | number |
Значение во время регистрации, если задано. |
|
Состояние
|
status | string |
Состояние цели во время регистрации. |
|
Примечания.
|
notes | GoalNotes |
Список заметок. |
Получение систем показателей (предварительная версия)
Возвращает список систем показателей Power BI в указанной рабочей области.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
Возвращаемое значение
Весь текст ответа.
- Получить
- ListedScorecards
Получение цели (предварительная версия)
Возвращает указанную цель Power BI в системе показателей.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Идентификатор цели
|
goalId | True | string |
Уникальный идентификатор цели. |
Возвращаемое значение
Сведения о цели.
- Цель
- FetchedGoal
Создание регистрации (предварительная версия)
Создает проверку цели Power BI.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Идентификатор цели
|
goalId | True | string |
Уникальный идентификатор цели. |
|
Date
|
timestamp | True | date |
Дата регистрации. Пример: 2021-07-21 |
|
Ценность
|
value | number | ||
|
Состояние
|
status | string |
Состояние цели. |
|
|
Замечание
|
note | string |
Может быть многострочного текста |
Создание системы показателей (предварительная версия)
Создает систему показателей для целей Power BI.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Имя
|
name | True | string |
Имя системы показателей |
|
Description
|
description | string |
Описание системы показателей |
Возвращаемое значение
Созданная системная карта показателей.
- Созданная карта показателей
- CreatedScorecard
Создание цели (предварительная версия)
Создает цель Power BI для указанной системы показателей.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Имя
|
name | True | string |
Имя цели. |
|
Владелец
|
owner |
Адрес электронной почты владельца цели. Пример: foo@bar.com |
||
|
Текущее значение
|
value | string |
Текущее значение отслеживаемой цели. |
|
|
Целевое значение
|
target | string |
Целевое значение цели. |
|
|
Состояние
|
status | string |
Текущее состояние цели. |
|
|
Начальная дата
|
startDate | date |
Дата начала цели. Пример: 2021-07-15. |
|
|
Дата завершения
|
completionDate | date |
Дата завершения цели. Пример: 2021-07-29. |
|
|
Замечание
|
note | string |
Обратите внимание на присоединение к первоначальной регистрации цели. Может быть многострочного текста |
|
|
Идентификатор родительской цели
|
parentId | string |
Если эта цель является подгоном, уникальный идентификатор своей родительской цели. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Уникальный идентификатор цели. |
Экспорт в файл для отчетов Power BI
Использование REST API Power BI для инициализации экспорта для отчетов Power BI
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Отчет
|
reportid | True | string |
Уникальный идентификатор отчета pbi. |
|
Формат экспорта
|
format | True | string |
Формат экспорта отчета Power BI. Поддерживаемые форматы: PPTX (PowerPoint), PDF и PNG |
|
Региональные настройки
|
locale | string |
Языковой стандарт для применения |
|
|
Включение скрытых страниц
|
includeHiddenPages | boolean |
Флаг, указывающий, следует ли включать скрытые страницы при экспорте всего отчета (при передаче определенных страниц это свойство будет игнорироваться). Если это не указано, поведение по умолчанию — исключить скрытые страницы |
|
|
Имя закладки
|
name | string |
Имя закладки |
|
|
Состояние закладки
|
state | string |
Состояние закладки |
|
|
Filter
|
filter | string |
Фильтр для применения |
|
|
pageName
|
pageName | string |
Имя страницы |
|
|
visualName
|
visualName | string |
(Необязательно) Экспорт визуального имени |
|
|
Имя закладки
|
name | string |
Имя закладки |
|
|
Состояние закладки
|
state | string |
Состояние закладки |
|
|
Имя пользователя
|
username | True | string |
Эффективное имя пользователя, отраженное маркером для применения правил RLS (для модели OnPrem, имя пользователя может состоять из альфа-числовых символов или любого из следующих символов ".", "-", "_", "_", "!", "#", "^", "~", "\", "@", а также имя пользователя не может содержать пробелы. Для облачной модели имя пользователя может состоять из всех символов ASCII. имя пользователя должно быть не более 256 символов) |
|
Наборы данных
|
datasets | array of string |
Массив наборов данных, для которых применяется это удостоверение |
|
|
Роли
|
roles | array of string |
Массив ролей RLS, отраженных маркером при применении правил RLS (удостоверение может содержать до 50 ролей, роль может быть состоит из любого символа, кроме "," и должно быть до 50 символов). |
|
|
CustomData
|
customData | string |
Значение customdata, используемое для применения правил RLS. Поддерживается только для динамических подключений к Службам Azure Analysis Services. |
|
|
Значение BLOB-объекта
|
value | True | string |
Маркер доступа OAuth2 для SQL Azure |
|
Отчеты
|
reports | array of string |
Массив отчетов, для которых применяется это удостоверение, поддерживается только для отчетов с разбивкой на страницы. |
Возвращаемое значение
Содержимое файла.
- Содержимое файла
- binary
Экспорт в файл для отчетов с разбивкой на страницы
Использование REST API Power BI для инициализации экспорта для отчетов с разбивкой на страницы
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Отчет
|
reportid | True | string |
Уникальный идентификатор отчета с разбивкой на страницы. |
|
Формат экспорта
|
format | True | string |
Формат экспорта для отчета с разбивкой на страницы. Поддерживаемые форматы: PPTX (PowerPoint), PDF, ACCESSIBLEPDF (доступный PDF), XLSX (Excel), DOCX (Word), CSV, XML, MHTML и Image (BMP, EMF, GIF, JPEG, PNG или TIFF). |
|
Имя пользователя
|
username | True | string |
Эффективное имя пользователя, отраженное маркером для применения правил RLS (для модели OnPrem, имя пользователя может состоять из альфа-числовых символов или любого из следующих символов ".", "-", "_", "_", "!", "#", "^", "~", "\", "@", а также имя пользователя не может содержать пробелы. Для облачной модели имя пользователя может состоять из всех символов ASCII. имя пользователя должно быть не более 256 символов) |
|
Наборы данных
|
datasets | array of string |
Массив наборов данных, для которых применяется это удостоверение |
|
|
Роли
|
roles | array of string |
Массив ролей RLS, отраженных маркером при применении правил RLS (удостоверение может содержать до 50 ролей, роль может быть состоит из любого символа, кроме "," и должно быть до 50 символов). |
|
|
CustomData
|
customData | string |
Значение customdata, используемое для применения правил RLS. Поддерживается только для динамических подключений к Службам Azure Analysis Services. |
|
|
Значение BLOB-объекта
|
value | True | string |
Маркер доступа OAuth2 для SQL Azure |
|
Отчеты
|
reports | array of string |
Массив отчетов, для которых применяется это удостоверение, поддерживается только для отчетов с разбивкой на страницы. |
|
|
FormatSettings
|
formatSettings | object |
Словарь параметров формата. Ключи — это имена свойств сведений об устройстве для запрошенного формата файла. |
|
|
имя
|
name | string |
Имя параметра отчета |
|
|
value
|
value | string |
Значение параметра отчета |
Возвращаемое значение
Содержимое файла.
- Содержимое файла
- binary
Триггеры
| Когда кто-то добавляет или редактирует проверку цели (предварительная версия) |
Триггер для некоторых изменений цели Power BI или заметок. |
| Когда пользователь назначает новому владельцу цель (предварительная версия) |
Когда пользователь назначает новому владельцу цель Power BI. |
| Нажмите кнопку Power BI |
Этот триггер позволяет запускать поток при нажатии кнопки Power BI. (Доступно только для Power Automate.) |
| При активации оповещения на основе данных |
Возвращает сведения о указанном оповещении на основе данных из Power BI при активации оповещения. |
| При изменении состояния цели (предварительная версия) |
При изменении состояния некоторых целей Power BI. |
| При изменении текущего значения цели (предварительная версия) |
При изменении текущего значения некоторых целей Power BI. |
| При изменении цели (предварительная версия) |
При изменении свойства некоторых целей Power BI. |
| При сбое обновления данных для цели (предварительная версия) |
Если обновление данных для цели Power BI завершается сбоем. |
Когда кто-то добавляет или редактирует проверку цели (предварительная версия)
Триггер для некоторых изменений цели Power BI или заметок.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Идентификатор цели
|
goalId | True | string |
Уникальный идентификатор цели. |
|
Интервал опроса (с)
|
pollingInterval | True | number |
Количество секунд между проверками новых данных. Минимальное значение — 300. |
Возвращаемое значение
Добавлены или изменены цели для регистрации или примечания.
- Обновленная цель
- GoalValueOrNoteUpserted
Когда пользователь назначает новому владельцу цель (предварительная версия)
Когда пользователь назначает новому владельцу цель Power BI.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Владелец
|
owner |
Электронная почта владельца. Может быть вашим. Может быть пустым при отслеживании любого владельца. |
||
|
Интервал опроса (с)
|
pollingInterval | True | number |
Количество секунд между проверками новых данных. Минимальное значение — 300. |
Возвращаемое значение
Назначенные цели.
- Назначенные
- GoalsAssigned
Нажмите кнопку Power BI
Этот триггер позволяет запускать поток при нажатии кнопки Power BI. (Доступно только для Power Automate.)
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
operationId
|
operationId | True | string | |
|
host
|
host | object | ||
|
parameters
|
parameters | True | object | |
|
headersSchema
|
headersSchema | object | ||
|
schema
|
schema | object |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Строк
|
body.rows | array of object | |
|
items
|
body.rows | object | |
|
Электронная почта пользователя
|
headers.x-ms-user-email-encoded | byte |
Адрес электронной почты пользователя, активировавшего поток. |
|
Имя пользователя
|
headers.x-ms-user-name-encoded | byte |
Отображаемое имя пользователя, активировавшего поток. |
|
Отметка времени
|
headers.x-ms-user-timestamp | string |
Время активации потока. |
|
Идентификатор пользователя
|
headers.x-ms-user-id | guid |
Уникальный идентификатор пользователя, активировавшего поток в AAD. |
При активации оповещения на основе данных
Возвращает сведения о указанном оповещении на основе данных из Power BI при активации оповещения.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор оповещения
|
alertId | True | string |
Идентификатор оповещения для отслеживания. |
Возвращаемое значение
- Тело
- EvaluatedAlert
При изменении состояния цели (предварительная версия)
При изменении состояния некоторых целей Power BI.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Идентификатор цели
|
goalId | True | string |
Уникальный идентификатор цели. |
|
Интервал опроса (с)
|
pollingInterval | True | number |
Количество секунд между проверками новых данных. Минимальное значение — 300. |
Возвращаемое значение
Изменены свойства цели.
- Измененная цель
- GoalStatusChanged
При изменении текущего значения цели (предварительная версия)
При изменении текущего значения некоторых целей Power BI.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Идентификатор цели
|
goalId | True | string |
Уникальный идентификатор цели. |
|
Интервал опроса (с)
|
pollingInterval | True | number |
Количество секунд между проверками новых данных. Минимальное значение — 300. |
Возвращаемое значение
Изменены свойства цели.
- Измененная цель
- GoalValueChanged
При изменении цели (предварительная версия)
При изменении свойства некоторых целей Power BI.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Идентификатор цели
|
goalId | True | string |
Уникальный идентификатор цели. |
|
Интервал опроса (с)
|
pollingInterval | True | number |
Количество секунд между проверками новых данных. Минимальное значение — 300. |
Возвращаемое значение
Изменены свойства цели.
- Измененная цель
- GoalChanged
При сбое обновления данных для цели (предварительная версия)
Если обновление данных для цели Power BI завершается сбоем.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Workspace
|
groupid | True | string |
Уникальный идентификатор рабочей области. |
|
Идентификатор системы показателей
|
scorecardId | True | string |
Уникальный идентификатор системы показателей. |
|
Идентификатор цели
|
goalId | True | string |
Уникальный идентификатор цели. |
|
Отслеживание целевого источника
|
trackTargetSource | True | string |
Будет отслеживать ссылку для цели цели. |
|
Отслеживание источника значений
|
trackValueSource | True | string |
Будет отслеживать ссылку для значения цели. |
|
Интервал опроса (с)
|
pollingInterval | True | number |
Количество секунд между проверками новых данных. Минимальное значение — 300. |
Возвращаемое значение
Проблемы с обновлением цели.
- Сбой обновления
- GoalRefreshIssues
Определения
QueryExecutionResults
Результаты выполнения запроса.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Первые строки таблицы
|
firstTableRows | array of object |
Результаты запроса в виде массива строк. |
CreatedScorecard
Созданная системная карта показателей.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Уникальный идентификатор системы показателей. |
ListedScorecards
Весь текст ответа.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Карточки оценок
|
value | array of ListedScorecard |
Список систем показателей. |
ListedScorecard
Системы показателей.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Уникальный идентификатор системы показателей. |
|
Имя
|
name | string |
Имя системы показателей. |
|
Контакт
|
contact | string |
Контактные данные для системы показателей. |
FetchedGoals
Весь текст ответа.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Цели
|
value | array of FetchedGoal |
Список целей. |
FetchedGoal
Сведения о цели.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Уникальный идентификатор цели. |
|
Имя
|
name | string |
Имя цели. |
|
Владелец
|
owner |
Адрес электронной почты владельца цели. |
|
|
Начальная дата
|
startDate | date |
Дата начала цели. Пример: 2021-07-15. |
|
Дата завершения
|
completionDate | date |
Дата выполнения цели, на которую будет выполнена. Пример: 2021-07-29. |
|
Идентификатор родительской цели
|
parentId | string |
Если эта цель является подгоном, уникальный идентификатор своей родительской цели. |
|
Текущее значение
|
currentValue | number |
Текущее значение отслеживаемой цели. |
|
Метка времени текущего значения
|
currentValueTimestamp | date |
Метка времени, когда задано текущее значение цели. |
|
Целевое значение
|
targetValue | number |
Целевое значение цели. |
|
Метка времени целевого значения
|
targetValueTimestamp | date |
Метка времени при установке целевого значения цели. |
|
Состояние
|
status | string |
Состояние цели. |
|
Метка времени состояния
|
statusTimestamp | date |
Метка времени при установке состояния цели. |
|
Частота
|
cycle | string |
Интервал частоты цикла отслеживания, показанный на визуальных элементах этой цели. |
|
Дата цикла отслеживания
|
cyclePeriod | date |
Дата, чтобы узнать дополнительные свойства цикла отслеживания. |
ГолЧане
Изменены свойства цели.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Уникальный идентификатор цели. |
|
Старое имя
|
oldName | string |
Имя цели. |
|
Старый владелец
|
oldOwner |
Адрес электронной почты владельца цели. |
|
|
Старая дата начала
|
oldStartDate | date |
Дата начала цели. Пример: 2021-07-15. |
|
Старая дата завершения
|
oldCompletionDate | date |
Дата выполнения цели, на которую будет выполнена. Пример: 2021-07-29. |
|
Старый идентификатор родительской цели
|
oldParentId | string |
Если эта цель является подгоном, уникальный идентификатор своей родительской цели. |
|
Старое текущее значение
|
oldCurrentValue | number |
Текущее значение отслеживаемой цели. |
|
Старое целевое значение
|
oldTargetValue | number |
Целевое значение цели. |
|
Старое состояние
|
oldStatus | string |
Состояние цели. |
|
Старая частота
|
oldCycle | string |
Старый интервал частоты отслеживания, показанный на визуальных элементах этой цели. |
|
Старая дата цикла отслеживания
|
oldCyclePeriod | date |
Старая дата, чтобы узнать дополнительные свойства цикла отслеживания. |
|
Новое имя
|
newName | string |
Имя цели. |
|
Новый владелец
|
newOwner |
Адрес электронной почты владельца цели. |
|
|
Новая дата начала
|
newStartDate | date |
Дата начала цели. |
|
Новая дата завершения
|
newCompletionDate | date |
Дата выполнения цели, на которую будет выполнена. |
|
Новый идентификатор родительской цели
|
newParentId | string |
Если эта цель является подгоном, уникальный идентификатор своей родительской цели. |
|
Новое текущее значение
|
newCurrentValue | number |
Текущее значение отслеживаемой цели. |
|
Новое целевое значение
|
newTargetValue | number |
Целевое значение цели. |
|
Новое состояние
|
newStatus | string |
Состояние цели. |
|
Новая частота
|
newCycle | string |
Новый интервал цикла отслеживания, показанный на визуальных элементах этой цели. |
|
Новая дата цикла отслеживания
|
newCyclePeriod | date |
Новая дата, чтобы узнать дополнительные свойства цикла отслеживания. |
|
Список изменений
|
changeList | string |
Разделенный запятыми список изменений. Пример: status,currentValue. |
GoalStatusChanged
Изменены свойства цели.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Уникальный идентификатор цели. |
|
Старое состояние
|
oldStatus | string |
Состояние цели. |
|
Новое состояние
|
newStatus | string |
Состояние цели. |
GoalValueChanged
Изменены свойства цели.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Уникальный идентификатор цели. |
|
Старое текущее значение
|
oldCurrentValue | number |
Текущее значение отслеживаемой цели. |
|
Новое текущее значение
|
newCurrentValue | number |
Текущее значение отслеживаемой цели. |
GoalRefreshIssues
Проблемы с обновлением цели.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Проблемы
|
issues | array of GoalRefreshIssue |
Проблемы с обновлением цели. |
GoalRefreshIssue
Проблема с обновлением цели.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Тип подключения
|
connectionType | string |
Тип подключения ( Current или Target). |
|
Отметка времени
|
timestamp | string |
Метка времени сбоя обновления. |
|
Сообщение об ошибке
|
message | string |
Описание ошибки. |
ЦелиAssigned
Назначенные цели.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Цели
|
assignedGoals | array of object |
Список целей, назначенных новому владельцу. |
|
Идентификатор
|
assignedGoals.id | string |
Уникальный идентификатор цели. |
|
Идентификатор системы показателей
|
assignedGoals.scorecardId | string |
Уникальный идентификатор системы показателей. |
|
Имя
|
assignedGoals.name | string |
Имя цели. |
|
Владелец
|
assignedGoals.owner | string |
Новый владелец, которому была назначена цель. |
|
Автор последнего изменения
|
assignedGoals.lastModifiedBy | string |
Пользователь, который последний раз изменил цель. |
|
Начальная дата
|
assignedGoals.startDate | date |
Дата начала цели. |
|
Дата завершения
|
assignedGoals.completionDate | date |
Дата завершения цели. |
GoalValueOrNoteUpserted
Добавлены или изменены цели для регистрации или примечания.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Входы
|
values | array of object |
Добавлены или обновлены входы. |
|
Date
|
values.timestamp | date |
Дата, в которую была выполнена регистрация. |
|
Ценность
|
values.value | number |
Значение цели во время регистрации. |
|
Состояние
|
values.status | string |
Состояние цели во время регистрации. |
|
Примечания.
|
notes | array of object |
Добавлены или измененные заметки. |
|
Дата регистрации
|
notes.valueTimestamp | date |
Дата регистрации, в которую добавлена эта заметка. |
|
Текст
|
notes.body | string |
Текст только что добавленной заметки. |
|
Время создания
|
notes.createdTime | datetime |
Дата создания заметки. |
GoalNotes
Список заметок.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Текст
|
body | string |
Содержимое заметки. |
|
Время создания
|
createdTime | datetime |
Дата создания заметки. |
EvaluatedAlert
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Название оповещения
|
alertTitle | string |
Заголовок оповещения. |
|
Пороговое значение оповещени
|
alertThreshold | number |
Пороговое значение, с помощью которого активируется оповещение. |
|
Активируется ли оповещение
|
isAlertTriggered | boolean |
Логическое значение (true, false) определяет, активируется ли оповещение. |
|
URL-адрес плитки
|
tileUrl | string |
URL-адрес, связанный с плиткой панели мониторинга, в которой настроено оповещение. |
|
Значение плитки
|
tileValue |
Значение плитки. |
бинарный
Это базовый тип данных binary.
объект
Это тип object.