Trello List Component

Trello List Component conecta tu flujo con tu cuenta de Trello para trabajar con las listas de un tablero: crear una lista nueva, consultar los datos de una lista o todas las listas de un tablero, cambiar el nombre de una lista o archivarla.

Es útil para preparar la estructura de un tablero de forma automática, por ejemplo las columnas “Pendiente”, “En curso” y “Hecho”, o para conocer los identificadores de las listas que usan otros componentes de Trello.

Cuándo usarlo

• Al crear el tablero de un proyecto nuevo quieres que tenga siempre las mismas listas.
• Necesitas el identificador de una lista para crear tarjetas en ella con Trello Card Component.
• Quieres renombrar una lista, por ejemplo con el mes en curso.
• Una fase de trabajo termina y quieres retirar su lista del tablero.

Configuración

Necesitas una credencial Trello Task API con el token y la clave de API de tu cuenta de Trello. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Trello Task API con la que se accede a tu cuenta.
Operation	Lo que hace el componente. Ver Operaciones. Por defecto, Create.
Board ID (obligatorio)	El identificador del tablero. Solo en Create (tablero donde se crea la lista) y Read All (tablero cuyas listas quieres traer).
List Id (obligatorio)	El identificador de la lista. Solo en Read, Update y Delete.
List Name (obligatorio)	El nombre de la lista. Solo en Create (nombre de la lista nueva) y Update (nombre nuevo).

Operaciones

Operación	Qué hace
Create	Crea una lista nueva con el nombre indicado en el tablero elegido.
Read	Trae los datos de una lista.
Read All	Trae todas las listas de un tablero.
Update	Cambia el nombre de una lista.
Delete	Archiva la lista: desaparece del tablero, pero se puede recuperar desde los elementos archivados de Trello.

Resultado

La salida Data devuelve la lista con la que has trabajado tal como la guarda Trello: su identificador, nombre y tablero al que pertenece, entre otros datos. Con Read All sale un elemento por cada lista del tablero. Delete devuelve una confirmación.

El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo crear o consultar listas. Ver Tool Mode.

Ejemplo

Un estudio de diseño quiere que cada tablero de proyecto empiece con las listas de su proceso.

1. Un Trello Board Component crea el tablero del proyecto.
2. Añade Trello List Component con la operación Create.
3. En Board ID pon el identificador del tablero recién creado y en List Name Briefing.
4. Repite el paso anterior con Bocetos, Revisión del cliente y Entregado.

Buenas prácticas

• Delete no borra la lista: la archiva. Si la necesitas de nuevo, recupérala desde Trello.
• Usa Read All para obtener los identificadores de las listas de un tablero antes de crear tarjetas en ellas.

Componentes relacionados

• Trello Board Component: los tableros.
• Trello Card Component: las tarjetas de una lista.