Trace функция

Применимо к: Функции Power Platform CLI Dataverse приложений На основе моделей На основе холста приложений Copilot Studio

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

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

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

Синтаксис

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

• Сообщение – Обязательно. Сведения для отслеживания. Числа, даты, логические значения и данные любого другого типа, которые можно преобразовать в текст.
• TraceSeverity – Необязательно. Уровень серьезности записываемых Trace в 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 );

3. Откройте Power Apps Monitor в другом окне браузера, выбрав значок «Дополнительные инструменты» в левой области и выбрав «Открыть монитор»:
4. Вернитесь в исходное окно браузера Studio и нажмите созданную вами кнопку четыре раза. При работе в режиме разработки используйте Alt+щелчок мыши.
5. Просмотрите Power Apps Monitor.
6. Сетка монитора будет содержать событие для каждого нажатия кнопки и для каждого Trace вызова, которое будет отображать значение переменной после каждого увеличения. Trace Детализация события, чтобы узнать, где Trace была инициирована, и выражение, используемое для сообщения, на правой панели: .

См. также

Power Apps Обзор монитора
Test Studio Обзор
Работа с Test Studio