リストとハッシュのFormula ​

基本データ型（文字列や整数など）に加えて、複数の項目に関する情報や、1つの項目に関する複数の情報を含む、より複雑なデータ構造を扱う場合があります。

次のデータ構造を扱う場合があります:

• リスト（配列とも呼ばれます）
• ハッシュ
• ハッシュのリスト

WorkatoのFormulaは、Rubyメソッドの許可リストに追加されます。 許可リストに含まれるRubyメソッドのみがサポートされます。 許可リストへの新しいFormulaの追加をリクエストするには、Customer Success Managerにお問い合わせください。

リスト（配列） ​

配列は、任意のオブジェクトの順序付き整数インデックス付きコレクションです。 リストのインデックスは0から始まります。 リストと配列は同じデータ構造を指します。

次の例では、整数のリストは次のように表されます:

number_list = [100, 101, 102, 103, 104]

リストは順序付けられているため、次のFormulaを使用して値を取得できます。 Workatoでは、この構文を使用して取得できるのは5番目の項目までです。

インデックスを使用して、対応する値を取得することもできます。 インデックスは0から始まることに注意してください:

Rubyのリストは負のインデックスをサポートします。

リストは、インデックスとして範囲もサポートします。 これは値のみではなく、別のリストを返します。

ハッシュ ​

ハッシュは、一意のキーとその値の辞書のようなコレクションです。 リストと似ていますが、リストがインデックスとして整数を使用するのに対し、ハッシュでは任意のオブジェクト型を使用できます。 ハッシュは、対応するキーが挿入された順序で値を列挙します。

2つの値を持つハッシュの例を見てみましょう。'Acme widgets'と10は、それぞれitem_nameとitem_quantityの値です。

line_item = { 'item_name' => 'Acme widgets', 'item_qty' => 10 }

ハッシュのリスト ​

複数の明細項目を持つ請求書の例を次に示します。 これはハッシュのリストとして表されます。

line_items = [
  { 'item_no': 1, 'item_name' => 'Acme widgets', 'item_qty' => 10 },
  { 'item_no': 2, 'item_name' => 'RR bearings',  'item_qty' => 99 },
  { 'item_no': 3, 'item_name' => 'Coyote tyres', 'item_qty' => 7 }
]

ハッシュのリストの例 ​

次は、Contactsというハッシュのリストの例です。

これはテーブル形式のContactsリストです:

これは、ハッシュのリスト形式のContactsリストです。

[
  {
    'name' => 'Joe',
    'email' => '[email protected]',
    'state' => 'CA',
    'company' => 'ABC',
    'company_rev' => 1000,
    'description' => { 'summary' => 'First time buyer', 'estimated_value' => 300 }
  },
  {
    'name' => 'Jill',
    'email' => '[email protected]',
    'state' => 'MA',
    'company' => 'NBC',
    'company_rev' => 1000,
    'description' => { 'summary' => 'Referral', 'estimated_value' => 500 }
  },
  {
    'name' => 'Joan',
    'email' => '[email protected]',
    'state' => 'MA',
    'company' => 'NBC',
    'company_rev' => 10000,
    'description' => { 'summary' => 'Recurring customer', 'estimated_value' => 900 }
  },
  {
    'name' => 'Jack',
    'email' => '[email protected]',
    'state' => 'CA',
    'company' => 'HBO',
    'company_rev' => 30000,
    'description' => { 'summary' => 'Recurring customer', 'estimated_value' => 1000 }
  }
]

リストのFormula ​

first ​

このFormulaは、リスト内の最初の項目を返します。

リスト内の最初の_n_個の項目を返すためにも使用できます。 この場合、出力はリストとしてフォーマットされます。

構文 ​

List.first(number)

• List - 入力リスト。
• number - （任意）リストから取得する項目数。 指定しない場合、Formulaは_1つ_の項目のみを返します。

利用例 ​

仕組み ​

このFormulaは、リストから最初の_n_個の項目を返します。 _n_が1より大きい場合、出力はリストとしてフォーマットされます。

