Função Trace

  • Artigo

Aplica-se a: Aplicativos de tela CLI de aplicativos Power Platform controlados por modelo

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. O rastreamento só pode ser usado 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 evento de rastreamento são combinadas com mensagens de asserção passadas e com falha na tabela Traces do registro 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

Rastreamento( Mensagem [, 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 );
  1. 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": ponto de entrada para o Monitor do Power Apps
  2. 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.
  3. Ver o Monitor do Power Apps.
  4. 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: rastreio do Monitor a mostrar o botão a ser premido quatro vezes e 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