Composites

Um composite é um pacote reutilizável de perguntas — por exemplo, Nome, Sobrenome, Cargo, E-mail como uma única unidade "Pessoa". Você o define uma vez, insere em quantos formulários quiser e gerencia tudo em um só lugar. Quando você aprimora o composite, cada formulário que o utiliza adota a nova versão na próxima vez que esse formulário for publicado.

Os composites resolvem dois problemas que crescem a cada formulário que você cria:

• Consistência — as mesmas perguntas de "Pessoa", "Bloco de endereço" ou "Apólice de seguro" permanecem idênticas em todos os seus formulários, em vez de divergirem conforme as cópias são editadas de forma independente.
• Agregação — cada resposta a um composite também é salva como uma entrada independente, para que você possa ver todas as "Pessoas" já enviadas em todos os seus formulários em uma única tabela.

Criando um composite

Há três maneiras de criar um:

1. A partir da página Composites — abra Composites na barra lateral do aplicativo e clique em Novo composite. Isso abre o editor completo de composites, onde você adiciona e configura subperguntas exatamente como ao construir um formulário.
2. A partir de um formulário — adicione uma pergunta Composite (seção Avançado da paleta) ou uma pergunta Lista configurada para itens de composite, depois clique em Escolher um composite… e use a opção de criação no seletor. O novo composite é vinculado à sua pergunta imediatamente.
3. A partir de um grupo de perguntas existente — selecione um Grupo de Perguntas no construtor e clique em Transformar em composite. Suas subperguntas são convertidas em um novo composite, e o grupo é substituído por uma pergunta Composite que o referencia.

Um composite pode conter até 30 subperguntas dos tipos de pergunta padrão (texto, e-mail, telefone, número, datas, escolhas, avaliações e mais). Telas, grupos e outros composites não podem ser aninhados dentro de um composite.

Edição: três níveis

Você pode editar um composite na profundidade que o momento exigir:

• Inline no canvas — quando um formulário referencia um composite seu, os campos dele aparecem como nós filhos sob a pergunta no canvas de fluxo de trabalho. Edite títulos e configurações, adicione ou remova campos ali mesmo. As alterações são salvas automaticamente no próprio composite (não no formulário), tornando-se disponíveis para todos os formulários que o utilizam.
• O seletor — troque qual composite uma pergunta referencia com Alterar, ou duplique o composite de outra pessoa para obter sua própria cópia editável.
• O editor completo — clique em Abrir editor completo (ou abra o composite pela página Composites) para a experiência de edição independente completa, incluindo a aba Idiomas para traduções e a visualização de Entradas.

Publicação e versões

Os composites têm um modelo de segurança deliberado em duas etapas:

• A cópia de trabalho é o que você edita. Ela nunca é exibida aos respondentes.
• A definição publicada é um snapshot imutável criado sempre que você clica em Publicar no composite. A publicação incrementa a versão do composite.

Quando você publica um formulário, ele congela a definição publicada atual do composite em seu próprio snapshot publicado. A partir daí, os respondentes desse formulário sempre veem exatamente essa versão — mesmo que o composite mude depois. Isso significa que:

• Um composite com edições não publicadas exibe um selo Alterações em rascunho · Publicar em seu badge no canvas. Clique nele para publicar o composite ali mesmo onde você está trabalhando (será solicitada confirmação se outros formulários também o utilizarem).
• Ao publicar um formulário que referencia composites com alterações pendentes, uma caixa de diálogo lista todos eles, com a opção de Publicar tudo (composites primeiro, depois o formulário) ou Apenas o formulário (manter o formulário nas últimas versões publicadas dos composites).
• Um composite que nunca foi publicado bloqueia a publicação do formulário até que você o publique — não há versão para o formulário congelar.

Para levar uma melhoria de composite a um formulário existente: publique o composite e depois republique o formulário.

Usando composites em formulários

O tipo de pergunta Composite

