Compreender o Salvamento Automático
Em condições específicas, selecionar um comando da barra de comandos antes da execução da lógica de ação salvará automaticamente os dados do formulário. Esse comportamento de Salvamento Automático só se aplica quando você configura o comando para usar o Power Fx. Se você usar JavaScript para a lógica de comando, nenhum salvamento automático ocorrerá.
Os comandos que usam o Power Fx são configurados por padrão para salvar automaticamente os dados do formulário antes de executar a expressão. O Salvamento Automático só se aplica às barras de comandos do formulário principal e pode ocorrer para linhas de dados novas e existentes.
Comportamento de Salvamento Automático para novas linhas
Quando um usuário seleciona o comando ao criar uma nova linha, o aplicativo tenta salvar a linha com os dados inseridos. Depois que a linha é salva com êxito, a lógica de comando é executada e Self.Selected.Item é definido para a linha recém-criada. A lógica do Power Fx é executada conforme esperado.
Se o usuário não tiver preenchido todas as colunas necessárias, a ação de salvar falhará. No entanto, a lógica do comando ainda será executada. Como a nova linha não foi criada, Self.Selected.Item está em branco. A lógica que depende dessa propriedade, como atualizar colunas ou criar linhas relacionadas, não funcionará corretamente.
Para evitar confusão do usuário, considere ocultar o botão de comando quando uma nova linha estiver em andamento. Use esta fórmula para a propriedade Visibility:
If (Self.Selected.State = 1, false, true)
Essa abordagem ajuda a evitar o disparo da lógica de negócios prematuramente, por exemplo, quando um usuário preenche apenas 5 dos 20 campos e uma automação é executada antes que todos os dados sejam inseridos.
Em certos casos, esse comportamento pode ser intencional e útil. Por exemplo, um comando Salvar e Enviar pode criar a ordem e imediatamente enfileirá-la para remessa. Isso dá suporte a uma experiência simplificada em que o usuário não precisa selecionar Salvar separadamente.
Comportamento de Salvamento Automático para linhas existentes
Quando um usuário seleciona o comando enquanto edita uma linha existente, o formulário tenta salvar as alterações antes de executar o comando. Se o salvamento for bem-sucedido, a lógica do comando será executada e Self.Selected.Item refletirá a linha atualizada.
Se você desabilitar o Salvamento Automático, o formulário não salvará as alterações antes de executar o comando. Nesse caso, Self.Selected.Item mantém o estado anterior da linha. Isso pode afetar qualquer automação downstream disparada por atualizações de dados.
Como desabilitar o Salvamento Automático
Por padrão, os comandos que usam o Power Fx têm o Salvamento Automático habilitado na biblioteca de componentes. Para desativá-lo, adicione JavaScript ao evento OnSave do formulário. Para obter mais informações, consulte Desabilitar Salvamento Automático para um formulário.