Função Trace

  • Artigo

Aplica-se a: Aplicativos Canvas Aplicativos baseados em modelo Power Platform CLI

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. Trace só pode ser usado 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 de evento Trace são combinadas com mensagens de asserçã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

Rastrear( Mensagem [, Gravidade do Rastreamento [, RegistroPersonalizado [, Opções do Rastreamento ] ] ] )

  • 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 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 );
  1. Abra o Power Apps Monitor em outra janela do navegador, selecionando o ícone "Ferramentas avançadas" no painel esquerdo e selecione "Abrir monitor": Ponto de entrada para o Power Apps Monitor
  2. 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.
  3. Exiba o Power Apps Monitor.
  4. 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: Rastreamento do monitor mostrando o botão sendo pressionado quatro vezes e os incrementos correspondentes de uma variável

Consulte Também

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