データ型 ​

WELには16種類のデータ型があります。データが式に入るとき、または式から出るときに適切な型を使用して、不正な値によって変換が暗黙的に失敗しないようにします。

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

WELのすべての型の動作は、次の2つのルールに従います。

• WELはデフォルトでは強制型変換を行いません:Stringが想定される場所に数値を渡すと、変換されるのではなくE100が発生します。式を成功させるために暗黙的に再解釈されるものはありません。ただし、常に自動変換を行う文字列補間内、および特定の強制型変換を設定する2つのTransform dataフラグは例外です。
• コレクションが誤って文字列になることはありません:ListまたはMapは、to_jsonなどの明示的な呼び出しによってのみシリアライズされます。

この2つのルールがあるのは、失敗した変換は目に見えますが、誤った値を暗黙的に生成する変換は見えないためです。

クイックリファレンス ​

WELには次のデータ型があります。

数値 ​

WELには3つの数値型があり、ほとんどの連携では、その選択が最も重要な型の決定になります。

Integer ​

Integerは任意精度の整数です。 64-bitの上限はなく、2^53を超えても暗黙的な損失はありません。

Float ​

Floatはバイナリ浮動小数点数です。 Float演算は高速で、測定値、比率、割合、科学的な値に適しています。 Floatはほとんどの小数を正確に表現できません。金額を扱う場合など、小数の精度が重要なケースではDecimalを使用します。

Decimal ​

Decimalは任意精度で正確な小数演算を提供します。金額を扱う場合など、小数の精度が重要なケースで使用します。

数値型の混在 ​

IntegerはDecimalおよびFloatの両方と組み合わせることができます。 DecimalとFloatを直接混在させることはできません。

この制限により、Floatが結果を暗黙的に近似値にすることを防ぎます。 E103を発生させることで、近似を明示的にすることを強制します。 E103を修正するには、DecimalオペランドをFloatに降格するのではなく、FloatオペランドをDecimalに変換します。

テキストとバイト ​

次の2つの型は、テキストと生バイトデータを保持します。

String ​

Stringは、一重引用符または二重引用符（'または"）で囲まれたUTF-8テキストです。

f"Order {_.id} has {_.count} items"

Binary ​

Binaryは、16進形式で記述された生バイトです。例:0x"48656C6C6F"。

日付と時刻 ​

WELには5つの時系列型があります。一般的な日付のバグを避けるため、ユースケースに合った型を使用します。

DateTime ​

DateTimeは、タイムゾーンまたはオフセットを持つ正確な時点です。作成、発送、ログ記録など、イベントの特定の時刻を記録するために使用します。例:DateTime('2026-03-15T09:30:00Z')。

PlainDate ​

PlainDateは、時刻とゾーンのないカレンダー日付です。請求書の日付、生年月日、契約開始日など、見る人全員にとって同じカレンダー日付に使用します。例:PlainDate('2026-03-15')。

PlainTime ​

PlainTimeは、日付とゾーンのない時刻です。店舗の開店時刻や日次締め時刻など、日付が付かない時刻に使用します。例:PlainTime('09:30:00')。

PlainDateTime ​

PlainDateTimeは、ゾーンのない日付と時刻です。ソースシステムがゾーンを別途提供し、ローカル時刻を送信する場合など、タイムゾーンが判明する前の壁時計時刻の読み取りに使用します。例:PlainDateTime('2026-03-15T09:30:00')。

Duration ​

Durationは、カレンダー単位ではなく固定の時計時間を保持し、Duration('PT2H30M')と記述します。年齢、2つのイベント間の経過時間、タイムアウトなど、時間の長さに使用します。

コレクション ​

WELには2つのコレクション型があります。 Listには順序付きデータが含まれ、Mapにはキーと値のデータが含まれます。

List ​

Listは、混在した型の要素を含めることができる順序付きコレクションです。リストを角括弧で囲み、値をカンマで区切ります。例:[1, 2, 3]。

詳細については、List functionsドキュメントを参照してください。

Map ​

Mapはキーと値のコレクションであり、JSONオブジェクト用のWEL型です。キーは常にStringで、挿入順序は保持されます。マップを中括弧で囲み、ペアをカンマで区切ります。例:{a: 1, b: 2}。

詳細については、Map functionsドキュメントを参照してください。

コレクションは文字列になりません ​

ListまたはMapが自動的にStringになることはありません。

この制限があるのは、誤って文字列化されたコレクション、たとえば配列全体が送信先フィールドに[object Object]や角括弧付きの塊として到着することが、追跡が最も難しい連携バグの1つであるためです。 E100を発生させることで、変換を明示的にすることを強制します。送信先が想定する内容に応じて、JSONにはto_json、WELリテラルにはto_wel、区切りリストにはjoin_to_stringを呼び出します。

NullとSkip ​

nullとSkipはどちらも不在を表しますが、多くの送信先システムでは動作が異なります。

• null:フィールドに値がありません。キーは引き続き出力されます。

• Skip:これをまったく出力しません。キーはマップから除外されます。

この区別は、CRM更新APIで特によく見られます。 nullを送信するとフィールドがクリアされますが、Skipでキーを省略すると、そのまま変更されません。

値をテスト ​

present?は一般的なテストで、あらゆる種類の不在を同じように扱います。

present?(false)はtrueを返します。これは、nullや空の文字列のように欠落データの代用ではなく、パイプラインが意図的に運ぶことができる実際の値であるためです。

presenceはあらゆる種類の不在をnullとして報告するため、空の文字列、空白のみの文字列、空のリスト、空のマップを含め、1つのフォールバック演算子（|）ですべて捕捉できます。

型間の変換 ​

各型には、Integer(...)、Decimal(...)、PlainDate(...)などのコンストラクターがあります。コンストラクターは厳格です。たとえば、Integer('3 items')は部分的に解析するのではなくE102を発生させます。

変換で最も信頼性の高い形は、最初にすべてのフィールドを変換することです。

{
  order_id: String(_.id),
  qty: Integer(_.qty),
  total: Decimal(_.total),
  ship_date: PlainDate(_.ship_date)
}

詳細については、Conversion functionsドキュメントを参照してください。

関連情報 ​

• 標準ライブラリ: すべてのWEL関数に関する情報。
• 変換関数: 各データ型を構築する方法。
• Error codes:E100、E101、E102、E103などのエラーをトラブルシューティングします。
• Transform data:Transform dataアクションでデータ型を宣言します。