Wert zu einem Mehrfachfeld hinzufügen
Der Roboter „Wert zu einem Mehrfachfeld hinzufügen“ hängt einen neuen Wert an ein CRM-Mehrfachfeld (Auftrag, Kontakt, Unternehmen oder Lead) in Geschäftsprozessen und Robotern von Bitrix24 (Alaio) an, ohne vorhandene Werte zu überschreiben. Duplikate werden standardmäßig übersprungen. Zurückgegeben werden ein Kennzeichen „Erfolgreich“ Y/N und die resultierende Anzahl der Elemente im Feld.
Der Roboter fügt einem CRM-Mehrfachfeld einen einzelnen Wert hinzu und behält dabei alle zuvor eingegebenen Werte — anders als eine einfache Feldaktualisierung, die die gesamte Liste überschreibt. Eingabe sind der Entitätstyp (deal, contact, company oder lead), deren ID, der Feldcode (z. B. UF_CRM_TAGS oder PHONE) und der hinzuzufügende Wert; das Kennzeichen „Überspringen, wenn bereits vorhanden“ (Standard Y) verhindert Duplikate. Typische Anwendungsfälle: einem Auftrag bei einem Ereignis ein Tag anhängen; einem Kontakt ein zusätzliches Telefon hinzufügen, ohne das Haupttelefon zu verlieren; Werte im Verlauf des Prozesses in einem benutzerdefinierten Mehrfachfeld ansammeln. Wird die Entität nicht gefunden oder sind die Parameter ungültig, wird „Erfolgreich“ = N zurückgegeben. Zurückgegeben werden „Erfolgreich“ Y/N und die resultierende Anzahl der Elemente im Feld — nutzen Sie sie in den nächsten Schritten des Geschäftsprozesses.
Welche Eingabeparameter akzeptiert der Roboter?
| Parameter | Typ | Pflichtfeld? | Standard |
|---|---|---|---|
| Entitätstyp: deal / contact / company / lead | string | ja | |
| Entitäts-ID | int | ja | |
| Feldcode (z. B. UF_CRM_TAGS oder PHONE) | string | ja | |
| Hinzuzufügender Wert | string | ja | |
| Überspringen, wenn bereits vorhanden (Y/N, Standard Y) | string | — |
Was gibt der Roboter zurück?
| Parameter | Typ |
|---|---|
| Erfolgreich (Y/N) | string |
| Resultierende Anzahl der Elemente im Feld | int |
Welche Fehler kann der Roboter zurückgeben?
Diese Meldungen schreibt der Roboter ins Protokoll des Geschäftsprozesses, wenn er einen Schritt nicht ausführen kann. Der Text zeigt, was in den Einstellungen oder Daten zu korrigieren ist.
- Fehler: ungültige Parameter
- Entität nicht gefunden
Szenario: Auftrag bei Zahlung mit Tag versehen
- Ein Auftrag wechselt in die Phase „Bezahlt“
- Der Roboter fügt den Wert „bezahlt“ zum Tag-Mehrfachfeld des Auftrags hinzu
- Bei „Erfolgreich“ = Y wird der Prozess fortgesetzt und die resultierende Elementanzahl weiterverwendet