Referência de padronização

Padronizadores

Padronizador	Produz
Nome	Capitalização e espaçamento consistentes; expande abreviações comuns
E-mail	Um endereço normalizado, em minúsculas, com formas específicas de provedor dobradas
Telefone	Um formato internacional canônico
Data	Uma data sem ambiguidade a partir de muitos formatos
Endereço	Componentes estruturados, com abreviações expandidas
Maiúsculas	O valor em maiúsculas
Minúsculas	O valor em minúsculas
Título	O valor em caixa de título
Sentença	O valor em caixa de sentença
Linha de endereço	Uma única linha de endereço, normalizada
Remoção	O valor sem os caracteres correspondentes a um padrão
Normalização Unicode	Uma forma com acentos e caracteres de compatibilidade normalizados
Expansão de apelido	Um nome canônico a partir de uma forma familiar

São treze padronizadores, e esse é o conjunto inteiro. Uma regra que nomeie qualquer outra coisa é rejeitada ao salvar.

Campos de uma regra

Todos os campos que uma regra de padronização aceita.

Campo	Aceita	Padrão	Alterável	O que faz
attributeDefId	Um atributo	—	Não	Qual atributo a regra padroniza. Para padronizar outro, crie outra regra.
ruleType	standardize	—	Sim	O único tipo de regra de padronização que existe. Ele existe para que o formato siga aberto a extensão, não porque haja escolha a fazer.
ruleConfig	Um objeto nomeando um padronizador e suas opções	{}	Sim	Qual padronizador executar e como. Veja Opções.
executionOrder	Inteiro, 0 ou maior	0	Sim	Posição na cadeia deste atributo. As regras executam em ordem crescente.
isActive	verdadeiro ou falso	true	Sim	Se a regra executa. Desativar é a alternativa reversível a excluir — embora não desfaça valores já padronizados.
metadata	Um objeto	{}	Sim	Suas próprias anotações, armazenadas e devolvidas sem interpretação.

A ordem é uma cadeia, não uma preferência

Várias regras num mesmo atributo se compõem por executionOrder, cada uma recebendo a saída da anterior. É assim que um valor é ao mesmo tempo limpo e formatado:

Ordem	Padronizador	123-45-6789 vira
0	strip com um padrão de não-dígitos	123456789
1	uppercase	123456789

Deixe duas regras na mesma ordem e a sequência entre elas fica indefinida — então dê um número próprio a cada uma sempre que o resultado depender de qual executa primeiro.

Opções

Opções são por padronizador:

Padronizador	Opção	Efeito
E-mail	Remoção de subendereço	Remove um sufixo marcado em todo domínio, não só nos provedores que o ignoram
Remoção	Padrão	Quais caracteres remover — obrigatório
Telefone	País padrão	O país assumido para números sem prefixo internacional — defina isto, ou números que já não sejam internacionais falham em normalizar
Data	Localidade	Desambigua datas numéricas onde a ordem de dia e mês é ambígua

A lista autoritativa de opções por padronizador é servida pela plataforma. Consulte-a em vez de confiar apenas nesta tabela.

Uma opção não reconhecida é rejeitada ao salvar, em vez de ignorada. Uma opção que silenciosamente não fizesse nada produziria dados que parecem configurados e não são.

Execução

Comportamento	Detalhe
Quando	Na gravação, antes da validação e do armazenamento
Ordem	Por atributo, na ordem configurada
Resultado	O valor padronizado é o valor armazenado
Entrada bruta	Não é retida — veja adiante

Não há coluna bruta paralela. Duas representações de um fato divergem, e todo consumidor passa a ter de decidir em qual confiar.

O valor original não é guardado

A padronização é aplicada na entrada, e o que você enviou não fica armazenado em lugar nenhum. A entrada de auditoria registra o valor padronizado junto com um sinalizador dizendo se a padronização o alterou — ela não registra o que chegou.

Portanto a padronização é irreversível pela plataforma. Desligar uma regra muda como gravações futuras são tratadas; não restaura valores já padronizados, e não há de onde restaurá-los. Recuperar os originais significa recarregar a partir do sistema de origem.

Antes de ativar uma regra que descarta informação — strip em especial, que remove caracteres de vez — experimente-a no painel de teste de regras e confira a saída sobre valores reais primeiro.

Codificação fonética

A codificação fonética não é uma regra de padronização. Códigos fonéticos são computados no momento da comparação a partir do valor canônico, usando o codec que o perfil de comparação especifica.

Isso é deliberado: códigos armazenados ficariam obsoletos assim que um perfil mudasse de codec, e nada sinalizaria isso. Veja referência do perfil de comparação.

A seguir

• Configure regras de padronização
• Valide e pontue a qualidade

---

Última verificação no commit d3c2586b (2026-08-03)