Modula
Documentação do Modula
As ferramentas
AutoFetch
O AutoFetch preenche os campos dos seus SmartTexts e SmartMails com informações lidas nas suas páginas abertas: o nome de um cliente no seu CRM, um código de rastreio numa transportadora. É o AutoCopy, no automático: em vez de selecionar o valor, você o indica uma vez, e o Modula vai buscá-lo sempre.
O princípio Avançado Pro
Um campo do formulário de inserção pode ser vinculado a um elemento de uma página. Quando o formulário abre, o Modula lê o valor desse elemento, na página exibida ou em outra aba, e preenche o campo. O formulário sempre abre: você confere o que foi lido e confirma.
Um SmartMail “Retorno de orçamento” tem os campos Nome do cliente e Nº do pedido. Eles estão vinculados à ficha do cliente no seu CRM. A ficha de Alice Martin está aberta numa aba: você digita a palavra-chave do SmartMail no seu e-mail, e o formulário abre com “Alice Martin” e “12345” já preenchidos.
Podem ser vinculados: campos de texto, listas de escolha única, campos de data e hora, {{selection}} e {{clipboard}}. Não o cursor, que é uma posição, nem uma lista de múltipla escolha.
Nada sai do seu computador: o valor vai da página para o formulário, e o Modula guarda apenas como reencontrar o elemento, de forma codificada, sem nenhum texto legível da página — nunca o que leu.
Vincular um campo Avançado Pro
A configuração é feita no painel do AutoFetch, ao lado do Chrome. Ele não cobre a página: você clica livremente nos elementos a vincular.
- Abra uma página que tenha a informação, por exemplo a ficha de um cliente.
- Abra o painel: ⚡ AutoFetch no menu do ícone, no editor de um item ou no formulário de inserção.
- Escolha o item e clique em + Fonte ao lado do campo.
- Na página, os elementos se destacam ao passar o mouse: clique no valor. ↑ escolhe o contêiner, ↓ um elemento mais preciso, Esc cancela.
- O painel mostra o valor lido e verifica se reencontra esse elemento, e só ele. Se precisar, escolha o que manter e depois Salvar a fonte.
Se o Modula não conseguir reencontrar o elemento com segurança, ele avisa na hora: mire com mais precisão ou escolha seu contêiner. Ele testa sozinho os contêineres que exibem exatamente o mesmo valor.
A aba Pré-visualização da ficha mostra o conteúdo como será inserido, com os valores lidos nas suas páginas abertas.
As páginas envolvidas Avançado Pro
Uma fonte vale para um tipo de página, descrito por um modelo de endereço: crm.exemplo.com/clientes/*/ficha. O Modula o sugere a partir do endereço da página: as partes que mudam de um cliente para outro (números, identificadores) viram *.
O modelo é conferido no momento de pegar o elemento, em Aplica-se às páginas, antes de salvar a fonte: uma marca verde indica que a aba atual corresponde. Depois, o painel o mostra ao lado de cada fonte.
* substitui uma parte do endereço sem atravessar uma /. A parte depois de ? não é comparada.
Qual aba é lida Avançado Pro
Para cada tipo de página, o Modula lê uma única aba: a página exibida, se corresponder; senão, a aba desse tipo consultada mais recentemente. Assim, todos os valores de um mesmo tipo de página vêm da mesma ficha — nunca o nome de um cliente com o endereço de outro.
Um formulário pode reunir vários tipos de página: a ficha do cliente e a página da transportadora são lidas cada uma na sua aba.
Se outras fichas do mesmo tipo estiverem abertas, o formulário avisa no topo: confira se os valores vêm da certa. Uma aba em repouso não é lida: exiba-a e tente de novo.
No formulário de inserção Avançado Pro
O formulário abre na hora; os campos vinculados mostram “Buscando…” e depois se preenchem. Abaixo de cada campo:
| O que você vê | O que significa |
|---|---|
| “de crm.exemplo.com” | O valor foi lido nessa página. Altere-o se precisar: um campo que você mexeu não é mais reescrito. |
| Em vermelho: não encontrado, vários elementos possíveis… | A página está aberta, mas o elemento não foi encontrado com segurança. O campo fica vazio: o Modula nunca adivinha. |
| Em cinza: página não aberta | Nenhuma página desse tipo está aberta. Não é um erro. |
Pegar daqui adiciona uma fonte a partir da página exibida: o formulário sai da frente, você clica no valor, o campo se preenche. Parar de buscar este campo suspende o vínculo sem apagá-lo. O botão ↻ lê de novo todos os campos vinculados, exceto os que você alterou, e ⚡ AutoFetch abre o painel neste item.
Quando você volta à aba do formulário, por exemplo depois de exibir a ficha certa, os campos vinculados são lidos de novo sozinhos. Se um valor mudou, o formulário avisa. Um campo que você alterou mantém o que você digitou, e uma nova leitura nunca esvazia um campo já preenchido.
O AutoCopy continua disponível num campo vinculado: ative-o, selecione um texto na página, e ele substitui o valor lido.
Uma ficha, vários layouts Especialista Pro
Um mesmo aplicativo pode exibir uma ficha de várias formas conforme o que está preenchido: um bloco some quando a informação falta, outro toma o seu lugar. Uma fonte, então, não cobre todas as fichas.
Um campo pode ter várias fontes, uma por layout. Elas são testadas em ordem, na mesma ficha, até uma responder: as setas ↑ ↓ definem a ordem.
- Depois de vincular um campo, confira em outra ficha, de preferência uma com informações vazias.
- Se o campo aparecer em vermelho ali, clique em Pegar daqui no formulário, ou em + Fonte no painel, a partir dessa ficha.
Manter só parte do valor Especialista Pro
Às vezes o elemento contém mais do que você precisa: “Pedido nº 12.345 de 03/09/2026”. Para cada fonte, escolha o que manter: Todo o texto, Primeiro número, Endereço de e-mail, Telefone, Data ou Valor.
Um campo de data reconhece a data lida (“12 de setembro de 2026”, “12/09/2026”, “14h30”…) e a escreve no seu próprio formato. Um valor que não faz parte de uma lista é mantido, em cor de alerta.
Seleção e área de transferência vinculadas Especialista Pro
- Um
{{clipboard}}vinculado pega o valor da página; se nada for encontrado, volta para a área de transferência, como antes. - Um
{{selection}}vinculado também pega o valor da página, onde quer que ela esteja aberta; se nada for encontrado, usa o texto selecionado antes do acionamento, como antes.
Acompanhar seus vínculos Especialista Pro
A visão geral do painel mostra Nesta página: todos os seus conteúdos vinculados à página exibida, com o estado de cada campo. Abaixo, a lista dos seus conteúdos pode ser filtrada em Todos, Vinculados ou Não vinculados.
Enquanto uma fonte funciona, nada é exibido sobre ela. Se falhar com frequência nas últimas leituras, ela é sinalizada “falha com frequência”. A caixa Buscar de um campo suspende seus vínculos: ele volta a funcionar como antes, e suas fontes ficam prontas para ser reativadas.
Para parar tudo de uma vez, desmarque AutoFetch em Configurações → Caixa de ferramentas. Seus vínculos são mantidos e nenhum valor é lido. Os vínculos entram no backup e na exportação de configuração, não na exportação de conteúdos.
Limites Especialista Pro
- Iframes de outro domínio e Shadow DOM fechado não são lidos, como na inserção.
- Uma página aberta antes da instalação ou atualização do Modula precisa ser recarregada.
- Se um site muda o seu layout, os vínculos dele podem parar de funcionar: adicione uma fonte ou suspenda o campo.