Получить элемент массива по индексу
Робот «Получить элемент массива по индексу» возвращает один элемент из массива значений по номеру позиции в бизнес-процессах и роботах Битрикс24. Принимает множественное поле или результат другого робота и индекс: 0 — первый элемент, -1 — последний, -2 — предпоследний. Возвращает значение элемента и признак «Элемент существует» Y/N.
Робот достаёт значение из массива по позиции, что нужно, когда другой робот или множественное поле возвращает список, а в процессе требуется конкретный элемент. На вход подаётся множественное поле (например телефоны контакта, товары сделки) или массив от предыдущего шага и индекс; положительные значения отсчитываются с начала (0 — первый), отрицательные — с конца (-1 — последний, -2 — предпоследний). Типовые случаи применения: взять первый телефон контакта для звонка; получить последнее добавленное значение из множественного поля; вытащить нужный элемент из результата робота-разбивки строки. Если индекс выходит за границы массива, возвращается пустое значение и «Элемент существует» = N. Возвращает значение элемента и признак Y/N — используйте их на следующих шагах бизнес-процесса.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Массив значений | string | да | |
| Индекс (0 = первый, -1 = последний, -2 = предпоследний…) | int | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Элемент массива | string |
| Элемент существует (Y/N) | string |
Сценарий: звонок по первому телефону контакта
- Контакт переходит на стадию «В работе»
- Робот берёт элемент с индексом 0 из множественного поля телефонов контакта
- При «Элемент существует» = Y процесс инициирует звонок по полученному номеру