Usuń element z tablicy
Robot „Usuń element z tablicy” usuwa elementy z tablicy wartości według wartości lub według pozycji w procesach biznesowych i robotach Bitrix24 (Alaio). W trybie według wartości usuwane są wszystkie dopasowania (domyślnie bez rozróżniania wielkości liter), w trybie według indeksu — jeden element, indeksy ujemne liczone są od końca. Zwraca tablicę po usunięciu, liczbę usuniętych elementów oraz wynikową liczbę.
Robot wycina elementy z tablicy i zwraca nową listę — w odróżnieniu od robota „Usuń wartość z pola wielokrotnego” działa na przekazanej tablicy, a nie na polu encji CRM. Wejściem jest pole wielokrotne lub wynik innego robota, tryb usuwania oraz cel: w trybie value usuwany jest każdy element równy podanej wartości (flaga wielkości liter steruje porównaniem), w trybie index — jeden element według pozycji, 0 to pierwszy, -1 ostatni. Pusty cel w trybie value usuwa puste elementy tablicy. Typowe przypadki użycia: wykluczyć konkretny adres e-mail z listy wysyłkowej; odrzucić pierwszy element po jego przetworzeniu; oczyścić tablicę z pustych wartości przed pętlą. Zwraca tablicę po usunięciu, liczbę usuniętych elementów oraz wynikową liczbę — użyj ich w kolejnych krokach procesu biznesowego.
Jakie parametry wejściowe przyjmuje robot?
| Parametr | Typ | Wymagany? | Domyślnie |
|---|---|---|---|
| Tablica wartości | string | tak | |
| Tryb: value — według wartości, index — według pozycji (domyślnie value) | string | — | |
| Co usunąć: wartość lub indeks (0 = pierwszy, -1 = ostatni) | string | — | |
| Rozróżniaj wielkość liter przy porównaniu (Y/N, domyślnie N) | string | — |
Co zwraca robot?
| Parametr | Typ |
|---|---|
| Tablica po usunięciu | string |
| Usunięte elementy | int |
| Wynikowa liczba elementów | int |
Scenariusz: wykluczenie adresu z wysyłki
- Proces zebrał tablicę adresów e-mail odbiorców
- Robot usuwa z tablicy adres klienta, który się wypisał
- Pętla wysyłki przechodzi po tablicy po usunięciu — wypisany klient nie dostaje wiadomości