プラグインおよびワークフロー活動で InvalidPluginExecutionException を使用する

カテゴリ: 保守性、ユーザビリティ

影響の可能性: 中程度

現象

同期プラグインがプラットフォームに InvalidPluginExecutionException 以外の例外を返す場合、Power Apps クライアント上でエラーがスタック トレース付きの例外メッセージ Message とともに表示されます。 これは、すでに発生している可能性のある不満を感じる状況で、好ましくないユーザー エクスペリエンスを提供します。

データ検証のロジックに問題があり、操作を意図的にキャンセルするために InvalidPluginExecutionException を使用している場合、アプリケーション ユーザーに適用可能なガイダンスを提供して、問題を修正して続行できるようにする必要があります。

エラーが予期しないものである場合、例外をキャッチし、InvalidPluginExecutionException に変換し、その後、新たな例外を投げることをお勧めします。それによって、ユーザーや技術スタッフが問題をすばやく特定できるように、アプリケーションにガイダンス付きのわかりやすいエラーメッセージを表示できるようになります。

ガイダンス

プラグインは、次の理由からのみ InvalidPluginExecutionException を返します。

• ユーザーに対して役に立つメッセージを表示する
• イベント ログ / トレース ファイルの肥大化を回避する

投げられた InvalidPluginExecutionException は友好的なメッセージと IsvAborted エラーコードを返します。 例外をキャッチして InvalidPluginExecutionException に変換しないと、Power Apps クライアントからユーザーにフレンドリーなメッセージが表示されないという IsvUnExpected エラー コードが発生します。

プラグインで呼び出された関数からのエラーを処理する

プラグイン内では、通常、他の関数を呼び出してコードを再利用します。 未処理のエラーはワーカー プロセスをクラッシュさせる可能性があるため、これらの関数のエラーをどのように処理するかは非常に重要です。 これにより、プラグインが終了するだけでなく、組織で実行されている同時プラグインも終了する可能性があります。 詳細: エラー: サンドボックス ワーカー プロセスがクラッシュしました

問題となるパターン

警告

これらのパターンは、回避する必要があります。

エラー メッセージ テキスト内で HTML を使用しないでください。

Dataverse データにアクセスする Web アプリケーションは、エラー メッセージ テキストをユーザーに表示する前に HTML エンコードする必要があります。 これにより、メッセージ内の HTML が意図したとおりに表示されなくなります。 HTML コードを表示するだけです。

関連項目

操作のキャンセル
ワークフロー活動のデバッグ

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。