関連項目 ​

• last: リスト内の最後の_n_個の項目を返します。
• where: 特定の条件を満たすリスト項目のサブセットを返します。

last ​

このFormulaは、リスト内の最後の項目を返します。

リスト内の最後の_n_個の項目を返すためにも使用できます。 この場合、出力はリストとしてフォーマットされます。

構文 ​

List.last(number)

• List - 入力リスト。
• number - （任意）リストから取得する項目数。 指定しない場合、Formulaは_1つ_の項目のみを返します。

利用例 ​

仕組み ​

このFormulaは、リストから最後の_n_個の項目を返します。 _n_が1より大きい場合、出力はリストとしてフォーマットされます。

関連項目 ​

• first: リスト内の最初の_n_個の項目を返します。
• where: 特定の条件を満たすリスト項目のサブセットを返します。

index ​

指定された値に一致する最初の項目のインデックスを返します。 一致する項目が見つからない場合はnilを返します。

構文 ​

Input.index(value)

• Input - 入力リスト。
• value - リスト内で検索する値。

利用例 ​

count ​

リスト内の項目数を返します。

構文 ​

List.count

• List - リストデータ型の入力。

利用例 ​

where ​

指定されたWHERE条件を満たす行（ハッシュ）のみを取得します。 このFormulaは、1つ以上のキーと値のペアを持つハッシュ形式の単一引数を受け入れます。

条件のデフォルトのオペランドは等しい（==）です。 このFormulaは、次のオペランドもサポートします。 オペランドは、キーの末尾にスペースで区切って追加する必要があります。

利用例 ​

[
  {
    'name' => 'Joe',
    'email' => '[email protected]',
    'state' => 'CA',
    'company' => 'ABC',
    'company_rev' => 1000
  },
  {
    'name' => 'Jack',
    'email' => '[email protected]',
    'state' => 'CA',
    'company' => 'HBO',
    'company_rev' => 30000
  }
]

[
  {
    'name' => 'Jack',
    'email' => '[email protected]',
    'state' => 'CA',
    'company' => 'HBO',
    'company_rev' => 30000
  }
]

[
  {
    'name' => 'Jill',
    'email' => '[email protected]',
    'state' => 'MA',
    'company' => 'NBC',
    'company_rev' => 1000
  },
  {
    'name' => 'Joan',
    'email' => '[email protected]',
    'state' => 'MA',
    'company' => 'NBC',
    'company_rev' => 10000
  }
]

[
  {
    'name' => 'Joe',
    'email' => '[email protected]',
    'state' => 'CA',
    'company' => 'ABC',
    'company_rev' => 1000
  },
  {
    'name' => 'Jack',
    'email' => '[email protected]',
    'state' => 'CA',
    'company' => 'HBO',
    'company_rev' => 30000
  }
]

[
  {
    'name' => 'Joe',
    'email' => '[email protected]',
    'state' => 'CA',
    'company' => 'ABC',
    'company_rev' => 1000
  },
  {
    'name' => 'Joan',
    'email' => '[email protected]',
    'state' => 'MA',
    'company' => 'NBC',
    'company_rev' => 10000
  }
]

[
  {
    'name' => 'Jack',
    'email' => '[email protected]',
    'state' => 'CA',
    'company' => 'HBO',
    'company_rev' => '30000'
  }
]

except ​

指定されたキー以外のすべてを含むハッシュを返します。

hash = { a: true, b: false, c: nil }
hash.except(:c)     # => { a: true, b: false }
hash.except(:a, :b) # => { c: nil }
hash                # => { a: true, b: false, c: nil }

pluck ​

指定された列のみを取得します。

利用例 ​

["[email protected]", "[email protected]", "[email protected]", "[email protected]"]

[["[email protected]", "ABC"], ["[email protected]", "NBC"], ["[email protected]", "NBC"], ["[email protected]", "HBO"]]

