¿Eres desarrollador y necesitas integrar Tableau en otros procesos y aplicaciones? ¿Es administrador de Tableau y le gustaría automatizar procesos para gestionar sus usuarios o para migrar contenido y libros de trabajo entre distintos entornos, ya sean sitios de Tableau o servidores reales?
Entonces lo que necesitas son las API REST de Tableau, y has llegado al lugar adecuado. En este artículo, exploraremos estas importantes herramientas disponibles con Tableau Server y Tableau Cloud y cómo se pueden utilizar para explotar todo su potencial al servicio de la visualización de datos.
Como sabemos, Tableau es una de las principales plataformas de visualización de datos y permite a particulares y empresas explorar, analizar y compartir datos de forma intuitiva y eficaz. Sin embargo, a menudo existe la necesidad de integrar los datos y las visualizaciones de Tableau en otras aplicaciones o automatizar procesos, creando soluciones personalizadas.
La API REST de Tableau permite a los desarrolladores acceder a su plataforma Tableau e interactuar con ella, abriendo la puerta a un mundo de posibilidades para la integración de datos. Pero vayamos por orden…
¿Qué es una API REST?
Antes de sumergirnos en la API REST de Tableau, es importante entender qué es una API REST. «API» significa «Application Programming Interface», que es un conjunto de reglas y protocolos que permiten que diferentes aplicaciones de software se comuniquen entre sí. La API REST, que significa «Representational State Transfer API», es un tipo de API que se basa en los principios fundamentales del HTTP («Protocolo de transferencia de hipertexto»). Esto hace que sean fáciles de usar y compatibles con una amplia gama de lenguajes de programación para enviar y recibir datos a través de llamadas web estándar. Según el método y el recurso de destino, las llamadas utilizan un URI (‘Uniform Resource Identifier’) construido de forma única.
Para simplificar, podemos considerar la API REST como un conjunto de bloques programados que pueden utilizarse para operaciones complejas, concatenando la salida de una acción como entrada de la siguiente. De este modo, también pueden aplicarse otras condiciones y escenarios que se manejan mejor con lógica de programación.
Si deseas saber más sobre este tema, te recomendamos que eches un vistazo a este enlace: A Brief Introduction to REST.
API REST de Tableau: descripción general
Hay más de 150 puntos finales disponibles para la API REST de Tableau. La amplia gama de operaciones posibles incluye:
- Acceso a los datos: los datos pueden recuperarse de las hojas de trabajo de Tableau, lo que permite integrarlos en otras aplicaciones o en dashboards personalizados.
- Automatización de actividades: las API REST permiten automatizar tareas administrativas como la gestión de usuarios, proyectos y publicación de contenidos.
- Creación y publicación de dashboards: los desarrolladores pueden crear dashboards personalizados utilizando datos de Tableau y publicarlos directamente en la plataforma.
- Integración con otras aplicaciones: La API REST de Tableau puede integrarse con otras aplicaciones, lo que permite visualizar los datos de Tableau en una aplicación externa.
La documentación oficial de Tableau es muy rica (puede encontrarla aquí Tableau REST API Concepts) y los diferentes métodos disponibles con sus endpoints están categorizados.
API REST de Tableau: Requisitos de uso
Para poder acceder y explotar la API REST, existen ciertos requisitos técnicos que dependen del producto y la versión de Tableau que desees utilizar.
Para Tableau Server:
- El entorno debe ser al menos de la versión 9.0. Ten en cuenta, no obstante, que se añaden nuevos puntos finales y métodos con cada nueva versión de Tableau; consulta la documentación oficial para conocer la disponibilidad y la compatibilidad en este enlace: Tableau Server versions and REST API versions
- También es necesario que el uso de la API esté habilitado. En las instalaciones estándar esto ya es así, pero para asegurarse, puede comprobar el estado actual ejecutando el siguiente comando desde un terminal en la máquina donde está instalado el nodo primario de Tableau Server:
tsm configuration get -k api.server.enabled
Para activar la API REST utiliza en su lugar:
tsm configuration set -k api.server.enabled -v true
Para Tableau Online:
- no existen limitaciones, ya que siempre se actualiza a la última versión disponible del software Tableau.
Para la mayoría de los endpoints, estos son los únicos requisitos a tener en cuenta. Sin embargo, existen algunas limitaciones para los métodos que actúan sobre Prep Flows, Tableau Metadata API o Virtual Connection, para los que debe disponer de Gestión de datos, un complemento de su paquete de licencia que también desbloquea muchas otras funcionalidades. Para obtener más información, consulte Licencia de gestión de datos.
API REST de Tableau: cómo funciona y cómo utilizarla
Dependiendo de la API deseada, la llamada HTTP puede ser de un tipo:
- GET: para obtener información como la lista de usuarios del servidor o descargar un libro de trabajo;
- POST: para crear o publicar un nuevo recurso en el servidor, como usuarios, libros de trabajo o fuentes de datos;
- PUT: para actualizar/cambiar un recurso existente, como la contraseña de un usuario, el propietario del contenido y el permiso;
- DELETE: para borrar contenidos como un libro de trabajo o eliminar a un usuario de un sitio.
Y consiste en un URI único y un cuerpo de llamada para enviar más detalles y parámetros para la finalización de la acción.
La estructura básica de cada URI es la siguiente:
https://<your-server>/api/<api-version>/sites/<site-id>
donde <your-server> es el nombre o la dirección IP de su Tableau Server/Cloud, <api-version> es la versión de la API que desea usar y <site-id> que es un código alfanumérico de 16 caracteres que identifica su sitio de Tableau.
Este ID de sitio se toma de la respuesta a la API REST » Sign-In «, que es la primera llamada que debe realizar para autenticarse en Tableau Server/Cloud y es la única excepción a la estructura URI básica. Para esta API, solo se necesitan el nombre del servidor y la versión de la API:
https://<your-server>/api/<api-version>/auth/signin
La llamada ‘Sign-In’ no solo devuelve el <site-id>, sino que también sirve para obtener un token de autorización para realizar cualquier llamada posterior al servidor. Normalmente, este token es válido durante 240 minutos, pero para Tableau Server la duración puede personalizarse.
Tras autenticarse, el token se enviará en el cuerpo de las llamadas posteriores con la cabecera «X-Tableau-Auth», mientras que el URI cambiará en función del método y el objetivo que se busque. Por ejemplo, para solicitar todos los grupos del sitio, se realizará una llamada GET utilizando la siguiente URI:
https://mycompany.tableau.com/api/3.15/ sites/d02811a3-5095-48a3-93f8-b0d6055e6144/groups/
mientras que para obtener la lista de usuarios de un grupo, la petición será siempre una GET pero mediada por la URI:
https://mycompany.tableau.com/api/3.15 /sites/d02811a3-5095-48a3-93f8-b0d6055e6144/groups/ 1408ea49-f616-4ae9-ac48-ad5f3c3b0c38/users
donde <id-sitio> y <id-grupo> son los ID únicos que identifican el sitio y el grupo de destino, respectivamente.
Conclusión
Las API REST de Tableau son una potente herramienta para sacar el máximo partido a su plataforma de visualización de datos. Permiten crear aplicaciones personalizadas, automatizar tareas complejas e integrar Tableau con otras aplicaciones. Los desarrolladores pueden aprovechar esta flexibilidad para mejorar el análisis de datos y optimizar los flujos de trabajo empresariales. Los administradores de la plataforma pueden mejorar la experiencia de sus usuarios y optimizar sus actividades de gestión y mantenimiento.
Si exploras la API REST de Tableau, podrás descubrir un sinfín de oportunidades para innovar en la visualización de datos. Si es un entusiasta de los datos o un desarrollador, el uso de la API REST de Tableau puede ser un recurso inestimable para llevar sus capacidades de análisis de datos al siguiente nivel.
Lee todos nuestros artículos sobre Tableau
¿Quieres conocer las últimas novedades o profundizar en algunas características para convertirte en un experto?
Visualitics Team
Este artículo ha sido escrito y editado por uno de nuestros consultores
Compártelo ahora en tus redes sociales o por correo electrónico:
