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