Hoja de Referencia de Reglas Comerciales¶

Introducción¶

Esta página proporciona una descripción general de alto nivel de las diferentes reglas comerciales disponibles en Vinyl, qué son y por qué se usan.

Llamada API¶

Llamada API es un tipo de regla disponible en Vinyl para usar al llamar a un extremo API. Al seleccionar esta regla, los resultados de Target se limitarán únicamente a los extremos de la API REST.

Objeto de Negocio¶

Objeto de negocio es el tipo de regla de negocio más utilizado en aplicaciones de Vinyl. Este tipo de regla le permite utilizar Eventos y vincular lógica simple o compleja mediante acciones y validaciones. Los objetos comerciales se utilizan principalmente para crear la capa UI en una aplicación. Los objetos de negocio pueden utilizar subconsultas como parte de su lógica.

Source y List Hay dos ejemplos comunes de Business Objects:

Source: Muestra todas las filas y columnas de una tabla en la capa de datos. Hace referencia a una tabla y no debe incluir ningún filtro. Los objetos de origen se utilizan a menudo cuando necesita crear una expresión o función en los datos subyacentes para presentarlos en la capa de interfaz de usuario de la aplicación.
List: Traduce el valor de ID de la clave principal a un valor de columna de título fácil de usar. Los objetos de lista se pueden utilizar cuando desee mostrar datos al usuario final que pueden no estar disponibles en la tabla. Los objetos de lista a menudo presentan información en forma de un menú desplegable que un usuario puede seleccionar.

Calendario¶

Calendario Las reglas comerciales se utilizan para crear la lógica comercial para un calendario que se mostrará en la capa de la interfaz de usuario. La ventaja de crear una regla con el tipo Calendario es que puede configurar y organizar cualquier atributo de Calendario requerido a nivel de regla definiendo Tipo de uso.

Valores del tipo de uso:

Color
Description
End
Sort
Start

Cuadro¶

Gráfico Las reglas comerciales se utilizan para crear la lógica comercial para un gráfico que se mostrará en la capa UI de la aplicación. La ventaja de crear una regla con tipo de gráfico es que puede configurar y organizar cualquier atributo de gráfico requerido en el nivel de regla definiendo Tipo de uso.

Valores del tipo de uso:

Category
Color
Flag
JSON Options Object
Sort
Value

CRUD¶

Las Reglas CRUD se utilizan cuando desea actualizar, eliminar o insertar datos en una aplicación. Las acciones asociadas que selecciona al configurar (Cram, Delete, Insert, Update) definen cómo la regla afecta los registros de la tabla de destino. Las reglas de negocio CRUD se crean y definen en la capa de lógica de negocios.

CRUD Business Layer Las reglas ejecutarán su regla en la capa de lógica empresarial, lo que significa que harán que se ejecuten todas las acciones y validaciones en la tabla u objeto que está modificando.

XP CRUD Reglas significa CRUD multiplataforma y se usa cuando desea utilizar CRUD entre dos fuentes de datos diferentes.

Se requiere definir una acción para una regla CRUD, dependiendo de lo que busca lograr

Update - modificar registros existentes en la tabla de destino
Delete - elimina registros existentes en la tabla de destino
Insert - crea nuevos registros en la tabla de destino
Cram - similar a Insertar pero no fallará si ya existe una clave principal. Lo que significa que solo creará un nuevo registro si la PK no existe en la fuente de datos y omitirá cualquier registro clave duplicado que se encuentre.

Por Defecto¶

Los Objetos predeterminados se utilizan para la información predeterminada que aparece en un campo en la capa UI de una aplicación y también se pueden usar en las capas de datos y lógica empresarial. El objetivo de las reglas predeterminadas es ahorrar tiempo al usuario y brindarle una mejor experiencia. Un ejemplo común es establecer de forma predeterminada un campo Fecha para un nuevo registro agregado hoy.

Gantt¶

Gantt Las reglas comerciales se utilizan para crear la lógica comercial para un diagrama de Gantt que se mostrará en la capa de la interfaz de usuario. La ventaja de crear una regla con tipo Gantt es que puede configurar y organizar cualquier atributo del diagrama de Gantt requerido a nivel de regla definiendo Tipo de uso.

Valores del tipo de uso:

Color
Dependency
End
JSON Options Object
Parent Task
Sort
Start
Task
Task Group

Lista¶

Lista Las reglas comerciales se utilizan para completar listas de selección desde la capa UI en una aplicación. Las reglas de lista no tienen acciones ni validaciones asociadas. El beneficio de crear una regla con tipo Lista es que puede configurar y organizar cualquier atributo de Lista en el nivel de regla definiendo Tipo de uso.

Valores del tipo de uso:

Key
Title
Subtitle

Mapa¶

Mapa Las reglas comerciales se utilizan para crear la lógica comercial para un mapa que se mostrará en la capa de la interfaz de usuario. El beneficio de crear una regla con tipo de mapa es que puede configurar y organizar cualquier atributo de mapa a nivel de regla definiendo Tipo de uso.

