リストとハッシュの formula ​

基本的なデータ型 (文字列や整数など) のほかにも、複数の要素に関する情報や、単一の要素に関する複数の情報を含んでいる、より複雑なデータ構造もあります。

たとえば次のようなデータ構造です。

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

Workato の formula は、ホワイトリストで許可された Ruby メソッドです。したがって、すべての Ruby メソッドがサポートされているわけではありません。その他の formula をホワイトリストに追加したい場合は、弊社までご連絡ください。

リスト (配列) ​

配列は、任意のオブジェクトからなる順序付きの集まりであり、整数のインデックスが付けられています。リストのインデックスは0から始まります。リストと配列は同一のデータ構造を表します。

以下の例は、整数のリストがどのように表現されるかを示しています。

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

リストは順序付けられているため、以下の formula を使用して値を取得できます。この構文で取得できるのは、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 }
]

リストの formula ​

ハッシュのリストの例 ​

以下に、 Contacts というハッシュのリストの例を示します。

この Contacts リストを表形式で表すと、次のようになります。

この Contacts リストをハッシュのリストの形式で表すと、次のようになります。

[
  {
    'name' => 'Joe',
    'email' => 'joe@abc.com',
    'state' => 'CA',
    'company' => 'ABC',
    'company_rev' => 1000,
    'description' => { 'summary' => 'First time buyer', 'estimated_value' => 300 }
  },
  {
    'name' => 'Jill',
    'email' => 'jill@nbc.com',
    'state' => 'MA',
    'company' => 'NBC',
    'company_rev' => 1000,
    'description' => { 'summary' => 'Referral', 'estimated_value' => 500 }
  },
  {
    'name' => 'Joan',
    'email' => 'joan@nbc.com',
    'state' => 'MA',
    'company' => 'NBC',
    'company_rev' => 10000,
    'description' => { 'summary' => 'Recurring customer', 'estimated_value' => 900 }
  },
  {
    'name' => 'Jack',
    'email' => 'jack@hbo.com',
    'state' => 'CA',
    'company' => 'HBO',
    'company_rev' => 30000,
    'description' => { 'summary' => 'Recurring customer', 'estimated_value' => 1000 }
  }
]

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 - リスト内で検索する値。

使用例 ​

where ​

指定された WHERE 条件を満たす行 (ハッシュ) のみを取得します。この formula は、1つ以上のキーと値のペアを含むハッシュの形式で単一の引数を受け付けます。

条件のデフォルトのオペランドは Equal to (==) です。この formula は、以下のオぺランドにも対応しています。オペランドは、キーの末尾にスペースで区切りを入れ、その後に追加する必要があります。

使用例 ​

[
  {
    'name' => 'Joe',
    'email' => 'joe@abc.com',
    'state' => 'CA',
    'company' => 'ABC',
    'company_rev' => 1000
  },
  {
    'name' => 'Jack',
    'email' => 'jack@hbo.com',
    'state' => 'CA',
    'company' => 'HBO',
    'company_rev' => 30000
  }
]

[
  {
    'name' => 'Jack',
    'email' => 'jack@hbo.com',
    'state' => 'CA',
    'company' => 'HBO',
    'company_rev' => 30000
  }
]

[
  {
    'name' => 'Joe',
    'email' => 'joe@abc.com',
    'state' => 'CA',
    'company' => 'ABC',
    'company_rev' => 1000
  },
  {
    'name' => 'Jack',
    'email' => 'jack@hbo.com',
    'state' => 'CA',
    'company' => 'HBO',
    'company_rev' => 30000
  }
]

[
  {
    'name' => 'Joe',
    'email' => 'joe@abc.com',
    'state' => 'CA',
    'company' => 'ABC',
    'company_rev' => 1000
  },
  {
    'name' => 'Joan',
    'email' => 'joan@nbc.com',
    'state' => 'MA',
    'company' => 'NBC',
    'company_rev' => 10000
  }
]

