Excluir arquivo do card
O robô «Excluir arquivo do card» exclui um arquivo de um campo de arquivo de uma entidade CRM do Bitrix24 — um negócio, contato, empresa ou lead — por índice (0 = primeiro, -1 = último), ou esvazia todo o campo se o índice ficar vazio. As entradas são o tipo de entidade, seu ID, o código do campo de arquivo e o índice. Retorna um indicador de sucesso (Y/N) e a quantidade de arquivos restantes.
O robô remove anexos de um campo de arquivo de uma entidade CRM diretamente dentro de um processo de negócios. As entradas são: o tipo de entidade (deal, contact, company ou lead), o ID da entidade, o código do campo de arquivo e o índice do arquivo. Se o índice ficar vazio, todo o campo é esvaziado; o índice 0 exclui o primeiro arquivo, -1 o último, valores negativos contam a partir do fim e um índice fora do intervalo é ajustado para o mais próximo existente. As saídas são: success — um indicador Y quando o card foi atualizado com sucesso, caso contrário N, e remaining — quantos arquivos restam no campo após a exclusão. Use para remover um rascunho de contrato desatualizado na mudança de etapa do negócio, esvaziar anexos temporários após o processamento ou retirar um arquivo excedente mantendo os demais. Se os parâmetros forem inválidos ou a entidade não for encontrada, o robô retorna success N; para um campo já vazio retorna success Y e remaining 0. As saídas success e remaining podem ser comparadas na condição da próxima etapa do processo de negócios.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Tipo de entidade: deal / contact / company / lead | string | sim | |
| ID da entidade | int | sim | |
| Código do campo de arquivo | string | sim | |
| Índice do arquivo a excluir (0 = primeiro, -1 = último). Deixe vazio para esvaziar todo o campo | string | — |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Sucesso (Y/N) | string |
| Arquivos restantes após a exclusão | int |
Cenário: esvaziar anexos temporários após a aprovação
- Um negócio entra na etapa «Aprovado»
- O robô exclui o primeiro arquivo do campo de rascunhos (índice 0)
- Em remaining é retornada a quantidade de arquivos restantes, success mostra Y ou N