Conectar Tableau a ActivityInfo a través del Conector REST API

Este artículo se ha traducido del inglés mediante IA y puede contener errores. Sus comentarios nos ayudarán a mejorar.

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.
Siguiente elemento
Guías prácticas