マップ関数 ​

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

Mapはキーと値のペアの集合であり、JSONオブジェクト用のWELの型です。マップ関数は、そのキーと値の読み取り、あるマップと別のマップの結合、フィールドの削除、およびリスト関数が操作できるようにマップとリストの間の変換を行います。

キーはデフォルトで String です。挿入順序は保持されるため、意図した順序で作成されたマップはその順序でシリアル化されます。

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

マップ関数を呼び出す ​

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

wel
keys(_.customer)
_.customer >> keys

フィールドはピリオド(.)で読み取ります。キーが計算される場合やベア識別子でない場合は、角かっこ([])を使用します。

wel
_.customer.email
_.customer['email']

存在しないキーを読み取るとE104が発生します。最初にテストするにはhas_key?を使用し、デフォルトを指定するにはtry-fallback演算子|?を使用します。

wel
_.customer.nickname |? 'none'

キーと値の読み取り ​

次の関数は、マップを変更せずにマップのキーと値を読み取ります。

keys ​

キーを挿入順序でリストとして返します。

wel
keys(map)
パラメーター説明
map読み取るマップ。
マップのキーを取得する

次の例は、マップのキーを挿入順序で返します。

Formula

wel
keys({sku: 'WID-1', qty: 3})

出力

wel
["sku", "qty"]

values ​

値を挿入順序でリストとして返します。 Skipである値は省略されます。

wel
values(map)
パラメーター説明
map読み取るマップ。
マップの値を取得する

次の例は、マップの値を挿入順序で返します。

Formula

wel
values({sku: 'WID-1', qty: 3})

出力

wel
["WID-1", 3]

has_key? ​

キーが存在する場合はtrueを返します。

キーのテストは、値のテストと同じではありません。 null値を持つキーが存在する場合、ここではtrueを返します。使用可能な値をテストするには、代わりにpresent?を使用します。

wel
has_key?(map, key)
パラメーター説明
mapテストするマップ。
keyStringとしてのキー名。文字列以外のデータ型はE100をスローします。
存在するキーはtrueを返す

次の例は、マップに存在するキーをテストします。

Formula

wel
has_key?({sku: 'WID-1'}, 'sku')

出力

wel
true
存在しないキーはfalseを返す

次の例は、マップに存在しないキーをテストします。

Formula

wel
has_key?({sku: 'WID-1'}, 'qty')

出力

wel
false

at ​

指定したキーにある値を返します。 null値で存在するキーは、エラーを送出するのではなくnullを返します。 atはListにも使用でき、その場合はキーではなくIntegerのインデックスを受け取ります。

wel
at(map, key)
パラメーター説明
map読み取り元のマップ。
keyStringとしてのキー名。存在しないキーは、捕捉可能なE104を送出します。文字列以外のデータ型はE100をスローします。
キーにある値を取得

次の例では、キーにある値を取得します。

Formula

wel
at({sku: 'WID-1', qty: 3}, 'qty')

出力

wel
3

フィールドの選択 ​

次の関数は、マップをより小さく安全なフィールドのセットに絞り込みます。

pluck ​

指定されたキーだけを含むMapを返します。キーの順序はMap自体の順序ではなく、keysにリストされている順序になります。 pluckは存在しないキーをスキップし、複数回指定されたキーは重複を排除します。

これを使用して、大きな受信レコードを宛先が実際に受け入れるフィールドに絞り込みます。

wel
pluck(map, keys)
パラメーター説明
map読み取り元のマップ。
keys保持するキー名のリスト。文字列以外のデータ型はE100をスローします。
指定されたキーのみを保持する

次の例は、マップから指定されたキーのみを保持します。

Formula

wel
pluck({id: 1, secret: 'x', name: 'a'}, ['id', 'name'])

出力

wel
{id: 1, name: "a"}
存在しないキーは、エラーを発生させるのではなくスキップされる

次の例は、存在しないキーをpluckします。このキーは、エラーを発生させるのではなくスキップされます。

Formula

wel
pluck({id: 1}, ['id', 'missing'])

出力

