Função Trace

Aplica-se a: Aplicativos de tela Aplicativos baseados em modelo CLI do Power Platform

Costumar haver muita lógica por trás de um aplicativo. Às vezes, o impacto é óbvio: o valor ou a cor de um controle muda, confirmando que a lógica operou corretamente. Mas, às vezes não é óbvio e pode ser difícil visualizar e entender o que está acontecendo dentro do aplicativo. Use a função Trace para registrar informações de diagnóstico em segundo plano, criando uma linha do tempo do que realmente aconteceu, para entender melhor como seu aplicativo opera e para ajudar a depurar problemas.

Quando usada no Power Apps, a saída de Trace aparece na ferramenta Power Apps Monitor junto com outras atividades do aplicativo. Se você permitiu ao aplicativo enviar dados de telemetria para o Azure Application Insights, a função Trace também poderá ser usada para enviar informações para o recurso do Application Insights. A função Trace só pode ser usada em fórmulas de comportamento.

Quando usada com o Test Studio, Trace é uma expressão opcional a ser usada para fornecer informações adicionais em resultados de teste do evento OnTestCaseComplete. As mensagens do evento Trace são combinadas com mensagens de declaração aprovadas e com falha na tabela Traces do registro TestCaseResult. A tabela Traces tem duas propriedades, Message e Timestamp. As informações de rastreamento usadas em testes também serão registradas no Application Insights. As informações de rastreamento de teste não estarão disponíveis na ferramenta Monitor porque o Monitor está conectado ao aplicativo quando é reproduzido no Power Apps Studio.

Sintaxe

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

• Message - obrigatório. As informações a serem rastreadas. Números, datas, boolianos e qualquer outro tipo de dados a ser convertido em texto.
• TraceSeverity – Opcional. O nível de gravidade do rastreamento registrado no Monitor e no Application Insights. As opções são TraceSeverity.Information (padrão), TraceSeverity.Warning, TraceSeverity.Error ou TraceSeverity.Critical.
• CustomRecord – Opcional. Um registro que contém dados personalizados que serão registrados no Monitor ou no Application Insights.
• TraceOptions – Opcional. As opções são TraceOptions.None (padrão) e TraceOptions.IgnoreUnsupportedTypes que ignorará os tipos de dados em CustomRecord que não podem ser serializados.

Exemplo

1. Crie um controle de botão no Power Apps Studio.
2. Defina OnSelect com a seguinte fórmula:

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

3. Abra o Power Apps Monitor em outra janela do navegador, selecionando o ícone "Ferramentas avançadas" no painel esquerdo e selecione "Abrir monitor":
4. Retorne à janela original do navegador do Studio e selecione o botão quatro vezes. Use Alt-clique no mouse se estiver no modo de design.
5. Exiba o Power Apps Monitor.
6. A grade do Monitor conterá um evento para cada clique do botão e para cada chamada Trace, que mostrará o valor da variável após cada incremento. Pesquise um evento Trace para ver onde o Trace foi iniciado e a expressão usada para a mensagem, no painel à direita:

Consulte Também

Power Apps Visão geral do Monitor
Visão geral do Test Studio
Como trabalhar com o Test Studio