Saltar al contenido

Conexión de Airtable

Introducción

Una conexión de Airtable, creada utilizando el conector de Airtable, establece acceso a Airtable. Una vez que se configura una conexión, se pueden crear instancias de actividades de Airtable asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión de Airtable

Se crea una nueva conexión de Airtable utilizando el conector de Airtable desde una de estas ubicaciones:

Una conexión de Airtable existente se puede editar desde estas ubicaciones:

Configurar una conexión de Airtable

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Airtable se describe a continuación, junto con nuestra configuración recomendada.

Configuración de la conexión de Airtable

Tip

Los campos con un ícono variable admiten el uso de variables globales, variables de proyecto, y variables de Jitterbit. Comienza escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes de las que puedes elegir.

  • Nombre de Conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Airtable y no debe contener barras inclinadas (/) ni dos puntos (:). Este nombre también se utiliza para identificar el punto final de Airtable, que se refiere tanto a una conexión específica como a sus actividades.

  • Esquema de Autenticación: Selecciona el esquema de autorización, uno de:

    • ApiKey: Cuando se selecciona, se muestran los campos API Key y Client Secret:

      • API Key: Ingresa tu clave API.

      • Client Secret: Ingresa el secreto del cliente.

      Warning

      La autenticación con clave API fue desaprobada por Airtable el 31 de enero de 2024.

    • PersonalAccessToken: Cuando se selecciona, se muestra el campo OAuth Access Token:

      • OAuth Access Token: Ingresa tu token de acceso personal, que puedes obtener de la página de Tokens (se requiere inicio de sesión) en Airtable. Se recomiendan si estás construyendo integraciones para ti mismo, tu cliente o tu empresa.

    • OAuthPKCE: (Recomendado) Este es el método de autenticación recomendado por Jitterbit. Necesitas autenticación OAuth si estás construyendo una integración de Airtable para muchos usuarios diferentes que necesitan acceder a la API de Airtable en nombre de esos usuarios. Cuando se selecciona, proporcionas propiedades de configuración en la tabla de Configuraciones Avanzadas a continuación para configurar OAuth.

  • ID de Base: Ingresa el ID de la base de Airtable a la que deseas acceder. Puedes encontrar el ID en la URL de Airtable, comenzando con app.

  • Habilitar API de Metadatos: Cuando está seleccionado (por defecto), especifica habilitar la API de metadatos.

  • Mostrar IDs de Objetos: Cuando está seleccionado, especifica usar mostrar IDs de objetos.

  • Usar Nombres Simples: Cuando está seleccionado, especifica usar nombres simples.

  • Usar Configuraciones de Proxy: Selecciona para usar configuraciones de proxy de agente privado.

  • Configuraciones Avanzadas: Cuando está seleccionado, muestra la tabla de Propiedades de Configuraciones Avanzadas, que se utiliza para agregar propiedades de configuración adicionales como pares clave-valor.

    • Agregar: Agrega una fila a la tabla. Ingresa un par clave-valor para cada propiedad.
    • Enviar: Guarda el par clave-valor en la tabla. Visible al pasar el cursor sobre una fila en modo de edición.
    • Descartar: Descarta una nueva fila o cualquier edición realizada en una fila existente. Visible al pasar el cursor sobre una fila en modo de edición.
    • Editar: Te permite editar un par clave-valor existente. Visible al pasar el cursor sobre una fila existente.
    • Eliminar: Elimina la fila de la tabla. Visible al pasar el cursor sobre una fila existente.
    • Limpiar Todo: Elimina todas las filas de la tabla.

    Requerido para todas las opciones del menú Esquema de Autenticación, agrega las siguientes filas:

    Nombre Valor
    BaseId Requerido solo si no está definido en ID de Base arriba. Agrega el ID de la base de Airtable a la que deseas acceder. Puedes encontrar el ID en la URL de Airtable, comenzando con app.
    TableNames Agrega una lista de nombres de todas las tablas en la base de Airtable a la que deseas acceder, separada por comas. Puedes encontrar los nombres en tus URLs de Airtable, comenzando con tbls.
    BaseName Agrega el nombre de la base de Airtable a la que deseas acceder.

    Cuando el AuthScheme seleccionado es OAuthPKCE, agrega las siguientes filas:

    Nombre Valor
    OAuthClientId Agrega el ID de cliente obtenido de la página de Airtable OAuth (se requiere iniciar sesión).
    OAuthClientSecret Agrega el secreto de cliente obtenido de la página de Airtable OAuth (se requiere iniciar sesión).
    InitiateOAuth Establece esto en REFRESH (recomendado) o OFF.
    OAuthAccessToken Agrega tu token de acceso. Necesitarás una herramienta de terceros, como Postman, para obtener este token.
    OAuthRefreshToken (Requerido solo si InitiateOAuth se estableció en REFRESH.) Agrega tu token de actualización. Necesitarás una herramienta de terceros, como Postman, para obtener este token.
    Other Establece esto igual a OAuthSettingsLocation=, más una ruta a un archivo al que tu agente tenga acceso de escritura.
    PathDelimiter (Opcional, pero recomendado.) Establece esto en un carácter que no se use en ningún nombre de columna en tus tablas de interés, como un guion bajo _.

    Nota

    Los nombres de columnas y tablas de Airtable pueden contener caracteres especiales no soportados por otros servicios. Agrega la propiedad de configuración UseSimpleNames y configúralo en true para imponer un esquema de nombres restringido a caracteres alfanuméricos y guiones bajos para columnas y tablas. Los caracteres no alfanuméricos se convierten en guiones bajos cuando está habilitado.

    Importante

    Al configurar la autenticación OAuth, ten en cuenta estas notas importantes:

    • La configuración de OAuth solo funciona para grupos de agentes que consisten en un solo agente.

    • Se pueden requerir IDs adicionales, secretos, ámbitos y otros tokens de autenticación para completar con éxito la autenticación OAuth. Consulta la documentación del endpoint para obtener información adicional sobre sus requisitos.

    • Los campos en la tabla de Propiedades de Configuraciones Avanzadas muestran el ícono de variable solo en modo de edición. Para que los valores de variable de estos campos se llenen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

    • Los campos en la tabla de Propiedades de Configuraciones Avanzadas no admiten el uso de variables para pasar JSON sin procesar. Si tu caso de uso no admite definir JSON sin procesar en los campos directamente, escapa el contenido JSON antes de pasarlo con una variable. Por ejemplo, escapar {"success": "true"}; se convierte en {\"success\": \"true\"};.

  • Test: Haz clic para verificar la conexión utilizando la configuración especificada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar Actualización Automática del Conector.

  • Save Changes: Haz clic para guardar y cerrar la configuración de la conexión.

  • Discard Changes: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pedirá que confirmes que deseas descartar los cambios.

  • Delete: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulta Dependencias de componentes, eliminación y remoción). Un mensaje te pedirá que confirmes que deseas eliminar la conexión.

Próximos pasos

Después de que se ha creado una conexión de conector de Airtable, se coloca un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulta Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

  • Consulta: Recupera registros de una tabla en Airtable y está destinado a ser utilizado como fuente en una operación.

  • Crear: Inserta un registro en una tabla en Airtable y está destinado a ser utilizado como destino en una operación.

  • Actualizar: Actualiza un registro en una tabla en Airtable y está destinado a ser utilizado como destino en una operación.

  • Eliminar: Elimina un registro de una tabla en Airtable y está destinado a ser utilizado como destino en una operación.

  • Ejecutar: Ejecuta un procedimiento en Airtable y está destinado a ser utilizado como destino en una operación.