Entrada de Dados
1. Entrada de Dados
A entrada de dados permite que os usuários editem dados diretamente em componentes de tabelas.
1.1. Configuração
Ativação: Para habilitar a entrada de dados na tabela, acesse o menu de configurações do componente, na VIEW, navegue até o dado (coluna) que deseja habilitar a entrada de dados, clique nos três pontinhos do dado e ative a opção de entrada de dados. Assim, essa coluna permitirá ao usuário, a inserção de dados.
Indicação Visual:
Sem Entrada de Dados: Quando a entrada de dados não está ativada, as células da tabela são exibidas com uma aparência padrão.
Entrada de Dados Ativada, Sem Salvamento: Quando a entrada de dados é ativada e os dados são editados mas não salvos, as células são destacadas com uma cor diferente (um rosa mais forte), indicando que há alterações pendentes de salvamento.
Entrada de Dados Ativada, Dados Salvos: Após os dados serem salvos, as células retornam a uma aparência de dados salvos (rosa claro), indicando que as informações foram persistidas no banco de dados.
1.2. Critério de Uso para a Funcionalidade de Entrada de Dados
Essa funcionalidade é regulada por um critério essencial: o nível de detalhamento da tabela. A entrada de dados é automaticamente bloqueada se a tabela não estiver no nível de detalhamento mais específico, para garantir a precisão e a integridade das informações.
1.2.1. Nível de Detalhamento
Mais Específico: A entrada de dados é permitida quando a tabela exibe dados no seu nível raiz, como registros individuais de transações ou eventos. Neste caso, o sistema pode identificar claramente a qual registro específico as alterações devem ser aplicadas. Por exemplo, em uma tabela que detalha vendas por mês e vendedor, é possível editar os dados de vendas e metas porque cada registro é único e específico para cada mês e cada vendedor.
1.2.2. Nível de Agregação
Menos Específico: Quando a tabela é configurada para um nível de agregação mais alto, como resumir dados anuais ou por categoria, a entrada de dados é desabilitada. Isso ocorre porque o sistema não pode determinar com precisão como distribuir as alterações feitas pelos usuários em registros específicos. Por exemplo, ao visualizar dados de vendas agregados por ano, o sistema não sabe a qual mês uma nova meta de vendas deveria ser aplicada.
1.2.3. Uso de Filtros para Especificação
Seletor de Detalhes: Para permitir a entrada de dados em tabelas agregadas, os usuários podem utilizar filtros ou seletores para especificar o nível de detalhe desejado. Por exemplo, um seletor de mês pode ser usado para definir um mês específico. Isso permite que o sistema saiba exatamente onde aplicar as alterações, desbloqueando a funcionalidade de entrada de dados. Este método ajuda a manter a integridade dos dados enquanto permite a edição em níveis de detalhamento adequados. Para mais detalhes sobre seletores, acesse sua documentação.
Este critério de bloqueio para entrada de dados em níveis de agregação mais altos é uma precaução importante para proteger a precisão dos dados. Ele assegura que qualquer modificação seja feita de forma consciente e precisa, correspondendo aos registros específicos onde essas alterações são aplicáveis.
2. Entrada de Dados Automática
A entrada de dados automática é uma funcionalidade que salva automaticamente as alterações feitas pelos usuários sem a necessidade de ações manuais. Isso garante que todas as mudanças sejam persistidas no banco de dados instantaneamente, mantendo os dados sempre atualizados.
2.1. Configuração
Ativação: Para ativar a entrada de dados automática, acesse as configurações do componente, em personalizar, habilite a opção entrada de dados automática.
2.2. Integração com Reatividade
A entrada de dados automática pode ser usada em conjunto com a funcionalidade de Reatividade. Quando ambas estão habilitadas, a plataforma não só salva as alterações automaticamente, mas também atualiza os componentes relacionados de forma automática, sem a necessidade de recarregar todos os componentes da tela. Isso é especialmente útil para garantir que a interface do usuário reflita sempre os dados mais recentes sem interrupções visuais, como "piscadas" na tela. Para mais informações, acessar a documentação de reatividade.
3. Ações Personalizadas para Salvar Dados
Além da entrada de dados automática, os desenvolvedores podem configurar ações personalizadas para salvar dados manualmente, através de um botão ou label. Isso é útil em cenários onde o salvamento automático não é desejável, proporcionando maior controle sobre o momento e as condições em que os dados são salvos.
3.1. Configuração
Criação da Ação:
Acesse a seção de configuração de ações na plataforma Mitra.
No primeiro passo da ação, adicione o passo "Salvar Entrada de Dados".
No segundo passo, adicione a funcionalidade "Recarregar", que garante que a interface do usuário seja atualizada para refletir os dados salvos recentemente. Para mais detalhes sobre a configuração dessas ações, consulte a documentação de ações.
Atribuição da Ação:
A ação personalizada pode ser atribuída a vários tipos de componentes, como botões e labels
Por exemplo, ao clicar em um botão configurado com a ação de salvamento, o sistema irá salvar os dados e recarregar a interface conforme configurado.
Essa abordagem de salvamento manual é útil em casos onde é necessário validar os dados antes de salvá-los ou quando o usuário precisa confirmar o salvamento.