Trello Attachment Component

El Trello Attachment Component te permite crear, leer, actualizar y eliminar archivos adjuntos en tarjetas de Trello directamente desde tu dashboard de Nappai. Con una sola configuración puedes automatizar tareas como subir imágenes, documentos o enlaces a tus tarjetas, y también leer la lista de archivos que ya están adjuntos.

¿Cómo funciona?

El componente se conecta a la API de Trello mediante un token OAuth y una clave de API que debes haber guardado previamente en la sección de credenciales de Nappai. Cuando seleccionas una operación, el componente envía la solicitud correspondiente a la API de Trello y devuelve los datos recibidos. Si activas el Mapping Mode, puedes procesar varios registros a la vez: cada campo puede recibir un valor fijo, un valor mapeado desde otro componente o un valor calculado con JavaScript.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

• Create: Añade un nuevo archivo adjunto a una tarjeta usando una URL y un nombre.
• Read: Obtiene la información de un archivo adjunto específico.
• Read All: Recupera la lista completa de archivos adjuntos de una tarjeta.
• Update: (No implementado en el código actual, pero disponible para futuras extensiones)
• Delete: Elimina un archivo adjunto de una tarjeta.

Para usar el componente, primero selecciona la operación que necesitas en el campo “Operation” (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada “Mapping Data” y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

• Fixed (Fijo): Escribes el valor directamente en el campo.
• Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
• Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

• Operation: Selecciona la acción que quieres realizar.

  • Visible en: Create, Read, Read All, Update, Delete

• Attachment ID: Identificador del archivo adjunto que quieres leer, actualizar o eliminar.

  • Visible en: Read, Update, Delete

• Attachment Name: Nombre que tendrá el archivo adjunto cuando lo subas.

  • Visible en: Create, Read, Update

• Attachment Url: URL del recurso que quieres adjuntar a la tarjeta.

  • Visible en: Create, Read, Update

• Card ID: Identificador de la tarjeta de Trello donde se gestionarán los adjuntos.

  • Visible en: Create, Read, Read All, Update, Delete

• Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros.

  • Visible en: Create, Read, Read All, Update, Delete

• Tool Name: Nombre del tool que se mostrará al agente cuando el componente se conecte como herramienta.

  • Visible en: Create, Read, Read All, Update, Delete

• Tool Description: Descripción detallada de lo que hace el tool.

  • Visible en: Create, Read, Read All, Update, Delete

• Tools arguments metadata: Metadatos de los argumentos que el tool aceptará.

  • Visible en: Create, Read, Read All, Update, Delete

Credencial
Este componente requiere una credencial de tipo Trello Task API.

1. Configura la credencial en la sección de credenciales de Nappai.
2. Selecciona esa credencial en el campo Credential del componente.
   La credencial debe contener:

• Trello Oauth token (ejemplo: <APP_OAUTH_TOKEN>)
• Trello Api Key (ejemplo: <API_KEY>)

Salidas

• Data: Devuelve la información recibida de la API de Trello.
• Tool: Permite que el componente actúe como una herramienta que puede ser llamada por agentes de IA.

Ejemplo de Uso

Crear un adjunto

1. Selecciona la operación Create.
2. Ingresa el Card ID de la tarjeta donde quieres añadir el archivo.
3. Proporciona la Attachment Url (por ejemplo, https://example.com/image.png).
4. Escribe un Attachment Name (por ejemplo, Imagen de producto).
5. Conecta la salida Data a otro componente que necesite la información del adjunto recién creado.

Leer todos los adjuntos

1. Selecciona la operación Read All.
2. Ingresa el Card ID.
3. Ejecuta el flujo.
4. La salida Data contendrá una lista con cada adjunto de la tarjeta, que puedes usar para generar un informe o para procesar cada archivo individualmente.

Componentes Relacionados

• TrelloApi: Clase que encapsula las llamadas a la API de Trello.
• AsyncMixin: Permite que el componente ejecute operaciones de forma asíncrona.

Consejos y Mejores Prácticas

• Reutiliza credenciales: Crea una sola credencial de Trello y úsala en todos los componentes que necesiten acceder a la API.
• Activa Mapping Mode cuando necesites procesar varias tarjetas o adjuntos a la vez; evita ejecutar el mismo flujo repetidamente.
• Valida los IDs antes de ejecutar la operación para evitar errores de “not found”.
• Maneja errores: Conecta la salida Data a un componente de manejo de errores para capturar respuestas de la API con códigos de error.

Consideraciones de Seguridad

• Los tokens OAuth y las claves API se almacenan como secretos en Nappai; no los expongas en el flujo de trabajo.
• Usa el campo Credential para pasar los datos sensibles; evita introducirlos directamente en los campos de texto.
• Revoca y actualiza los tokens periódicamente para mantener la seguridad de tu cuenta de Trello.