Creare un pulsante della funzione dati in Power BI (anteprima)

SI APPLICA A: Power BI Desktop Servizio Power BI

È possibile creare un pulsante di funzione dati nel servizio Power BI Desktop e Power BI. Questo pulsante accetta input dall'utente e chiama una funzione per intervenire.

Annotazioni

La funzionalità di flusso di attività translytical è attualmente disponibile in anteprima pubblica.

Prerequisiti

Abilitare le funzionalità di anteprima necessarie in Power BI e Infrastruttura.
Creare funzioni di dati utente in Fabric. Per esempi, vedere Esempi di flusso delle attività translitiche.

Importante

I pulsanti della funzione dati richiedono che la funzione di riferimento restituisca una stringa.

Procedure consigliate per le funzioni dati utente

Quando si scrivono funzioni personalizzate per scenari di flusso di attività translitiche, seguire queste procedure consigliate per garantire un'esperienza utente finale di qualità.

Scrivere la logica di convalida dell'input per ogni parametro. Usare il metodo fn.UserThrownError() per inviare una risposta di errore prevista al report di Power BI. Per esempio:
```
if (discount < 0):
    raise fn.UserThrownError("Discount cannot be negative.")
```
Usare un'istruzione try/catch per tutte le chiamate di esecuzione al database. Restituisce un messaggio amichevole per gestire i casi in cui il database è offline o non raggiungibile.
Assicurati che le istruzioni SQL non siano vulnerabili agli attacchi di injection SQL.
Scrivere un messaggio di esito positivo descrittivo che indica all'utente finale che l'operazione ha avuto esito positivo.

Configurare gli input per i parametri della funzione

Ogni parametro che la funzione dati utente accetta come input deve eseguire il mapping a un elemento nel report di Power BI. Questo elemento può essere un pulsante, un elenco o un filtro di testo; un campo dati; o metriche.

Filtri a selezione come controlli di input

I tre tipi di filtro dei dati supportati (pulsante, elenco e testo) sono tutte funzionalità di anteprima, talvolta denominate nuovi filtri dei dati. Assicurarsi di abilitarli come descritto nei prerequisiti.

Per utilizzare un pulsante o un filtro elenco come parametro, è necessario collegarlo a un campo dati dal riquadro Dati. Se vuoi utilizzare un pulsante o un slicer elenco solo come controllo di input e non per filtrare i dati, rimuovi tutte le interazioni visive tramite Modifica interazioni. Per altre informazioni sulla modifica delle interazioni, vedere Modificare l'interazione degli oggetti visivi in un report di Power BI.

Per usare un filtro dei dati di testo come parametro, il collegamento a un campo dati è facoltativo. Collegarlo a un campo dati solo se si desidera filtrare i dati nel report. In caso contrario, crearlo senza usare un campo dati nel riquadro Dati .

Campi di dati o misure come controlli di ingresso

I campi dati e le misure possono anche essere collegati come parametri. È possibile selezionare solo i campi che corrispondono al tipo di parametro di input.

Se è necessario passare una singola chiave primaria a una funzione dati, ad esempio CustomerID per un'operazione di modifica/eliminazione, è possibile usare l'espressione SELECTEDVALUE DAX .

Per esempio:

SelectedCustomerID = SELECTEDVALUE(Customer[CustomerID])

Per altre informazioni, vedere Creare misure per l'analisi dei dati

Configurare un pulsante per la funzione dati

Creare un pulsante della funzione dati e configurarlo per connettere gli elementi del report o l'input dell'utente a una funzione dati utente.

In Power BI Desktop aggiungere un pulsante al report.
Nel riquadro Pulsante Formato espandere il menu Azione . Attivare l'interruttore Azione su On se non è già attivo.
Dal menu a discesa Tipo selezionare Funzione dati.

Dopo aver selezionato l'opzione della funzione dati, vengono visualizzati i parametri seguenti: Area di lavoro, Set difunzioni e Funzione dati.

Suggerimento

Se l'opzione Funzione dati non è visualizzata, assicurarsi che la funzionalità di anteprima flussi di attività Translytical sia abilitata in Power BI Desktop.

Specificare i valori seguenti per il pulsante:

Parametro	Valore
Area di lavoro	Selezionare l'area di lavoro che contiene la funzione dati utente.
Set di funzioni	Selezionare il set di funzioni che contiene la funzione di dati.
Funzione dati	Seleziona la funzione dati.

Suggerimento

Se non viene visualizzata la funzione dati utente che si vuole usare, assicurarsi che la funzione di dati restituisca una stringa.

Dopo aver selezionato la funzione dati, vengono visualizzati altri parametri che rappresentano i parametri accettati dalla funzione. Per ogni parametro, è possibile:
- Usare il menu a discesa per selezionare un filtro dei dati dal report.
- Selezionare il pulsante Formattazione condizionale (fx) per selezionare un campo dati o una misura dal report.

Personalizzare l'interfaccia del report

In un report è possibile usare qualsiasi combinazione di filtri dei dati, campi dati e pulsanti per creare oggetti visivi interattivi personalizzati. Le sezioni seguenti forniscono esempi e raccomandazioni.

Interfaccia con i selettori

In una pagina del report, è possibile creare una sezione con slicer che non interagiscono con altri componenti visivi per funzionare soltanto come controlli di input. Nella parte inferiore, posizionare un pulsante e impostarne l'azione sulla funzione Data, collegandola ai suoi parametri con gli slicer. È possibile progettare questa sezione in qualsiasi modo, ma la chiave consiste nel renderla simile a una sezione praticabile che si distingue dal contenuto del report.

L'esempio seguente mostra una sezione interattiva con tre elementi:

Filtro dei dati di testo per immettere un nuovo ID ordine
Un slicer a pulsante per selezionare lo stato dell'ordine tra tre opzioni
Pulsante per inviare l'input dai filtri dei dati a una funzione dati utente

È possibile verificare se il pulsante è collegato correttamente ai filtri dei dati aggiungendo valori di input a ognuno. Se i parametri vengono accettati, il pulsante ne modifica lo stile. Personalizza lo stile del pulsante per rendere il suo stato più accattivante. In Power BI Desktop non è possibile attivare azioni finché il report non viene pubblicato.

Interfaccia con campi dati e misure

In una pagina del report è possibile usare oggetti visivi del report e un pulsante con un'azione Funzioni dati , collegando un parametro a un campo dati.

L'esempio seguente mostra una sezione interattiva con due elementi:

Tabella le cui righe possono essere selezionate come input per l'ID dell'ordine
Pulsante per inviare la riga della tabella come input a una funzione dati utente

È possibile verificare se il pulsante è collegato correttamente alla tabella facendo clic su una riga. Se il parametro viene accettato, il pulsante ne modifica lo stile. Personalizzare lo stile del pulsante per rendere il suo stato più accattivante. In Power BI Desktop non è possibile attivare azioni finché il report non viene pubblicato.

Interfaccia con input misti

È possibile usare una combinazione di slicer e campi dati/misure per creare le esperienze più creative. Collegare ogni parametro definito nella funzione dati con l'opzione corretta, che può essere un filtro dei dati che si trova nella pagina o un campo dati visibile o una misura.