WELエラーコード ​

すべてのWELエラーには安定したコードが含まれます。エラーメッセージが変更または翻訳されても、コードは同じままです。エラーの検索、アラートの設定、またはサポートリクエストへの記載にコードを使用します。

_ は、これらの例で式が受け取る入力です。詳細については、入力変数を参照してください。

エラーコードは次のカテゴリに分類されます。

ファミリの識別 ​

エラーファミリはエラーの発生元を示します。

• E0xx: 式はすべての入力に対して不正であり、解析できないスクリプトからは何も復旧できないため、キャッチできません。これらはプロダクションではなく、式の記述中に表面化します。

• E1xxおよびE2xx: 式自体には問題ありませんが、この特定のレコードが想定された形状を持っていません。たとえば、フィールドが欠落している、または数値が必要な場所に文字列がある場合です。これらはプロダクションで最も表面化しやすいエラーであり、多くの場合、通常は正常に実行されるバッチの途中で発生します。これらはキャッチ可能なため、何を行うかを決定できます。

• E3xx: 式自体には問題ありませんが、依存するホスト関数または別の依存関係が想定どおりに動作しませんでした。キャッチ可能性はコードによって異なります。 E300はキャッチ可能です。欠落した任意のホスト値は復旧可能であるためです。 E301–E303はキャッチできません。ホスト自体が失敗したためです。

キャッチ可能性 ​

try-fallback演算子|?は、キャッチ可能なエラーをキャッチし、代わりにフォールバックを返します。キャッチできないエラーは常に伝播します。

_.customer.email |? 'unknown'
Integer(_.qty) |? 0

|?と|の比較 ​

|?と|の違いは非常に重要であり、ここで混同するとよく混乱の原因になります。

存在しないフィールドを読み取るとE104が発生します。これはnullを生成しないため、|では保護されません。

_.customer.nickname | 'none'      // still raises E104
_.customer.nickname |? 'none'     // returns 'none'

キーが存在し、その値がnullまたは空白になる可能性がある場合は、通常、あらゆる種類の欠如をnullに正規化するpresenceとともに|を使用します。

presence(_.display_name) | 'Unknown'

形状自体が異なる可能性がある場合は|?を使用します。

解析および静的分析エラー ​

WELは評価が開始される前にこれらのエラーを発生させます。これらはすべての入力で発生し、キャッチできません。

型エラー ​

WELは、値が操作に必要な型でない場合にこれらのエラーを発生させます。すべての型エラーはキャッチ可能です。

WELは、関数または演算子を満たすために引数を自動的に強制変換しません。入力型が必要な型と一致しない場合は、値を明示的に変換します。詳細は変換関数を参照してください。

E103は金額に関するものです ​

DecimalとFloatは混在できません。暗黙の混在は、Decimalを使用する価値である正確性を損ないます。 Floatが計算に入ると結果は近似値になり、下流ではそれを判別できません。

合計でE103が発生した場合、ほとんどの場合、修正はDecimalをFloatに変換するのではなく、もう一方のオペランドをDecimalにすることです。

ランタイムエラー ​

WELは、入力値を処理できない場合に評価中にこれらのエラーを発生させます。すべてのランタイムエラーはキャッチ可能です。

データの形状とアクセス ​

データが操作で想定される形状または値を持たない場合、次のエラーが発生します。

解析と変換 ​

値を想定される形式として解析できない、または想定される形式に変換できない場合、次のエラーが発生します。

スキーマと構造 ​

値の構造が宣言されたスキーマ、オプションマップ、またはパス式と一致しない場合、次のエラーが発生します。

制限 ​

式、名前、リテラル、またはそれが処理するデータがサイズ制限を超えた場合、次のエラーが発生します。

シリアル化 ​

値をWELリテラルにシリアル化できない場合、次のエラーが発生します。

その他 ​

ホストエラー ​

WELは式の外部でこれらのエラーを発生させます。

一般的なエラー ​

入力が式で想定される型または形状と一致しない場合、一般的に次のエラーが発生します。

変換の開始時に入力フィールドを想定される型に変換し、任意の値を明示的に処理することで、これらのエラーを減らします。 presence(...) | defaultは、実際に任意のフィールドに使用します。詳細は変換関数および共通関数を参照してください。

関連情報 ​

• データ型: これらのエラーに関連するデータ型。
• 演算子: |および|?の詳細情報。
• 変換関数: 各データ型を構築する方法。
• Transform data: 失敗した式が実行されるアクション。