Formulários e entrada de dados

Introdução ao Power Apps

Luise Freese

Azure & Power Platform Architect

O controle Edit form

Inserir → Formulário de edição
Defina DataSource como sua lista de tickets
O Power Apps gera automaticamente um card por coluna

Formulário de edição do Power Apps em um tablet com cards de entrada para Title, Status, Priority e Due Date.

Modos do formulário: New / Edit / View

Três estados do Edit Form lado a lado mostrando FormMode.New em branco, FormMode.Edit pré-preenchido e FormMode.View somente leitura.

FormMode.New, formulário em branco, pronto para criar uma linha
FormMode.Edit, pré-preenchido com uma linha existente
FormMode.View, exibição somente leitura

SubmitForm() e o ciclo de vida

O botão Salvar executa SubmitForm(frmTicket)
O Power Apps valida e grava na sua origem de dados
O formulário dispara OnSuccess ou OnFailure

Fluxograma do toque em Salvar até SubmitForm(), gravação no SharePoint, marca de verificação OnSuccess e um ramo de erro OnFailure.

OnSuccess, OnFailure, OnReset

Três blocos por cor empilhados: verde OnSuccess com Notify, Refresh, Navigate; vermelho OnFailure com toast de erro Notify; cinza OnReset limpa o formulário para os padrões.

OnSuccess, mostre um toast, atualize a galeria, volte
OnFailure, mostre um toast de erro
OnReset, executa quando o formulário é limpo

Refresh(), o passo esquecido

Galerias não atualizam sozinhas após o envio
Adicione Refresh(Tickets) ao OnSuccess do formulário
Sem isso, a nova linha parece invisível

Dois tablets lado a lado: à esquerda, galeria sem Refresh onde o novo ticket não aparece; à direita, galeria com Refresh onde o novo ticket aparece destacado no topo.

ResetForm(), o caminho de cancelamento

Dois formulários New de ticket mostrando dados restantes antes de ResetForm() e um formulário em branco pronto para entrada após o reset.

ResetForm(frmTicket) limpa todos os campos
Use em um botão Cancelar, nunca em OnSuccess
OnSuccess já navega para fora; NewForm limpa na próxima vez

Patch()

Patch(DataSource, record, changes) grava sem formulário
Útil para atualizações em lote ou mudanças de um campo
Uma ferramenta mais avançada, além deste curso

Patch(
  Tickets,
  ThisItem,
  { Status: "Resolved" }
)

O que você vai praticar

Formulário de edição com campos de ticket pré-preenchidos, dropdowns, seletor de pessoa, DueDate e um botão verde Save na parte inferior.

Como um Edit Form se vincula a uma origem de dados e cria seus cards
O que ocorre em sucesso e falha após o envio
Como os botões New e Cancel completam o ciclo do formulário

Vamos praticar!

Introdução ao Power Apps