Configurar la aplicación de Tableau para Microsoft Teams
La aplicación de Tableau para Microsoft Teams permite a los usuarios interactuar con las vistas (visualizaciones) y métricas de Tableau sin abandonar su flujo de trabajo. Como administrador de Tableau, instale y configure la aplicación para conectar su sitio de Tableau existente con su implementación de Microsoft Teams. Puede instalar la aplicación para Tableau Cloud directamente desde Microsoft Apps Marketplace. Para instalar la aplicación para Tableau Server, descárguela y cárguela de forma lateral.
Para obtener información sobre cómo usar la aplicación Tableau para Microsoft Teams, consulte Acceso al contenido de Tableau en Microsoft Teams. Este artículo trata sobre la configuración de la aplicación de Tableau.
Consulte también
- Preguntas frecuentes sobre la aplicación de Tableau en GitHub(El enlace se abre en una ventana nueva)
- Notas de la versión en GitHub(El enlace se abre en una ventana nueva)
- Tutorial de introducción en Youtube(El enlace se abre en una ventana nueva)
Requisitos previos
Para configurar la aplicación de Tableau para Microsoft Teams, necesita las siguientes aplicaciones y cuentas.
- Tableau Cloud o Tableau Server versiones 2023.1 o posteriores
- Una cuenta de administrador de sitio para Tableau Cloud o una cuenta de administrador de servidor para Tableau Server
- Una suscripción a Microsoft 365 para Enterprise
- Microsoft Teams
- Una cuenta de administrador de Microsoft 365, si las directivas de su organización requieren una cuenta de administrador para instalar aplicaciones
- Las licencias de usuario de Tableau y Microsoft Teams que se asignan entre sí en función de uno de los atributos de asignación de usuarios
Atributos de mapeo de usuarios
Para permitir el inicio de sesión único con Tableau, asigne las cuentas de usuario de Microsoft Teams a las cuentas de usuario de Tableau. Puede configurar esta asignación usando atributos del SDK de Microsoft Teams o del perfil de Microsoft Entra de un usuario.
Atributos del SDK de Microsoft Teams
| Atributo | Descripción |
|---|---|
| Preferred_Username(El enlace se abre en una ventana nueva) | La dirección de correo electrónico del usuario de Microsoft Teams. En algunos casos, este valor difiere del correo electrónico definido en Microsoft Entra. |
| User Principal Name(El enlace se abre en una ventana nueva) | La principal forma en que los usuarios inician sesión en Microsoft Entra. |
Atributos de perfil de Microsoft Entra
| Atributo | Descripción |
|---|---|
| Primary Email(El enlace se abre en una ventana nueva) | Corresponde al user.mail atributo y representa la dirección de correo electrónico del usuario. |
| Mail Nickname(El enlace se abre en una ventana nueva) | Corresponde al atributo user.mailNickname y representa un alias para el usuario. |
| Employee ID(El enlace se abre en una ventana nueva) | Corresponde al atributo user.employeeId y representa un identificador de empleado asignado por la organización. |
| On-Premise Distinguished Name(El enlace se abre en una ventana nueva) | Corresponde al atributo user.onPremiseDistinguishedName y representa el nombre distintivo (DN) sincronizado desde un Active Directory local. |
| On-Premise User Principal Name(El enlace se abre en una ventana nueva) | Corresponde al atributi user.onPremiseUserPrincipalName y representa el userPrincipalName sincronizado desde un Active Directory local. |
| On-premise SAM Account Name(El enlace se abre en una ventana nueva) | Corresponde al atributo user.onPremiseSamAccountName y representa el samAccountName sincronizado desde un Active Directory local. |
| Extension Attribute X(El enlace se abre en una ventana nueva) | Microsoft Entra le permite agregar hasta 15 atributos adicionales al perfil de Entra de un usuario. Si el nombre de usuario de Tableau no existe en Microsoft Entra, utilice un atributo de extensión para almacenar el nombre de usuario de Tableau de cada usuario de Entra. |
Requisitos previos adicionales para Tableau Server
La aplicación Tableau usa llamadas API para comunicarse con Tableau Server e insertar contenido interactivo. Estas llamadas deben poder llegar a Tableau Server.
- Si Tableau Server está detrás de un firewall, permite solicitudes HTTP entrantes de los rangos de IP 4.152.0.0/15 y 20.2.0.0/16.
- Asegúrese de que los usuarios puedan acceder a Tableau Server de la misma manera que acceden a Microsoft Teams.
- Si los usuarios deben estar en una VPN para acceder a Microsoft Teams, entonces Tableau Server debe ser accesible desde la misma VPN.
- Si los usuarios pueden acceder a Microsoft Teams desde una red de Internet pública, entonces Tableau Server debe ser accesible desde una red de Internet pública.
- Si los usuarios pueden acceder a Microsoft Teams a través de aplicaciones móviles, entonces Tableau Server debe ser accesible desde dispositivos móviles.
Instalar la aplicación de Tableau para Tableau Server
Para instalar la aplicación de Tableau para Tableau Server, edite el manifiesto de la aplicación para personalizar el nombre de host y, a continuación, cargue el manifiesto de la aplicación en Microsoft Teams.
Para instalar la aplicación Tableau para Tableau Cloud, consulte la Guía de configuración de Tableau Cloud.
1. Descargar y editar el manifiesto de la aplicación
- En GitHub, descargue el manifiesto de la aplicación.
Extraiga los archivos del archivo de manifiesto de extensión
tableau-server-app-for-teams.zip.Abra el archivo
manifest.jsonen un editor de texto.Busque
manifest.jsonpara*.online.tableau.comy reemplace ese dominio por el nombre de host de su entorno de Tableau Server. Si su URL de Tableau Server eshttps://analytics.company.com, entonces el nombre de host seríaanalytics.company.com.Guarde los cambios de
manifest.json.Comprima los archivos de la carpeta
tableau-app-for-teams-serverpara crear un archivo zip que incluya los cambios.
2. Subir el manifiesto de la aplicación
Las directivas de aplicaciones de su organización determinan si puede instalar aplicaciones de Microsoft Teams. Es posible que se requiera una cuenta de administrador de Microsoft 365 para instalar aplicaciones.
Abra el Centro de administración de Microsoft Teams(El enlace se abre en una ventana nueva).
En el panel de navegación, seleccione Aplicaciones de Teams > Administrar aplicaciones.
Seleccione Acciones > Cargar nueva aplicación.
Cargue el archivo
tableau-server-app-for-teams.zipque ha editado. Recibirá un mensaje de confirmación con un enlace para administrar la aplicación.
3. Instalar y anclar la aplicación para los usuarios
Puede instalar la aplicación para que esté disponible para todos los usuarios o para un subconjunto de ellos. También puede anclar la aplicación para que aparezca en la barra de aplicaciones para sus usuarios.
Abra el Centro de administración de Microsoft Teams(El enlace se abre en una ventana nueva).
En el panel de navegación, seleccione Aplicaciones de Teams > Directivas de configuración.
En Aplicaciones instaladas, seleccione Agregar aplicaciones y luego agregue la aplicación de Tableau.
Opcionalmente, en Aplicaciones ancladas, seleccione Agregar aplicaciones y luego agregue la aplicación de Tableau.
Guarde los cambios.
Después de añadir la aplicación de Tableau, pueden pasar hasta 24 horas para que la aplicación esté disponible para los usuarios.
Configurar la aplicación de Tableau
Después de instalar la aplicación de Tableau, Microsoft Teams le solicitará que configure la aplicación. Configure la información de su sitio para conectar la aplicación a su sitio de Tableau.
1. Crear una aplicación conectada
La aplicación de Tableau para Microsoft Teams usa una aplicación conectada para autenticar a los usuarios con el inicio de sesión único. Crea esta aplicación conectada en Tableau Cloud o Tableau Server.
En Tableau Cloud o Tableau Server, cree una aplicación conectada de confianza directa. Para obtener más información, consulte Configurar aplicaciones conectadas con confianza directa para Tableau Cloud o Configurar aplicaciones conectadas con confianza directa para Tableau Server(El enlace se abre en una ventana nueva).
- Si limita la lista de dominios permitidos de la aplicación conectada solo a los dominios especificados, agregue los siguientes dominios a la lista de permitidos.
tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.netteams.microsoft.com*.teams.microsoft.com
- Si los usuarios van a acceder a la aplicación desde otras plataformas de Microsoft, agregue dominios adicionales de la lista de direcciones URL de Microsoft 365(El enlace se abre en una ventana nueva).
- Si limita la lista de dominios permitidos de la aplicación conectada solo a los dominios especificados, agregue los siguientes dominios a la lista de permitidos.
Habilite la aplicación conectada.
Genere un secreto de aplicación conectada.
Copie el ID del cliente de la aplicación conectada, el ID secreto y el valor secreto. Guarde estos valores. Los necesitará cuando configure su sitio de Tableau en Microsoft Teams.
2. Añadir la configuración de su sitio a la aplicación de Tableau
Al abrir la aplicación de Tableau, si aún no la ha configurado, verá una pantalla de configuración.
Para Etiqueta, asigne un nombre al sitio. Este nombre aparece para los usuarios de la aplicación Microsoft Teams. Si no especifica una etiqueta, la aplicación muestra el nombre del sitio. Este campo es opcional.
En el campo Nombre del sitio de Tableau, indique el nombre del sitio tal como aparece en su URL. Por ejemplo, para la URL
https://us-west-2b.online.tableau.com/#/site/mysitename/home, debe escribirmysitename. Si va a conectar la aplicación a Tableau Server y quiere usar el sitio predeterminado, deje este campo en blanco.Para URL base, escriba la parte de la URL del sitio que termina en
tableau.com, por ejemplo,https://us-west-2b.online.tableau.com.Para Atributo de mapeo de usuarios, seleccione el atributo de Microsoft Entra que se utiliza para autenticar al usuario con el inicio de sesión único.
Para ID de aplicación conectada, ID secreto de aplicación conectada y Valor secreto de aplicación conectada, pegue los valores que copió cuando creó la aplicación conectada.
Seleccione Añadir configuración de sitio.
La aplicación de Tableau prueba la conexión antes de guardar los detalles de configuración. La configuración del sitio no se agregará si la aplicación no se puede conectar a Tableau. Este error puede deberse a que la aplicación conectada no puede autenticarse, la aplicación conectada no está habilitada, la información del sitio es incorrecta o porque la cuenta que está usando no es una cuenta de administrador de Tableau. También podría significar que la aplicación no puede acceder a Tableau Server porque está detrás de un firewall.
Añadir o eliminar configuraciones de sitios
Después de agregar una configuración de sitio, puede agregar sitios adicionales o eliminar una configuración de sitio existente.
En la aplicación de Tableau para Microsoft Teams, seleccione la pestaña Configuración.
En Configuración, seleccione la pestaña Configuración del sitio de Tableau. Solo los administradores de Tableau pueden acceder a la configuración en esta pestaña.
Para agregar un sitio, seleccione Agregar detalles del sitio. Para eliminar un sitio, también puede seleccionar el icono Eliminar de ese sitio.
