Como usar expressões regulares para validar valores de propriedade

Crie propriedades de texto e adicione expressões regulares (regexes) para validar seus valores. Regexes são sequências de caracteres que definem um padrão de texto desejado. Por exemplo, você pode exigir valores com um determinado número de dígitos ou incluir caracteres específicos e formatos definidos. Configure expressões regulares manualmente ou use o Breeze para gerar regex com base no meta das regras de validação. Para obter mais orientações, revise os casos de uso de exemplo.

Observe o seguinte: O mecanismo regex da HubSpot não suporta grupos de captura de suporte. Você pode usar expressões regulares para correspondência de padrões, mas não será possível utilizar recursos associados a grupos de captura, como: extrair partes da correspondência para uso posterior, referenciar valores capturados dentro da própria expressão (backreferences) ou armazenar resultados de correspondência em variáveis ou grupos.

Adicionar regras de validação de regex a uma propriedade

Você pode adicionar expressões regulares às regras de validação de propriedade de texto. Você pode inserir ou usar manualmente a IA para gravar expressões regulares.

1. Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.

2. No menu da barra lateral esquerda, vá para Propriedades.

3. Clique no menu suspenso Selecionar um objeto e selecione [Objeto] propriedades para criar ou editar uma propriedade para esse objeto.

4. Crie ou edite uma propriedade com o texto de linha única ou com o texto de várias linhas Ao usar regras de validação de regex, há um limite de 1.000 caracteres para a propriedade.
5. No editor de propriedades, clique na aba Regras .
   • Selecione Validar usando regras personalizadas. Se quiser usar regras básicas, aprenda como configurar outras regras de validação.
   • Adicione a expressão regular manualmente:
     • No campo Regex de regra personalizada, digite sua expressão.
     • No campo Mensagem de valor inválido , digite uma mensagem com até 100 caracteres. Isso é exibido aos usuários quando o valor inserido não atende aos requisitos de validação.
     • No campo Valor adicional inválido , digite texto de ajuda com até 350 caracteres. Isso é para obter mais detalhes sobre a mensagem Valor inválido, se desejado.
       
   • Adicione a expressão regular com AI:
     • Clique em Gerar com IA.
     • Na caixa pop-up, digite uma descrição de como a propriedade deve ser validada e clique em Gerar. Os outros campos também serão preenchidos automaticamente.
       
6. No campo Testar regras personalizadas , insira um valor para validar sua regra. Se o regex funcionar, um valor inválido resultará em um erro, enquanto um valor válido será aceito.
7. Conclua a configuração ou edição da propriedade e, na parte superior direita, clique em Criar ou Salvar.

As regras de validação se aplicam quando os usuários definem ou editam o valor da propriedade durante a criação, em um registro, na página de índice de objeto, via importação ou por meio de envios a formulários criados por meio do novo editor de formulários.

Sintaxe Regex

Para obter orientação sobre como configurar sua expressão regular, consulte esta folha de ajuda Regex.

Expressões de exemplo

Alguns exemplos de casos de uso incluem:

Observe: antes de implementar as expressões a seguir, você deve verificar se elas funcionam para seu caso de uso específico.

• Número de telefone dos EUA: para exigir que os números de telefone sejam inseridos no formato (123) 456-7890, use o regex ^\(\d{3}\) \d{3}-\d{4}$.
• Endereço de e-mail: para validar se um valor inserido segue um formato de e-mail padrão (por exemplo, user@example.com), você pode usar o regex ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$.
• CEP: para exigir que os CEPs tenham cinco dígitos, você pode usar o regex ^\d{5}$.
• URL: para validar um URL que comece com "http://" ou "https://", você pode usar o regex ^https?:\/\/[^\s/$.?#].[^\s]*$.
• Sem espaços em branco: para evitar que os espaços em branco sejam inseridos, você poderá usar o regex ^\S*$.