Saltar al contenido
Verificada

Crea un CRM pequeño

Modela contactos, lístalos y edítalos, y guarda los cambios mediante un flujo de trabajo, todo dentro de un único proyecto de Studio.

Un CRM necesita tres cosas: un lugar donde guardar los contactos, una pantalla para verlos y una forma de añadir y editar uno. Esta guía recorre las tres en Studio, desde un proyecto vacío hasta una lista de Contactos funcional con un flujo de guardado. Calcula unos 25 minutos.

Lo que vas a construir

  • Una tabla Contacts con nombre, correo, teléfono y empresa.
  • Un componente Contacts List (Vista múltiple) que lee la tabla.
  • Un componente Contact Form (Vista única) que crea un contacto.
  • Un programa Set Data y un programa Alert detrás del botón Guardar del formulario.
  • Una Ruta que hace que la lista se pueda abrir como página.
Prefieres describirlo

Todo lo de abajo también se puede escribir como prompt: "A CRM with a table for contacts and a screen that lists them" te da una primera versión que ajustar. Consulta Empezar un proyecto. Este tutorial construye la misma estructura a mano, una pestaña cada vez.

Paso 1: Crea la tabla Contacts

Añade la tabla

En el árbol de la izquierda, haz clic derecho en Base de datos y elige Crear. Establece Tipo en Tabla, elige un Controlador DBS (un proyecto en borrador usa automáticamente su propia base de datos integrada) y ponle el nombre CNT - Contacts.

Añade los campos

Abre la pestaña Campos de la tabla y usa Agregar campo para cada columna: CNT_Contact_Id (String, obligatorio), CNT_Name (String, obligatorio), CNT_Email (String), CNT_Phone (String), CNT_Company (String). El prefijo CNT_ mantiene estas columnas sin ambigüedad cuando otras tablas compartan el proyecto.

Añade un índice único

En la pestaña Índices, añade un índice sobre CNT_Contact_Id y activa Único. El Contact Form lo necesita para localizar una fila exacta más adelante.

Añade una fila de ejemplo

Cambia a la pestaña Datos y añade un contacto con valores reales, para que la lista tenga algo que mostrar cuando se conecte.

Paso 2: Construye la lista de Contacts

Añade el componente

Haz clic derecho en Programas y elige Crear. Establece Tipo en Componente, Salida en Vista múltiple y ponle el nombre Contacts List.

Conecta la fuente de datos

Abre la pestaña Fuente de datos, elige Tabla de BD, selecciona CNT - Contacts y establece el modo de filtro en Índice para que la pantalla cargue todos los contactos.

Trae los campos

Abre la pestaña Campos. Con la tabla conectada, Studio sugiere CNT_Name, CNT_Email, CNT_Phone y CNT_Company directamente desde la tabla; empieza por esos campos de Tabla en lugar de recrear las columnas a mano.

Diseña la fila

Abre la pestaña Interfaz. Usa la herramienta Elementos de interfaz o Etiqueta de la barra de herramientas Insertar para añadir una tarjeta o una fila, luego selecciónala y activa Bucle For en las propiedades del elemento para que se repita una vez por contacto. Vincula dentro de ella el nombre, el correo y el teléfono con los campos correspondientes.

Previsualízalo

Usa el botón de reproducir de la barra de herramientas de vista previa de la interfaz para activar la Vista previa en vivo y confirma que aparece el contacto de ejemplo. Consulta Vista previa en vivo y consola.

Paso 3: Construye el Contact Form

Añade el componente

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

Añade sus campos

En la pestaña Campos, añade CNT_Name, CNT_Email, CNT_Phone y CNT_Company como campos de Tabla con origen en CNT - Contacts.

Construye las entradas

En la pestaña Interfaz, añade una entrada para cada campo y luego selecciona cada una para abrir las propiedades del elemento. Usa Vincular para conectar la entrada con su campo mediante xu-bind, de modo que al escribir se actualice el campo.

Paso 4: Conecta el flujo de guardado

Añade un programa Set Data

Haz clic derecho en Programas, Crear, Tipo Set Data, y ponle el nombre Save Contact. Deja crudMode en C para crear una fila nueva. En su cuadrícula Campos, vincula CNT_Name, CNT_Email, CNT_Phone y CNT_Company como campos de Tabla, igual que en la propia tabla.

Añade un programa Alert

Haz clic derecho en Programas, Crear, Tipo Alert, y ponle el nombre Contact Saved. En su pestaña Alerta establece Tipo en Success, Visualización en Toast, Título en "Saved" y Cuerpo en "Contact saved."

Conecta el botón Guardar

De vuelta en el Contact Form, selecciona el botón Guardar en la pestaña Interfaz y abre Flujos de trabajo en las propiedades del elemento. Usa Agregar acción para construir: Activar indicador de carga (Utilidades de interfaz), Set Data (Base de datos) apuntando a Save Contact con cada parámetro asignado al campo del formulario correspondiente, Llamar a una alerta (Utilidades de interfaz) apuntando a Contact Saved, y luego Desactivar indicador de carga. Es la misma estructura que el patrón de guardado del propio catálogo de flujos de trabajo: Activar indicador de carga, Set Data, Alert, Desactivar indicador de carga.

Evita una alerta bloqueante en la vista previa

Una visualización tipo toast es segura en la Vista previa en vivo. Una visualización modal o browser puede aparecer en cambio como un alert() nativo bloqueante dentro de una sesión de vista previa. Consulta Alert.

Paso 5: Conviértelo en una página

Añade una Ruta

Haz clic derecho en Rutas, Crear, y ponle el nombre CRM. En el editor de Rutas, añade un elemento de menú con el título "Contacts" que apunte al componente Contacts List, y márcalo como elemento de menú predeterminado.

Abre el formulario desde la lista

Selecciona un elemento "Add contact" en Contacts List y dale un flujo de trabajo: Agregar acción > Navegación > Llamar a un modal, apuntando a Contact Form.

Compruébalo

Activa la Vista previa en vivo, conecta la consola a la sesión en ejecución, añade un contacto mediante el formulario y confirma que aparece en la lista sin actualizar manualmente. Consulta Vista previa en vivo y consola.