Compartilhar via

Tratamento de erros

O Power Fx dá suporte ao tratamento de erros no nível da fórmula. Esse recurso é ativado por padrão para todos os novos aplicativos. No entanto, alguns aplicativos mais antigos podem tê-lo desativado nas Configurações do aplicativo. É recomendável manter esse recurso ativado.

Para verificar se esse recurso está ativado:

  1. Abra um Canvas App para edição.
  2. Vá para a guia Configurações>Atualizações>Desativadas.
  3. Certifique-se de desabilitar o gerenciamento no nível da fórmula.

Quando essa configuração estiver habilitada, você poderá usar fórmulas comoIfError, , IsErrore ErrorIsBlankorError. Essas funções ajudam você a detectar erros, fornecer valores alternativos ou executar ações específicas com base no erro. Ao ativar essa configuração, você pode gravar valores nulos ou em branco em fontes de dados. Quando você desativa esse recurso, os erros são retornados como valores em branco.

Tratamento de erros de validação

Essas funções ajudam a validar entradas como formatos incorretos ou campos obrigatórios. Use as instruções If ou funções como IsBlank e IsError para validar a entrada do usuário. Forneça mensagens de erro claras e evite o processamento adicional até que a entrada seja corrigida.

If( IsBlank(TextInput.Text),
    Notify("Field cannot be blank", 
    NotificationType.Error),
    // Continue with processing
)

Tratamento de erros da função Patch

Semelhante ao exemplo anterior, as funções Error ajudam a capturar erros ao aplicar patches de dados em uma fonte de dados. A função Patch relata erros de duas maneiras.

Ela pode retornar um valor de erro como resultado das operações.

UpdateContext(
    {   
    result : Patch(
             Feeds,
             Defaults(Feeds),
             {
                 createdon: Now(),
                 crde8_content: TextInput1_1.Text
                 cr9ce_imageurl: filename
             }
        )
    }
)

Você pode detectar erros usando IsError e substituí-los ou suprimi-los usando IfError.

IfError(result, Notify("There was an issue saving data" , NotificationType.Error));
IfError(result, Notify("There was an issue saving data" , & FirstError.Message, NotificationType.Error))

If(
    IsError(
        Patch(
            Feeds,
            Defaults(Feeds),
            {
                createdon: Now(),
                crde8_content: TextInput1_1.Txt,
                cr9ce_imageurl: filename        
            }
        )
    ),
    Notify("Error: There was an issue saving data", NotificationType.Error)
)

Tratamento de erros de formulários

Ao usar o Forms para enviar dados usando a SubmitForm função, use a propriedade OnFailure de controle Formulário para notificar os usuários sobre mensagens de erro.

// OnSelect property of the form's submit button
SubmitForm(frm_SubmitData);

// OnSuccess property of the form
Navigate('Success Screen');

// OnFailure property of the form
Notify("Error: the invoice could not be created", NotificationType.Error);

Mensagem de erro personalizada usando a propriedade OnError

A propriedade Power Apps OnError captura todos os erros sem tratamento em seu aplicativo. Usando o recurso OnError, você pode executar uma expressão sempre que o aplicativo encontrar um erro sem tratamento. Por exemplo, você pode armazenar o erro em uma variável ou usar uma função como IfError substituir o erro por outro valor. Para usar a OnError propriedade, adicione-a ao aplicativo onde você deseja lidar com erros. Em seguida, escreva uma fórmula na OnError caixa de propriedades para especificar a mensagem de erro que você deseja exibir.

App.OnError não pode substituir o erro como IfError pode. Quando App.OnError se executa, o erro já aconteceu e o resultado já foi processado por outras fórmulas. App.OnError controla apenas como o erro é relatado ao usuário final. Ele também fornece ao criador uma maneira de registrar o erro em log, caso queira.

Este código na App.OnError pode ajudar a localizar a origem do erro:

Notify(
    Concatenate(
        FirstError.Message,
        ", Observed: ",
        FirstError.Observed,
        ", Source: ",
        FirstError.Source
    ),
    NotificationType.Error
)

Próxima etapa

Monitoramento e teste

  • Last updated on