Função Trace

Aplica-se a: Aplicações de tela Aplicações condicionadas por modelo CLI do Power Platform

Numa aplicação, é frequente haver muita lógica a trabalhar nos bastidores. Por vezes, o impacto é óbvio, por exemplo, pelo valor ou alteração de cor de um controlo, que confirma que a lógica operou corretamente. No entanto, por vezes, não é óbvio e pode ser difícil visualizar e compreender o que está a acontecer dentro da aplicação. Utilize a função Trace para registar informações de diagnóstico nos bastidores, criando uma linha cronológica do que realmente aconteceu, para compreender melhor o funcionamento da aplicação e para ajudar a depurar problemas.

Quando utilizado no Power Apps, a saída de Trace aparece na ferramenta Monitor do Power Apps, juntamente com outras atividades da aplicação. Se permitiu que a sua aplicação enviasse dados telemétricos para o Azure Application Insights, a função Trace também pode ser utilizada para enviar eventos personalizados ou informações de diagnóstico para o seu recurso do Application Insights. A função Trace só pode ser utilizada em fórmulas de comportamento.

Quando utilizada com o Test Studio, a função Trace é uma expressão opcional que pode ser utilizada para fornecer informações adicionais aos resultados do seu teste a partir do evento OnTestCaseComplete. As mensagens de eventos de Trace são combinadas com mensagens de asserção aprovadas ou falhadas na tabela Rastreios do registo TestCaseResult. A tabela Rastreios tem duas propriedades: Message e Timestamp. As informações de Trace utilizadas em testes também serão registadas no Application Insights. As informações de rastreio de testes não estarão disponíveis na ferramenta Monitor, uma vez que o Monitor está ligado à aplicação quando é reproduzido a partir do Power Apps Studio.

Sintaxe

Trace( Message [, TraceSeverity [, CustomRecord [, TraceOptions ] ] ] )

• Mensagem – Obrigatório. A informação a ser rastreada. Números, Datas, Booleanos e qualquer outro tipo de dados que possa ser colocado como Texto.
• TraceSeverity — Opcional. O nível de gravidade do rastreio registado no Monitor e no Application Insights. As opções são TraceSeverity.Information (predefinido), TraceSeverity.Warning, TraceSeverity.Error, or TraceSeverity.Critical.
• CustomRecord — Opcional. Um registo que contém dados personalizados que vão ser registados no Monitor e no Application Insights.
• TraceOptions — Opcional. As opções são TraceOptions.None (predefinida) e TraceOptions.IgnoreUnsupportedTypes, o que ignorará os tipos de dados em CustomRecord que não podem ser serializados.

Exemplo

1. Crie um controlo button no Power Apps Studio.
2. Defina a fórmula OnSelect para a fórmula:

Set( x, x+1 );
Trace( x );

3. Abra o Monitor do Power Apps noutra janela de browser selecionando o ícone "Ferramentas avançadas" no painel do lado esquerdo e selecione "Abrir monitor":
4. Regresse à janela original de browser do Studio e selecione o botão quatro vezes. Utilize Alt-clique no rato se estiver em modo de design.
5. Ver o Monitor do Power Apps.
6. A grelha do Monitor irá conter um evento para cada clique de botão e para cada chamada Trace, o que mostrará o valor da variável após cada incremento. Desagrade um evento Trace para ver onde o Rastreio foi iniciado e a expressão utilizada para a mensagem, no painel do lado direito:

Consulte também

Descrição geral do Monitor do Power Apps
Descrição geral do Test Studio
Utilizar o Test Studio