Saltar para o conteúdo
Verificado

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.
Prefere descrever em vez disso

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.

Evite um alerta bloqueante na pré-visualização

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.