O que é campo de repetição em formulário de processo eletrônico

Campo de repetição é um tipo de campo de formulário eletrônico que contém um bloco inteiro de perguntas e que o requerente pode repetir quantas vezes precisar, preenchendo um conjunto completo de dados a cada repetição. Ele resolve o caso em que o número de itens não é conhecido de antemão, como unidades de um empreendimento, sócios, pavimentos ou zoneamentos incidentes sobre um mesmo lote.

Campo de repetição na prática

No formulário de protocolo, o órgão define o bloco uma única vez: quais campos o compõem, quais são obrigatórios e como se organizam. O requerente então adiciona uma repetição para cada item que precisa informar. Um quadro de áreas, por exemplo, pode ter uma linha de dados por pavimento ou por tipologia, sem que o formulário precise prever 3, 10 ou 40 conjuntos de campos fixos.

O efeito é duplo. Para o requerente, o formulário se adapta ao tamanho real do pedido. Para o órgão, todos os itens chegam com a mesma estrutura, o que facilita a conferência na análise e evita o dado digitado em texto livre, num formato diferente a cada protocolo.

Campo de repetição × campo de lista × anexo

A confusão mais comum é tratar o campo de repetição como lista de opções ou como anexo. São três coisas diferentes:

• Campo de seleção múltipla (multi-checkbox): o requerente marca opções que o órgão já definiu. Não há dado novo, só escolha entre itens previstos.
• Campo de texto avançado: um único espaço de texto livre em área, útil para descrever, mas sem estrutura de dados.
• Campo de repetição: cada repetição é um bloco estruturado, com seus próprios campos e suas próprias regras de preenchimento, criado sob demanda pelo requerente.

Anexar um documento também não substitui a repetição. Quando o dado importante fica dentro de uma planilha ou PDF enviado, o servidor precisa abrir o arquivo para conferir. Quando ele vem em campos, a conferência acontece na própria tela de análise.

Casos de uso comuns

O campo de repetição é adequado sempre que o pedido envolve itens da mesma natureza em quantidade variável:

• Licenciamento de obras: quadro de áreas por pavimento ou tipologia, zoneamentos incidentes sobre o lote e responsáveis técnicos de cada disciplina do projeto.
• Cadastro de pessoa jurídica: sócios, administradores e atividades econômicas exercidas.
• Compras e contratações: itens de uma demanda, com descrição, quantidade e unidade, no mesmo formulário de abertura do processo.
• Fiscalização: vários pontos de vistoria ou infrações registrados em um único auto.
• Benefícios e cadastros sociais: componentes de um grupo familiar, cada um com os mesmos dados de identificação.

O oposto também vale: se há sempre um único item, um campo comum basta. Repetição demais deixa o formulário mais difícil de preencher, e a regra prática é usá-la só onde a quantidade realmente varia. Para testar essa decisão antes da publicação, o guia sobre como validar o formulário de um processo com a secretaria mostra como simular o preenchimento com quem conhece a rotina do serviço.

O que a legislação diz

Não existe norma que trate especificamente de campo de repetição, que é uma decisão de desenho de formulário. O fundamento está nos princípios do governo digital: a Lei nº 14.129/2021 coloca a desburocratização e a simplificação de procedimentos entre os princípios e as diretrizes da administração pública digital. Um formulário que pede exatamente os dados necessários, na quantidade que o caso exige, vai nessa direção. Já o dado estruturado em campos ajuda o órgão a cumprir, na análise, o que a legislação local de cada serviço determina, como os parâmetros urbanísticos de um licenciamento.

Como o Aprova aplica o campo de repetição

• O formulário de cada serviço é organizado em cartões sequenciais, e o campo de repetição pode conter um bloco inteiro de campos dentro de um desses cartões.
• Além da repetição, o formulário aceita seleção múltipla, campo de texto e campo de texto avançado em área, combináveis no mesmo serviço.
• Campos obrigatórios não preenchidos impedem a finalização do pedido, e o cartão incompleto aparece sinalizado ao requerente antes do protocolo.
• O formulário é configurado pelo próprio órgão em um construtor sem código, em que os campos são adicionados e ajustados sem programação.
• Na análise, o servidor registra comentário ao lado do campo e o requerente corrige, conforme explica o guia por que o servidor não deve editar os dados do requerente.

FAQ sobre campo de repetição

Qual é a diferença entre campo de repetição e campo de seleção múltipla?

A seleção múltipla permite marcar várias opções entre as que o órgão já definiu. O campo de repetição permite criar novos blocos de dados, cada um com seus próprios campos, na quantidade que o requerente precisar.

Há limite de repetições que o requerente pode adicionar?

Depende da configuração do formulário, e o órgão deve definir o limite com base na realidade do serviço. Em pedidos com poucos itens típicos, vale orientar no texto de ajuda lateral quantos blocos costumam ser necessários.

O campo de repetição pode ter campos obrigatórios?

Sim. As regras de obrigatoriedade valem para os campos dentro do bloco, de modo que cada repetição só é considerada completa quando os campos exigidos estão preenchidos.

Quando é melhor usar anexo em vez de repetição?

Quando o conteúdo é um documento que precisa ser apresentado como tal, como um projeto ou um laudo. Se a informação será conferida, comparada ou cruzada na análise, é melhor pedi-la em campos estruturados.

Campo de repetição serve para qualquer tipo de órgão?

Sim. O recurso é uma característica do formulário e se aplica a prefeituras, câmaras municipais e outros órgãos públicos, sempre que o pedido envolva itens em quantidade variável.

Conclusão

Campo de repetição é a forma de deixar o formulário do tamanho do pedido: um bloco desenhado uma vez, repetido quantas vezes o caso exigir, com dados sempre na mesma estrutura. Usado onde a quantidade varia e evitado onde ela é fixa, reduz retrabalho de conferência e pedidos de correção. Para ver como montar os formulários dos serviços do seu órgão, agende uma demonstração do Aprova.