Trace Função

Aplica-se a: Aplicativos de tela Copilot Studio Aplicativos baseados em modelo FUNÇÕES do Power Platform CLI Dataverse

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 Trace função para registrar informações de diagnóstico nos bastidores, criando uma linha do tempo do que realmente aconteceu, para entender melhor como seu aplicativo está operando e para ajudar a depurar problemas.

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

Quando usada com o Test Studio, Trace é uma expressão opcional que pode ser usada para fornecer informações adicionais nos resultados do teste do evento OnTestCaseComplete . Trace as mensagens de evento são combinadas com mensagens de declaração passadas e com falha na tabela Rastreamentos do registro TestCaseResult . A tabela Traces tem duas propriedades, Message e Timestamp. Trace as informações 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( Mensagem [, TraceSeverity [, CustomRecord [, TraceOptions ] ] ] )

• Mensagem – 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 Trace 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 de botão e para cada Trace chamada, que mostrará o valor da variável após cada incremento. Faça drill into a event Trace to see where the Trace was initiated, and the expression used for the message, in the right hand panel:

Consulte Também

Power Apps Visão geral do monitor
Test Studio Visão geral
Trabalhando com Test Studio