Formatuj ciąg za pomocą regex
Robot „Formatuj ciąg za pomocą regex" do procesów biznesowych Bitrix24 wykonuje PHP preg_replace na ciągu źródłowym: dopasowuje Twoje wyrażenie regularne i zastępuje je Twoim ciągiem zastępującym, gdzie $0 to całe dopasowanie, a $1, $2 to przechwycone grupy. Zwraca przekształcony Wynik oraz znacznik Sukces (false przy błędzie regex).
„Formatuj ciąg za pomocą regex" to tekstowy robot do procesów biznesowych i robotów w Bitrix24, który daje pełną zamianę za pomocą wyrażenia regularnego (PHP preg_replace) bezpośrednio w kreatorze procesów. Podajesz ciąg źródłowy, wzorzec i ciąg zastępujący; robot stosuje wzorzec do tekstu i zwraca przepisaną wartość w polu „Wynik". W ciągu zastępującym możesz odwołać się do całego dopasowania jako $0 oraz do przechwyconych grup jako $1, $2 i tak dalej, co pozwala zmieniać kolejność, ponownie formatować lub wyodrębniać części wartości. Zwracany jest również znacznik Sukces — ma wartość false, gdy wzorzec jest nieprawidłowy, dzięki czemu możesz bezpiecznie się rozgałęzić zamiast zapisywać uszkodzony wynik. Użyj go, aby ponownie sformatować numery telefonów, ujednolicić daty, usunąć lub zmienić kolejność części ciągu albo wyodrębnić fragment z danych CRM. Wdrożenie kodu ani programista nie są wymagane.
Jakie parametry wejściowe przyjmuje robot?
| Parametr | Typ | Wymagany? | Domyślnie |
|---|---|---|---|
| Ciąg źródłowy | string | tak | |
| Wyrażenie regularne (wzorzec) | string | tak | |
| Ciąg zastępujący ($1, $2 dla grup) | string | — |
Co zwraca robot?
| Parametr | Typ |
|---|---|
| Wynik | string |
| Sukces (false przy błędzie regex) | bool |
Scenariusz: przeformatuj 10-cyfrowy numer telefonu na czytelną maskę.
- Krok 1. Dodaj robota „Formatuj ciąg za pomocą regex“ do swojego procesu biznesowego.
- Krok 2. Ustaw Ciąg źródłowy na pole, np. {=Document:PHONE}.
- Krok 3. Ustaw wzorzec i ciąg zastępujący z grupami, np. zamianę "+48 ($1) $2-$3".
- Krok 4. Użyj pola Wynik w dalszych krokach i sprawdź znacznik Sukces w warunku.