Adicione uma pergunta Composite da seção Avançado da paleta e escolha um composite. Os respondentes veem todos os campos dele juntos em uma tela, preenchem e continuam com um único OK — como uma Página de Múltiplas Perguntas cujo conteúdo é gerenciado centralmente. A resposta é salva como um único valor estruturado, e uma entrada de composite é registrada.

Compartilhamento e propriedade

Os composites pertencem a quem os criou. Colegas de equipe podem referenciar seu composite nos formulários deles — verão os campos em modo somente leitura com uma nota mostrando o proprietário — mas apenas você pode editá-lo. Qualquer pessoa pode clicar em Duplicar para editar para criar sua própria cópia independente.

Composites + o tipo de pergunta Lista

O tipo de pergunta Lista (seção Escolhas da paleta) coleta itens repetidos. Defina o Tipo de item como Itens de composite e escolha um composite, e os respondentes poderão adicionar quantas entradas estruturadas quiserem — o clássico padrão "adicione todos os membros do seu conselho":

• Os respondentes clicam em Adicionar item para acrescentar uma entrada; cada entrada é um cartão contendo os campos do composite.
• As configurações de Mínimo / máximo de itens determinam quantas entradas são obrigatórias ou permitidas (limite rígido de 100).
• As entradas podem ser removidas e recolhidas para manter listas longas gerenciáveis — por padrão, apenas uma entrada fica aberta por vez.
• Cada entrada é registrada como sua própria entrada de composite, marcada com sua posição na lista.

Modos de exibição recolhida

A configuração Modo de exibição (mostrada assim que um composite é selecionado) controla como uma entrada recolhida é renderizada:

• Compacto (padrão) — a entrada é recolhida em uma única linha. Use Campos do resumo recolhido para escolher quais campos aparecem nessa linha e em que ordem — por exemplo, John · Diretor · john@acme.com. O primeiro campo do composite vem pré-selecionado; adicione, remova e arraste para reordenar.
• Cartão — a entrada é recolhida em um cartão mais alto mostrando o rótulo e o valor de todos os campos (um travessão marca os campos não respondidos). Ideal quando os revisores precisam verificar entradas rapidamente sem expandi-las.

Listas de texto simples

Uma Lista também pode coletar itens de texto simples (Tipo de item → Itens de texto) — digite e pressione Enter, ou use o botão Adicionar. Validação por item (padrão, comprimento), prevenção de duplicatas, reordenação por arrastar, itens padrão e contagens mín/máx estão todos disponíveis. Nenhum composite é necessário.

Entradas: um composite, todos os formulários

Abra um composite e alterne para Entradas para ver uma tabela somente leitura de todas as entradas salvas em todos os formulários que o utilizam. Cada linha é um composite preenchido — seja proveniente de uma pergunta Composite ou de um item individual em uma Lista.

• Colunas — uma coluna por subcampo, além do formulário de origem, do horário de envio e (para entradas de lista) da posição do item. Oculte e mostre colunas para focar a visualização.
• Copiar como JSON — cada linha tem um botão de copiar que coloca a entrada completa na sua área de transferência como JSON.
• Exportar — baixe a visualização atual como CSV ou JSON. As exportações respeitam seus filtros e sua seleção de colunas visíveis.

Lógica com composites e listas

As regras de lógica entendem a estrutura dos composites:

• Condições em subcampos — direcione qualquer subresposta de composite em uma condição (por exemplo, saltar se Pessoa → Cargo for igual a "CEO"). Os subcampos aparecem no seletor de campos de condição sob sua pergunta pai.
• Operadores de contagem de lista — ramifique com base em quantos itens uma Lista tem: contagem de itens igual a, contagem de itens maior que, contagem de itens menor que.

Traduções

Os composites carregam suas próprias traduções, gerenciadas na aba Idiomas do editor completo. Adicione um idioma e traduza automaticamente com IA o nome, a descrição e cada subcampo do composite — o mesmo mecanismo que os formulários usam. As traduções fazem parte da cópia de trabalho e chegam aos respondentes pelo fluxo de publicação, de modo que um formulário multilíngue renderiza seus composites no idioma do respondente.

Chamadas telefônicas

