< Anterior | Siguiente >

Lección 1.5: Programar el botón Someter

Cuando se somete el formulario de entrada, la página añade automáticamente un registro nuevo a la base de datos. En esta lección, programará el botón Publicar listado nuevo para que vuelva a la página all_records.jsp de forma que se pueda ver inmediatamente el registro nuevo en la base de datos.

Para programa el botón de someter:

  1. En el archivo new_record.jsp pulse el botón derecho sobre el botón Publicar listado nuevo creado en la página Web y seleccione Propiedades.
  2. Pulse Añadir regla. Se abre la ventana Añadir regla de navegación.
  3. En el menú desplegable Página, seleccione all_records.jsp y pulse Aceptar.
  4. Guarde la página. Si desea añadir un registro a la base de datos para verificar que volverá a la página all_records.jsp, ejecute new_record.jsp en el servidor de prueba.
Evitar claves duplicadas
Importante:

Como la columna ID es una clave primaria de la tabla ADS, no puede añadir registros con un valor ID que ya exista en la tabla. En el Módulo 2 se verá cómo utilizar la generación automática de claves para crear automáticamente una clave nueva sin utilizar para cada registro nuevo.

Hasta entonces, en esta página hay que entrar un número de ID sin utilizar para añadir un registro nuevo. Los registros que vienen en la base de datos utilizan números de ID del 1 al 24, de forma que puede utilizar cualquier número superior a 24 como clave primaria. Asegúrese de no duplicar claves, si entra más de un registro.

Enlace de la entrada con un registro relacional (opcional)

El formulario de entrada de la página es un conjunto de campos de entrada de JavaServer Faces que se han enlazado al registro relacional que ha creado. Recuerde que el registro relacional se creó para representar un registro nuevo en la tabla ADS de la base de datos. El Enlace es un método mediante el cual se puede enlazar un componente de entrada de JavaServer Faces a una columna del registro relacional.

Cuando se crea el registro relacional, el asistente enlaza automáticamente todas sus columnas a los campos de entrada de la página. Si quiere hacer cambios manuales, puede enlazar las columnas a otros campos de entrada. Para enlazar una columna del registro relacional con un campo de entrada, arrastre la columna de la vista Datos de página sobre el campo. Este proceso se puede probar suprimiendo y volviendo a crear el campo de entrada Descripción del formulario.

La vista Datos de página suele estar en la esquina inferior izquierda del entorno de trabajo. Si no la encuentra, acceda a la barra de menús y pulse Ventana > Mostrar vista > Datos de página. Por lo general, la vista Datos de páginas sólo se utiliza cuando se crean páginas Web dinámicas.

La vista Datos de página almacena conexiones a orígenes de datos, como bases de datos en forma de objetos de datos, como registros relacionales o listas de registros relaciones. Estos objetos de datos (o cualquier componente de la página) no representan el origen de datos en sí mismo. Estos objetos de datos representan una conexión entre el proyecto y el origen de datos. Una vez creada esta conexión, puede arrastrar un objeto de datos de la vista Datos de página sobre una página Web para completar la conexión y visualizar información del origen de datos en la página Web. Por ejemplo, a continuación se muestra un gráfico de la vista Datos de página que muestra una lista de registros relacionales creada durante esta guía de aprendizaje:

Vista Datos de página.

En este gráfico se puede ver la lista de registros relacionales all_recordlist (ADS) seguida de todas las columnas de dicha lista. Una vez que se ha definido este objeto de datos en la vista Datos de página, puede arrastrar dichas columnas sobre componentes de entrada de la página Web tantas veces como quiera, sin tener que volver a conectar la base de datos.

Por ejemplo, si quiere mostrar el valor de la columna DESCRIPTION en una página web, antes debe arrastrar un campo de salida de texto sobre la página y a continuación arrastrar la columna DESCRIPTION de la vista Datos de página sobre dicho campo de salida de texto. Esto se denomina enlace de una columna con un campo de salida.

Si quisiera que el usuario entrara un valor nuevo para la columna DESCRIPTION de la base de datos, puede arrastrar un campo de entrada de texto sobre la página. A continuación, arrastre la columna DESCRIPTION sobre dicho campo de entrada de texto.

Los pasos siguientes se proporcionan para ilustrar el concepto del campo de entrada y el proceso de enlace; no obstante, la consecución de estos pasos es opcional en esta guía de aprendizaje. Si no desea hacerlo, pase a la lección siguiente.

  1. En el archivo new_record.jsp, pulse sobre el campo de entrada Descripción. Pulse la tecla Suprimir.
  2. En la vista Paleta, pulse en la bandeja Componentes Faces ampliados para expandirla.
  3. Arrastre un componente Entrada de la paleta a la celda que contiene el campo de entrada Descripción que acaba de suprimir. Ahora hay un campo de entrada en esta celda, pero no hay texto como {ID} o {TITLE} dentro de él, ya que este campo de entrada no está enlazado a ninguna columna.
  4. En la vista Datos de página, pulse para expandir Registros relacionales > create_record (Service Data Object) > create_record (ADS) y arrastre la columna DESCRIPTION al componente Entrada que acaba de crear. El texto dentro del componente Entrada cambia para indicar que ahora está enlazado con la columna DESCRIPTION, como en este gráfico:
    Vista Datos de página.
  5. Guarde el archivo y, si lo desea, ejecute la página en el servidor de prueba.

Punto de comprobación de lección

Ha terminado la Lección 1.5. En esta lección ha aprendido a programar un botón de mandato y a enlazar datos a un campo de entrada arrastrando y soltando un widget de la paleta a una página Web.

< Anterior | Siguiente >