API Parametri query di Power BI Embedded
Data di pubblicazione: 25 marzo, 2018
I parametri di query consentono agli utenti di definire parametri e creare parti dei report e dei modelli di dati (ad esempio filtro di query, riferimento all'origine dati o definizione della misura), in base a uno o più valori dei parametri. I parametri vengono definiti nel file PBIX tramite Power BI Desktop. Per scoprire di più sui parametri di query, vedi questo post di blog.
La nuova API Parametri query permette agli sviluppatori di modificare dinamicamente i valori dei parametri e di automatizzare il processo per l'uso dei parametri. L'API include una chiamata per ottenere tutti i parametri definiti in un set di dati specifico e una chiamata per impostare nuovi valori per i parametri esistenti.
Con questa nuova API puoi automatizzare molti processi per più clienti. Ecco alcuni esempi:
- Modifica della stringa di connessione. Configurando i parametri nella stringa di connessione puoi usare l'API ogni volta che esegui l'onboarding di un nuovo cliente. È sufficiente clonare il report e modificare i valori dei parametri per la connessione al database del cliente. Questo approccio può contribuire anche all'automazione degli aggiornamenti delle connessioni alle origini dati non supportate tramite l'API Update Datasources.
- Modifica dei parametri di query. Tramite la definizione dei parametri nell'API puoi impostare i valori e ottenere risultati e dati diversi per rispecchiare solo gli elementi che dovrebbero essere visualizzati dagli utenti del report.
- Misurazione dei parametri. Puoi modificare dinamicamente diverse misure calcolate per rispondere alle esigenze di ogni cliente nello stesso report. Puoi ad esempio impostare la valuta tramite i parametri per diversi clienti o rami situati in paesi diversi.
Nota che i parametri sono basati sul set di dati, quindi vengono definiti in base al singolo report/dashboard, ma non a livello di sessione dell'utente. Gli utenti diversi che usano lo stesso report nello stesso momento visualizzeranno quindi sempre lo stesso valore di parametro.