Saltar para o conteúdo
Verificado

Criar uma app de receção de encomendas

Ligue uma fonte de dados filtrada, valide um formulário antes de guardar e mostre o alerta certo em ambos os casos.

Uma app de receção de encomendas recebe um pedido, verifica-o antes de ser guardado e diz à pessoa se funcionou. Este tutorial constrói essa forma: uma tabela, uma fila que só mostra o que ainda precisa de atenção, um formulário que se recusa a guardar até fazer sentido e dois alertas diferentes consoante o que aconteceu. Conte com cerca de 25 minutos.

O que vai criar

  • Uma tabela Orders com um cliente, um produto, uma quantidade e um estado.
  • Um componente Order Queue (Vista múltipla) cuja fonte de dados está filtrada apenas para encomendas pendentes.
  • Um componente Order Intake (Vista única) com um formulário.
  • Um workflow de gravação que verifica se o formulário está preenchido antes de escrever o que quer que seja, um Alerta de erro quando não está e um Alerta de sucesso quando está.
A continuar a partir do tutorial do CRM

Este tutorial assume a forma de Criar um pequeno CRM: uma tabela, uma lista em Vista múltipla, um formulário em Vista única e um workflow de gravação. Gasta menos tempo nessas bases e mais nas partes que aqui são novas: uma fonte de dados filtrada e um workflow que se ramifica.

Passo 1: Criar a tabela Orders

Adicione a tabela

Na árvore da esquerda, clique com o botão direito em Base de dados, escolha Criar, defina Tipo como Tabela, escolha um Driver de BD e dê-lhe o nome ORD - Orders.

Adicione os campos

No separador Campos, use Adicionar campo para: ORD_Order_Id (String, obrigatório), ORD_Customer_Name (String, obrigatório), ORD_Product (String, obrigatório), ORD_Quantity (Number, obrigatório), ORD_Status (String).

Adicione um índice único

No separador Índices, adicione um índice em ORD_Order_Id e ative Único.

Adicione linhas de exemplo

No separador Dados, adicione duas ou três encomendas à mão com valores diferentes de ORD_Status, para que o passo seguinte tenha algo para filtrar.

Passo 2: Criar a Order Queue com uma fonte de dados filtrada

Adicione o componente

Clique com o botão direito em Programas, Criar, Tipo Componente, Saída Vista múltipla, e dê-lhe o nome Order Queue.

Ligue a fonte de dados com uma Consulta

Abra o separador Fonte de dados, escolha Tabela da BD, selecione ORD - Orders e defina o modo de filtro como Consulta em vez de Índice. Use a vista Criador para adicionar uma regra: ORD_Status igual a Pending. Ao contrário da Contacts List do CRM, que carregava todas as linhas através de um índice, este componente recebe apenas as linhas que correspondem à regra. Consulte Fonte de dados do componente.

Traga os campos e disponha uma linha

No separador Campos, traga ORD_Customer_Name, ORD_Product, ORD_Quantity e ORD_Status como campos de Tabela. No separador Interface, adicione um elemento de linha, selecione-o e ative Ciclo For nas propriedades do elemento para que se repita uma vez por encomenda ainda pendente.

Pré-visualize

Ative a Pré-visualização em direto e confirme que só aparecem as encomendas de exemplo pendentes, não as que marcou com outro estado.

Passo 3: Criar o formulário Order Intake

Adicione o componente

Clique com o botão direito em Programas, Criar, Tipo Componente, Saída Vista única, e dê-lhe o nome Order Intake.

Adicione os seus campos

No separador Campos, adicione ORD_Customer_Name, ORD_Product e ORD_Quantity como campos de Tabela com origem em ORD - Orders. Deixe ORD_Status fora do formulário. É definido pelo workflow no passo seguinte, não escrito pela pessoa que faz a encomenda.

Construa as entradas

No separador Interface, adicione uma entrada para cada um dos três campos, selecione cada uma e use Bind nas propriedades do elemento para a ligar ao seu campo com xu-bind.

Passo 4: Ligar o workflow de gravação, com validação

Adicione um programa Definir Dados

Clique com o botão direito em Programas, Criar, Tipo Definir Dados, e dê-lhe o nome Save Order. Deixe crudMode em C. Na grelha de Campos, associe ORD_Customer_Name, ORD_Product e ORD_Quantity como campos de Tabela, mais ORD_Status também como campo de Tabela, o valor deste último vem do passo do workflow, não do formulário.

Adicione dois programas Alerta

Clique com o botão direito em Programas, Criar, Tipo Alerta, duas vezes: Order Saved (Tipo Sucesso, Visor Toast, Título "Encomenda recebida", Corpo "A encomenda foi guardada.") e deixe o caso inválido para um alerta em linha no próprio workflow, para que não precise de um programa separado. Consulte Alerta.

Comece o workflow do botão Guardar

De volta ao Order Intake, selecione o botão Guardar, abra Fluxos de trabalho e Adicionar ação para construir: Ativar Loader (Utilitários de UI), um Alerta em linha (Utilitários de UI) para o caso inválido, Definir Dados (Base de dados) apontado a Save Order com ORD_Status mapeado para o valor fixo Pending, Chamar Alerta (Utilitários de UI) apontado a Order Saved e depois Desativar Loader.

Torne condicional o Alerta do caso inválido

Clique com o botão direito no passo Alerta em linha e escolha Condição. Defina a sua expressão como verdadeira apenas quando o formulário estiver incompleto, por exemplo um nome de cliente, produto ou quantidade que ainda esteja vazio. Preencha os campos de Alerta em linha: Tipo Erro, Visor Toast, Título "Verifique a encomenda", Corpo "Preencha o cliente, o produto e a quantidade antes de guardar."

Faça do passo Definir Dados a condição oposta

Clique com o botão direito no passo Definir Dados, escolha Condição e defina a sua expressão como verdadeira apenas quando o formulário estiver completo, exatamente o oposto da condição do passo Alerta. Faça o mesmo no passo Chamar Alerta que se segue, para que uma gravação só chegue ao alerta de sucesso quando o Definir Dados foi realmente executado. Consulte Eventos, Workflow para ver o que Condição e Assíncrono controlam num passo.

Teste um ramo de cada vez

Use a caixa de seleção num passo do workflow para o desativar temporariamente. Desative os passos do caminho válido enquanto verifica que o Alerta de erro dispara corretamente com um campo vazio e depois volte a ativá-los.

Passo 5: Transformá-lo numa página

Adicione uma Rota

Clique com o botão direito em Rotas, Criar, e dê-lhe o nome Orders. Adicione um item de menu com o título "Fila" apontado a Order Queue e defina-o como item de menu predefinido, depois um segundo item com o título "Nova encomenda" apontado a Order Intake.

Selecione um elemento "Nova encomenda" na Order Queue e dê-lhe um workflow: Adicionar ação > Navegação > Chamar Página, apontado a Order Intake.

Verifique

Ative a Pré-visualização em direto. Experimente primeiro guardar o formulário Order Intake vazio, confirme que aparece o toast de erro e que nada é escrito. Depois preencha os três campos, guarde, confirme que aparece o toast de sucesso e que a encomenda surge na Order Queue com o estado Pending.