文字列関数 ​

文字列関数はテキストを読み取り、整形し直します。これらを使用して、インバウンドペイロードのクリーンアップ、識別子の抽出、値が宛先システムに到達する前の正規化、およびターゲットが想定する正確な文字列形式の構築を行います。

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

文字列関数を呼び出す ​

関数を直接呼び出すか、>>を使用して値をパイプします:

upper(_.status)
_.status >> upper

パイプ形式は左から右に読み取られるため、複数のステップを連結する場合に適しています。

_.email >> trim >> lower

パイプされた値が、関数の最初の引数に入ります。その他の引数は通常どおり記述します。

_.order_id >> starts_with?('SO-')

文字列をチェックする ​

次の関数はBooleanを返します。これらは条件、filter_by、およびステップの実行前の保護に使用します。

blank? ​

文字列が空、または空白のみを含む場合はtrueを返します。

blank?(string)

blank?('   ')

true

blank?('SO-1001')

false

empty? ​

値にコンテンツがない場合はtrueを返します。 String、List、Map、またはBinary値で機能し、blank?とは異なり、nullに対してtrueを返します。

empty?(value)

empty?('')

true

empty?(null)

true

contains? ​

大文字と小文字を区別する比較を使用して、文字列に部分文字列が含まれる場合はtrueを返します。

contains?(string, substring)

contains?('Partner account', 'Partner')

true

contains?('Partner account', 'partner')

false

starts_with? ​

文字列がプレフィックスで始まる場合はtrueを返します。

starts_with?(string, prefix)

starts_with?('SO-1001', 'SO-')

true

ends_with? ​

文字列がサフィックスで終わる場合はtrueを返します。

ends_with?(string, suffix)

ends_with?('invoice.pdf', '.pdf')

true

valid_email? ​

文字列がRFC 5321およびRFC 5322で定義されている有効なメールアドレスの場合はtrueを返します。

valid_email?(string)

valid_email?('nur@example.com')

true

valid_email?('nur@@example.com')

false

valid_url? ​

文字列が有効なURLの場合はtrueを返します。許可されるスキームを制限するには、スキームのリストを渡します。

valid_url?(string)
valid_url?(string, schemes)

valid_url?('https://example.com/orders')

true

valid_url?('ftp://example.com', ['http', 'https'])

false

match? ​

文字列が正規表現に一致する場合はtrueを返します。 WELはECMAScript正規表現構文を使用します。

match?(string, pattern)

match?('SO-1001', '^SO-\d+$')

true

ユースケース: 区切り文字付き受信者リストをフィルタリングする ​

webhookは、間隔、大文字と小文字、形式不正なエントリが混在する受信者を1つのカンマ区切り文字列として配信します。文字列関数を使用してこれを分割し、各アドレスを正規化してから、有効なものだけを保持します。

入力

{
  "recipients": "a@example.com, B@Example.com ,,not-an-address"
}

Formula

_.recipients
  >> split(',')
  >> map_by(e ~> trim(e) >> lower)
  >> filter_by(e ~> valid_email?(e))

出力

["a@example.com", "b@example.com"]

splitは、1つの空文字列を含む4つのエントリを生成します。 trimとlowerはそれぞれを正規化します。 valid_email?は空のエントリとnot-an-addressの両方を破棄します。

大文字と小文字を変更する ​

次の関数は、文字列の文字の大文字と小文字を変更します。

upper ​

文字列を大文字に変換します。

upper(string)

upper('acme corp')

ACME CORP

lower ​

文字列を小文字に変換します。比較または重複排除の前にメールアドレスとコードを正規化するために使用します。

lower(string)

lower('ACME Corp')

acme corp

capitalize ​

最初の文字を大文字に変換し、残りを小文字に変換します。

capitalize(string)

capitalize('acme')

Acme

titleize ​

空白で区切られた各単語の最初の文字を大文字に変換し、残りを小文字に変換します。

titleize(string)

titleize('acme widgets inc')

Acme Widgets Inc

クリーンアップとパディング ​

次の関数は、空白を削除するか、文字列を固定幅にパディングします。

trim ​

先頭と末尾の空白を削除します。

trim(string)

trim('  SO-1001  ')

SO-1001

ltrim ​

先頭の空白を削除します。

ltrim(string)

ltrim('  SO-1001')

SO-1001

rtrim ​

末尾の空白を削除します。

rtrim(string)

rtrim('SO-1001  ')

SO-1001

lpad ​

指定された幅に達するまで文字列の先頭をパディングします。ゼロパディングされた参照番号と固定幅レコードに使用します。

lpad(string, width, pad)

lpad('42', 8, '0')

00000042

rpad ​

指定された幅に達するまで文字列の末尾をパディングします。

rpad(string, width, pad)

rpad('A-100', 8, ' ')

"A-100   "

normalize_newlines ​

CRLF、CR、LFの行終端文字を単一の規則に書き換えます。デフォルトはLFです。

normalize_newlines(string, terminator)

normalize_newlines("a\r\nb\rc")

"a\nb\nc"

ユースケース: 固定幅レコードを構築する ​

多くのERPおよびメインフレームシステムは、JSONではなく固定幅レコードを受け入れます。文字列関数を使用して各フィールドをその列幅にパディングし、それらを連結します。

入力

{
  "sku": "A-100",
  "qty": 2
}

Formula

rpad(_.sku, 10, ' ') ++ lpad(String(_.qty), 5, '0')

出力

"A-100     00002"

SKUは、右側がパディングされた10文字の列を占有します。数量は、左側がゼロパディングされた5文字の列を占有します。 qtyはIntegerであるため、パディングの前にString(...)で変換します。

文字列の一部を抽出する ​

次の関数は、文字列の残りの部分を変更せずに文字列の一部を読み取るか抽出します。

substring ​

コードポイントインデックスによって文字列の一部を抽出します。負の開始位置は末尾から逆に数えます。

substring(string, start, length)

substring('SO-1001', 3)

1001

substring('SO-1001', 0, 2)

SO

substring('SO-1001', -4)

1001

index_of ​

部分文字列の最初の出現箇所のゼロベースインデックスを返します。見つからない場合は-1を返します。

index_of(string, substring)

index_of('orders/SO-1001', '/')

6

split ​

リテラル区切り文字で文字列をリストに分割します。

split(string, separator)

split('a@example.com,b@example.com', ',')

["a@example.com", "b@example.com"]

split_regex ​

正規表現で文字列をリストに分割します。区切り文字が変化する場合に使用します。

split_regex(string, pattern)

split_regex('A-100; B-220,C-050', '[;,]\s*')

["A-100", "B-220", "C-050"]

match ​

最初の正規表現一致をマップとして返します。一致がない場合はnullを返します。キー0は完全一致、数値キーは各キャプチャグループを保持し、名前付きキャプチャも名前で使用できます。

match(string, pattern)

match('SO-1001', '^(?<prefix>[A-Z]+)-(?<number>\d+)$')

{"0": "SO-1001", "1": "SO", "2": "1001", prefix: "SO", number: "1001"}

match_all ​

すべての正規表現一致を、matchと同じキー構造を使用してマップのリストとして返します。

match_all(string, pattern)

match_all('A-100 B-220', '[A-Z]-\d+')

[{"0": "A-100"}, {"0": "B-220"}]

parse_url ​

URLをそのコンポーネントに解析します。

parse_url(string)

parse_url('https://api.example.com:8443/v2/orders?status=open#top')

{scheme: "https", host: "api.example.com", port: 8443, path: "/v2/orders", query: "status=open", fragment: "top"}

ユースケース: コールバックパスから識別子を抽出する ​

インバウンドコールバックは、URLパス内に注文番号を保持します。セグメントの位置に依存せずに取り出すには、名前付きキャプチャグループを使用します。

入力

{
  "path": "/orders/SO-1001/lines"
}

Formula

match(_.path, '/orders/(?<order>[A-Z]{2}-\d+)/').order

出力

"SO-1001"

matchはマップを返すため、Formulaはorderキーを直接読み取ります。パスが一致しない場合、matchはnullを返し、その結果としてキーの読み取りは失敗します。ソースデータが変化する場合は、|?でフォールバックを追加します。詳細は演算子ドキュメントを参照してください。

文字列の一部を置換する ​

WELには、リテラルマッチングと正規表現マッチング用の別々の関数があります。それぞれに、最初の一致とすべての一致の形式があります。

replace_all ​

リテラル部分文字列のすべての出現箇所を置換します。

replace_all(string, pattern, replacement)

replace_all('A-100-X', '-', '')

A100X

replace_first ​

リテラル部分文字列の最初の出現箇所を置換します。

replace_first(string, pattern, replacement)

replace_first('A-100-X', '-', '')

A100-X

replace_all_regex ​

すべての正規表現一致を置換します。 gsubはエイリアスです。

replace_all_regex(string, pattern, replacement)

replace_all_regex('SO 1001  extra', '\s+', ' ')

SO 1001 extra

gsub('(555) 123-4567', '[^0-9]', '')

5551234567

replace_first_regex ​

最初の正規表現一致を置換します。 subはエイリアスです。

replace_first_regex(string, pattern, replacement)

sub('SO-1001', '^SO', 'PO')

PO-1001

concat ​

2つの文字列を結合します。 2つを超える文字列を結合する場合、または他の型を混在させる場合は、++または文字列補間を使用します。

concat(first, second)

concat('Josh', ' Ito')

Josh Ito

_.first_name ++ ' ' ++ _.last_name
"Order ${_.order_id} for ${_.customer}"

ユースケース: インバウンド連絡先を正規化する ​

サインアップwebhookは、間隔と大文字小文字が一貫しない名前、およびダウンストリームCRMが大文字と小文字を区別して扱うメールアドレスを配信します。レコードが作成される前に、文字列関数を使用して3つのフィールドすべてを正規化します。

入力

{
  "first_name": "  josh ",
  "last_name": "ITO",
  "email": " Josh@Example.COM "
}

Formula

{
  full_name: titleize(trim(_.first_name) ++ ' ' ++ trim(_.last_name)),
  email: lower(trim(_.email))
}

出力

{
  "full_name": "Josh Ito",
  "email": "josh@example.com"
}

trimは、++で結合する前に各フィールドから空白を削除するため、結合用のスペースが名前の間にある唯一のスペースになります。その後、titleizeが両方の名前の大文字小文字を一度に修正します。 lowerは、入力方法に関係なく既存のCRMレコードと一致するようにアドレスを正規化します。

関連情報 ​

• データ型: 文字列関数にStringが必要な理由。
• 文字列とフォーマット: 補間、f文字列、フォーマット仕様に関する情報。
• 演算子: ++、パイプ>>、フォールバック演算子に関する情報。
• エラーコード: E100やE201などのジョブ失敗をトラブルシューティングします。