Saltar al contenido
Verificada

Crea una app de entrada de pedidos

Conecta una fuente de datos filtrada, valida un formulario antes de guardarlo y muestra la alerta correcta en cada caso.

Una app de entrada de pedidos recibe una solicitud, la comprueba antes de guardarla y le dice a la persona si funcionó. Este tutorial construye esa estructura: una tabla, una cola que solo muestra lo que aún necesita atención, un formulario que se niega a guardar hasta que tiene sentido, y dos alertas distintas según lo que ocurra. Calcula unos 25 minutos.

Lo que vas a construir

  • Una tabla Orders con un cliente, un producto, una cantidad y un estado.
  • Un componente Order Queue (Vista múltiple) cuya fuente de datos está filtrada para mostrar solo los pedidos pendientes.
  • Un componente Order Intake (Vista única) con un formulario.
  • Un flujo de guardado que comprueba que el formulario está relleno antes de escribir nada, una Alert de error cuando no lo está y una Alert de éxito cuando sí.
Continuación del tutorial del CRM

Este tutorial parte de la estructura de Crea un CRM pequeño: una tabla, una lista de Vista múltiple, un formulario de Vista única y un flujo de guardado. Dedica menos tiempo a esos conceptos básicos y más a lo que aquí es nuevo: una fuente de datos filtrada y un flujo de trabajo que se bifurca.

Paso 1: Crea la tabla Orders

Añade la tabla

En el árbol de la izquierda, haz clic derecho en Base de datos, elige Crear, establece Tipo en Tabla, elige un Controlador DBS y ponle el nombre ORD - Orders.

Añade los campos

En la pestaña Campos, usa Agregar campo para: ORD_Order_Id (String, obligatorio), ORD_Customer_Name (String, obligatorio), ORD_Product (String, obligatorio), ORD_Quantity (Number, obligatorio), ORD_Status (String).

Añade un índice único

En la pestaña Índices, añade un índice sobre ORD_Order_Id y activa Único.

Añade filas de ejemplo

En la pestaña Datos, añade a mano dos o tres pedidos con distintos valores de ORD_Status, para que el siguiente paso tenga algo que filtrar.

Paso 2: Construye la Order Queue con una fuente de datos filtrada

Añade el componente

Haz clic derecho en Programas, Crear, Tipo Componente, Salida Vista múltiple, y ponle el nombre Order Queue.

Conecta la fuente de datos con una consulta

Abre la pestaña Fuente de datos, elige Tabla de BD, selecciona ORD - Orders y establece el modo de filtro en Consulta en lugar de Índice. Usa la vista Constructor para añadir una regla: ORD_Status igual a Pending. A diferencia de la lista de Contacts del CRM, que cargaba todas las filas mediante un índice, este componente recibe solo las filas que cumplen la regla. Consulta Fuente de datos del componente.

Trae los campos y diseña una fila

En la pestaña Campos, trae ORD_Customer_Name, ORD_Product, ORD_Quantity y ORD_Status como campos de Tabla. En la pestaña Interfaz, añade un elemento de fila, selecciónalo y activa Bucle For en las propiedades del elemento para que se repita una vez por cada pedido que siga pendiente.

Previsualízalo

Activa la Vista previa en vivo y confirma que solo aparecen los pedidos de ejemplo pendientes, no los que marcaste con otro estado.

Paso 3: Construye el formulario Order Intake

Añade el componente

Haz clic derecho en Programas, Crear, Tipo Componente, Salida Vista única, y ponle el nombre Order Intake.

Añade sus campos

En la pestaña Campos, añade ORD_Customer_Name, ORD_Product y ORD_Quantity como campos de Tabla con origen en ORD - Orders. Deja ORD_Status fuera del formulario. Lo establece el flujo de trabajo del siguiente paso, no lo escribe la persona que hace el pedido.

Construye las entradas

En la pestaña Interfaz, añade una entrada para cada uno de los tres campos, selecciona cada una y usa Vincular en las propiedades del elemento para conectarla con su campo mediante xu-bind.

Paso 4: Conecta el flujo de guardado, con validación

Añade un programa Set Data

Haz clic derecho en Programas, Crear, Tipo Set Data, y ponle el nombre Save Order. Deja crudMode en C. En su cuadrícula Campos, vincula ORD_Customer_Name, ORD_Product y ORD_Quantity como campos de Tabla, más ORD_Status también como campo de Tabla; el valor de este último viene del paso del flujo de trabajo, no del formulario.

Añade dos programas Alert

Haz clic derecho en Programas, Crear, Tipo Alert, dos veces: Order Saved (Tipo Success, Visualización Toast, Título "Order received", Cuerpo "The order was saved.") y deja el caso no válido para una alerta en línea en el propio flujo de trabajo, de modo que no necesita un programa aparte. Consulta Alert.

Empieza el flujo de trabajo del botón Guardar

De vuelta en Order Intake, selecciona el botón Guardar, abre Flujos de trabajo y usa Agregar acción para construir: Activar indicador de carga (Utilidades de interfaz), una Alert en línea (Utilidades de interfaz) para el caso no válido, Set Data (Base de datos) apuntando a Save Order con ORD_Status asignado al valor fijo Pending, Llamar a una alerta (Utilidades de interfaz) apuntando a Order Saved, y luego Desactivar indicador de carga.

Haz condicional la Alert del caso no válido

Haz clic derecho en el paso Alert en línea y elige Condición. Establece su expresión para que sea verdadera solo cuando el formulario esté incompleto, por ejemplo un nombre de cliente, un producto o una cantidad que sigan vacíos. Rellena en línea sus campos de Alerta: Tipo Error, Visualización Toast, Título "Check the order", Cuerpo "Fill in customer, product and quantity before saving."

Haz que el paso Set Data tenga la condición opuesta

Haz clic derecho en el paso Set Data, elige Condición y establece su expresión para que sea verdadera solo cuando el formulario esté completo, justo lo contrario de la condición del paso Alert. Haz lo mismo con el paso Llamar a una alerta que le sigue, para que un guardado solo llegue a la alerta de éxito cuando Set Data se haya ejecutado de verdad. Consulta Eventos, Flujo de trabajo para ver qué controlan Condición y Async en un paso.

Prueba una rama cada vez

Usa la casilla de un paso del flujo de trabajo para desactivarlo temporalmente. Desactiva los pasos de la ruta válida mientras compruebas que la Alert de error se dispara bien con un campo vacío, y luego vuelve a activarlos.

Paso 5: Conviértelo en una página

Añade una Ruta

Haz clic derecho en Rutas, Crear, y ponle el nombre Orders. Añade un elemento de menú con el título "Queue" que apunte a Order Queue y márcalo como elemento de menú predeterminado, y luego un segundo elemento con el título "New Order" que apunte a Order Intake.

Selecciona un elemento "New order" en Order Queue y dale un flujo de trabajo: Agregar acción > Navegación > Llamar a una página, apuntando a Order Intake.

Compruébalo

Activa la Vista previa en vivo. Prueba primero a guardar el formulario Order Intake vacío, confirma que aparece el toast de error y que no se escribe nada. Después rellena los tres campos, guarda, confirma que aparece el toast de éxito y que el pedido aparece en la Order Queue con estado Pending.