[
  ["[email protected]", "First time buyer"],
  ["[email protected]", "Referral"],
  ["[email protected]", "Recurring customer"],
  ["[email protected]", "Recurring customer"]
]

format_map ​

入力配列内の各項目にフォーマットを適用して、新しい文字列配列を作成します。 ハッシュの場合は%{field_name}、サブ配列およびスカラー値の場合は%sを使用して、フォーマット文字列内で入力値を参照できます。

利用例 ​

[
  { name: 'Alex',  email: '[email protected]',  company: 'ACME' },
  { name: 'Hao',   email: '[email protected]',   company: 'ACME' },
  { name: 'Kai',   email: '[email protected]',   company: 'STARK' },
  { name: 'Sasha', email: '[email protected]', company: 'ACME' }
].format_map('Name: %{name}, Email: %{email}, Company: %{company}')

[
  'Name: Alex, Email: [email protected], Company: ACME',
  'Name: Hao, Email: [email protected], Company: ACME',
  'Name: Kai, Email: [email protected], Company: STARK',
  'Name: Sasha, Email: [email protected], Company: ACME',
]

[
  ['Alex', '[email protected]', 'ACME'],
  ['Hao', '[email protected]', 'ACME'],
  ['Kai', '[email protected]', 'STARK'],
  ['Sasha', '[email protected]', 'ACME']
].format_map('Name: %s, Email: %s, Company: %s')

[
  'Name: Alex, Email: [email protected], Company: ACME',
  'Name: Hao, Email: [email protected], Company: ACME',
  'Name: Kai, Email: [email protected], Company: STARK',
  'Name: Sasha, Email: [email protected], Company: ACME'
]

['Alex', 'Hao', 'Kai'].format_map('Name: %s')

[
  'Name: Alex',
  'Name: Hao',
  'Name: Kai'
]

join ​

リスト内のすべての項目を1つのテキスト文字列に結合します。 各項目の間に区切り文字が配置されます。

構文 ​

List.join(separator)

• List - リストデータ型の入力。
• separator - 項目を結合するときに項目間に追加する文字。 区切り文字が指定されていない場合、リスト項目はそのまま結合されます。

利用例 ​

仕組み ​

リスト項目は1つのテキスト文字列に結合されます。 区切り文字は各項目の間に追加されます。

関連項目 ​

• split: 指定された文字で文字列を分割し、文字列の配列を返します。

smart_join ​

リスト要素を文字列に結合します。 結合する前に、空の値とnil値を削除し、空白をトリミングします。

構文 ​

List.smart_join(separator)

• List - リストデータ型の入力。
• separator - 項目を結合するときに項目間に追加する文字。 区切り文字が指定されていない場合、結合文字として空白が使用されます。

利用例 ​

concat ​

2つのリストを1つのリストに連結します。 ネストされたリストはフラット化されません。

構文 ​

List.concat(list_to_be_joined)

• List - リストデータ型の入力。
• list_to_be_joined - 元のリスト入力と連結するもう一方のリスト。

利用例 ​

reverse ​

リストの順序を反転します。

構文 ​

List.reverse

• List - リストデータ型の入力。

利用例 ​

sum ​

整数と小数の場合、数値が加算され、合計が得られます。 文字列の場合、文字列が連結されて、より長い文字列が形成されます。

構文 ​

List.sum

• List - リストデータ型の入力。

利用例 ​

uniq ​

一意の項目を含むリストを返します。

構文 ​

List.uniq

• List - リストデータ型の入力。

利用例 ​

flatten ​

多次元配列（配列の配列）を単一次元配列にフラット化します。

構文 ​

List.flatten

• List - リストデータ型の入力。

利用例 ​

length ​

self内の要素数を返します。 リストが空の場合は0を返します。

構文 ​

List.length

• List - リストデータ型の入力。

利用例 ​

max ​

配列内の最大値を返します。 数値を比較する場合、最大の数値が返されます。 文字列を比較する場合、最大のASCII値を持つ文字列が返されます。

構文 ​

List.max

• List - リストデータ型の入力。

利用例 ​