wel
{id: 1}

except ​

指定されたキーを削除したマップを返します。 exceptは、keysで指定されていてもMapに存在しないキーをスキップします。

pluckとexceptは反対の機能であり、安全性の観点ではどちらを選ぶかが重要です。 pluck は許可リストなので、上流の新しいフィールドはデフォルトで破棄されます。 exceptは拒否リストであるため、新しいフィールドはデフォルトで転送されます。新しく追加されたフィールドの漏えいが懸念される場合は、pluckを優先します。

wel
except(map, keys)
パラメーター説明
map読み取り元のマップ。
keys削除するキー名のリスト。文字列以外のデータ型はE100をスローします。
指定されたキーを削除する

次の例は、マップから指定されたキーを削除します。

Formula

wel
except({id: 1, secret: 'x', name: 'a'}, ['secret'])

出力

wel
{id: 1, name: "a"}

ユースケース:転送前に機密フィールドを削除する ​

受信ユーザーレコードには、宛先システムに届くべきではない資格情報が含まれています。レコードを転送する前に機密フィールドを削除するには、exceptを使用します。

入力

json
{
  "user": {
    "id": "U-1",
    "email": "nur@example.com",
    "password": "hunter2",
    "ssn": "111-22-3333"
  }
}

Formula

wel
_.user >> except(['password', 'ssn'])

出力

json
{"id": "U-1", "email": "nur@example.com"}

このexceptの使用は拒否リスト形式であり、ソースが送信できるすべてのフィールドを把握している間だけ安全です。ソースがフィールドを追加する可能性がある場合、pluck(['id', 'email'])は同じ意図を表すより安全な式です。

マップの結合 ​

次の関数は、2つのマップを1つに結合します。

merge ​

2つのマップを結合します。両方のMapで同じキーが定義されている場合は後のMapが優先され、優先された値がnullであっても同様です。 mergeは、両方のMapで定義されているキーを先のMapで持っていた位置に配置し、後のMapのみに存在するキーは末尾に追加します。

wel
merge(first, second)
パラメーター説明
firstベースマップ。
second値が優先されるマップ。
2つのマップをマージする。競合時は2番目が優先される

次の例は2つのマップをマージします。共有キーでは2番目のマップの値が優先されます。

Formula

wel
merge({sku: 'WID-1', qty: 1}, {qty: 5})

出力

wel
{sku: "WID-1", qty: 5}

ユースケース:デフォルトセットにオーバーライドを適用する ​

デフォルトのセットに呼び出し元が指定したオーバーライドを重ねて適用する必要があります。指定されたものはすべて優先され、省略されたものはフォールバックされます。 mergeでは、デフォルトを1番目に、呼び出し元の値を2番目に指定します。

入力

json
{
  "overrides": {"currency": "EUR", "notify": true}
}

Formula

wel
merge(
  {currency: 'USD', locale: 'en-US', notify: false},
  _.overrides
)

出力

json
{"currency": "EUR", "locale": "en-US", "notify": true}

mergeは1つのレベルを結合します。 2番目の引数にあるネストされたマップは、対応するマップにマージされるのではなく、そのまま置き換えます。

マップとリストの間の変換 ​

これら4つの関数によって、マップはリスト関数に到達できます。 entriesとpairsは一方向に変換します。 from_entriesとfrom_pairsは元に戻します。

entries ​

マップを{key, value}マップのリストに変換します。

wel
entries(map)
パラメーター説明
map変換するマップ。
マップをキー/値マップのリストに変換する

次の例は、マップを{key, value}マップのリストに変換します。

Formula

wel
entries({sku: 'WID-1', qty: 3})

出力

wel
[{key: "sku", value: "WID-1"}, {key: "qty", value: 3}]

from_entries ​

{key, value}マップのリストをマップに戻します。 entriesの逆です。

wel
from_entries(list)
パラメーター説明
listそれぞれにkeyとvalueを持つマップのリスト。 keyまたはvalueフィールドがない要素はE100を送出します。 IntegerやBooleanなどの非Stringキーは、Stringに強制変換されます。同じキーに強制変換される要素が2つあると、捕捉可能なE223が送出されます。
キー/値マップのリストをマップに戻す

