適用対象:
キャンバス アプリ Copilot Studio モデル駆動型アプリ Power Platform CLI Dataverse 関数
多くの場合、アプリのバックグラウンドでは、多くのロジックが動作しています。 コントロールの値や色の変化など、影響が明らかになることがあり、ロジックが正しく動作することを確認します。 ただし、明らかでない場合もあり、アプリ内で何が起こっているのかを視覚化して理解することが難しい場合があります。 Trace関数を使用して、バックグラウンドから診断情報を記録し、実際に発生した内容のタイムラインを作成して、アプリの動作状況を理解し、問題のデバッグに役立ちます。
Power Apps で使用すると、 Trace からの出力が他のアプリ アクティビティと共に Power Apps Live Monitor ツールに表示されます。 アプリが Azure Application Insights にテレメトリ データを送信することを許可した場合、 Trace 関数を使用して Application Insights リソースに情報を送信することもできます。 Trace は 動作式 でのみ使用できます。データ プロパティから値をトレースするには、 デバッグ ボタンなどの代替手段を使用する必要があります。
Test Studio で使用する場合、Traceはオプションの式であり、OnTestCaseComplete イベントからテスト結果に追加情報を提供するために使用できます。 Traceイベント メッセージは、TestCaseResult レコードの Traces テーブルで、渡されたアサーション メッセージと失敗したアサーション メッセージと組み合わされます。 Traces テーブルには、Message と Timestamp の 2 つのプロパティがあります。 Trace テストで使用される情報も Application Insights に記録されます。 Power Apps Studio から再生すると Live Monitor がアプリに接続されるため、Live Monitor ツールではテスト トレース情報を使用できません。
構文
Trace( Message [, TraceSeverity [, CustomRecord [, TraceOptions ] ] ] )
- メッセージ – 必須。 トレースされる情報。 数値、日付、ブール値、およびテキストに強制変換できるその他のデータ型。
- TraceSeverity – オプション。 Live Monitor と Application Insights に記録される Trace の重大度レベル。 オプションは TraceSeverity.Information (既定)、TraceSeverity.Warning、TraceSeverity.Error または TraceSeverity.Critical です。
- CustomRecord – オプション。 Live Monitor または Application Insights に記録されるカスタム データを含むレコード。
- TraceOptions – オプション。 オプションは TraceOptions.None (既定) と TraceOptions.IgnoreUnsupportedTypes であり、シリアル化できない CustomRecord 内のデータ型を無視します。
例
- Power Apps Studio でボタン コントロールを作成します。
- OnSelect 式を次の式に設定します:
Set( x, x+1 );
Trace( x );
- 別のブラウザー ウィンドウで Power Apps Live Monitor を開くには、左側のウィンドウで [高度なツール] アイコンを選択し、[ライブ モニターを開く] を選択します。
- 元の Studio ブラウザー ウィンドウに戻り、ボタンを 4 回選択します。 デザイン モードの場合は、マウスで Alt キーを押しながらクリック を使用します。
- Power Apps Live Monitor を表示します。
- Live Monitor のグリッドには、各ボタンクリックと各 Trace 呼び出しのイベントが含まれ、各インクリメント後に変数の値が表示されます。
Trace イベントにドリルダウンして、Traceが開始された場所と、メッセージに使用された式を右側のパネルで確認します。
