Excluir elemento do array

O robô «Excluir elemento do array» remove elementos de um array de valores por valor ou por posição em processos de negócios e robôs do Bitrix24 (Alaio). No modo por valor todas as correspondências são removidas (por padrão sem diferenciar maiúsculas), no modo por índice — um único elemento, índices negativos contam a partir do fim. Retorna o array após a exclusão, o número de elementos excluídos e a quantidade resultante.

O robô recorta elementos de um array e retorna uma nova lista — ao contrário do robô «Remover valor de um campo múltiplo», ele trabalha com o array recebido, não com um campo de uma entidade CRM. A entrada é um campo múltiplo ou a saída de outro robô, o modo de exclusão e o alvo: no modo value é removido cada elemento igual ao valor dado (o indicador de maiúsculas controla a comparação), no modo index — um elemento por posição, 0 é o primeiro e -1 o último. Um alvo vazio no modo value remove os elementos vazios do array. Casos típicos de uso: excluir um e-mail específico de uma lista de envio; descartar o primeiro elemento após processá-lo; limpar os valores vazios de um array antes de um laço. Retorna o array após a exclusão, o número de elementos excluídos e a quantidade resultante — use-os nas próximas etapas do processo de negócios.

Quais parâmetros de entrada o robô aceita?

O que o robô retorna?

Cenário: exclusão de um endereço de um envio

1. O processo reuniu um array de e-mails de destinatários
2. O robô exclui do array o endereço do cliente que se descadastrou
3. O laço de envio percorre o array após a exclusão — o cliente descadastrado não recebe carta

Robôs semelhantes

• Verificar se um valor existe no array
• Tamanho do array / número de elementos
• Obter elemento do array por índice
• Adicionar valor a um campo múltiplo