次の例は、{key, value}マップのリストをマップに戻します。

Formula

wel
from_entries([{key: 'sku', value: 'WID-1'}])

出力

wel
{sku: "WID-1"}

pairs ​

マップを2要素の[key, value]リストのリストに変換します。値がSkipであるペアは省略されます。

wel
pairs(map)
パラメーター説明
map変換するマップ。
マップをキー/値ペアのリストに変換する

次の例は、マップを2要素の[key, value]リストのリストに変換します。

Formula

wel
pairs({sku: 'WID-1', qty: 3})

出力

wel
[["sku", "WID-1"], ["qty", 3]]

from_pairs ​

2要素の[key, value]リストのリストをマップに戻します。 pairsの逆です。

wel
from_pairs(list)
パラメーター説明
list2要素リストのリスト。不正な形式の要素はE100を送出します。非StringキーはStringに強制変換されます。同じキーに強制変換される要素が2つあると、捕捉可能なE223が送出されます。
キー/値ペアのリストをマップに戻す

次の例は、2要素の[key, value]リストのリストをマップに戻します。

Formula

wel
from_pairs([['sku', 'WID-1']])

出力

wel
{sku: "WID-1"}

変換せずにマップをフィルターする

filter_byはマップを直接受け入れます。ラムダはキーと値の2つのパラメーターを受け取り、結果はマップになります。

wel
{a: 1, b: 2} >> filter_by((k, v) ~> v > 1)

ネストされたマップのフラット化 ​

次の関数は、ネストされたマップを単一レベルに折りたたみ、パスを1つのキーに結合します。

flatten_map ​

ネストされたマップを単一レベルに折りたたみ、パスを1つのキーに結合します。

走査は挿入順序で深さ優先です。マップのみが下位にたどられます。リストはリーフ値として扱われ、全体が保持されます。空のネストされたマップもリーフです。

2つのネストされたキーが、同じフラット化されたキーに折りたたまれることがあります。これにより、一方の書き込みだけが黙って保持されるのではなく、捕捉可能なE223が送出されます。

wel
flatten_map(map, options)
パラメーター説明
mapフラット化するマップ。
optionsフラット化を制御するためのオプションのMap。認識されないオプションキーは、無視されるのではなくE225を送出します。
  • sep: キー区切り文字。デフォルトは.です。 256バイトを超えるセパレーターはE211を送出します。
  • max_depth: 下位にたどるレベル数。デフォルトは無制限です。整数以外のデータ型の場合はE218が発生します。負の値はE211を返します。
デフォルトの区切り文字でネストされたマップをフラット化する

次の例は、デフォルトの.区切り文字でパスを結合して、ネストされたマップをフラット化します。

Formula

wel
flatten_map({customer: {name: 'Nur', address: {city: 'London'}}})

出力

wel
{"customer.name": "Nur", "customer.address.city": "London"}
カスタム区切り文字でネストされたマップをフラット化する

次の例は、カスタム区切り文字を使用してネストされたマップをフラット化します。

Formula

wel
flatten_map({a: {b: 1}}, {sep: '_'})

出力

wel
{a_b: 1}

ユースケース:CSV行用にレコードをフラット化する ​

CSVの宛先ではフィールドごとに1つの列が必要ですが、ソースは2レベルの深さでネストされています。マップ関数を使用して、レコードを単一レベルにフラット化します。

入力

json
{
  "record": {
    "id": "C-1",
    "customer": {
      "name": "Nur",
      "address": {"city": "London", "postcode": "E1"}
    }
  }
}

Formula

wel
_.record >> flatten_map

出力

json
{
  "id": "C-1",
  "customer.name": "Nur",
  "customer.address.city": "London",
  "customer.address.postcode": "E1"
}

フラット化されたキーは、宛先が期待する列ヘッダーそのものです。ターゲットがヘッダー名のドットを受け入れない場合は、{sep: '_'}を渡します。

最終更新日: