Obter elemento do array por índice
O robô «Obter elemento do array por índice» retorna um único elemento de um array de valores por posição em processos de negócios e robôs do Bitrix24. Aceita um campo múltiplo ou a saída de outro robô e um índice: 0 é o primeiro elemento, -1 o último, -2 o penúltimo. Retorna o valor do elemento e um indicador «O elemento existe» Y/N.
O robô extrai um valor de um array por posição, o que é necessário quando outro robô ou um campo múltiplo retorna uma lista e o processo precisa de um elemento específico. A entrada é um campo múltiplo (como os telefones de um contato, os produtos de um negócio) ou um array de uma etapa anterior mais um índice; valores positivos contam a partir do início (0 = primeiro), negativos a partir do fim (-1 = último, -2 = penúltimo). Casos típicos de uso: pegar o primeiro telefone do contato para uma ligação; obter o último valor adicionado a um campo múltiplo; extrair o elemento necessário da saída de um robô que divide strings. Se o índice ficar fora dos limites do array, é retornado um valor vazio e «O elemento existe» = N. Retorna o valor do elemento e um indicador Y/N — use-os nas próximas etapas do processo de negócios.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Array de valores | string | sim | |
| Índice (0 = primeiro, -1 = último, -2 = penúltimo…) | int | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Elemento do array | string |
| O elemento existe (Y/N) | string |
Cenário: ligar para o primeiro telefone do contato
- Um contato entra na etapa «Em andamento»
- O robô pega o elemento no índice 0 do campo múltiplo de telefones do contato
- Com «O elemento existe» = Y o processo inicia uma ligação para o número obtido