Trace функція

Застосовується до: Програми Canvas Copilot Studio Model-driven apps Power Platform CLI Dataverse functions

Часто в додатку є багато логіки, яка працює за лаштунками. Іноді вплив очевидний, наприклад, значення або колір елемента керування, що підтверджує правильну роботу логіки. Однак іноді це не очевидно, і може бути важко уявити та зрозуміти, що відбувається всередині програми. Trace За допомогою функції можна записувати діагностичні відомості з-за лаштунків, створювати часову шкалу того, що насправді сталося, щоб краще зрозуміти, як працює програма, і допомогти з налагодження проблем.

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

Використовується з Test Studio – це необов'язковий вираз, Trace який можна використовувати для надання додаткових відомостей у результатах тестування з події OnTestCaseComplete . Trace повідомлення про події об'єднуються з переданими та невдалими повідомленнями про твердження в таблиці Трасування запису TestCaseResult . Таблиця «Трасування» має дві властивості: «Повідомлення » і «Позначка часу». Trace інформація, яка використовується в тестах, також буде записана в Application Insights. Відомості про трасування перевірки недоступні в засобі Live Monitor, оскільки динамічний монітор підключено до програми під час відтворення зі студії Power Apps Studio.

Синтаксис

Trace( Повідомлення [, 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 , які ігнорують типи даних у настроюваному записі, які не можна серіалізувати.

Приклад

1. Створіть кнопку керування в Power Apps Studio.
2. Встановіть формулу OnSelect на формулу:

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

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

Див. також

Огляд монітора Power Apps Live Monitor
Test Studio Огляд
Робота з Test Studio