API de Parâmetros de Consulta do Power BI Embedded

Os parâmetros de consulta permitem aos utilizadores definirem parâmetros e criarem partes dos seus relatórios e modelos de dados (como um filtro de consulta, uma referência de origem de dados ou uma definição de medida), dependendo de um ou mais valores de parâmetro. Os parâmetros são definidos no ficheiro PBIX através do Power BI Desktop. Pode saber mais sobre parâmetros de consulta nesta mensagem de blogue.

A nova API de Consulta permite aos programadores alterarem os valores dos parâmetros de forma dinâmica e automatizarem o processo de trabalhar com eles. A API inclui uma chamada para obter todos os parâmetros definidos num conjunto de dados específico e uma chamada para definir novos valores para os parâmetros existentes.

Com esta nova API, pode automatizar muitos processos para vários clientes. Eis alguns exemplos:

• Alterar cadeia de ligação. Ao configurar parâmetros na cadeia de ligação, pode utilizar a API sempre que integrar um novo cliente. Basta clonar o relatório e alterar os valores dos parâmetros para se ligar à base de dados do cliente. Também pode ajudar a automatizar as atualizações de ligação para origens de dados que não são suportadas pela API Atualizar Origens de Dados.
• Alterar parâmetros de consulta. Ao definir parâmetros na API, pode definir os valores e obter resultados e dados diferentes para refletir apenas o que os utilizadores deste relatório devem ver.
• Parâmetros de medida. Altere dinamicamente diferentes medidas calculadas para responder às necessidades de cada cliente no mesmo relatório. Por exemplo, pode definir a moeda através de parâmetros para diferentes clientes ou ramos que são baseados em países diferentes.

Tenha em atenção que os parâmetros baseiam-se no conjunto de dados, pelo que são definidos por relatório/dashboard, mas não ao nível da sessão do utilizador. O que significa que utilizadores diferentes que utilizam o mesmo relatório em simultâneo verão sempre o valor do mesmo parâmetro.