[
  {
    'name' => 'Jack',
    'email' => 'jack@hbo.com',
    '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 ​

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

使用例 ​

["joe@abc.com", "jill@nbc.com", "joan@nbc.com", "jack@hbo.com"]

[["joe@abc.com", "ABC"], ["jill@nbc.com", "NBC"], ["joan@nbc.com", "NBC"], ["jack@hbo.com", "HBO"]]

[
  ["joe@abc.com", "First time buyer"],
  ["jill@nbc.com", "Referral"],
  ["joan@nbc.com", "Recurring customer"],
  ["jack@hbo.com", "Recurring customer"]
]

format_map ​

与えられたハッシュの配列の各行を整形して、文字列の配列を作り出します。作り出した文字列に静的なテキストを追加することもできます。フィールドは %{ <field_name> } という形式で表現します。

使用例 ​

contacts.format_map('Name: %{name}, Email: %{email}, Company: %{company}') は以下を返します。

[
  'Name: Joe, Email: joe@abc.com, Company: ABC' ,
  'Name: Jill, Email: jill@nbc.com, Company: NBC' ,
  'Name: Joan, Email: joan@nbc.com, Company: NBC' ,
  'Name: Jack, Email: jack@hbo.com, Company: HBO' ,
]

この例からは、文字列のリストが得られます。リスト "contacts" の各行につき1つの文字列となっています。表記のとおり、name、email、company という3つのフィールドのデータが使用されています。

join ​

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

構文 ​

List.join(separator)

• List - リスト型の入力。
• separator - 項目が結合されたときに、その間に挿入される文字。区切り文字を指定しない場合、リストの項目は一続きに結合されます。

使用例 ​

動作 ​

リストの項目が結合され、1つのテキスト文字列になります。区切り文字が各項目の間に挿入されます。

関連情報 ​

• split: 指定した文字を中心に文字列を分割し、文字列の配列を返します。

smart_join ​

リストの要素を結合して1つの文字列にします。空の値と nil 値は取り除かれ、空白は結合前に切り詰められます。

構文 ​

List.smart_join(separator)

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

使用例 ​

reverse ​

リストの順序を逆にします。

構文 ​

List.reverse

• List - リスト型の入力。

使用例 ​

sum ​

整数や小数の場合は、数値が足し合わせ、合計値を取得します。文字列の場合は、文字列を連結し、1つの長い文字列を生成します。

構文 ​

List.sum

• List - リスト型の入力。

使用例 ​

uniq ​

ユニークな項目からなるリストを返します。

構文 ​

List.uniq

• List - リスト型の入力。

使用例 ​

flatten ​

多次元配列 (配列の配列) を一次元配列にフラット化します。

構文 ​

List.flatten

• List - リスト型の入力。

使用例 ​

length ​

自身に含まれる要素の数を返します。リストが空の場合は0を返します。

構文 ​

List.length

• List - リスト型の入力。

使用例 ​

max ​

配列内の最大値を返します。数値を比較するときは、最も大きい数が返されます。文字列を比較するときは、最大の ASCII 値を持つ文字列が返されます。

構文 ​

List.max

• List - リスト型の入力。

使用例 ​

min ​

配列内の最小値を返します。数値を比較するときは、最も小さい数が返されます。文字列を比較するときは、最小の ASCII 値を持つ文字列が返されます。

構文 ​

List.min

• List - リスト型の入力。

使用例 ​

compact ​

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

使用例 ​

条件 ​

blank? ​

この formula は入力文字列をチェックし、それが空の文字列または null である場合に true を返します。

構文 ​

Input.blank?

• Input - 入力データピル。利用できるデータ型には、文字列や数値、日付、日時があります。

使用例 ​

動作 ​

入力値が null または空の文字列の場合、この formula は true を返します。他のデータの場合は false を返します。

関連情報 ​

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

include? ​

文字列に特定の部分文字列が含まれているかどうかをチェックします。含まれている場合は true を返します。

構文 ​

Input.include?(substring)

• Input - 文字列の入力。
• substring - チェック対象の部分文字列。

使用例 ​

動作 ​

この formula は文字列に特定の部分文字列が含まれているかどうかをチェックします。含まれている場合は true を返し、含まれていない場合は false を返します。この部分文字列は大文字と小文字が区別されます。

このメソッドは、exclude? とは反対の働きをします。入力文字列に指定されたキーワードが含まれている場合に限り、true を返します。

関連情報 ​

• exclude?: 文字列に特定の部分文字列が含まれているかどうかをチェックします。含まれている場合は false を返します。

present? ​

この formula は入力データをチェックし、値が存在する場合は true を返します。入力データが nil、ブール値の 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 行を生成します。この formula はエスケープを処理します。CSV 行内では、nil 値や空の文字列も表現されます。

構文 ​

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 - ハッシュデータ型の入力。

使用例 ​