HubSpot Baza wiedzy

Używanie wyrażeń regularnych do sprawdzania poprawności wartości właściwości

Autor: HubSpot Support | Dec 9, 2024 2:22:11 PM

Aby poprawić spójność i jakość danych CRM, można użyć wyrażeń regularnych (regex) do sprawdzania poprawności wartości właściwości tekstowych. Wyrażenia regularne to sekwencje znaków, które definiują pożądany wzorzec tekstu. Można na przykład wymagać wartości z określoną liczbą cyfr lub zawierać określone znaki i formatowanie.

Możesz ręcznie skonfigurować wyrażenia regularne lub użyć sztucznej inteligencji do generowania wyrażeń regularnych w oparciu o cele reguł walidacji. Aby uzyskać dalsze wskazówki, przejrzyj przykładowe przypadki użycia.

Uwaga: silnik wyrażeń regularnych HubSpot nie obsługuje grup przechwytywania. Możesz używać wyrażeń regularnych do dopasowywania wzorców, ale nie będziesz mógł korzystać z funkcji związanych z grupami przechwytywania, takich jak: wyodrębnianie części dopasowania do późniejszego wykorzystania, odwoływanie się do przechwyconych wartości w wyrażeniu (tj. backreferences) lub przechowywanie wyników dopasowania w zmiennych lub grupach.

Dodawanie reguł walidacji regex do właściwości

Do reguł walidacji właściwości tekstowych można dodawać wyrażenia regularne. Wyrażenia regularne można wprowadzać ręcznie lub za pomocą sztucznej inteligencji.

  • W menu na lewym pasku bocznym przejdź do Właściwość.

  • Kliknij menu rozwijane Wybierz obiekt , a następnie wybierz Właściwości [Obiekt] , aby utworzyć lub edytować właściwość dla tego obiektu.

  • Utwórz lub edytuj właściwość z typem pola Tekst jednowierszowy lub Tekst wielowierszowy. W przypadku korzystania z reguł walidacji regex, istnieje limit 1000 znaków dla właściwości.
  • W edytorze właściwości przejdź do zakładki Reguły.
  • Aby skonfigurować walidację przy użyciu wyrażeń regularnych, wybierz opcję Waliduj przy użyciu wyrażenia regularnego (regex). Jeśli zamiast tego chcesz użyć prostych reguł, dowiedz się, jak skonfigurować inne reguły walidacji.
  • Dodaj wyrażenie regularne:
    • Aby ręcznie dodać wyrażenie regularne, wprowadź wyrażenie w polu Regex .
    • Aby wygenerować wyrażenie regularne za pomocą AI, kliknij Generuj, wprowadź opis sposobu walidacji właściwości, a następnie kliknij Generuj. Pozostałe pola również zostaną wygenerowane automatycznie.
  • Wprowadź komunikat o błędzie w polu Komunikat o nieprawidłowej wartości. Jest on wyświetlany użytkownikom, gdy wprowadzona przez nich wartość nie spełnia wymagań walidacji.
  • Aby dodać więcej szczegółów do komunikatu o błędzie, wprowadź opcjonalny dodatkowy komunikat pomocy.
  • Aby przetestować walidację, wprowadź wartość. Jeśli wyrażenie regularne działa, nieprawidłowa wartość spowoduje błąd, podczas gdy prawidłowa wartość zostanie zaakceptowana.

  • Zakończ konfigurację lub edycję właściwości, a następnie kliknij Utwórz lub Zapisz.

Reguły walidacji mają zastosowanie, gdy użytkownicy ustawiają lub edytują wartość właściwości podczas tworzenia, na rekordzie, na stronie indeksu obiektu, poprzez import lub poprzez przesyłanie formularza utworzonego za pomocą nowego edytora formularzy.

Składnia Regex

Aby uzyskać wskazówki dotyczące konfigurowania wyrażenia regularnego, zapoznaj się z tą ściągawką Regex.

Przykładowe wyrażenia

Przykładowe przypadki użycia obejmują:

Uwaga: przed zaimplementowaniem poniższych wyrażeń należy sprawdzić, czy działają one w konkretnym przypadku użycia.

  • Numer telefonu w USA: aby wymagać, aby numery telefonów były wprowadzane w formacie (123) 456-7890, można użyć wyrażenia regularnego ^\(\d{3}\) \d{3}-\d{4}$.
  • Adres e-mail: aby sprawdzić, czy wprowadzona wartość obserwuje standardowy format wiadomości e-mail (np. user@example. com), można użyć wyrażenia regularnego ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$.
  • Kod pocztowy: aby wymagać, aby kody pocztowe składały się z pięciu cyfr, można użyć wyrażenia regularnego ^\d{5}$.
  • URL: aby sprawdzić, czy adres URL zaczyna się od "http://" lub "https://", można użyć wyrażenia regularnego ^https?:\/\/[^\s/$.?#].[^\s]*$.
  • Brak białych znaków: aby zapobiec wprowadzaniu białych znaków, można użyć wyrażenia regularnego ^\S*$.