Roboteka
Roboteka · Robots · Valor anterior de un campo

Valor anterior de un campo

El robot «Valor anterior de un campo» devuelve, dentro de un proceso de negocio de Bitrix24 (Alaio), el valor que tenía un campo antes de su último cambio: el valor anterior, el nuevo, el momento del cambio y el ID del usuario que lo hizo. Funciona con negociaciones, prospectos, contactos, empresas y procesos inteligentes y necesita el historial de cambios de campos activado.

El robot lee el historial de cambios que la aplicación mantiene en su portal de Bitrix24 (Alaio) y devuelve el último cambio de un campo: el valor anterior, el valor posterior, el momento y el ID del usuario. El historial de cambios de campos debe estar activado en los ajustes de la aplicación; si está desactivado o el campo nunca ha cambiado, el robot no falla, sino que devuelve el indicador «encontrado» = N, por lo que el camino normal no necesita gestión de errores. El campo se indica con su código tal como lo devuelve la API REST de Bitrix24: title, opportunity, ufCrm_123; teléfonos, correos, sitios web y mensajeros son phone, email, web, im. Por defecto se usa el elemento sobre el que se ejecuta el proceso; los modos «por ID» cubren los procesos que se ejecutan sobre otro elemento. Si el campo se cambió en segundo plano sin usuario (por ejemplo, un robot o un proceso de negocio tras una pausa), el indicador «sin usuario» es Y y el ID de usuario es 0.

¿Qué parámetros de entrada acepta el robot?

Parámetro Tipo ¿Obligatorio? Por defecto
Código del campo (por ejemplo title, opportunity, ufCrm_123; para teléfonos, correos, sitios web y mensajeros: phone, email, web, im) string sí
Elemento select Elemento actual, Prospecto por ID, Negociación por ID, Contacto por ID, Empresa por ID, Elemento de proceso inteligente por ID — auto
ID del elemento (para los modos «por ID») string —
ID del tipo de proceso inteligente (solo para el modo de proceso inteligente) string —

¿Qué devuelve el robot?

Parámetro Tipo
Valor del campo antes del último cambio string
Valor del campo después del último cambio string
Cuándo cambió el campo por última vez datetime
ID del usuario que hizo el cambio; 0 si se hizo en segundo plano sin usuario. Para un cambio que el historial aún no ha registrado, el último editor del elemento int
El cambio se hizo en segundo plano sin usuario (por ejemplo, un robot o un proceso de negocio tras una pausa); también Y para un cambio que el historial aún no ha registrado (Y/N) bool
Cambio encontrado (Y/N) bool
Correcto bool
Mensaje del resultado string

¿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.

  • No se ha indicado el código del campo.
  • Este elemento no tiene historial de cambios. El robot funciona con prospectos, negociaciones, contactos, empresas y procesos inteligentes; para los modos «por ID» indique un ID válido.
  • No se pudo leer el historial de cambios. Vuelva a ejecutar el paso más tarde; si el error se repite, contacte con el soporte.

Escenario: avisar al supervisor cuando se reduce el importe de una negociación

  1. El robot está en la etapa «Aprobación» y lee el campo opportunity
  2. Devuelve el importe anterior y el nuevo, y el ID del empleado que lo cambió
  3. Si el importe nuevo es menor que el anterior, el supervisor recibe un aviso con ambas cifras

Robots similares