Поделиться через

Функция Trace

  • Статья

Применимо к: Приложениям Canvas Приложениям на основе моделей Power Platform CLI

Часто за кулисами приложения работает много различной логики. Иногда те или иные логические взаимосвязи очевидны, например, изменяется значение или цвет элемента управления, подтверждая правильность работы логики. Однако иногда работа логики не так очевидна, и может быть трудно визуализировать и понять, что происходит внутри приложения. Используйте функцию трассировки для записи диагностической информации «из-за кулис» и создания временной шкалы того, что происходило на самом деле. Это поможет лучше понять, как работает ваше приложение, а также поможет найти и устранить проблемы.

При использовании в Power Apps выходные данные из функции трассировки отображаются в инструменте Power Apps Monitor вместе с информацией о других действиях приложения. Если вы разрешили приложению отправлять данные телеметрии в Azure Application Insights, функцию трассировки можно также использовать для отправки информации в ваш ресурс Application Insights. Трассировку можно использовать только в формулах поведения.

При использовании с Test Studio функция трассировки является необязательным выражением, которое можно использовать для предоставления дополнительных сведений в результатах теста по событию OnTestCaseComplete. Сообщения о событиях трассировки объединяются с сообщениями о пройденных и неудачных утверждениях в таблице Traces записи TestCaseResult . Таблица Трассировки имеет два свойства: Сообщение и Метка времени. Сведения трассировки, используемые в тестах, будут также записаны в Application Insights. Информация тестовой трассировки не будет доступна в инструменте Monitor, поскольку Monitor подключается к приложению, когда оно работает из Power Apps Studio.

Синтаксис

Трассировка( Сообщение [, Серьезность трассировки [, Пользовательская запись [, Параметры трассировки ] ] ] )

  • Сообщение – Обязательно. Сведения для отслеживания. Числа, даты, логические значения и данные любого другого типа, которые можно преобразовать в текст.
  • TraceSeverity – Необязательно. Степень серьезности трассировки, записанной в Monitor и Application Insights. Возможные варианты: TraceSeverity.Information (по умолчанию), TraceSeverity.Warning, TraceSeverity.Error или TraceSeverity.Critical.
  • CustomRecord – Необязательно. Запись, содержащая пользовательские данные, которые будут записаны в Monitor или Application Insights.
  • TraceOptions – Необязательно. Возможные варианты: TraceOptions.None (по умолчанию) и TraceOptions.IgnoreUnsupportedTypes, при котором в CustomRecord будут игнорироваться типы данных, которые невозможно сериализовать.

Пример

  1. Создайте элемент управления «кнопка» в Power Apps Studio.
  2. Задайте для OnSelect следующую формулу:
Set( x, x+1 );
Trace( x );
  1. Откройте Power Apps Monitor в другом окне браузера, выбрав значок «Дополнительные инструменты» в левой области и выбрав «Открыть монитор»: точка входа для Power Apps monitor
  2. Вернитесь в исходное окно браузера Studio и нажмите созданную вами кнопку четыре раза. При работе в режиме разработки используйте Alt+щелчок мыши.
  3. Просмотрите Power Apps Monitor.
  4. Сетка инструмента Monitor будет содержать событие для каждого нажатия кнопки и для каждого вызова функции трассировки, которое будет показывать значение переменной после каждого приращения. На правой панели просмотрите детали события трассировки, чтобы увидеть, где была инициирована трассировка и какое выражение было использовано для сообщения: Трассировка monitor, показывающая нажатие кнопки четыре раза и соответствующие приращения переменной

См. также

Power Apps Обзор монитора
Обзор тестовой студии
Работа с тестовой студией