Criar um pequeno CRM
Modele contactos, liste-os e edite-os, e guarde as alterações através de um workflow, tudo dentro de um projeto Studio.
Um CRM precisa de três coisas: um sítio onde guardar contactos, um ecrã para os ver e uma forma de adicionar e editar um. Este guia percorre as três no Studio, desde um projeto vazio até uma lista de Contactos funcional com um workflow de gravação. Conte com cerca de 25 minutos.
O que vai criar
- Uma tabela Contacts com nome, e-mail, telefone e empresa.
- Um componente Contacts List (Vista múltipla) que lê a tabela.
- Um componente Contact Form (Vista única) que cria um contacto.
- Um programa Definir Dados e um programa Alerta por trás do botão Guardar do formulário.
- Uma Rota que torna a lista abrível como página.
Tudo o que se segue também pode ser escrito como um pedido: "A CRM with a table for contacts and a screen that lists them" dá-lhe uma primeira versão para ajustar. Consulte Iniciar um projeto. Este tutorial constrói a mesma forma à mão, um separador de cada vez.
Passo 1: Criar a tabela Contacts
Adicione a tabela
Na árvore da esquerda, clique com o botão direito em Base de dados e escolha Criar. Defina
Tipo como Tabela, escolha um Driver de BD (um projeto em rascunho usa automaticamente a
sua própria base de dados integrada) e dê-lhe o nome CNT - Contacts.
Adicione os campos
Abra o separador Campos da tabela e use Adicionar campo para cada coluna: CNT_Contact_Id
(String, obrigatório), CNT_Name (String, obrigatório), CNT_Email (String), CNT_Phone (String),
CNT_Company (String). O prefixo CNT_ mantém estas colunas inequívocas quando outras tabelas
partilharem o projeto.
Adicione um índice único
No separador Índices, adicione um índice em CNT_Contact_Id e ative Único. O Contact Form
precisa disto para localizar uma linha exata mais tarde.
Adicione uma linha de exemplo
Mude para o separador Dados e adicione um contacto com valores reais, para que a lista tenha algo para mostrar quando estiver ligada.
Passo 2: Criar a Contacts List
Adicione o componente
Clique com o botão direito em Programas e escolha Criar. Defina Tipo como Componente,
Saída como Vista múltipla e dê-lhe o nome Contacts List.
Ligue a fonte de dados
Abra o separador Fonte de dados, escolha Tabela da BD, selecione CNT - Contacts e defina o
modo de filtro como Índice para que o ecrã carregue todos os contactos.
Traga os campos
Abra o separador Campos. Com a tabela ligada, o Studio sugere CNT_Name, CNT_Email, CNT_Phone
e CNT_Company diretamente a partir da tabela, comece por esses campos de Tabela em vez de
recriar as colunas à mão.
Disponha a linha
Abra o separador Interface. Use a ferramenta Elementos de interface ou Etiqueta da barra Inserir para adicionar um cartão ou uma linha, depois selecione-o e ative Ciclo For nas propriedades do elemento para que se repita uma vez por contacto. Associe-lhe o nome, o e-mail e o telefone, aos campos correspondentes.
Pré-visualize
Use o botão de reprodução na barra de pré-visualização da interface para ativar a Pré-visualização em direto e confirme que o contacto de exemplo aparece. Consulte Pré-visualização em direto e consola.
Passo 3: Criar o Contact Form
Adicione o componente
Clique com o botão direito em Programas, Criar, Tipo Componente, Saída Vista única, e
dê-lhe o nome Contact Form.
Adicione os seus campos
No separador Campos, adicione CNT_Name, CNT_Email, CNT_Phone e CNT_Company como campos de
Tabela com origem em CNT - Contacts.
Construa as entradas
No separador Interface, adicione uma entrada para cada campo e depois selecione cada uma para abrir
as propriedades do elemento. Use Bind para ligar a entrada ao seu campo com xu-bind, de modo que
escrever atualize o campo.
Passo 4: Ligar o workflow de gravação
Adicione um programa Definir Dados
Clique com o botão direito em Programas, Criar, Tipo Definir Dados, e dê-lhe o nome
Save Contact. Deixe crudMode em C para criar uma nova linha. Na grelha de Campos,
associe CNT_Name, CNT_Email, CNT_Phone e CNT_Company como campos de Tabela, tal como na
própria tabela.
Adicione um programa Alerta
Clique com o botão direito em Programas, Criar, Tipo Alerta, e dê-lhe o nome
Contact Saved. No separador Alerta, defina Tipo como Sucesso, Visor como Toast,
Título como "Guardado" e Corpo como "Contacto guardado."
Ligue o botão Guardar
De volta ao Contact Form, selecione o botão Guardar no separador Interface e abra Fluxos de
trabalho nas propriedades do elemento. Use Adicionar ação para construir: Ativar Loader
(Utilitários de UI), Definir Dados (Base de dados) apontado a Save Contact com cada parâmetro
mapeado para o campo correspondente do formulário, Chamar Alerta (Utilitários de UI) apontado a
Contact Saved e depois Desativar Loader. É a mesma forma do padrão de gravação do próprio
catálogo de workflows: Ativar Loader, Definir Dados, Alerta, Desativar Loader.
Uma apresentação em toast é segura na Pré-visualização em direto. Uma apresentação modal ou
browser pode surgir como um alert() nativo bloqueante dentro de uma sessão de pré-visualização.
Consulte Alerta.
Passo 5: Transformá-lo numa página
Adicione uma Rota
Clique com o botão direito em Rotas, Criar, e dê-lhe o nome CRM. No editor de Rotas,
adicione um item de menu com o título "Contactos" apontado ao componente Contacts List e defina-o
como item de menu predefinido.
Abra o formulário a partir da lista
Selecione um elemento "Adicionar contacto" na Contacts List e dê-lhe um workflow: Adicionar ação >
Navegação > Chamar Modal, apontado a Contact Form.
Verifique
Ative a Pré-visualização em direto, ligue a consola à sessão em execução, adicione um contacto através do formulário e confirme que aparece na lista sem uma atualização manual. Consulte Pré-visualização em direto e consola.