DocumentaciónWorkflowsLógica y datos
Airtable nodo
Usa tus bases de Airtable como base de datos: lista, crea y actualiza registros. Consulta la configuración, las entradas y salidas, las pruebas y la solución de errores.
8 min de lecturaActualizado el
Qué hace este nodo
Usa tus bases de Airtable como base de datos: lista, crea y actualiza registros.
Usa Airtable como un paso claramente definido en un workflow de anymize.
- Procesa 1 entrada.
- Ofrece 1 salida para los pasos siguientes.
- Se ejecuta como un paso normal del flujo.
Configurar el nodo
- 01Abre un workflow y añade Airtable desde el catálogo de nodos.
- 02Guarda las credenciales en Secretos de workflows y elígelas en el campo «Token de acceso personal de Airtable».
- 03Completa los campos obligatorios y asigna valores de los pasos anteriores.
- 04Ejecuta el nodo con un conjunto pequeño de datos y revisa la salida.
- 05Conecta la salida correcta y activa el workflow después de una prueba completa.
Acciones y modos
Elige la función necesaria en Acción. El panel mostrará los ajustes correspondientes.
- Listar registros
- Crear registro
- Actualizar registro
Ajustes
| Campo | Significado | Área |
|---|---|---|
| Token de acceso personal de Airtable | Elige el secreto del workflow que tiene tu token de acceso personal de Airtable. El token en sí nunca se guarda en el workflow, solo el nombre del secreto. | Protegido |
| Acción | Opciones: Listar registros, Crear registro, Actualizar registro | Estándar |
| ID de la base | El ID de tu base de Airtable (lo encuentras en la doc de la API de tu base o en la URL). | Estándar |
| Nombre de la tabla | Nombre o ID de la tabla dentro de la base. | Estándar |
| Fórmula de filtro | Fórmula opcional de Airtable para devolver solo los registros que coincidan. | Estándar |
| Máx. de registros | Opcional: limita el número total de registros devueltos. | Estándar |
| ID del registro | El ID del registro que quieres actualizar. | Estándar |
| Campos (JSON) | Objeto JSON con los nombres de columna y valores del nuevo registro. | Estándar |
| Ejecutar una vez por elemento | Desactivado (por defecto): el nodo se ejecuta una vez para toda la entrada. Activado: si recibe varios elementos (por ejemplo de «Dividir lista»), se ejecuta una vez POR elemento, y {{ $json }} es justo ese elemento. Así procesas una lista de archivos entrada por entrada. | Estándar |
| Si un elemento falla | «Omitir» escribe un campo `error` para el elemento fallido y sigue con el resto, en lugar de perder toda la ejecución por un único archivo ilegible. | Estándar |
| Pausa entre elementos (milisegundos) | Espera antes de cada ejecución excepto la primera. 1000 = 1 segundo por elemento. Útil si el otro extremo te limita. Máximo 300000 (5 minutos). | Estándar |
Entradas y salidas
| Entrada | Significado | Tipo |
|---|---|---|
| Estándar | Recibe el resultado completo del paso anterior. | JSON |
| Salida | Significado | Tipo |
|---|---|---|
| Estándar | Entrega el resultado al paso siguiente como JSON. | JSON |
Este nodo puede procesar listas elemento por elemento. La gestión de errores y la pausa están en los ajustes avanzados.
Ejemplo y prueba
Obtener tareas abiertas de una tabla de Airtable: empieza con un conjunto pequeño y reconocible. Revisa la salida y usa solo los campos que estén presentes.
Ejemplo de prueba
{
"base_id": "appXXXXXXXXXXXXXX",
"table_name": "Tasks",
"filterByFormula": "{Status}='Offen'",
"max_records": 50
}Acceso y seguridad
Las credenciales están en un secreto de workflow que eliges en el campo «Token de acceso personal de Airtable». El workflow solo guarda el nombre del secreto, nunca la clave.
Si también tienes una conexión de Airtable en Conectores, su ajuste «Acciones permitidas» también se aplica a este nodo, aunque trabaje con un secreto de workflow, y se comprueba en cada ejecución. Con «Solo lectura» o «Leer y crear borradores» solo se ejecutan las acciones de lectura: Listar registros. Estas acciones necesitan «Permitir cambios»: Crear registro, Actualizar registro.
Las claves y credenciales van en Secretos de workflows o en tus cuentas conectadas. Nunca las pegues como texto normal en campos del workflow, datos de prueba ni descripciones.
Resolver errores
- Sin salida: revisa la última ejecución y los campos entregados por el nodo anterior.
- Variable vacía: abre la salida anterior y usa un campo presente en los datos reales.
- Acción bloqueada: pon «Acciones permitidas» de la conexión en Conectores en «Permitir cambios» o elige una acción de lectura.
- La lista se procesa una sola vez: activa la ejecución por elemento.