Aproveite as Funções de Atributo do Usuário (UAF) com os componentes de Web Lightning do Tableau
Você pode aproveitar as Funções de Atributos do Usuário (UAF) com seus componentes de Web Lightning (LWC) do Tableau View e do Pulse para exibir dados específicos com base nos atributos do usuário que está olhando uma visualização. Funções de atributos do usuário forneça segurança em nível de linha para que as pessoas que visualizam sua visualização vejam apenas dados relevantes para elas. Para obter mais informações sobre UAFs, consulte Desbloquear o poder da análise personalizada com funções de atributos do usuário.
Pré-requisitos
O logon único (SSO) com autenticação de token é configurado para os Componentes de Web Lightning do Tableau. Consulte Configurar componentes do Web Lightning do Tableau e logon único (SSO) com autenticação de token.
O Tableau está configurado para capturar atributos do usuário em fluxos de trabalho de autenticação. Consulte Permitir captura de atributos do usuário.
O conteúdo do Tableau a ser inserido inclui funções de atributo do usuário. Para obter um exemplo de como usar funções de atributo do usuário em uma pasta de trabalho do Tableau, consulte Garantir que o criador do conteúdo inclua funções de atributo do usuário.
Definições de declarações do Tableau UAF no Salesforce
As definições de declaração do Tableau UAF permitem que você inclua declarações para atributos de usuário no JWT. Os valores desses atributos podem ser extraídos de objetos Conta, Usuário, Oportunidade ou Caso no Salesforce. Quando usado com funções de atributo do usuário no conteúdo do Tableau, somente dados correspondentes aos atributos especificados são exibidos.
Por exemplo, um painel do Tableau pode ser configurado para mostrar apenas dados de vendas em que o valor na coluna de dados [Estado/Província] corresponda a um dos valores na declaração JWT para o atributo “estado”.
Sintaxe: USERATTRIBUTEINCLUDES('attribute_name', valor esperado)
Exemplo: USERATTRIBUTEINCLUDES('state', [State/Province])
Criar uma definição de reivindicação no Salesforce pode incluir as informações específicas do usuário apropriadas no JWT. Neste exemplo, o atributo “estado” pode ser preenchido com valores de Contas em que o usuário atual é o Proprietário da Conta, extraindo valores do campo Estado/Província de Cobrança.
Exemplo de definição de reivindicação
Nome da definição: state_Account_BillingState
Nome do atributo: estado
Objeto de destino: conta
Campo do objeto de destino: estado/província de cobrança
Relação do objeto de destino do visualizador: o visualizador atual é o proprietário da conta
No caso de um representante de vendas que possui contas em Washington, Oregon e Califórnia, o JWT incluirá uma declaração de “estado” com os valores [WA, OR, CA]. O painel do Tableau mostraria então apenas dados com valores de [Estado/Província] correspondentes a WA, OR ou CA.
Suporte para usuários externos no Experience Cloud
As Funções de Atributo do Usuário (UAF) e o Mapeamento do Host são compatíveis com usuários externos acessando o Tableau por meio de sites do Experience Cloud. Isso permite que os atributos do Salesforce associados ao usuário externo conectado sejam incluídos no JWT, permitindo exibições personalizadas do Tableau com base nos dados desse usuário.
Os usuários externos incluem usuários autenticados do Experience Cloud, como usuários parceiros e da comunidade do cliente. Usuários convidados não são aceitos.
Para garantir a funcionalidade adequada:
- Os usuários externos devem ter acesso aos registros relevantes usados pelo UAF e Mapeamento de host.
- Os seguintes objetos devem ser configurados para permitir acesso externo (por exemplo, Somente leitura pública):
- Token de função de atributo do usuário de análise
- Mapeamento de host
- As declarações UAF devem ser criadas e configuradas por um usuário Salesforce interno com acesso de configuração.
Com a configuração de compartilhamento adequada, o UAF e o mapeamento de host funcionarão da mesma forma para usuários externos e internos.
Criar uma definição
Para criar uma definição de atributo do usuário, siga estas etapas:
No aplicativo Salesforce, selecione a engrenagem no canto superior direito e, em seguida, selecione Configurar.
No painel de navegação esquerdo, digite “Tableau” na barra de pesquisa Busca rápida.
Selecione a página de configurações Definição de reivindicações UAF do Tableau.
Selecione Criar novo .
Preencha os valores de definição:
Nome da definição: insira um exclusiva nome. (Exemplo: state_Account_BillingState)
Nome do atributo: insira o nome do atributo especificado pela função de atributo do usuário no Tableau. (Exemplo: estado)
Objeto de destino: selecione o objeto de destino do qual você deseja extrair os valores. Atualmente, os LWCs do Tableau oferecem suporte aos objetos Usuário e Conta.
Campo do objeto de destino: selecione o campo no objeto de destino do qual você deseja extrair os valores. (Exemplo: Estado/Província de cobrança)
Relação entre o objeto de destino do visualizador: selecione a relação entre o visualizador atual e o objeto de destino. (Exemplo: o visualizador atual é o proprietário da conta).
Selecione Salvar. Ou, se quiser retornar à página de configurações de Definição de reivindicações UAF do Tableau sem salvar, selecione Cancelar.
Adicionar uma definição a uma página do componente de Web Lightning do Tableau
Página inicial, páginas Aplicativo e Registro de Lightning
Para adicionar uma definição:
Selecione Selecione….
Use as setas para mover as definições disponíveis para o campo Selecionado.
Selecione OK.
Repita para todos os componentes da Web Lightning do Tableau na mesma página. Para obter mais informações, consulte Considerações para vários componentes na mesma página.
Páginas do Experience Cloud e a barra de utilitários
Insira uma lista separada por vírgulas de nomes de definições de reivindicações UAF. Para copiar nomes de definições, no aplicativo Salesforce, navegue até a página de configurações Definição de reivindicações do Tableau UAF e selecione Cópia.
Considerações para vários componentes na mesma página
Se vários componentes da Web Lightning do Tableau View ou do Tableau Pulse forem adicionados à mesma página, cada componente deverá ter o mesmo conjunto de nomes de definição de UAF. Somente um dos componentes é autenticado para o Tableau, e essa sessão será usada para carregar ambos os componentes. Isso significa que as informações de atributo do usuário relevantes para ambos os componentes devem estar presentes nessa sessão, independentemente de qual componente faz a autenticação.
Por exemplo:
Se você tiver dois componentes do Tableau View e um precisar de informações de atributo do usuário na Definição A e o outro precisar de informações de atributo do usuário na Definição B, ambos os componentes deverão incluir as Definições A e B.
Se um componente do Tableau View precisar da Definição A, mas o componente do Tableau Pulse na mesma página não precisar de nenhuma informação de atributo do usuário, ambos os componentes deverão incluir a Definição A.
Excluir uma definição
Para excluir uma definição de atributo do usuário, siga estas etapas:
No aplicativo Salesforce, selecione a engrenagem no canto superior direito e, em seguida, selecione Configurar.
No painel de navegação esquerdo, digite “Tableau” na barra de pesquisa Busca rápida.
Selecione a página de configurações Definição de reivindicações UAF do Tableau.
Selecione Excluir para a definição que deseja excluir.
Página inicial, páginas Aplicativo e Registro de Lightning
Se você excluir uma definição que já foi adicionada a um Tableau LWC, atualize a página no Lightning App Builder para atualizar as definições disponíveis. Definições excluídas são removidas automaticamente.
Páginas do Experience Cloud e a barra de utilitários
Definições excluídas não são removidas automaticamente do campo do componente Tableau LWC. Definições excluídas no campo de componente Nomes de definição UAF não causará problemas, mas criará desordem e confusão desnecessárias. Para remover definições do campo do componente Tableau LWC, selecione o campo Nomes de definição do UAF e exclua manualmente todos os nomes que não estão mais em uso.