La acción de Coincidir registros (o para abreviar, CR ) es una de las herramientas más poderosas del paquete de automatización de Mapsly. Le permite encontrar registros en cualquier objeto específico que coincida con su registro base en función de una condición y una fórmula de clasificación, y luego ejecutar una secuencia de acciones para todo el conjunto de registros coincidentes y, por separado, para cada uno de los registros coincidentes. Aborda una amplia gama de escenarios mencionados en nuestro sitio web que normalmente requerirían escribir y mantener un código.

Conceptos básicos

Veamos un ejemplo: para un paciente de atención médica, estamos buscando las 3 clínicas más cercanas que ofrezcan el servicio que el paciente necesita (como resonancia magnética), más cercanas por tiempo de conducción, pero no más de 20 minutos en coche. Las clínicas encontradas deben guardarse en el registro del CRM del paciente .

Definamos los términos utilizados en la acción Coincidir registros

Objeto paciente es el objeto base y el paciente concreto para el cual estamos buscando clínicas, es el registro base . En fórmulas y parámetros de acción se le menciona con el prefijo registro .
Objeto de clínica es el objeto de coincidencia . En fórmulas y parámetros de acción se menciona con el prefijo match .
Clínicas que ofrecen el servicio que el paciente necesita es la condición de la coincidencia , y los registros de la clínica que cumplen la condición son candidatos de la coincidencia. .

Si, en nuestro ejemplo, el servicio que necesita un cliente es una lista de selección única o de selección múltiple ServiciosNecesitados en el objeto de posibles clientes, y los servicios que ofrece una clínica se almacenan como una elección de la lista de selección ServiciosOfrecidos en el registro de la cuenta, la condición de la coincidencia sería:
coincidencia.ServiciosOfrecidos contiene todos los registros.ServiciosNecesitados
Más cercano por distancia nos dice cómo debemos elegir las 3 clínicas que mejor se adaptan a los candidatos. En los registros de coincidencia este criterio se denomina calificación y, dado que Mapsly selecciona los registros con la más alta calificación, este criterio se traduce en la fórmula de calificación - tiempo_deconduccion (el tiempo de conducción con el signo menos) - para que una clínica más cercana tenga una calificación más alta.
No más de 20 minutos en coche establece una restricción en el valor de los criterios utilizados para elegir las clínicas que mejor se adapten. En los Registros de coincidencia dicho límite se denomina límite y es el valor mínimo de la calificación de un candidato de coincidencia para que se considere un registro coincidente. En nuestro ejemplo, esta restricción se traduce en un límite de -20 .

Para ejecutar la acción de CR, configuraríamos un flujo de trabajo en Mapsly, desencadenado por un nuevo posible cliente y agregaríamos la acción de CR a su lista de acciones.

Configuración de la acción 'Coincidir registro'

Nombre de la acción : un nombre descriptivo de su acción.

Nombre de API de acción : un nombre técnico de su acción si planea ejecutarla desde el código.

Para un registro en : este es el objeto base . CR se ejecutará para un registro de este objeto.

Buscar registros en : este es el objeto de coincidencia . CR buscará registros en este objeto.

Registros para encontrar : cuántos registros como máximo le gustaría encontrar. El conjunto de registros resultantes puede contener menos registros, si menos registros que la cantidad requerida coinciden con la condición y tienen una calificación por encima del límite, pero nunca más que el mismo.

Almacenar registros coincidentes en : un campo de búsqueda en el objeto base que hace referencia al objeto coincidente. Opcional.

Le gustaría usarlo en los dos escenarios siguientes:

cuando busca encontrar exactamente 1 registro coincidente y almacenarlo en el campo de búsqueda única en el registro base;
cuando busca encontrar varios registros coincidentes y almacenarlos en los campos de búsqueda de selección múltiple.

En todos los demás escenarios, necesitará usar Acciones base para manejar el resultado del CR.

Criterios de coincidencia : un grupo de opciones de configuración que definen cuales registros deben incluirse en el conjunto de registros resultantes (se convierten en registros coincidentes).

Condición de coincidencia : esta es la condición de coincidencia . Solo se puede editar en el Generador de expresiones , pero no en el Editor de expresiones .

En el ejemplo anterior, para garantizar que no superemos el número máximo de candidatos coincidentes después de que la condición de la coincidencia se aplique a todas las cuentas (consulte la sección Limitaciones a continuación ), también deberíamos filtrar los registros innecesarios por distancia. Para hacer esto, estamos agregando la siguiente condición de coincidencia usando el Y lógico:

Aquí, seleccionamos Distancia directa actual del bloque Especial como el operando izquierdo e ingresamos la distancia en metros (32.000 metros son aproximadamente 20 millas).

Nota. Dado que calcular la distancia o el tiempo de conducción es una operación que requiere muchos recursos, no existe una condición de coincidencia disponible que se pueda aplicar a millones de registros, por lo que cuando necesite filtrar por distancia en la condición de coincidencia, utilice siempre Distancia directa actual como se muestra arriba. La palabra actual aquí se refiere a la distancia entre el registro base y el registro de coincidencia actual

Tener la calificación más alta : aquí puede establecer la calificación . Opcional.

Aquí también puede utilizar las funciones del sistema CurrentDirectDistance() y CurrentRoute() .

En el ejemplo anterior, usamos CurrentRoute().time en la fórmula de calificación, la cual es el tiempo de conducción entre el registro base y la coincidencia actual registro.

Pero no inferior a : aquí puede establecer el limite . Opcional.

Acciones de coincidencia: bloques de acciones / condiciones que se ejecutarán para cada uno de los registros coincidentes (si corresponde).

Acciones base : bloques de acciones / condiciones para ser ejecutado una vez, al final de la ejecución del CR. Estas acciones tienen acceso a los registros de los registros coincidentes, que se pueden usar para almacenarlos en el registro base de una manera personalizada, enviar un informe por correo electrónico con su lista a través de una acción Enviar correo electrónico , enviarlos a una API externa a través de una acción de invocación de URL y demás

Cómo ejecutar una acción de 'Coincidir registro'

Normalmente, querrá configurar un flujo de trabajo activado por un registro de objeto base nuevo o actualizado, o un Botón para el objeto base - para ejecutar una acción del CR.

Límites en los Registros de coincidencias

Distancia y tiempo de conducción no son permitidos en las condiciones de coincidencia

No puede utilizar distancia de conducción o tiempo de conducción en la condición de coincidencia, porque consumen demasiados recursos para aplicarlos a todo el conjunto de registros del objeto de coincidencia. Cuando necesite filtrar por distancia en la condición de coincidencia, use la distancia directa en su lugar y luego use la distancia de conducción o el tiempo en la clasificación (o límite).

El número máximo de candidatos coincidentes es 1000, o 100 cuando se usa CurrentRoute()

Existe un límite en el número máximo de candidatos coincidentes:

100 , si está utilizando CurrentRoute () en la clasificación o el límite;
1000 en todos los demás casos.

Si el número de candidatos coincidentes supera este límite, la acción CR fallará en tiempo de ejecución.

Si necesita que se eleven estos límites para su organización de Mapsly, comuníquese con el servicio de asistencia de Mapsly.