Projeto: Buscar

Quando usar

• Precisa obter os dados de um projeto especifico (titulo, tipo, campos, membros) para usar em nodes seguintes


• Quer listar todos os projetos do workspace para apresentar ao usuario ou iterar sobre eles


• Precisa verificar se um projeto existe antes de criar cards nele


• Quer filtrar projetos por tipo (Kanban ou Lista) ou por titulo

---

Como funciona

O node consulta a base de projetos do seu workspace. No modo Unico*, retorna os dados completos de um projeto selecionado diretamente pelo dropdown ou por ID via variavel. No modo *Todos (Lista), retorna um array com projetos filtrados pelos criterios configurados.

---

Configuracoes

Modo de Busca

| Modo | Descricao |
|------|-----------|
| Unico | Selecione um projeto diretamente pelo dropdown. Retorna os dados completos desse projeto. |
| Todos (Lista) | Retorna um array de projetos com filtros opcionais. |

Projeto (modo Unico)

Dropdown com todos os projetos do workspace. Voce pode alternar entre Selecionar* (dropdown) e *Usar variavel (campo de texto com suporte a variaveis dinamicas como `{{node.output.id}}`).

Busca (modo Todos)

Campo de texto para filtrar projetos por titulo. Aceita variaveis dinamicas.

Tipo (modo Todos)

Filtro por tipo de projeto:

| Opcao | Descricao |
|-------|-----------|
| Todos | Retorna projetos de qualquer tipo |
| Kanban | Apenas projetos do tipo Kanban |
| Lista | Apenas projetos do tipo Lista |

Limite (modo Todos)

Numero maximo de projetos retornados. Padrao: 20.

---

Dados de saida

Modo Unico

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `id` | Texto | ID unico do projeto |
| `title` | Texto | Titulo do projeto |
| `type` | Texto | Tipo (kanban, list) |
| `description` | Texto | Descricao do projeto |
| `color` | Texto | Cor do projeto |
| `fields` | Lista | Campos personalizados do projeto |
| `members` | Lista | Membros do projeto |

Modo Todos (Lista)

| Variavel | Tipo | Descricao |
|----------|------|-----------|
| `projects` | Lista | Array com os projetos (cada item tem os mesmos campos do modo Unico) |
| `total` | Numero | Total de projetos encontrados |

---

Dicas

• Use o modo Unico quando ja sabe qual projeto precisa. O dropdown facilita a selecao visual.


• Alterne para Usar variavel no seletor de projeto quando o ID do projeto vier de um node anterior (ex: gatilho de Projeto/Card).


• No modo Todos*, combine com o node *Para Cada (For Each) para executar acoes em lote em varios projetos.


• O campo `fields` da saida contem os campos personalizados do projeto — util para saber quais campos estao disponiveis antes de criar/atualizar cards.