API de Parâmetros de Consulta do Power BI Embedded
Data da publicação: 25 março, 2018
Os parâmetros de consulta permitem que os usuários definam parâmetros e façam com que partes de seus relatórios e modelos de dados (tais como um filtro de consulta, uma referência de fonte de dados ou uma definição de medida) sejam dependentes de um ou mais valores de parâmetro. Os parâmetros são definidos no arquivo PBIX usando o Power BI Desktop. Saiba mais sobre parâmetros de consulta nesta postagem no blog.
A nova API de Parâmetros de Consulta permite que os desenvolvedores alterem dinamicamente os valores dos parâmetros e automatizem o processo de trabalhar com eles. A API inclui uma chamada para obter todos os parâmetros definida em um conjunto de dados específico e uma chamada para definir novos valores para parâmetros existentes.
Nessa nova API, é possível automatizar vários processos para diversos clientes. Estes são alguns exemplos:
- Alterar a cadeia de conexão. Configurando parâmetros na cadeia de conexão, é possível usar a API sempre que você integrar um novo cliente. Basta clonar o relatório e alterar os valores dos parâmetros para conectar ao banco de dados do cliente. Isso também pode ajudar a automatizar as atualizações de conexão com fontes de dados que não são compatíveis com a API de Atualizar Fontes de Dados.
- Alterar parâmetros de consulta. Ao definir parâmetros na API, você pode definir os valores e obter resultados e dados diferentes para refletir somente aquilo que os usuários deste relatório devem ver.
- Parâmetros de medida. Altere dinamicamente diferentes medidas calculadas para atender às necessidades de cada cliente no mesmo relatório. Por exemplo, é possível definir a moeda por meio de parâmetros para diferentes filiais ou clientes estabelecidos em diferentes países.
Observe que os parâmetros são baseados no conjunto de dados, portanto, eles são definidos por relatório ou dashboard, mas não no nível da sessão do usuário. Isso significa que diferentes usuários que estiverem usando o mesmo relatório ao mesmo tempo sempre verão o mesmo valor do parâmetro.