Dodaj wartość do pola wielokrotnego
Robot „Dodaj wartość do pola wielokrotnego” dopisuje nową wartość do pola wielokrotnego encji CRM (deala, kontaktu, firmy lub leada) w procesach biznesowych i robotach Bitrix24, nie nadpisując istniejących wartości. Domyślnie duplikaty są pomijane. Zwraca flagę „Powodzenie” Y/N oraz wynikową liczbę elementów w polu.
Robot dodaje pojedynczą wartość do pola wielokrotnego encji CRM, zachowując wszystkie wcześniej wprowadzone wartości — w przeciwieństwie do zwykłej aktualizacji pola, która nadpisuje całą listę. Wejściem są typ encji (deal, contact, company lub lead), jej ID, kod pola (np. UF_CRM_TAGS lub PHONE) oraz dodawana wartość; flaga „Pomiń, jeśli już istnieje” (domyślnie Y) zapobiega powtórzeniom. Typowe przypadki użycia: dopisać tag do deala przy zajściu zdarzenia; dodać dodatkowy telefon kontaktowi bez utraty głównego; gromadzić wartości w niestandardowym polu wielokrotnym w trakcie procesu. Jeśli encja nie zostanie znaleziona lub parametry są nieprawidłowe, zwracane jest „Powodzenie” = N. Zwraca „Powodzenie” Y/N oraz wynikową liczbę elementów w polu — użyj ich w kolejnych krokach procesu biznesowego.
Jakie parametry wejściowe przyjmuje robot?
| Parametr | Typ | Wymagany? | Domyślnie |
|---|---|---|---|
| Typ encji: deal / contact / company / lead | string | tak | |
| ID encji | int | tak | |
| Kod pola (np. UF_CRM_TAGS lub PHONE) | string | tak | |
| Dodawana wartość | string | tak | |
| Pomiń, jeśli już istnieje (Y/N, domyślnie Y) | string | — |
Co zwraca robot?
| Parametr | Typ |
|---|---|
| Powodzenie (Y/N) | string |
| Wynikowa liczba elementów w polu | int |
Scenariusz: oznaczenie deala tagiem przy płatności
- Deal wchodzi na etap „Opłacono”
- Robot dodaje wartość „opłacono” do pola wielokrotnego tagów deala
- Przy „Powodzenie” = Y proces jest kontynuowany, a wynikowa liczba elementów wykorzystywana dalej