Sfruttare le funzioni degli attributi utente (UAF) con i componenti Web Lightning di Tableau

È possibile sfruttare le funzioni degli attributi utente (UAF) con i componenti Web Lightning (LWC) Tableau View e Pulse per far emergere dati specifici in base agli attributi dell'utente che esamina una visualizzazione. Le funzioni degli attributi utente forniscono sicurezza a livello di riga in modo che gli utenti che esaminano la tua visualizzazione vedano solo i dati rilevanti per loro. Per ulteriori informazioni sulle UAF, consulta Sbloccare la potenza dell'analisi personalizzata con le funzioni degli attributi utente (in inglese).

Prerequisiti

Definizioni delle attestazioni UAF di Tableau in Salesforce

Le definizioni delle attestazioni UAF di Tableau consentono di includere attestazioni per gli attributi utente nel JWT. I valori per questi attributi possono essere estratti dagli oggetti Account, Utente, Opportunità o Caso in Salesforce. Se utilizzati insieme alle funzioni degli attributi utente nel contenuto di Tableau, vengono visualizzati solo i dati che corrispondono agli attributi specificati.

Ad esempio, una dashboard di Tableau può essere configurata in modo da mostrare solo i dati di vendita in cui il valore nella colonna dati [Stato/Regione] corrisponde a uno dei valori nell’attestazione JWT per l'attributo "stato".

Sintassi: USERATTRIBUTEINCLUDES('nome_attributo', valore previsto)

Esempio: USERATTRIBUTEINCLUDES('stato', [Stato/Regione])

La creazione di una definizione di attestazione in Salesforce può includere le informazioni specifiche dell'utente appropriate nel JWT. In questo esempio, l'attributo "stato" può essere popolato con valori provenienti da Account di cui l'utente corrente è il proprietario, estraendo i valori dal campo Stato/Regione fatturazione.

Esempio di definizione di attestazione

  • Nome definizione: stato_Account_StatoFatturazione

  • Nome attributo: stato

  • Oggetto di destinazione: Account

  • Campo oggetto di destinazione: Stato/Regione fatturazione

  • Relazione tra oggetto di destinazione e Viewer: il Viewer corrente è il proprietario dell'account

Nel caso di un addetto alle vendite che possiede account negli stati di Washington, Oregon e California, il JWT includerà un’attestazione per ‘stato’ con i valori [WA, OR, CA]. La dashboard di Tableau mostrerebbe quindi solo i dati con valori [Stato/Regione] corrispondenti a WA, OR o CA.

Creare una definizione

Per creare una definizione di attributi utente, segui questa procedura:

  1. Dall’app Salesforce seleziona l’ingranaggio nell’angolo in alto a destra, quindi seleziona Configurazione.

  2. Nel riquadro di navigazione a sinistra immetti “Tableau” nella barra di ricerca Ricerca rapida.

  3. Seleziona la pagina di impostazioni Definizioni richieste UAF Tableau.

  4. Seleziona Crea nuova.

  5. Inserisci i valori della definizione:

    1. Nome definizione: immetti un nuovo nome (esempio: stato_Account_StatoFatturazione).

    2. Nome attributo: immetti il nome attributo specificato dalla funzione degli attributi utente in Tableau (esempio: stato).

    3. Oggetto di destinazione: seleziona l'oggetto di destinazione da cui desideri estrarre i valori. Attualmente i componenti LWC di Tableau supportano gli oggetti Utente e Account.

    4. Campo oggetto di destinazione: seleziona il campo nell'oggetto di destinazione da cui desideri estrarre i valori. (esempio: Stato/Regione fatturazione).

    5. Relazione tra oggetto di destinazione e Viewer: seleziona la relazione tra il Viewer corrente e l'oggetto di destinazione (esempio: Il Viewer corrente è il proprietario dell'account).

  6. Seleziona Salva. In alternativa, se desideri tornare alla pagina di impostazioni Definizioni richieste UAF Tableau senza salvare, seleziona Annulla.

Aggiungere una definizione alla pagina di un componente Web Lightning di Tabeau

Pagine Lightning Home, App e Record

Per aggiungere una definizione:

  1. Seleziona Seleziona….

  2. Utilizza le frecce per spostare le definizioni disponibili nel campo Selezionate.

  3. Seleziona OK.

  4. Ripeti l’operazione per tutti i componenti Web di Tableau Lightning nella stessa pagina. Per maggiori informazioni, consulta Considerazioni relative a più componenti nella stessa pagina.

Pagine di Experience Cloud e barra delle utilità

Immetti un elenco separato da virgole di nomi di definizioni di attestazioni UAF. Per copiare i nomi delle definizioni, dall'app Salesforce, vai alla pagina di configurazione Definizioni richieste UAF Tableau e seleziona Copia.

Considerazioni relative a più componenti nella stessa pagina

Se alla stessa pagina vengono aggiunti più componenti Web Lightning Vista Tableau o Tableau Pulse, ciascun componente deve avere lo stesso insieme di nomi di definizione UAF. Solo uno dei componenti esegue l’autenticazione in Tableau e tale sessione verrà utilizzata per caricare entrambi i componenti. Ciò significa che tale sessione deve includere le informazioni sugli attributi utente pertinenti per entrambi i componenti, indipendentemente dal componente che esegue l’autenticazione.

Ad esempio:

  • Se disponi di due componenti Vista Tableau e uno necessita delle informazioni sugli attributi utente della definizione A, mentre l’altro necessita delle informazioni sugli attributi utente della definizione B, entrambi i componenti devono includere le definizioni A e B.

  • Se un componente Vista Tableau necessita della definizione A, ma il componente Tableau Pulse nella stessa pagina non necessita di informazioni sugli attributi utente, entrambi i componenti devono includere la definizione A.

Eliminare una definizione

Per eliminare una definizione di attributi utente, segui questa procedura:

  1. Dall’app Salesforce seleziona l’ingranaggio nell’angolo in alto a destra, quindi seleziona Configurazione.

  2. Nel riquadro di navigazione a sinistra immetti “Tableau” nella barra di ricerca Ricerca rapida.

  3. Seleziona la pagina di impostazioni Definizioni richieste UAF Tableau.

  4. Seleziona Elimina per la definizione che desideri eliminare.

Pagine Lightning Home, App e Record

Se elimini una definizione già aggiunta a un LWC Tableau, aggiorna la pagina nel Generatore di app Lightning per aggiornare le definizioni disponibili. Le definizioni eliminate vengono rimosse automaticamente.

Pagine di Experience Cloud e barra delle utilità

Le definizioni eliminate non vengono rimosse automaticamente dal campo del componente LWC di Tableau. Le definizioni eliminate nel campo del componente Nomi definizione UAF non causano problemi, ma creano confusione inutile. Per rimuovere le definizioni dal campo del componente LWC di Tableau, seleziona il campo Nomi definizione UAF ed elimina manualmente tutti i nomi che non sono più in uso.