Trace функция

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

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

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

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

Синтаксис

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

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

Пример

1. Создайте элемент управления «кнопка» в Power Apps Studio.
2. Задайте для OnSelect следующую формулу:

Set( x, x+1 );
Trace( x );

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

См. также

Общие сведения о Power Apps Live Monitor
Test Studio Обзор
Работа с Test Studio