Zeichenkette per Regex formatieren
Der Roboter „Zeichenkette per Regex formatieren" für Bitrix24-Geschäftsprozesse führt ein PHP preg_replace über die Quellzeichenkette aus: Er findet Ihren regulären Ausdruck und ersetzt ihn durch Ihre Ersetzung, wobei $0 der gesamte Treffer und $1, $2 die erfassten Gruppen sind. Er gibt das umgewandelte Ergebnis und ein Kennzeichen Erfolg zurück (false bei einem Regex-Fehler).
„Zeichenkette per Regex formatieren" ist ein Text-Roboter für Geschäftsprozesse und Roboter in Bitrix24, der Ihnen die vollständige Ersetzung per regulärem Ausdruck (PHP preg_replace) direkt im Workflow-Designer bietet. Sie geben die Quellzeichenkette, ein Pattern und eine Ersetzung an; der Roboter wendet das Pattern auf den Text an und gibt den umgeschriebenen Wert im Feld „Ergebnis" zurück. In der Ersetzung können Sie auf den gesamten Treffer als $0 und auf erfasste Gruppen als $1, $2 usw. verweisen, womit Sie Teile eines Werts umsortieren, neu formatieren oder extrahieren können. Außerdem wird ein Kennzeichen Erfolg zurückgegeben — es ist false, wenn das Pattern ungültig ist, sodass Sie sicher verzweigen können, anstatt fehlerhafte Ausgaben zu speichern. Verwenden Sie ihn, um Telefonnummern neu zu formatieren, Datumsangaben zu normalisieren, Teile einer Zeichenkette zu entfernen oder umzuordnen oder ein Fragment aus CRM-Daten zu extrahieren. Es ist weder eine Code-Bereitstellung noch ein Entwickler erforderlich.
Welche Eingabeparameter akzeptiert der Roboter?
| Parameter | Typ | Pflichtfeld? | Standard |
|---|---|---|---|
| Quellzeichenkette | string | ja | |
| Regulärer Ausdruck (Pattern) | string | ja | |
| Ersetzungszeichenkette ($1, $2 für Gruppen) | string | — |
Was gibt der Roboter zurück?
| Parameter | Typ |
|---|---|
| Ergebnis | string |
| Erfolg (false bei Regex-Fehler) | bool |
Szenario: Eine 10-stellige Telefonnummer in eine lesbare Maske umwandeln.
- Schritt 1. Fügen Sie den Roboter „Zeichenkette per Regex formatieren“ zu Ihrem Geschäftsprozess hinzu.
- Schritt 2. Setzen Sie Quellzeichenkette auf das Feld, z. B. {=Document:PHONE}.
- Schritt 3. Legen Sie das Pattern und eine Ersetzung mit Gruppen fest, z. B. Ersetzung "+1 ($1) $2-$3".
- Schritt 4. Verwenden Sie das Feld Ergebnis nachgelagert und prüfen Sie das Kennzeichen Erfolg in einer Bedingung.