Objetivo

Aplicar reglas de negocio usando condiciones personalizadas (CustomParams).

Alcance

Afecta el Rule Engine y la aplicación de reglas de negocio en reservas generadas desde el API.

Configuraciones

1. Nuevo Permiso

Se agrega el permiso “Atributos para Reglas de Negocio” en la configuración de Roles en el menú de Personas y Compañias de NetAdmin.

El mismo se ubica en la sección “Permisos de Configuración”.

2. Atributos Personalizados

2.1 Resumen de Atributos

Cuando el usuario logueado posee el permiso “Atributos para Reglas de Negocio”, se le habilita la opción “Atributos para Reglas de Negocio” en el menú de Configuración de NetAdmin.

Una vez se selecciona la opción “Atributos para Reglas de Negocio” en el menú, se despliega una pantalla con el resumen de Atributos.

La misma posee:

• Título “Resumen de Atributos para Reglas de Negocion

• Botón “Nuevo” para registrar un nuevo atributo

• Buscador general para localizar atributos facilmente por nombre o descripción

• Grilla con los siguientes campos:

  • Acciones → Con ícono de edición y eliminación

  • Id → Identificador único del atributo personalizado

  • Nombre → Nombre del atributo personalizado. Dicho nombre se visualiza luego en la lista de atributos en todas las reglas de negocio. Se deja imagen al pie.

  • Descripción → Descripción del atributo personalizado. Dicha descripción se visualiza en configuración de las reglas de negocio cuando se selecciona un atributo personalizado. Se deja imagen al pie.

2.2 Resumen de Atributos

Cuando se presiona el botón “Nuevo” en el Resumen de Atributos, se desplega una nueva pantalla con:

• Titulo “Atributos para Reglas de Negocio"

• Botón “Volver” → para regresar al Resumen de Atributos

• Botón “Guardar” → para almacenar el nuevo atributo

• Campos:

  • Nombre → campo de texto para ingresar el nombre del nuevo atributo. Abajo se muestra la siguiente leyenda “Nombre con el cual se mostrará el atributo en la lista de condiciones del motor de reglas”

  • Descripción → campo de texto para ingresar la explicación del nuevo atributo. Abajo se muestra la siguiente leyenda “Descripción que explica para qué se usa el nuevo atributo”

⚠️ Los atributos se almacenan en una nueva tabla de base de datos llamada dbo.RuleEngineAttributes.

La misma cuenta con los siguientes campos:

• Id para identificar univocamente cada registro de la tabla.

• Name para almacenar el nombre del atributo que se va a mostrar en las condiciones del motor

• Description para almacenar la leyenda explicativa del atributo que se va a mostrar en las condiciones del motor

📣 ACLARACIONES!

El nombre del atributo se identifica en el dropdown de las reglas de negocio con la leyenda (custom):

La descripción se visualiza una vez se selecciona el atributo en el dropdopwn junto con la leyenda “Disponible únicamente para reservas generadas vía API“:

2.3 Edición de Atributos

Cuando se presiona el ícono de edición (lápiz) en la grilla de Resumen de Atributos, se despliega la misma pantalla de creación de atributos con la información pre cargada.

A su vez se suman los siguientes botones:

• Eliminar → para eliminar el atributo

• Historial → para conocer las modificaciones del atributo

• Nuevo → para crear un nuevo atributo personalizado

El botón de historial muestra el pop up con el listado de cambios realizados con la fecha correspondiente y el usuario que realizó la acción.

2.4 Eliminación de Atributos

Cuando se presiona el ícono de eliminación (cesto de residuos) en la grilla de Resumen de Atributos, se despliega un pop up solicitando la confirmación de la eliminación.

Si el usuario selecciona la “X” en el extremo superior derecho → no se elimina el atributo.

Si el usuario selecciona “Borrar” → se elimina el atributo y se registra la acción en la tabla dbo.EntityChangeHstory.

Rule Engine

1. Utilización de Condiciones Personalizadas

Cuando existen atributos personalizados configurados en el userservice, estos se muestran en el dropdown de condiciones en el motor de reglas (para todas las reglas de negocio) ordenados alfabéticamente con la palabra “Custom” al lado para identificarlos con facilidad. Ejemplo:

Una vez se selecciona el atributo personalizado en el dropdown se agrega debajo del campo la descripción del atributo junto con la leyenda “Disponible únicamente para reservas generadas vía API”. Ejemplo:

NOTA: Todas los atributos custom admiten una lista de valores.

2. Aplicación de Reglas de Negocio con Condiciones Personalizadas

Si la búsqueda se realiza desde NetCoreAPI y se recibe una lista de CustomParams en los RequestSettings, se buscan condiciones que tengan los mismos Key-Value.

Ejemplo:

Si existe una condición con la llave y valor enviada en el RequestSettings (en una regla vigente) → Entonces se aplica dicha regla de negocio.

Si no existe una condición con la llave y valor enviada en el RequestSettings (en una regla vigente) → Entonces no se aplica la regla de negocio.