Saltar al contenido

Conexión Airtable

Introducción

Una conexión Airtable, creada usando el conector Airtable, establece acceso a Airtable. Una vez configurada una conexión, puede crear instancias de actividades de Airtable asociadas con esa conexión para usarlas 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:

Se puede editar una conexión Airtable existente desde estas ubicaciones:

Configurar una Conexión Airtable

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

Configuración de la conexión de Airtable

Sugerencia

Campos con un ícono de variable Ícono de variable admite el uso de variables globales, variables del proyecto y variables Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes para elegir.

  • Nombre de la conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Airtable y no debe contener barras diagonales (/) o dos puntos (:). Este nombre también se utiliza para identificar el extremo de Airtable, que hace referencia tanto a una conexión específica como a sus actividades.

  • Esquema de autenticación: Seleccione el esquema de autorización, uno de los siguientes:

    • ApiKey: Cuando se selecciona, se muestran los campos Clave API y Secreto del cliente:

      • Clave API: Ingrese su clave API.

      • Secreto del cliente: Ingrese el secreto del cliente.

      Advertencia

      Autenticación de clave API quedó obsoleta por Airtable el 31 de enero de 2024.

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

      • Token de acceso OAuth: Ingrese su token de acceso personal, que puedes obtener desde la página de Tokens (es necesario iniciar sesión) en Airtable. Se recomiendan si está creando integraciones para usted mismo, su cliente o su empresa.

    • OAuthPKCE: (Recomendado) Este es el método de autenticación recomendado por Jitterbit. Necesita autenticación OAuth si está creando 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, se proporcionan propiedades de configuración en la tabla Configuraciones avanzadas a continuación para configurar OAuth.

  • ID de base: Ingrese el ID de la base de Airtable a la que desea acceder. Puede encontrar el ID en la URL de Airtable, comenzando con app.

  • Habilitar API de metadatos: Cuando se selecciona (predeterminado), especifica que se debe usar la API de metadatos habilitada.

  • Mostrar ID de objetos: Cuando se selecciona, especifica que se utilizarán los ID de objetos para mostrar.

  • Usar nombres simples: Cuando se selecciona, especifica que se utilizarán nombres simples.

  • Usar configuración de proxy: Seleccione para utilizar configuración de proxy de agente privado.

  • Configuraciones avanzadas: Cuando se selecciona, se muestra la tabla Propiedades de configuraciones avanzadas, que se utiliza para agregar propiedades de configuración adicionales como pares clave-valor. Haga clic en el icono de agregar icono de agregar para agregar una fila a la tabla siguiente e ingresar un par clave-valor para cada propiedad.

    Obligatorio para todas las opciones del menú Esquema de autenticación, agregue las siguientes filas:

    Nombre Valor
    BaseId Obligatorio solo si no se define en ID de base más arriba. Agregue el ID de la base de Airtable a la que desea acceder. Puede encontrar el ID en la URL de Airtable, comenzando con app.
    TableNames Agregue una lista separada por comas de todos los nombres de las tablas en la base de Airtable a las que desea acceder. Puede encontrar los nombres en las URLs de Airtable, comenzando con tbls.
    BaseName Agrega el nombre de la base Airtable a la que deseas acceder.

    Cuando el AuthScheme seleccionado sea OAuthPKCE, agregue las siguientes filas:

    Nombre Valor
    OAuthClientId Agregue el ID de cliente obtenido de Airtable OAuth página (es necesario iniciar sesión).
    OAuthClientSecret Agregue el secreto del cliente obtenido de Airtable OAuth página (es necesario iniciar sesión).
    InitiateOAuth Establezca esto en cualquiera de los dos REFRESH(recomendado) o OFF.
    OAuthAccessToken Agrega tu token de acceso. Necesitarás una herramienta de externo, como Postman, para obtener este token.
    OAuthRefreshToken (Requerido sólo si InitiateOAuth Estaba configurado para REFRESH.) Agrega tu token de actualización. Necesitarás una herramienta de externo, como Postman, para obtener este token.
    Other Establezca esto igual a OAuthSettingsLocation=, además de una ruta a un archivo que su agente tiene acceso de escritura a.
    PathDelimiter (Opcional, pero recomendado). Establezca esto en un carácter que no se use en ningún nombre de columna en las tablas de su interés, como un guión bajo. _.

    Para guardar la fila, haga clic en el ícono de envío ícono de envío en la columna más a la derecha.

    Para editar o eliminar una sola fila, pase el cursor sobre la columna más a la derecha y use el ícono de edición ícono de edición o eliminar icono eliminar icono.

    Para eliminar todas las filas, haga clic en Borrar todo.

    Importante

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

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

    • Es posible que se requieran identificadores, secretos, ámbitos y otros tokens de autenticación adicionales para completar con éxito la autenticación OAuth. Consulte la documentación del extremo para obtener información adicional sobre sus requisitos.

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

  • Prueba: Haga clic para verificar la conexión utilizando la configuración especificada. Cuando se prueba la conexión, los agentes del grupo de agentes asociado con el ambiente actual descargan la última versión del conector. Este conector admite la suspensión de la descarga de la última versión del conector mediante la política de la organización Deshabilitar actualización automática del conector.

  • Guardar cambios: Haga clic para guardar y cerrar la configuración de conexión.

  • Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le solicitará que confirme que desea descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte 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 crear una conexión de conector de Airtable, coloque un tipo de actividad en el tela 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).

Se puede acceder a las acciones del menú de una conexión y sus tipos de actividad desde el panel de proyecto y la paleta de componentes de diseño. Para obtener más información, consulte Menús de acciones en Conceptos básicos del conector.

Están disponibles estos tipos de actividades:

  • 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 objetivo en una operación.

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

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

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