Power BI Embedded Query Parameters API
Fecha de publicación: 25 marzo, 2018
Los parámetros de consulta permiten a los usuarios definir parámetros y crear partes de sus informes y modelos de datos (como un filtro de consulta, una referencia a un origen de datos o la definición de una medida) que dependan de uno o varios valores de parámetros. Los parámetros se definen en el archivo PBIX con Power BI Desktop. Encontrará más información sobre los parámetros de consulta en esta entrada de blog.
La nueva API Query Parameters permite a los desarrolladores cambiar de forma dinámica los valores de parámetros y automatizar el proceso para trabajar con ellos. La API incluye una llamada para obtener todos los parámetros definidos en un conjunto de datos específico y una llamada para establecer nuevos valores para parámetros que ya existen.
Con esta nueva API, puede automatizar muchos procesos para varios clientes. A continuación, se ofrecen algunos ejemplos:
- Cambiar una cadena de conexión. Si configura parámetros en la cadena de conexión, puede usar la API cada vez que incorpore un cliente nuevo. Solo tiene que clonar el informe y cambiar los valores de los parámetros para la conexión a la base de datos del cliente. También puede facilitar la automatización de actualizaciones de la conexión en los orígenes de datos que no se pueden realizar con la API Update Datasources.
- Cambiar parámetros de consulta. Si define parámetros en la API, puede establecer los valores para obtener diferentes resultados y datos que reflejen solo lo que los usuarios de este informe deben ver.
- Parámetros de medidas. Puede cambiar de forma dinámica diferentes medidas calculadas para responder a las necesidades de cada cliente en el mismo informe. Por ejemplo, puede establecer la moneda con parámetros para diferentes clientes o sucursales que se encuentren en países distintos.
Tenga en cuenta que los parámetros se basan en el conjunto de datos, es decir, se definen por informe o panel, pero no en el nivel de sesión del usuario. Esto significa que usuarios diferentes que utilicen el mismo informe al mismo tiempo verán siempre el mismo valor de un parámetro.