Cómo usar un conjunto de cambios para diferentes tipos de campos.

Copiar enlace al artículo

Copiado

Los campos en el sistema pueden ser de diferentes tipos y, en consecuencia, la verificación del valor de los campos en el historial será diferente según el tipo de campo, que es fijo para cada campo en la referencia del objeto.

Número: el valor numérico del campo se verifica especificando el número a verificar, sin caracteres adicionales:

conjunto de cambios.hasChangedField("delivery_cost") and conjunto de cambios.newValue("delivery_cost") == 100

Cadena: la verificación de un tipo de cadena se realiza escribiendo el texto necesario para verificar entre comillas o comillas dobles:

conjunto de cambios.hasChangedField("status") and conjunto de cambios.newValue("status").code == "complete"
conjunto de cambios.hasChangedField("first_name") and conjunto de cambios.newValue("first_name") == "no name"

Casilla de verificación (casilla de verificación sí / no) - tiene 2 significados: true - correspondiente al valor "Sí", es decir, una marca de verificación en el campo o un botón presionado. false - correspondiente al valor "No", es decir, no hay una marca de verificación en el campo o el botón no está presionado.

conjunto de cambios.hasChangedField("call") and conjunto de cambios.newValue("call") == true

Fecha: para comparar el valor del campo que se está cambiando con una fecha específica, use la función date(), cuyo parámetro será la fecha requerida.

conjunto de cambios.hasChangedField("delivery_date") and conjunto de cambios.newValue("delivery_date") == date("01.01.2000")

Un conjunto de cambios es una matriz de datos, por lo tanto, utilizando filtros de tubería, puede rastrear cambios en los objetos anidados en la matriz. Todos los filtros disponibles para su uso se presentan en el artículo Filtros disponibles.

conjunto de cambios | contains(item =>item.fieldName == "payments.status" and item.newValue.code == "paid")

La condición se cumplirá si, en el momento del cambio de pedido, se produce un cambio en el estado del pago a "Pagado" en su historial.

Características del seguimiento de cambios en un campo personalizado

Los campos personalizados, como los campos del sistema estándar, vienen en diferentes tipos, pero el trabajo con el seguimiento de cambios en los campos personalizados es diferente. El valor de los campos de tipo: "Número" o "Entero" en el historial será un número, para otros tipos de campos los valores serán texto.

Para realizar un seguimiento de los cambios en un campo personalizado de tipo "Número" y "Entero":

conjunto de cambios.hasChangedField("custom_integer") and conjunto de cambios.newValue("custom_integer") == 12

La condición se cumplirá si un campo personalizado con el código de carácter entero, del tipo "Integer", cambia y su nuevo valor será un número 12.

conjunto de cambios.hasChangedField("custom_number") and conjunto de cambios.newValue("custom_number") == 1.25

La condición se cumplirá si cambia el campo de usuario con el número de código simbólico, con el tipo "Número" y su nuevo valor será un número de coma flotante 1.25

Nota

El número de coma flotante debe especificarse con un signo de punto

Para realizar un seguimiento de un cambio en un campo personalizado de tipo "Casilla de verificación (sí / no)":

Los campos personalizados de tipo "Casilla de verificación (sí / no)" pueden contener uno de los siguientes valores:

true - correspondiente al valor "Sí", es decir, la casilla de verificación establecida en el campo de usuario. false - correspondiente al valor "No", es decir, una casilla de verificación sin marcar en el campo de usuario.

Nota

En el caso de los campos personalizados, verdadero y falso deben validarse como cadenas: "verdadero" y "falso" respectivamente.

conjunto de cambios.hasChangedField("custom_callback") and conjunto de cambios.newValue("custom_callback") == 'true'

La condición se cumplirá si el campo personalizado con el código simbólico de devolución de llamada cambia, con el tipo "Casilla de verificación (sí / no)" y su nuevo valor será la configuración de la casilla de verificación en este campo personalizado.

Para realizar un seguimiento de un cambio en un campo personalizado de tipo "Cadena" o "Texto":

conjunto de cambios.hasChangedField("custom_note") and conjunto de cambios.newValue("custom_note") == 'Vuelva a llamar antes de las 5 pm'

La condición se cumplirá si cambia el campo de usuario con el código simbólico de devolución de llamada, con el tipo "String" o "Text", y su nuevo valor será el texto 'Devolver la llamada antes de las 5 pm'.

¡Importante!

Esta condición se cumplirá solo si el campo contiene solo información que está marcada en el código

Para realizar un seguimiento de los cambios en un campo personalizado con el tipo "Correo electrónico":

conjunto de cambios.hasChangedField("custom_mail") and conjunto de cambios.newValue("custom_mail") == "support@retailcrm.es"

La condición se cumplirá si cambia el campo de usuario con el código de carácter mail, con el tipo "E-mail" y su nuevo valor será support@retailcrm.es

Nota

En la interfaz del sistema, los campos con este tipo son validados para la exactitud de los datos ingresados ​​en el campo, de acuerdo con la máscara mail@site.es. El signo @ y la URL después de este signo son obligatorios.

Para realizar un seguimiento de los cambios en un campo personalizado con el tipo "Referencia":

El valor nuevo o antiguo del campo con el tipo "Referencia" - almacena el código simbólico de la referencia correspondiente en formato de texto

conjunto de cambios.hasChangedField("custom_directory") and conjunto de cambios.newValue("custom_directory") == "two"

La condición se cumplirá si cambia el campo de usuario con el código simbólico directorio, con el tipo "Directorio" y su nuevo valor será con el código simbólico dos del elemento directorio.

Para realizar un seguimiento de los cambios en un campo personalizado de tipo "Fecha": en el formato

conjunto de cambios.hasChangedField("custom_birthday") and conjunto de cambios.newValue("custom_birthday") == "1980-01-13"

¡Importante!

En los campos personalizados con el tipo "Fecha", los datos del historial se almacenan en el formato AAAA-MM-DD, que es diferente del formato en la interfaz del sistema - DD.MM.YYYY

La condición se cumplirá si el campo personalizado con el código simbólico cumpleaños cambia con el tipo "Fecha" y su nuevo valor será 13.01.1980.