Outsystems Add Data To Entity

Añadir datos a una entidad en OutSystems significa guardar información nueva en una tabla de la base de datos. Una entidad en OutSystems es como una tabla en una base de datos. Representa un tipo de dato, como clientes, productos o pedidos.

¿Cómo funciona?

Imagina que tienes una entidad llamada "Clientes". Esta entidad tiene atributos como "Nombre", "Apellido" y "Email". Para añadir un nuevo cliente, necesitas crear un nuevo registro en la entidad "Clientes" con los valores correspondientes para cada atributo.

OutSystems proporciona varias maneras de hacer esto. La más común es utilizando un servidor Action. Un servidor Action es un bloque de código que se ejecuta en el servidor. Dentro de este Action, usas la acción "Create[NombreDeLaEntidad]". Por ejemplo, "CreateCliente".

Pasos básicos:

1. Crear la Entidad: Primero, necesitas tener una entidad. Define los atributos (columnas) que contendrá la entidad. Por ejemplo, "Nombre", "Email", "Teléfono".
2. Crear el Servidor Action: Arrastra un "Server Action" al flujo de tu lógica.
3. Usar la acción "Create": Dentro del Server Action, busca y arrastra la acción "Create[NombreDeLaEntidad]". Por ejemplo, "CreateCliente". Esta acción crea un nuevo registro en la entidad.
4. Asignar valores: La acción "CreateCliente" tendrá parámetros de entrada que corresponden a los atributos de la entidad "Cliente". Debes asignar valores a estos parámetros. Estos valores vendrán de tu formulario, variables, o cualquier otra fuente de datos.
5. Guardar los cambios: Después de asignar los valores, OutSystems guardará automáticamente el nuevo registro en la base de datos cuando el Server Action termine de ejecutarse.

Ejemplo sencillo:

Supongamos que tienes un formulario donde el usuario ingresa su nombre y email. Cuando el usuario presiona el botón "Guardar", se ejecuta un Server Action.

Dentro del Server Action:

• Usas la acción "CreateCliente".
• Asignas el valor del campo "Nombre" del formulario al parámetro "Nombre" de la acción "CreateCliente".
• Asignas el valor del campo "Email" del formulario al parámetro "Email" de la acción "CreateCliente".

Después de esto, OutSystems guarda automáticamente los datos del nuevo cliente en la entidad "Clientes".

Consideraciones importantes:

• Validación: Siempre valida los datos antes de guardarlos en la base de datos. Asegúrate de que el email tenga un formato correcto, que el nombre no esté vacío, etc.
• Manejo de errores: Anticipa posibles errores, como campos obligatorios faltantes o errores de conexión a la base de datos. Implementa lógica para manejar estos errores de manera adecuada.
• Transacciones: Si necesitas realizar múltiples operaciones de base de datos, considera usar una transacción. Una transacción asegura que todas las operaciones se completen con éxito o, en caso de error, se reviertan todas. Esto garantiza la consistencia de los datos.

En resumen, añadir datos a una entidad en OutSystems es un proceso sencillo que te permite guardar información en la base de datos. Usando la acción "Create" dentro de un Server Action, puedes fácilmente agregar nuevos registros a tus entidades. Recuerda siempre validar los datos y manejar posibles errores para asegurar la integridad de tu aplicación.