Supabase Writer

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

Supabase Writer es un componente sencillo que permite a los usuarios de Nappai añadir nuevos registros a una tabla de su base de datos Supabase directamente desde el dashboard. No requiere lógica compleja; simplemente envía los datos que le proporciones a la tabla indicada y devuelve los identificadores de los registros creados.

¿Cómo funciona?

El componente se conecta a Supabase mediante la API REST que expone el servicio. Para ello necesita una credencial de tipo Supabase API que ya debe haber sido creada en la sección de credenciales de Nappai. Esa credencial contiene el Supabase URL y el Supabase Service Key. Cuando el componente se ejecuta, toma esos valores, abre una conexión segura y envía los registros que le entregues en el campo Records a la tabla especificada en Table Name. La respuesta es una lista de objetos Data que incluyen el identificador (id) de cada registro insertado.

Entradas

Campos de Entrada

Records: Records to be written on the Supabase table.
Table Name: The name of the table within your Supabase database where records will be written on.

Nota importante: Antes de usar el componente, asegúrate de haber configurado una credencial Supabase API en la sección de credenciales de Nappai y seleccionarla en el campo Credential del componente.

Salidas

Response: Data (método: write_records)
La salida contiene una lista de objetos Data, cada uno con el identificador (id) del registro que se ha insertado en la tabla.

Ejemplo de Uso

Supongamos que tienes una tabla llamada orders y quieres añadir un nuevo pedido:

Configura la credencial:
- Ve a Credenciales → Agregar credencial → Selecciona Supabase API.
- Ingresa tu Supabase URL y Supabase Service Key.
Añade el componente al flujo de trabajo.
Configura los campos:
- Credential: selecciona la credencial que acabas de crear.
- Table Name: escribe orders.
- Records: pasa un objeto JSON con los datos del pedido, por ejemplo:
```
{
  "customer_id": 123,
  "product_id": 456,
  "quantity": 2,
  "status": "pending"
}
```
Ejecuta el flujo.
- El componente enviará el registro a Supabase y devolverá el id generado.

Componentes Relacionados

SupabaseReader – Lee registros de una tabla Supabase.
SupabaseUpdater – Actualiza registros existentes en Supabase.
SupabaseDeleter – Elimina registros de una tabla Supabase.

Consejos y Mejores Prácticas

Seguridad: No expongas la credencial en el flujo; utiliza la gestión de credenciales de Nappai.
Validación: Verifica que el nombre de la tabla exista y que los campos coincidan con el esquema de la tabla.
Manejo de errores: Captura la respuesta y revisa si algún registro falló; la API devuelve códigos de error claros.
Batching: Si necesitas insertar muchos registros, agrúpalos en un solo lote para reducir llamadas a la API.

Consideraciones de Seguridad

Mantén la credencial Supabase Service Key oculta y nunca la compartas públicamente.
Asegúrate de que solo los usuarios autorizados tengan acceso a la credencial en Nappai.
Revisa los permisos de la tabla en Supabase para limitar quién puede escribir datos.