Introducción a App Builder - Lección 2: Agregar datos a tu aplicación

Esta es la segunda lección de la serie de tutoriales Introducción a App Builder.

Crear una tabla

Para comenzar, irás a la capa de datos y crearás una tabla para la aplicación Northwinds. Como estás creando una aplicación simple de cumplimiento de pedidos, crearás una tabla para ayudar a diferenciar entre los mercados de la Costa Oeste y la Costa Este.

1. Selecciona Cajón de acción > App Workbench.

2. Ve a la pestaña Tablas y haz clic en el botón + Tabla. Se abre la página de Definición de tabla:

   

   Nota

   También se puede encontrar un botón + Tabla en la página de inicio de App Workbench.

3. En el panel Tabla, ingresa Región en el campo Nombre.

   Nota

   De acuerdo con las convenciones de nomenclatura de App Builder, los nombres de las tablas siempre deben ser singulares.

4. (Opcional) En el campo Ayuda técnica, ingresa una descripción del propósito de esta tabla. Esta información no será visible para los usuarios finales; está destinada a ayudar a otros desarrolladores.

5. Haz clic en Guardar. Después de unos momentos, la tabla será creada y podrás editarla.

6. Si miras en el panel Columnas, verás que tu tabla ya tiene una columna. Se llama RegionID, y App Builder la creó automáticamente. Ha sido designada como la Clave primaria de la tabla, lo que significa que será un identificador único para los registros en la tabla. Su Tipo de dato se ha establecido en UUID, lo que significa que se genera automáticamente una cadena única de 128 bits de caracteres para esta columna.

7. La columna RegionID será utilizada por App Builder, pero no es legible para los humanos. Necesitamos crear una columna amigable para el usuario que identifique los registros en la tabla Región. Estas columnas que están destinadas a ser utilizadas como identificadores por los usuarios finales se llaman columnas de título. Pueden ser creadas automáticamente o manualmente.

8. Para agregar la columna de título manualmente:

   1.  Haz clic en el botón **+ Columna**. Se abrirá el diálogo de **Columna**:
   
       ![Diálogo de columna](/_download/images/app-builder/manuals/column-dialog.png){style="width: 500px"}
   
   2.  En el campo **Nombre**, ingresa `Región`.
   
   3.  En la sección de **Tipos de Datos**, selecciona **Cadena** en el menú **Lógico**. Al hacer esto, el menú **Físico** debería seleccionar automáticamente **NVarchar**, pero si no lo hace, selecciónalo manualmente.
   
   4.  En la sección de **Avanzado**, el campo **Tipo de Uso de Columna** ayuda a señalar el uso previsto de una columna dada, lo que puede acelerar los pasos posteriores del proceso de desarrollo de la aplicación. Es probable que App Builder ya haya detectado que estás creando un identificador amigable y haya seleccionado automáticamente **Título** en este campo, pero puedes hacerlo manualmente si no lo ha hecho. Haz clic en **Guardar**.
   

9. Para agregar la columna de título automáticamente:

   1.  Haz clic en el botón **+ Título**. App Builder pedirá confirmación de que estás intentando crear una columna de título. Haz clic en **Proceder**.
   
   2.  App Builder creará y configurará automáticamente la columna de título. Ten en cuenta que el botón **+ Título** desaparece una vez que se ha creado una columna de título.
   

Ahora que tu tabla tiene las columnas que necesitaremos por ahora, tu panel de Columnas debería verse similar a esto:

Tu nueva tabla aún no contiene registros, pero la estructura subyacente está lista para recibir algunos. La columna RegionID contendrá un identificador único que App Builder utilizará, y la columna Región contendrá un nombre legible para humanos.

Agregar registros

Ahora que tienes una nueva tabla lista para contener registros, agreguemos los dos que nos ayudarán a diferenciar entre las diferentes áreas donde se encuentran nuestros clientes:

1. En el panel de Tabla, haz clic en el botón Resultados. Se abrirá la página Dinámica.

2. Haz clic en Crear. Aparecerá un campo donde puedes escribir información. Para guardar, haz clic en el ícono de marca de verificación . Recuerda que solo debes escribir en el campo Región, ya que el campo RegionID se creará automáticamente por App Builder.

3. Crea dos registros: Región de la Costa Oeste y Región de la Costa Este. Cuando termines, la página Dinámica debería verse así:

   

Eso es todo, los dos registros han sido almacenados y podremos usarlos en las próximas lecciones.

Auditoría lite

Una buena práctica recomendada por Jitterbit es siempre agregar información de auditoría a las tablas en tu capa de datos. Para facilitar esto, App Builder ofrece una función llamada Auditoría lite, con la cual puedes hacer que tus tablas sean auditables fácilmente. Usaremos la función Auditoría lite en todas las tablas de nuestra base de datos Northwinds.

1. En la pestaña App Workbench > Tablas, selecciona cualquiera de tus tablas.

2. En el panel de Tabla, en la sección de Aceleradores, haz clic en Mejorar Tabla, luego en Proceder. App Builder creará automáticamente las siguientes columnas:

   1. AgregadoPor: El nombre de usuario de la persona que agregó un registro.

   2. AgregadoEl: La fecha en que se agregó un registro.

   3. CambiadoPor: El nombre de usuario de la última persona que modificó un registro.

   4. CambiadoEl: La fecha en que se modificó por última vez un registro.

   5. EsActivo: Indica si un registro está actualmente activo o no.

   Por ejemplo, así es como debería verse la tabla Categoría después de que se hayan agregado las columnas de auditoría:

   

Repite estos pasos para todas las demás tablas en la base de datos Northwinds. Utilizar Auditoría lite en tus tablas es una buena práctica que Jitterbit recomienda encarecidamente.

Seleccionable por el Usuario

La columna IsActive creada por Audit lite se asigna automáticamente al tipo de uso de columna User Selectable. Este tipo de uso determina si una fila dada está disponible para selección en controles de lista. Se utiliza típicamente para filtrar registros inactivos, de modo que los usuarios solo vean opciones activas al editar o crear registros.

Revisión y conclusión

Revisemos lo que hemos hecho en esta lección. Comenzamos con una aplicación recién creada conectada a una fuente de datos. Luego, agregamos una nueva tabla a ella, que utilizaremos junto con las otras tablas que ya estaban allí. Una vez que nuestra nueva tabla estuvo configurada y lista para recibir registros, agregamos algunos.

Ahora estamos listos para pasar a la siguiente capa del desarrollo de aplicaciones, la capa de negocio. Ve a Lección 3: Crear reglas.