ユーザエラーメッセージの表示

onRender() 実装から CanvasRenderException を発生させた場合、Salesforce UI にその例外のエラーメッセージがユーザに表示されます。この例外は、onRender() メソッド内でのみ管理されます。

CanvasRenderException は、すべての標準 Apex 例外クラスメソッドおよびコンストラクタをサポートしています。Apex 例外についての詳細は、『Force.com Apex コード開発者ガイド』の「Exception クラスおよび組み込み例外」を参照してください。

次の例では、onRender() 実装で Canvas.CanvasRenderException を発生させます。Salesforce はこの例外を使用し、ユーザエラーメッセージとして「Error: Could not set URL (エラー: URL を設定できません)」と表示します。

1public void onRender(Canvas.RenderContext renderContext) {
2    // Code omitted that determines if the error condition occured
3    ...
4    throw new Canvas.CanvasRenderException('Error: Could not set URL.');
5}

キャンバスアプリケーションが Salesforce Chatter タブから実行されている場合、次のような類似のエラーメッセージが表示されます。