Eliminar archivo de la ficha
El robot «Eliminar archivo de la ficha» elimina un archivo de un campo de archivo de una entidad CRM de Bitrix24 (Alaio) — una negociación, un contacto, una empresa o un prospecto — por índice (0 = primero, -1 = último), o vacía todo el campo si el índice se deja vacío. Las entradas son el tipo de entidad, su ID, el código del campo de archivo y el índice. Devuelve un indicador de éxito (Y/N) y la cantidad de archivos restantes.
El robot quita adjuntos de un campo de archivo de una entidad CRM directamente dentro de un proceso de negocio. Las entradas son: el tipo de entidad (deal, contact, company o lead), el ID de la entidad, el código del campo de archivo y el índice del archivo. Si el índice se deja vacío, se vacía todo el campo; el índice 0 elimina el primer archivo, -1 el último, los valores negativos cuentan desde el final y un índice fuera de rango se ajusta al más cercano existente. Las salidas son: success — un indicador Y cuando la ficha se actualizó correctamente, de lo contrario N, y remaining — cuántos archivos quedan en el campo tras la eliminación. Úselo para eliminar un borrador de contrato obsoleto al cambiar de etapa la negociación, vaciar adjuntos temporales tras el procesamiento o quitar un archivo sobrante conservando el resto. Si los parámetros no son válidos o la entidad no se encuentra, el robot devuelve success N; para un campo ya vacío devuelve success Y y remaining 0. Las salidas success y remaining se pueden comparar en la condición del siguiente paso del proceso de negocio.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| Tipo de entidad: deal / contact / company / lead | string | sí | |
| ID de la entidad | int | sí | |
| Código del campo de archivo | string | sí | |
| Índice del archivo a eliminar (0 = primero, -1 = último). Déjelo vacío para vaciar todo el campo | string | — |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Éxito (Y/N) | string |
| Archivos restantes tras la eliminación | int |
¿Qué errores puede devolver el robot?
El robot escribe estos mensajes en el registro del proceso de negocio cuando no puede completar un paso. El texto indica qué corregir en la configuración o en los datos.
- Error: parámetros no válidos
- Entidad no encontrada
Escenario: vaciar adjuntos temporales tras la aprobación
- Una negociación entra en la etapa «Aprobada»
- El robot elimina el primer archivo del campo de borradores (índice 0)
- En remaining se devuelve la cantidad de archivos restantes, success muestra Y o N