Valores del tipo de uso:

Category
Color
JSON Options Object
Value

Migración¶

Migración Las reglas se ejecutan cuando se instala una versión en un nuevo servidor. Se definen como una regla CRUD y se ejecutan en el ambiente de desarrollo. Las reglas de migración permiten a un usuario modificar la base de datos mediante las acciones Actualizar, Insertar, Eliminar o Cram. Estas reglas se agregan a los pasos de Gestión de cambios que se ejecutan en orden al publicar un LP en Vinyl en un nuevo ambiente. Cuando se ejecuta una regla de migración, Vinyl toma una instantánea de la regla y la integra en el conjunto de cambios. La regla de migración se elimina después de ejecutarla como regla de migración. Estas reglas se utilizan principalmente al mover aplicaciones del desarrollo al control de calidad y a la producción.

Gráfico de Red¶

Gráfico de red Las reglas comerciales se utilizan para crear la lógica comercial para mostrar un gráfico de red en la capa de interfaz de usuario de una aplicación. La ventaja de utilizar este tipo de regla es que tiene una columna asociada Tipos de uso apropiados para Network Graph. Cuando use esto en la capa de la interfaz de usuario, los valores se establecerán de forma predeterminada según los tipos de uso.

Notificación¶

Una regla comercial de Notificación permite a Vinyl enviar un mensaje a un usuario. Los mensajes se pueden enviar por Correo, notificaciones automáticas, mensajes de texto o alertas de Vinyl (notificaciones dentro de la aplicación). Las notificaciones admiten archivos adjuntos de cualquier tipo.

Pivote¶

Las reglas dinámicas se utilizan para mostrar una tabla dinámica en una aplicación. Este tipo de regla le permite aplanar una tabla de conjunto de datos. Las reglas dinámicas resumen los datos relacionados que abarcan varias filas y los presentan en una sola fila. Este resultado ayuda a llamar la atención sobre información útil.

Informe¶

Informe Las reglas de negocio le permiten configurar la lógica de negocios sin ningún evento asociado. Este tipo de regla está destinado a diferentes requisitos de informes en la capa de la interfaz de usuario; por ejemplo, podría usarse para un gráfico, un panel de cuadrícula o un pivote.

Alcanzar¶

Alcance Las reglas comerciales le permiten restringir los datos a los que ciertos usuarios tienen acceso en una aplicación. Los usuarios podrán navegar a las mismas páginas, pero los datos que se muestran en cada página se personalizarán para mostrar solo los datos a los que tiene acceso el usuario individual. Podría utilizar Alcance, por ejemplo, si desea proporcionar a un usuario de ventas acceso solo a los datos según su región asignada.

Subconsulta¶

Subconsultas son reglas comerciales que residen dentro de otras reglas comerciales, como objetos comerciales. Las subconsultas por sí solas no están expuestas a la capa de interfaz de usuario de la aplicación y no admiten eventos de lógica empresarial. Por lo general, se utilizan para ajustar datos, realizar lógica y/o cálculos más complejos sobre datos. Al diseñar subconsultas, intente mantener la lógica lo más plana y simple posible.

Validación¶

Las validaciones se utilizan para proteger la integridad de los datos. Se pueden ejecutar con datos ingresados manualmente y evitar que un usuario agregue registros que violen la lógica empresarial (por ejemplo, registros duplicados). Las reglas de validación también se pueden utilizar en la capa de lógica empresarial. Si una regla CRUD se establece como capa empresarial, las validaciones también se ejecutarán cuando se ejecute esa regla CRUD.
Los mensajes de validación presentados a los usuarios son configurables y pueden aprovechar la sustitución dinámica para mejorar la experiencia del usuario.

Visibilidad¶

Visibilidad Las reglas comerciales determinan el estado de un control en la capa de la interfaz de usuario, es decir, qué controles están ocultos, son obligatorios o están disponibles para editar. El valor agregado de una regla de visibilidad es simplificar el diseño de la página y la experiencia del usuario. Estas reglas de tipo solo se pueden configurar para un panel de Formulario.

Gancho Web¶

Se utiliza un Webhook para permitir que cualquier sistema invoque eventos de devolución de llamada personalizados en Vinyl. Un Webhook es una devolución de llamada HTTP definida por el usuario y normalmente se activa mediante un evento. Si se utiliza un Webhook en forma de Correo o mensaje de texto, dependiendo de la respuesta del Usuario, Vinyl responderá en consecuencia invocando el Evento especificado.

XP Basura¶

Se utiliza una regla XP CRUD para crear y ejecutar una regla CRUD en todas las fuentes de datos. Las reglas de tipo XP están diseñadas para permitir que la lógica se ejecute en diferentes fuentes de datos.

Validación de XP¶

Se utiliza una regla de validación de XP para crear y ejecutar reglas de validación en todas las fuentes de datos. Las reglas de tipo XP están diseñadas para permitir que la lógica se ejecute en diferentes fuentes de datos.