1. Novidades e melhorias solicitadas por usuários

Novas funcionalidades

Novo gatilho de eventos em campos: "Ao aparecer em tela"

Até agora, eventos em campos só podiam ser disparados quando o campo era editado. Isso criava uma limitação importante em formulários com campos condicionais: se um campo só aparecia em tela após a edição de outro, o evento configurado não conseguia alcançá-lo, porque no momento do disparo o campo de destino ainda não existia na interface.

Com esta entrega, passa a existir um novo gatilho: Ao aparecer em tela. Ele dispara quando um campo faz a transição de oculto para visível, permitindo que automações aconteçam exatamente no momento em que o campo se torna acessível.

Na prática, isso resolve cenários como este: o campo "Atividade principal" é condicional e só aparece quando o campo "Tipo de cliente" é igual a "Pessoa jurídica". Ao selecionar o cliente, um evento tenta preencher automaticamente tanto o "Tipo de cliente" quanto a "Atividade principal". O problema é que, no momento em que o evento dispara, "Atividade principal" ainda não está em tela, porque "Tipo de cliente" ainda está sendo preenchido e a condição de visibilidade ainda não foi satisfeita. O resultado é que "Tipo de cliente" é preenchido corretamente, mas "Atividade principal" fica vazio. Agora, com o gatilho "Ao aparecer em tela", é possível configurar um segundo evento diretamente em "Atividade principal": assim que o campo se torna visível, ele é preenchido automaticamente, sem depender de reabrir o item ou de qualquer ação manual.

Alguns detalhes importantes sobre o comportamento:

• Neste gatilho, o campo pode ser alvo de si mesmo, pois o trigger é de renderização e não de edição, o que elimina o risco de loop.
• As expressões form_value, payload e item_related são suportadas normalmente.

Quer saber como configurar eventos em campos? Consulte a documentação.

Nova ação de eventos em campos: Recarregar campos

As ações disponíveis em eventos em campos (Editar, Resetar e Invalidar) nem sempre atendiam cenários onde o objetivo era apenas reprocessar as regras de um campo sem alterar seu valor. Resetar apagava o conteúdo, editar substituía e invalidar marcava o campo como inválido. Não havia meio-termo.

Com esta entrega, uma nova ação passa a estar disponível: Recarregar campos (Reload fields). Ela reprocessa a lógica do campo de destino (condicionais de visibilidade, obrigatoriedade, validações e filtros dinâmicos de listas e relacionamentos) sem alterar o valor que já está preenchido.

Um exemplo de uso: um formulário tem o campo "Região" e o campo "Filial", que é condicional e só aparece quando "Região" é preenchido. Um único evento é configurado para preencher ambos os campos automaticamente. Porém, no momento em que o evento dispara, "Filial" ainda não está em tela, porque "Região" ainda está sendo preenchido e a condição de visibilidade ainda não foi satisfeita. O resultado é que "Região" é preenchido corretamente, mas "Filial" fica vazio. Com o gatilho "Ao aparecer em tela" combinado com a ação "Recarregar campos", é possível configurar um evento em "Filial" que, assim que ele se torna visível, recarrega o campo de origem, fazendo com que o evento original seja redisparado e "Filial" receba o valor que não havia conseguido receber antes.

Quer saber como configurar eventos em campos? Consulte a documentação.

Melhorias

Subcampos de grupo e repetidor agora permitem configuração de largura

Subcampos dentro de campos do tipo Grupo e Repetidor ficavam limitados à largura padrão full, sem possibilidade de ajuste. Isso restringia o controle de layout dos formulários, especialmente em cenários onde faria mais sentido que alguns subcampos ocupassem apenas metade da linha.

Com esta melhoria, cada subcampo passa a ter uma opção de largura configurável, com as opções metade e full. O controle está disponível tanto no campo Grupo quanto no Repetidor em formato lista.

Formulários já existentes não são afetados. A largura padrão continua sendo full, e a configuração só é aplicada quando o configurador opta por ajustá-la.

Quer saber como configurar campos do tipo grupo? Consulte a documentação.

Quer saber como configurar campos do tipo repetidor? Consulte a documentação.

Expressões com fallback em eventos em campos

Eventos em campos permitem usar expressões para copiar ou calcular valores automaticamente. Uma dessas possibilidades é definir um valor de reserva (chamado de fallback) para quando o campo de origem estiver vazio. Por exemplo: a expressão {{form_value.campo | 0}} significa "use o valor do campo; se estiver vazio, use 0".

Havia um problema com essa funcionalidade: expressões no formato {{campo | valor}} não aplicavam o fallback corretamente. Quando o campo de origem estava vazio, o valor de reserva era ignorado, o que causava erros no resultado dos eventos.

A correção garante que a estrutura de fallback {{campo | valor}} funcione de forma confiável, independentemente do tipo de campo ou do valor de reserva definido. Na prática, isso elimina a necessidade de criar campos auxiliares ou condicionais manuais para tratar valores vazios em eventos em campos.

Quer saber como configurar eventos em campos? Consulte a documentação.

2. Evoluções e correções gerais do produto

Melhorias

Reorganização da sidebar de criação de campos

A sidebar (painel lateral) de criação de campos recebeu ajustes de organização para facilitar a localização dos tipos de campo disponíveis. Foram adicionados separadores com títulos centrais que agrupam os campos por categoria, e a ordem dos campos básicos de configuração foi reorganizada para seguir uma sequência mais lógica.

A mudança se aplica à criação e edição de todos os tipos de campo.

Quer saber mais sobre a configuração de campos? Consulte a documentação.

Correções de bugs

Erro em criação de itens por folder de relacionamento

Ao registrar um item por meio de uma folder de relacionamento (como andamentos, pagamentos e audiências), o sistema exibia uma mensagem de erro em vermelho após salvar, mesmo quando o item era salvo com sucesso na categoria de destino. O item nem sempre aparecia na folder de relacionamento: para alguns usuários, bastava atualizar a página para visualizá-lo; para outros, era necessário ir até a tela de itens da categoria de destino, onde o item estava de fato registrado.

A correção elimina o falso erro e ajusta o fluxo de criação via folder para garantir que o item e seus dados sejam associados e persistidos corretamente, refletindo imediatamente na listagem da folder sem necessidade de refresh.

Categorias criadas não apareciam na listagem

Ao criar uma nova categoria e confirmar o registro, a tela atualizava, mas a categoria recém-criada não aparecia na listagem, dando a impressão de que o cadastro havia falhado. Isso podia levar a tentativas repetidas de criação.

A correção garante que, após salvar, a listagem reflita imediatamente a nova categoria, sem necessidade de refresh manual.