ランタイムエラーは式の実行時に発生します。このエラーは次のように分類できます。

• 予期せぬエラー -- 開発時のエラーであり、ユーザーには表示すべきではありません。たとえば、@関数のパラメータを付け忘れると、実行時に次のメッセージが表示されます。「@関数の引数が足りません。」式を評価して、予期せぬエラーはすべて訂正してください。
• 報告されないエラー -- エラーとしては報告されませんが、正しくない結果になることがあります。たとえば、@Prompt で数値を表示しようとすると、@Prompt は機能しますが、空白が表示されます。このエラーも、ユーザーには表示すべきではありません。式を評価して、結果がすべて予測どおりになるようにしてください。
• 予想されるエラー -- 実行時にユーザーが原因となって発生するエラーです。たとえば、データベース名の入力を求めたときに、ユーザーが存在しないデータベース名を入力したときのエラーです。このようなエラーは防止できませんが、事前に予想して式で評価し、適切な処置を講じることはできます。

• @IsError(value) は、フィールド、一時変数、式にエラーがあると True (1) を返します。
• @Error は、エラーを生成します。
• @Failure(message) は、入力確認式で使われるメッセージを表示します。
• @Success は常に値 1 を返します。
• @Return(value) は、式の実行を停止し、値を返します。

また、ユーザーが文書を保存するときにも、フィールドのエラーが報告されます。たとえば、数値フィールドに数値以外の値が入っていると、文書の保存時に「文字を数字にすることはできません」というメッセージが表示されます。

メッセージを変更するか、またはエラー発生時に別のアクションを実行するには、フィールド確認式で @IsError を使用してフィールドにエラーがあるかテストします。@Failure を使うと独自のメッセージを生成できますが、この関数はフィールド確認式でしか使えません。

フィールドに独自のエラー条件を組み込むには、エラー条件が検出されたら @Error を返すようにします。

フィールド式以外、たとえばエージェント、ボタン、ホットスポットなどでも、フィールドの内容を調べて、エラー条件に対してただちに対応できます。たとえば、ボタンを使ってフィールドを調べて、ユーザーが文書を保存しようとする前に、フィールドの値を変更したり、エラーを報告できます。なお、エラーチェックでは、ユーザーがフィールドに値を入力するとすぐに、Lotus Notes の内部的なエラー検査が実行されてエラーが生成されるのに対し、@Error を使った変換式では、文書の保存時までエラーは生成されません。

例
関連項目

エラーを処理する

用語集