Em chamadas NueVoice, uma pergunta Composite é feita como uma sequência natural — o agente conduz quem ligou por cada subcampo em ordem. Uma Lista de composites vira um loop: após cada entrada concluída, o agente oferece adicionar outra, até que a pessoa termine ou o máximo seja atingido. As entradas são registradas de forma idêntica aos envios pela web.

Modelos

Quando você publica um formulário que usa composites como modelo no marketplace, os composites são incorporados a ele. Quem usar o modelo recebe seus próprios clones autocontidos — já publicados, totalmente editáveis e independentes dos seus originais.

Exclusão e restauração

Excluir um composite é uma exclusão reversível (soft delete): ele desaparece dos seletores e da sua lista de biblioteca, mas os formulários publicados continuam funcionando — seus snapshots já contêm a definição congelada. Restaure um composite excluído a qualquer momento pela página Composites. Novos formulários não podem referenciar um composite enquanto ele estiver excluído.

Acesso via API (MCP)

O servidor MCP do NueForm expõe o gerenciamento completo de composites a assistentes de IA: list_composites, get_composite, create_composite, update_composite, publish_composite e delete_composite. A mesma semântica de cópia de trabalho/publicação se aplica — update_composite edita o rascunho, e os formulários que o referenciam não podem ser publicados até que publish_composite tenha sido chamado. Veja Integração MCP.

Casos de uso do mundo real

Membros de conselho e listas de pessoas. O formulário de abertura de empresas de um escritório de advocacia precisa do nome, cargo e e-mail de cada membro do conselho. Crie um composite "Membro do Conselho", insira-o em uma Lista, e os clientes adicionam quantos membros tiverem. A visualização de Entradas se torna um registro consolidado de todos os membros de conselho já enviados — exportável para verificações de conflito.

Um bloco de contato, cinquenta formulários. O marketing mantém dezenas de formulários de campanha, todos pedindo os mesmos dados de contato. Com um composite "Contato", uma mudança de conformidade (digamos, dividir Nome completo em Nome e Sobrenome) é feita uma vez, publicada e implantada formulário a formulário na próxima publicação de cada um — sem caçar em cinquenta construtores.

Convidados de eventos. Um formulário de inscrição pede os dados do inscrito e, em seguida, uma Lista de um composite "Participante" ("Quem vem com você?") com um máximo compatível com o tamanho da sua mesa. O modo de exibição Compacto configurado como Nome · Preferência de refeição mantém listas longas de convidados fáceis de percorrer; a visualização de Entradas dá ao buffet uma única tabela com todos os participantes de todos os seus formulários de evento.

Conformidade de fornecedores. O setor de compras coleta apólices de seguro dos fornecedores: um composite "Apólice de Seguro" (seguradora, número da apólice, cobertura, data de vencimento) em uma Lista, usado nos formulários de onboarding, renovação e auditoria. O modo de exibição Cartão permite que os revisores verifiquem cada apólice sem expandi-la, e a visualização de Entradas é um registro único de todas as apólices arquivadas — com exportação CSV para a auditoria.

Candidaturas de RH. Uma candidatura de emprego usa um composite "Emprego Anterior" (empregador, função, datas) em uma Lista limitada a cinco, além de um composite "Contato de Emergência" compartilhado com o formulário separado de onboarding. A lógica no subcampo Emprego Anterior → Função direciona candidatos seniores a perguntas extras, e uma regra de contagem de lista sinaliza candidaturas sem histórico de trabalho para revisão manual.

Limites e informações úteis

• Até 30 subperguntas por composite; nomes de até 120 caracteres.
• Composites não podem conter telas, grupos ou outros composites, e não podem referenciar a si mesmos por meio de uma Lista.
• As Listas são limitadas a 100 itens, independentemente do máximo que você configurar.
• A edição inline no canvas está disponível para o proprietário do composite; colegas de equipe veem campos somente leitura e Duplicar para editar.
• Publicar um composite nunca altera um formulário no ar por si só — os formulários sempre recongelam as versões dos composites na publicação do formulário.