API параметров запроса Power BI Embedded

Параметры запроса позволяют пользователям определять параметры и создавать зависимости частей отчетов и моделей данных (например, фильтр запроса, ссылку на источник данных или определение меры) от одного или нескольких значений параметров. Параметры определяются в PBIX-файле с помощью Power BI Desktop. Подробнее о параметрах запроса см. в этой записи блога.

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

С помощью нового API можно автоматизировать большое количество процессов для нескольких клиентов. Ниже приведено несколько примеров.

• Изменение строки подключения. Настроив параметры строки подключения, вы можете использовать API каждый раз, когда начинаете работать с новым клиентом. Просто скопируйте отчет и измените значения параметров, чтобы подключиться к базе данных клиента. Кроме того, с помощью нового API можно автоматизировать обновления подключений к источникам данных, которые API обновления источников данных не поддерживает.
• Изменение параметров запроса. Определив параметры API, можно установить значения и получить различные результаты и данные, видимые для пользователей только этого отчета.
• Параметры меры. Динамически изменяйте различные вычисляемые меры в зависимости от потребностей каждого клиента в том же отчете. Например, вы можете установить валюту с помощью параметров для разных клиентов или филиалов, находящихся в различных странах.

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