Formulários
Nem toda informação vem de um sensor ou de um sistema automatizado. Às vezes é preciso um toque humano — e é aí que entra o widget de formulário. Pense nele como a sua prancheta digital dentro do IronFlock. Use-o sempre que quiser registrar dados manualmente, por exemplo:
- Registrar quantidades de refugo na linha de produção
- Inserir leituras de um medidor de pH antigo
- Anotar observações de inspeção durante uma ronda pela fábrica
Como os Formulários Funcionam
Quando alguém envia um formulário, os dados são armazenados em uma tabela designada no banco de dados do seu app. Cada campo do formulário corresponde a uma coluna dessa tabela, e todos os campos são salvos juntos como uma nova linha quando o formulário é enviado.
O que você configura no widget de formulário:
- Um título para o formulário
- Um ou mais campos, cada um com um rótulo, um tipo de entrada e a coluna da tabela em que deve gravar
- Regras de validação e valores padrão opcionais por campo
- Textos opcionais para os botões (Button Labels), como Salvar em vez de Submit, e uma página a abrir depois de salvar (Post-Submit Navigation)
Tipos de campo disponíveis: dropdown (seleção em uma lista), texto, número, checkbox e seletor de data/hora.
Organizando os Campos
Por padrão, cada campo ocupa uma linha inteira, um abaixo do outro. Um formulário longo fica mais fácil de preencher quando os campos relacionados ficam lado a lado e são agrupados sob títulos:
- Width: cada campo pode ocupar uma linha inteira, três quartos, dois terços, metade, um terço ou um quarto de uma linha. Os campos preenchem cada linha da esquerda para a direita, e um campo que não cabe mais começa a próxima linha. Defina uma Default Field Width em Field Layout para dar a todos os campos a mesma largura e, depois, altere campos individuais quando necessário.
- Start a New Row: o campo começa uma nova linha, mesmo que ainda coubesse ao lado do anterior.
- Seções: um campo do tipo section adiciona um título com uma dica opcional abaixo dele. Ele agrupa os campos seguintes, até a próxima seção. Sua Field Width in Group define a largura de todos esses campos de uma vez, e sua Conditional Display mostra ou oculta o grupo inteiro, por exemplo configurações que só se aplicam a um tipo de máquina.
- Density: novos formulários começam em Compact, com campos menores para boards de desktop usados com mouse. Escolha Comfortable para os campos maiores, adequados a telas sensíveis ao toque.
O formulário se adapta ao espaço disponível. Em um widget pequeno ou em um celular, os campos se alargam passo a passo até ficarem empilhados em uma única coluna, para que todos continuem legíveis. Minimum Field Width define o quanto um campo pode ficar estreito antes que isso aconteça.
Para Onde Vão os Dados?
Cada envio de formulário adiciona uma nova linha à tabela. Assim você tem o histórico completo de todas as entradas — nada é sobrescrito nem perdido.
Configure todos os campos obrigatórios para que cada nova linha fique completa e consistente.
Acompanhando o Estado Mais Recente
Se você usa formulários para acompanhar o estado atual de máquinas ou ativos — como o resultado de inspeção mais recente por máquina —, o IronFlock pode mostrar apenas a entrada mais recente de cada item. O desenvolvedor do app ativa isso informando à tabela quais colunas identificam uma entidade, por exemplo o nome da máquina.
Com isso configurado, ative a opção latest nas configurações de filtro de um widget, e o widget mostra apenas a linha atual por máquina ou ativo. O IronFlock determina qual é essa linha toda vez que o widget lê a tabela, e cada novo envio substitui a linha do item no board assim que chega, então um envio atrasado ou corrigido nunca deixa um valor desatualizado no board. O histórico completo de envios continua disponível caso você queira consultá-lo.
Em uma tabela assim, um formulário precisa de um campo para as colunas que identificam a entidade e, fora isso, apenas para as colunas que edita. Cada envio mantém o valor atual de toda coluna que o formulário não grava. Os campos do formulário são sempre gravados: um campo numérico esvaziado limpa sua coluna, um campo de texto esvaziado armazena um texto vazio e um campo oculto por uma condição de exibição limpa sua coluna. Um campo com valor padrão grava esse valor em vez de deixar a coluna vazia.
Editando um Registro a partir de uma Tabela
Para permitir que os usuários abram um registro existente e o alterem, combine uma tabela com um formulário na mesma página:
- Dê à tabela uma coluna do tipo Edit button, vinculada à coluna que identifica o registro, como o nome da máquina, e defina sua URL Parameter Key, por exemplo
edit. Cada linha passa a mostrar um ícone de lápis. Um clique grava a chave da linha na URL da página (?edit=press-1), do mesmo modo que um widget de filtro define seu parâmetro. - Adicione um formulário à mesma página, ative seu Form Open Button e defina Open on URL parameter com o mesmo nome. Em um board o formulário não mostra botão próprio: ele abre como um diálogo assim que a URL contém o parâmetro e fecha novamente quando o usuário salva ou cancela, o que remove o parâmetro da URL.
- Vincule o Pre-filled Value de cada campo à coluna do registro, com um filtro na coluna identificadora cujo valor vem do parâmetro de filtro
edit, e com a chave Latest ligada. O campo que grava a coluna identificadora é um Hidden Field com a mesma vinculação, para que o salvamento vá para o mesmo registro. Como na seção anterior, cada coluna que o formulário não grava mantém seu valor.
O diálogo mostra uma barra de progresso até que os valores do registro cheguem. Com a chave latest ligada, a tabela mostra a alteração salva no instante em que é armazenada. Uma URL salva como favorito com o parâmetro abre o diálogo imediatamente, e o botão voltar do navegador o fecha.
Um formulário separado com seu próprio botão de abertura continua criando novos registros. Fora de um board, na pré-visualização do editor de widgets, o formulário mantém seu botão para que você possa experimentá-lo.
Excluindo Dados
O IronFlock também usa uma abordagem somente de acréscimo para exclusões. Em vez de remover uma linha, um formulário envia uma nova entrada que marca o registro como excluído na coluna deleted da tabela, uma coluna booleana que o desenvolvedor do app adiciona à tabela. Não há um botão de exclusão especial para isso: um formulário de exclusão é um formulário cujo botão de envio diz Excluir.
Para permitir que os usuários excluam um registro a partir de uma tabela, com uma confirmação:
- Dê à tabela uma segunda coluna do tipo Edit button, vinculada à coluna que identifica o registro, com o URL Parameter Key
deletee o Icondelete. - Adicione um formulário à mesma página, ative seu Form Open Button, defina Open on URL parameter como
deletee dê a ele um título como “Excluir este registro?”. Em Button Labels, defina o Submit Label comoExcluire o Cancel Label comoManter, e escolha uma Highlight Color vermelha. - Dê ao formulário exatamente dois campos, ambos com Hidden Field ligado: um que escreve a coluna de identificação, com seu Pre-filled Value vinculado como no formulário de edição acima, mas filtrado pelo parâmetro
delete, e uma caixa de seleção que escreve a colunadeleted, com seu Default Value ligado.
Um clique no ícone de exclusão de uma linha abre o diálogo, e Excluir salva a chave do registro com deleted como true. Para excluir um registro na sua própria página de detalhes, coloque o mesmo formulário lá e defina sua Post-Submit Navigation como a página da lista, por exemplo /machines.
Os widgets que listam os registros combinam a chave latest com um filtro na coluna deleted (deleted está vazio ou é false). Um registro excluído desaparece do board no instante em que a entrada chega e permanece no banco de dados para histórico e auditoria. Nenhuma view ou transformação é necessária para isso; veja Exclusão Lógica de Registros. Para que um formulário de edição restaure um registro excluído, dê a ele uma caixa de seleção oculta na coluna deleted cujo Default Value esteja desligado.
Formulários criados com uma versão do widget de formulário anterior à 2.0 têm as configurações Show Delete Button e Delete-Flag Column. A versão 2.0 não as tem mais: ao mudar um formulário desses para a versão 2.0 ou posterior, refaça a exclusão dele como descrito aqui.
Resumo
Com o widget de formulário você tem:
- Entrada manual de dados fácil, diretamente no board
- Histórico automático de cada envio
- Padrões claros para mostrar o estado atual e ocultar registros excluídos
- Edição de registros existentes a partir de uma tabela, em um diálogo na mesma página
Tudo sem sair do seu board do IronFlock.