Introducción
Este tutorial demuestra cómo usar el Conector REST API de Tableau para vincular Tableau a ActivityInfo y recuperar sus datos para su análisis.
Prerrequisitos
- Una cuenta de ActivityInfo con permisos para al menos una base de datos y un formulario.
- Un token de API personal generado desde su perfil de ActivityInfo.
- Tableau Desktop (v2023.3 o posterior) instalado en macOS o Windows.
Paso 1: Genere su Token de API de ActivityInfo
- Inicie sesión en su cuenta de ActivityInfo.
- Haga clic en el icono de su perfil (esquina superior derecha) y seleccione Configuraciones de la cuenta.
- Seleccione Tokens de API en el panel de navegación y haga clic en Añadir.
- Asigne una etiqueta al token (por ejemplo, "Conector Tableau").
- Seleccione la opción Solo lectura (ya que Tableau solo necesita recuperar datos) y haga clic en Generar.
- Copie el token inmediatamente y guárdelo en un lugar seguro (como un gestor de contraseñas).
Nota: Por razones de seguridad, no podrá ver el token de nuevo una vez que deje esta página. Si un token se ve comprometido, revóquelo inmediatamente y genere uno nuevo.
Paso 2: Localice la URL de la API de consulta de su Formulario
Tableau se conecta a ActivityInfo a nivel de formulario o subformulario. Para continuar, necesita la URL de la API de consulta específica para su formulario o subformulario de destino.
- Navegue a su base de datos de ActivityInfo.
- Abra el formulario o subformulario que desea conectar, haga clic en Exportar y seleccione Consultar como JSON.
- Elija si desea consultar el formulario completo o las columnas seleccionadas, y luego haga clic en Copiar URL.
Paso 3: Descargue e instale el Conector REST API
Descargue el Conector JDBC REST API (archivo .jar) desde Tableau Exchange. Una vez descargado, mueva el archivo al directorio apropiado para su sistema operativo.
Windows
- Navegue a: C:\Program Files\Tableau\Drivers
- Si la carpeta no existe, créela manualmente.
- Copie el archivo .jar en esta carpeta.
MacOS
- Navegue a: /Users/
/Library/Tableau/Drivers - Si la carpeta no existe, créela manualmente.
- Copie el archivo .jar en esta carpeta.
Paso 4: Conecte Tableau a ActivityInfo
- Reinicie Tableau para asegurarse de que el nuevo controlador sea reconocido.
- En Conectar >> A un servidor, seleccione REST API o REST API Connector by Tableau.
En la ventana de configuración de REST API, ingrese los siguientes detalles:
URL de la API REST: Pegue la URL de la API de consulta del Paso 2.
Formato de respuesta: Seleccione JSON o CSV.
Autenticación: Seleccione Token portador.
Contraseña: Pegue el Token de API del Paso 1.
Haga clic en Iniciar sesión.
- Tableau ahora extraerá los datos del formulario.
- Haga clic en el nombre de la hoja en la esquina inferior izquierda y seleccione el icono Ver datos (que parece una pequeña tabla/cuadrícula), para ver los datos de su formulario de ActivityInfo organizados en una tabla.
- Puede conectar múltiples formularios, subformularios y construir las relaciones entre las tablas dentro de Tableau.
Solución de problemas
Incluso con las configuraciones correctas, la conexión entre Tableau y ActivityInfo puede fallar debido a errores de autenticación o problemas con el controlador. La tabla a continuación cubre algunos problemas comunes que puede encontrar y cómo resolverlos.
| Problema | Solución |
|---|---|
| Falta la API REST en la lista de Tableau | Confirme que el archivo .jar está en la carpeta de controladores correcta y reinicie Tableau. |
| Error HTTP (401) No se puede conectar al servidor de la API REST | Verifique que su Token de API esté pegado correctamente en el campo Contraseña y que no haya sido revocado en ActivityInfo. |
| Datos vacíos / no se devolvieron filas | Asegúrese de que el ID del Formulario en su URL de consulta sea correcto. Pruebe la URL directamente en un navegador después de iniciar sesión en ActivityInfo. |
| Tiempo de conexión agotado | Verifique la estabilidad de su internet o ajuste la configuración del tiempo de espera de la conexión HTTP. |
| Faltan datos del subformulario | Las consultas del formulario padre no incluyen los registros del subformulario. Cree una conexión separada usando la propia URL de consulta del subformulario. |