Query Parameters API til Power BI Embedded

Brugerne kan bruge forespørgselsparametre til at definere parametre og gøre dele af deres rapporter og datamodeller, f.eks. forespørgselsfiltre, en datakildereference eller en målingsdefinition, afhængige af en eller flere parameterværdier. Parametre defineres i PBIX-filen via Power BI Desktop. Du kan få mere at vide om forespørgselsparametre i dette blogindlæg.

Den nye Query Parameters-API gør det muligt for udviklere dynamisk at ændre parametrenes værdier og automatisere processen med at arbejde med dem. API'en inkluderer et kald for at hente alle de parametre, der er defineret i et specifikt datasæt, og et kald for at angive nye værdier for eksisterende parametre.

Med den nye API kan du automatisere mange processer for flere kunder. Her er nogle eksempler:

• Rediger forbindelsesstreng. Ved at konfigurere parametre i forbindelsesstrengen kan du bruge API'en, hver gang du har en ny kunde. Du skal blot klone rapporten og ændre parameterværdierne for at oprette forbindelse til kundens database. Det kan også hjælpe med at automatisere forbindelsesopdateringer af datakilder, som ikke understøttes via API'en Update Datasources.
• Rediger forespørgselsparametre. Ved at definere parametre i API'en kan du angive værdierne og få forskellige resultater og data, så rapportens brugere kun får vist det, der er relevant.
• Rediger målingsparametre. Rediger forskellige beregnede mål dynamisk for at opfylde hver enkelt kundes behov i den samme rapport. Du kan f.eks. angive valutaen via parametre for forskellige kunder eller afdelinger, som befinder sig i forskellige lande.

Bemærk, at parametrene er baseret på datasættet, så de defineres pr. rapport/dashboard, men ikke på brugerens sessionsniveau. Det betyder, at forskellige brugere, som bruger den samme rapport på samme tid, altid vil få vist den samme parameters værdi.