min ​

配列内の最小値を返します。 数値を比較する場合、最小の数値が返されます。 文字列を比較する場合、最小のASCII値を持つ文字列が返されます。

構文 ​

List.min

• List - リストデータ型の入力。

利用例 ​

compact ​

配列とハッシュからnil値を削除します。

利用例 ​

条件 ​

blank? ​

Rubyの慣例に従って、入力が空白とみなされるかどうかをチェックします。 これには以下が含まれます:

• Null値
• 空の入力
• falseのブール値
• 空白文字のみを含む文字列
• 値を持たない数値。NaN（not a number）と呼ばれることがあります。 これは未定義の値、または表現できない値です。 たとえば、ゼロ除算の結果、または欠損値です。

構文 ​

Input.blank?

• Input - 入力データピル。 これは、文字列、数値、日付、日時、ブール値、配列、またはオブジェクトデータ型にできます。

サンプル利用状況 ​

仕組み ​

入力がRubyの慣例に従って空白とみなされる場合、Formulaはtrueを返します。 その他のデータの場合は、falseを返します。

関連項目 ​

• presence: データが存在する場合はデータを返し、存在しない場合はnilを返します。
• present?: 有効な入力がある場合はtrueを返します。

include? ​

文字列に特定の部分文字列が含まれるか、リストに要素が含まれるかを確認します。 含まれる場合はtrueを返します。

構文 ​

Input.include?(substring)

• Input - 文字列またはリスト入力。
• substring_or_element - 確認する部分文字列または要素。

利用例 ​

仕組み ​

このFormulaは、文字列に特定の部分文字列が含まれるか、リストに特定の要素が含まれるかを確認します。 含まれる場合はtrueを返し、それ以外の場合はfalseを返します。 部分文字列の比較では大文字と小文字が区別され、要素の比較は完全一致です。

この関数はexclude?とは逆の動作をします。 後者は、入力文字列またはリストに指定されたキーワードまたは要素が含まれない場合にのみtrueを返します。

関連項目 ​

• exclude?: 文字列に特定の部分文字列が含まれるか、リストに要素が含まれるかを確認します。 含まれる場合はfalseを返します。

exclude? ​

文字列に特定の部分文字列が含まれるか、リストに要素が含まれるかを確認します。 含まれる場合はfalseを返します。

構文 ​

Input.exclude?(substring)

• Input - 文字列またはリスト入力。
• substring_or_element - 確認する部分文字列または要素。

利用例 ​

仕組み ​

このFormulaは、文字列に特定の部分文字列が含まれるか、リストに特定の要素が含まれるかを確認します。 含まれる場合はfalseを返し、それ以外の場合はtrueを返します。 部分文字列の比較では大文字と小文字が区別され、要素の比較は完全一致です。

この関数はinclude?とは逆の動作をします。 後者は、入力文字列またはリストに指定されたキーワードまたは要素が含まれる場合にのみtrueを返します。

関連項目 ​

• include?: 文字列に特定の部分文字列が含まれるか、リストに要素が含まれるかを確認します。 含まれる場合はtrueを返します。

present? ​

このFormulaは入力を確認し、値が存在する場合はtrueを返します。 入力がnil、boolean false、空の文字列、または空のリストの場合、Formulaはfalseを返します。

構文 ​

Input.present?

• Input - 入力データピル。 文字列、数値、日付、またはリストのデータ型を使用できます。

サンプル利用状況 ​

仕組み ​

入力がnull、空の文字列、または空のリストの場合、Formulaはfalseを返します。 その他のデータの場合はtrueを返します。

関連項目 ​

• presence: データが存在する場合はデータを返し、存在しない場合はnilを返します。
• blank?: データが存在しない場合、または文字列が空白のみで構成される場合はnilを返します。

presence ​

データが存在する場合はそのデータを返し、存在しない場合はnilを返します。

構文 ​

Input.presence

• Input - 入力データピル。 文字列、数値、日付、または日時のデータ型を使用できます。

