Acción de Entidad
Permite realizar operaciones sobre las instancias de una entidad.
Entidad
Permite seleccionar la entidad sobre la que se realiza la operación.
Operación
Permite seleccionar la operación a ejecutar sobre la entidad.
Valores Posibles
•Crear: crea una nueva instancia de la entidad seleccionada.
•Modificar: actualiza una instancia existente de la entidad seleccionada.
•Eliminar: elimina una instancia de la entidad seleccionada.
Parámetros
Los parámetros de una acción previa pueden ser de entrada o de salida.
Parámetros de entrada
Permiten definir los valores que se envían a la operación seleccionada. En la tabla de parámetros se identifican mediante el ícono 
.
Orígen del valor
Valores Posibles
•Vacío: no envía ningún valor para la persistencia del campo.
•Valor: utiliza un valor fijo definido en la ventana de configuración.
•Parámetros y Variables: utiliza el valor de un parámetro o una variable del objeto.
•Elemento: utiliza el valor de un campo del objeto cuyo tipo coincide con el del campo de la entidad.
Parámetros de salida
Permiten almacenar los valores devueltos por la operación para utilizarlos en acciones posteriores. En la tabla de parámetros se identifican mediante el ícono 
.
Cada operación dispone de su propio conjunto de parámetros de salida.
Orígen del valor
Valores Posibles
•Vacío: ignora el valor devuelto por el parámetro de salida.
•Variables: asigna el valor del parámetro de salida a una variable del objeto.
•Elementos: asigna el valor del parámetro de salida a un campo del objeto.
Los valores obtenidos quedan disponibles para los hipervínculos y las acciones posteriores.
Los parámetros disponibles dependen de la operación seleccionada, Crear, Modificar o Eliminar.
Al seleccionar la operación Crear, se muestran los campos de la entidad necesarios para definir los valores de la nueva instancia.
Además, se encuentran disponibles los siguientes parámetros de salida:
•idInstance: devuelve el identificador de la instancia creada y permite asignarlo a un campo o variable del objeto.
•dtLastUpdate: devuelve la fecha de última modificación de la instancia creada y permite asignarla a un campo o variable del objeto.
Al seleccionar la operación Modificar, se muestran los campos de la entidad que permiten actualizar los valores de una instancia existente.
Además, se encuentran disponibles los siguientes parámetros:
•idInstance (Entrada): indica el identificador de la instancia que se modifica.
•dtLastUpdate (At Read) (Entrada): indica la fecha de última modificación de la instancia que se modifica.
•dtLastUpdate (Salida): devuelve la fecha de última modificación de la instancia actualizada y permite asignarla a un campo o variable del objeto.
Al seleccionar la operación Eliminar, se encuentra disponible el siguiente parámetro:
•idInstance (Entrada): indica el identificador de la instancia que se elimina.
Al ejecutar la acción, el sistema elimina la instancia correspondiente al identificador indicado.
En las operaciones de creación y modificación, los campos de estructuras iterativas solo admiten valores de campos pertenecientes a repetidores o tablas. La correspondencia entre los elementos se realiza según su índice.
Ejemplos de Uso
Estos son algunos ejemplos de uso de acciones previas, utilizando las operaciones de una entidad: Crear, Modificar y Eliminar.
Caso 1: Dar de Alta un Cliente Nuevo — Operación: Crear
•El escenario: El usuario ingresa a una página con los campos vacíos. Completa el nombre y el teléfono del cliente y hace clic en el hipervínculo de guardado.
•Qué hace la acción previa: Está configurada como Entidad, con la operación Crear.
•Parámetros de entrada: La acción previa toma los valores ingresados en la página, en este caso nombre y teléfono, y los utiliza para crear una nueva instancia de la entidad.
•Parámetros de salida: Al crearse la instancia, se genera un ID único. La acción previa devuelve el idInstance (por ejemplo, el ID #105) y el dtLastUpdate. Estos valores pueden almacenarse en variables para utilizarlos posteriormente, por ejemplo, para mostrar un mensaje de éxito o identificar la instancia recién creada.
•Navegación: Una vez finalizada correctamente la creación, se ejecuta el hipervínculo y se navega hacia la página configurada.
Caso 2: Editar un Cliente Existente — Operación: Modificar
•El escenario: El usuario hace clic sobre una fila de la grilla, lo que lo lleva a una página con los datos de esa instancia, por ejemplo, el cliente #105. Allí modifica su número de teléfono y presiona el hipervínculo para guardar los cambios.
•Qué hace la acción previa: Está configurada como Entidad, con la operación Modificar.
•Parámetros de entrada: Para modificar una instancia existente es obligatorio informar el idInstance (en este caso, #105) y el dtLastUpdate (At Read). El idInstance permite identificar qué instancia se desea modificar, mientras que dtLastUpdate (At Read) permite validar que la instancia no haya sido modificada desde que el usuario la leyó.
•Datos a modificar: Además de estos identificadores, se envían los valores que hayan sido modificados por el usuario, por ejemplo, el nuevo número de teléfono.
•Navegación: Una vez modificada correctamente la instancia #105, se ejecuta el hipervínculo y se navega nuevamente hacia la página configurada.
Caso 3: Eliminar un Cliente — Operación: Eliminar
•El escenario: Dentro de la misma página que muestra los datos del cliente #105, el usuario hace clic en el hipervínculo para eliminarlo.
•Qué hace la acción previa: Está configurada como Entidad, con la operación Eliminar.
•Parámetros de entrada: La operación requiere el idInstance, que permite identificar la instancia que se desea eliminar. En este caso, se informa el ID #105.
•Resultado: La Acción Previa elimina la instancia correspondiente al idInstance recibido.
•Navegación: Una vez finalizada correctamente la eliminación, se ejecuta el hipervínculo y se navega hacia la página configurada.
