Obtener elemento del array por índice
El robot «Obtener elemento del array por índice» devuelve un único elemento de un array de valores por posición en los procesos de negocio y robots de Bitrix24. Acepta un campo múltiple o la salida de otro robot y un índice: 0 es el primer elemento, -1 el último, -2 el penúltimo. Devuelve el valor del elemento y un indicador «El elemento existe» Y/N.
El robot extrae un valor de un array por posición, lo que se necesita cuando otro robot o un campo múltiple devuelve una lista y el proceso necesita un elemento concreto. La entrada es un campo múltiple (como los teléfonos de un contacto, los productos de una negociación) o un array de un paso anterior más un índice; los valores positivos cuentan desde el principio (0 = primero), los negativos desde el final (-1 = último, -2 = penúltimo). Casos de uso típicos: tomar el primer teléfono del contacto para una llamada; obtener el último valor añadido a un campo múltiple; extraer el elemento necesario de la salida de un robot que divide cadenas. Si el índice queda fuera de los límites del array, se devuelve un valor vacío y «El elemento existe» = N. Devuelve el valor del elemento y un indicador Y/N — úselos en los siguientes pasos del proceso de negocio.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| Array de valores | string | sí | |
| Índice (0 = primero, -1 = último, -2 = penúltimo…) | int | — |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Elemento del array | string |
| El elemento existe (Y/N) | string |
Escenario: llamar al primer teléfono del contacto
- Un contacto entra en la etapa «En curso»
- El robot toma el elemento en el índice 0 del campo múltiple de teléfonos del contacto
- Con «El elemento existe» = Y el proceso inicia una llamada al número obtenido