サンプル利用状況 ​

仕組み ​

入力がnullまたは空の文字列の場合、Formulaはnilを返します。 その他のデータの場合は、元の入力データを返します。

関連項目 ​

• blank?: データが存在しない場合、または文字列が空白のみで構成される場合はnilを返します。
• present?: 有効な入力がある場合はtrueを返します。

変換 ​

次のFormulaを使用すると、配列から他のデータ型にデータを変換できます

to_csv ​

配列からCSV行を生成します。 これはエスケープを処理します。 Nil値と空の文字列もcsv行内に表されます。

構文 ​

Input.to_csv

• Input - リストデータ型の入力。

利用例 ​

to_json ​

ハッシュまたは配列をJSON文字列に変換します。

構文 ​

Input.to_json

• Input - 入力データピル。 リストまたはハッシュデータ型を指定できます。

利用例 ​

to_xml ​

ハッシュまたは配列をXML文字列に変換します。

構文 ​

Input.to_xml

• Input - 入力データピル。 リストまたはハッシュデータ型を指定できます。

利用例 ​

from_xml ​

XML文字列をハッシュに変換します。

構文 ​

Input.from_xml

• Input - 入力XMLデータ。

利用例 ​

<?xml version=\"1.0\" encoding=\"UTF-8\" ?>

<hash>
  <foo type="integer">123</foo>
</hash>

{ "hash":
  [ "foo":
    [
      { "@type": "integer",
        "content!": "1"
      }
    ]
  ]
}

encode_www_form ​

ハッシュをURLエンコードされたパラメーター文字列に結合します。

構文 ​

Input.encode_www_form

• Input - ハッシュデータ型の入力。

利用例 ​

to_param ​

URLクエリ文字列として使用する文字列表現を返します。

構文 ​

Input.to_param

• Input - ハッシュデータ型の入力。

利用例 ​

keys ​

入力ハッシュからキーの配列を返します。

構文 ​

Input.keys

• Input - ハッシュデータ型の入力。

利用例 ​

values ​

入力ハッシュから値の配列を返します。

構文 ​

Input.values

• Input - ハッシュデータ型の入力。

利用例 ​

リストのオペランド ​

差分（-） ​

2つの配列の差分を返します。つまり、最初の配列のコピーから、2番目の配列にも存在する項目を除いた新しい配列です。

構文 ​

list - updated_list

• - 差分/減算オペランド
• list - 元のリスト
• updated_list - 更新済みリスト

利用例 ​

contactsとupdated_contactsという2つの配列があるとします:

contacts = ["Ariel", "Max", "Kai", "Noam", "Tal"]

updated_contacts = ["Ariel", "Max", "Kai", "Lee", "Quinn"]

仕組み ​

このオペランドは、2つの配列間の差分である配列を作成します。 最初の例contacts - updated_contactsは、contactsに存在し、updated_contactsには存在しない項目の配列を返します。 これは重複項目を単に削除するわけではない点に注意することが重要です。操作の順序を逆にすると、異なる結果が得られます。 たとえば、updated_contactsとcontactsの差分を求めると、新しい配列にはupdated_contactsに存在し、contactsには存在しない項目が含まれます。

関連項目 ​

• where: 特定の条件を満たすリスト項目のサブセットを返します。 whereを使用して2つのリストを比較するには、notオペランドのチェーンの例を参照してください。

和集合（&） ​

Workatoでは、配列を直接操作するための和集合（&）オペランドはサポートされていませんが、concatとuniqのFormulaを組み合わせることで同様の結果を得ることができます。

構文 ​

list.concat(updated_list).uniq

• list - リスト
• concat - 2つのリストを1つのリストに連結します
• updated_list - 更新済みリスト
• uniq - 一意の値を含むリストを返します

利用例 ​

仕組み ​

concatは2つのリストを1つのリストに連結し、uniqは一意の項目を含むリストを返します。 2つのFormulaを組み合わせることで、2つのリストを結合し、出現する可能性のある重複項目を削除できます。