Aprovechar las funciones de atributos de usuario (UAF) con los componentes web Lightning de Tableau
Puede aprovechar las funciones de atributos de usuario (UAF) con sus componentes web Lightning (LWC), vistas de Tableau y Pulse para mostrar datos específicos en función de los atributos del usuario que mira una visualización. Las funciones de atributos de usuario proporcionan seguridad a nivel de fila para que las personas que vean tu visualización solo vean datos que sean relevantes para ellos. Para obtener más información sobre las UAF, consulte Descubrir el poder de los análisis personalizados con funciones de atributos de usuario.
Requisitos previos
El inicio de sesión único (SSO) con autenticación de token está configurado para los componentes web de Lightning de Tableau. Consulte Configurar los componentes web Lightning de Tableau y el inicio de sesión único (SSO) con autenticación de token.
Tableau está configurado para capturar atributos de usuario en flujos de trabajo de autenticación. Consulte Permitir la captura de atributos de usuario.
El contenido de Tableau que se va a insertar incluye funciones de atributos de usuario. Para ver un ejemplo de cómo utilizar funciones de atributos de usuario en un libro de trabajo de Tableau, consulte Comprobar que el autor del contenido incluye funciones de atributos de usuario.
Definiciones de reclamaciones de UAF de Tableau en Salesforce
Las definiciones de reclamaciones UAF de Tableau le permiten incluir reclamaciones de atributos de usuario en el JWT. Los valores de estos atributos se pueden extraer de los objetos Cuenta, Usuario, Oportunidad u Objetos de caso en Salesforce. Cuando se utiliza junto con funciones de atributos de usuario en el contenido de Tableau, solo se muestran los datos que coinciden con los atributos especificados.
Por ejemplo, un tablero de Tableau se puede configurar para mostrar solo datos de ventas donde el valor en su columna de datos [Estado/Provincia] coincida con uno de los valores en el reclamo JWT para el atributo 'estado'.
Sintaxis: USERATTRIBUTEINCLUDES('nombre_atributo', valor esperado)
Ejemplo: USERATTRIBUTEINCLUDES('estado', [Estado/Provincia])
La creación de una definición de reclamación en Salesforce puede incluir la información específica del usuario adecuada en el JWT. En este ejemplo, el atributo 'estado' se puede completar con valores de cuentas donde el usuario actual es el propietario de la cuenta, extrayendo valores del campo Estado/Provincia de facturación.
Ejemplo de definición de reclamación
Nombre de la definición: state_Account_BillingState
Nombre del atributo: estado
Objeto de destino: Cuenta
Campo de objeto de destino: estado/provincia de facturación
Relación del objeto de destino del Viewer: el Viewer actual es el propietario de la cuenta
En el caso de un representante de ventas que posee cuentas en Washington, Oregón y California, el JWT incluirá una reclamación para "estado" con los valores [WA, OR, CA]. El dashboard de Tableau entonces solo mostraría datos con valores de [Estado/Provincia] que coincidan con WA, OR o CA.
Crear una definición
Para crear una definición de atributo de usuario, siga estos pasos:
En su aplicación de Salesforce, seleccione el icono en forma de engranaje que aparece en la esquina superior derecha y luego seleccione Setup (Configuración).
En el panel de navegación izquierdo, escriba “Tableau” en la barra Quick Find (Búsqueda rápida).
Seleccione la página de configuración Definición de reclamaciones UAF de Tableau.
Seleccione Crear nueva .
Complete los valores de definición:
Nombre de definición: escriba un nombre único. (Ejemplo: estado_Cuenta_EstadoDeFacturación)
Nombre del atributo: escriba el nombre del atributo especificado por la función de atributo de usuario en Tableau. (Ejemplo: estado)
Objeto de destino: seleccione el objeto de destino del cual desea extraer los valores. Actualmente, los LWC de Tableau admiten los objetos Usuario y Cuenta.
Campo de objeto de destino: seleccione el campo en el objeto de destino del cual desea extraer los valores. (Ejemplo: Estado/provincia de facturación)
Relación entre el viewer y el objeto de destino: seleccione la relación entre el viewer actual y el objeto de destino. (Ejemplo: El viewer actual es el propietario de la cuenta).
Seleccione Guardar. O, si desea volver a la página de configuración de Definición de reclamaciones UAF de Tableau sin guardar, seleccione Cancelar.
Agregar una definición a una página de componente web de Lightning de Tableau
Páginas Inicio, Aplicación y Registro de Lightning
Para agregar una definición:
Haga clic en Seleccionar…
Utilice las flechas para mover las definiciones disponibles al campo Seleccionado.
Seleccione Aceptar.
Repita el procedimiento para todos los componentes web Lightning de Tableau en la misma página. Para obtener más información, consulte Consideraciones para varios componentes en la misma página.
Páginas de Experience Cloud y la barra de utilidades
Introduzca una lista separada por comas de nombres de definiciones de reclamaciones de UAF. Para copiar nombres de definiciones, desde la aplicación Salesforce, vaya hasta la página de configuración de Definición de reclamaciones de UAF de Tableau y seleccione Copiar.
Consideraciones para varios componentes en la misma página
Si se agregan varios componentes web de Tableau View o Tableau Pulse Lightning a la misma página, cada componente debe tener el mismo conjunto de nombres de definición de UAF. Solo uno de los componentes se autentica en Tableau y esa sesión se utilizará para cargar ambos componentes. Esto significa que la información de atributos de usuario relevante para ambos componentes debe estar presente en esa sesión, sin importar qué componente realice la autenticación.
Por ejemplo:
Si tiene dos componentes de Tableau View y uno necesita información de atributos de usuario de la definición A y el otro necesita información de atributos de usuario de la definición B, ambos componentes deben incluir las definiciones A y B.
Si un componente de Tableau View necesita la definición A, pero el componente de Tableau Pulse en la misma página no necesita ninguna información de atributos de usuario, ambos componentes deben incluir la definición A.
Eliminar una definición
Para eliminar una definición de atributo de usuario, siga estos pasos:
En su aplicación de Salesforce, seleccione el icono en forma de engranaje que aparece en la esquina superior derecha y luego seleccione Setup (Configuración).
En el panel de navegación izquierdo, escriba “Tableau” en la barra Quick Find (Búsqueda rápida).
Seleccione la página de configuración Definición de reclamaciones UAF de Tableau.
Seleccione Eliminar para la definición que desea eliminar.
Páginas Inicio, Aplicación y Registro de Lightning
Si elimina una definición que ya está agregada a un LWC de Tableau, actualice la página en Lightning App Builder para actualizar las definiciones disponibles. Las definiciones eliminadas se eliminan automáticamente.
Páginas de Experience Cloud y la barra de utilidades
Las definiciones eliminadas no se eliminan automáticamente del campo del componente LWC de Tableau. Las definiciones eliminadas en el campo de componente Nombres de definición de UAF no causarán problemas, pero crearán un desorden innecesario y confuso. Para eliminar definiciones del campo de componente LWC de Tableau, seleccione el campo Nombres de definición de UAF y elimine manualmente cualquier nombre que ya no esté en uso.