文字列の formula ​

Ruby における文字列は、一続きのテキストや文字のことを指します。

Workato では、さまざまな文字列の formula をサポートしています。Workato の formula は、ホワイトリストで許可された Ruby メソッドです。したがって、すべての Ruby メソッドがサポートされているわけではありません。その他の formula をホワイトリストに追加したい場合は、いつでも弊社までご連絡ください。これらの formula の構文と機能は、基本的に変更されません。present?、presence、blank? を除く大部分の formula は、null (Ruby では nil で表されます) を処理しようとするとエラーを返し、ジョブを停止することに注意してください。

文字列に関する Ruby の詳細なドキュメントについては、こちらをご覧ください。

以下の例では、テキスト文字列を操作するために使用できるメソッドをいくつか紹介します。ここでは、入力文字列として「Jean Marie」を使うことにします。

条件 ​

このセクションでは、文字列に条件 (if-else) を適用できる formula について説明します。条件の詳しい使用方法については、こちらを参照してください。

blank? ​

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

構文 ​

Input.blank?

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

使用例 ​

動作 ​

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

関連情報 ​

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

is_not_true? ​

ブール値を評価し、評価された値が true でない場合に true を返します。

構文 ​

Input.is_not_true?

• Input - 入力されるブール値、整数 (1 または 0)、あるいは認められている文字列値。

使用例 ​

動作 ​

入力を受け取り、true であるか false であるかを評価します。

関連情報 ​

• is_true: ブール値を評価し、評価された値が true の場合に true を返します。

is_true? ​

ブール値を評価し、評価された値が true の場合に true を返します。

構文 ​

Input.is_true?

• Input - 入力されるブール値、整数 (1 または 0)、あるいは認められている文字列値。

使用例 ​

動作 ​

入力を受け取り、true であるか false であるかを評価します。

関連情報 ​

• is_not_true: ブール値を評価し、評価された値が true でない場合に true を返します。

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 を返します。

include? ​

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

構文 ​

Input.include?(substring)

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

使用例 ​

動作 ​

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

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

関連情報 ​

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

exclude? ​

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

構文 ​

Input.exclude?(substring)

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

使用例 ​

動作 ​

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

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

関連情報 ​

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

match? ​

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

構文 ​

Input.match?(pattern)

• Input - 文字列の入力。
• pattern - チェック対象のパターン。

使用例 ​

動作 ​

この formula は文字列に特定のパターンが含まれているかどうかをチェックします。含まれている場合は true を返し、含まれていない場合は false を返します。

関連情報 ​

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

ends_with? ​

文字列の末尾が特定の部分文字列であるかどうかをチェックします。そうである場合は true を返します。

構文 ​

Input.ends_with?(substring)

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

使用例 ​

動作 ​

この formula は、文字列の末尾が特定の部分文字列であるかどうかをチェックします。そうである場合は true を返し、そうでない場合は false を返します。

関連情報 ​

• include?: 文字列に特定の部分文字列が含まれているかどうかをチェックします。含まれている場合は true を返します。
• exclude?: 文字列に特定の部分文字列が含まれているかどうかをチェックします。含まれている場合は false を返します。
• match?: 文字列に特定のパターンが含まれているかどうかをチェックします。含まれている場合は true を返します。
• starts_with?: 文字列の先頭が特定の部分文字列であるかどうかをチェックします。そうである場合は true を返します。

starts_with? ​

文字列の先頭が特定の部分文字列であるかどうかをチェックします。そうである場合は true を返します。

構文 ​

Input.starts_with?(substring)

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

使用例 ​

動作 ​

この formula は、文字列の先頭が特定の部分文字列であるかどうかをチェックします。そうである場合は true を返し、そうでない場合は false を返します。

関連情報 ​

• include?: 文字列に特定の部分文字列が含まれているかどうかをチェックします。含まれている場合は true を返します。
• exclude?: 文字列に特定の部分文字列が含まれているかどうかをチェックします。含まれている場合は false を返します。
• match?: 文字列に特定のパターンが含まれているかどうかをチェックします。含まれている場合は true を返します。
• ends_with?: 文字列の末尾が特定の部分文字列であるかどうかをチェックします。そうである場合は true を返します。

テキスト操作 ​

このセクションでは、文字列内のテキストを操作できる formula について説明します。

parameterize ​

文字列内の特殊文字を置き換えます。アプリケーションが非標準の文字を受け付けない場合に使用します。

構文 ​

Input.parameterize

• Input - 入力文字列。

使用例 ​

動作 ​

この formula は文字列内の特殊文字を検索し、それを標準文字と置き換えます。アプリケーションが非標準の文字を受け付けない場合に使用します。

lstrip ​

この formula は入力文字列の先頭にある空白を削除します。

構文 ​

String.lstrip

• String - 入力文字列。

使用例 ​

動作 ​

この formula は文字列の先頭から空白を削除します。文字列の先頭に空白がない場合は、入力文字列がそのまま返されます。

関連情報 ​

• strip: 入力文字列の先頭と末尾にある空白を削除します。
• rstrip: 入力文字列の末尾にある空白を削除します。
• gsub: テキスト文字列の一部を置換します。置換された文字を含む新しい文字列を返します。

rstrip ​

入力文字列の末尾にある空白を削除します。

構文 ​

String.rstrip

• String - 入力文字列。

使用例 ​

動作 ​

この formula は、文字列の末尾から空白を削除します。文字列の末尾に空白がない場合は、入力文字列がそのまま返されます。

関連情報 ​

• strip: 入力文字列の先頭と末尾にある空白を削除します。
• lstrip: 入力文字列の先頭にある空白を削除します。
• gsub: テキスト文字列の一部を置換します。置換された文字を含む新しい文字列を返します。

strip ​

この formula は入力文字列の先頭と末尾にある空白を削除します。

構文 ​

String.strip

• String - 入力文字列。

使用例 ​

動作 ​

この formula は文字列の両側から空白を削除します。文字列の先頭や末尾に空白がない場合は、入力文字列がそのまま返されます。

関連情報 ​

• lstrip: 入力文字列の先頭にある空白を削除します。
• rstrip: 入力文字列の末尾にある空白を削除します。
• gsub: テキスト文字列の一部を置換します。置換された文字を含む新しい文字列を返します。

strip_tags ​

この formula は、文字列に埋め込まれている html タグを削除します。

構文 ​

String.strip_tags

• String - 入力文字列。

使用例 ​

動作 ​

この formula は、入力文字列内の html タグをチェックします。検出された html タグを削除してから、その文字列を返します。

関連情報 ​

• strip: 入力文字列の先頭と末尾にある空白を削除します。

ljust ​

文字列を左揃えにし、指定した長さになるまで空白またはパターンを挿入します。

構文 ​

String.ljust(length,character)

• String - 入力文字列。
• length - 出力文字列の長さ。
• character - (任意) 文字列に埋め込む文字。指定しない場合、デフォルトの埋め込み文字は空白になります。

使用例 ​

関連情報 ​

• rjust: 文字列を右揃えにし、指定した長さになるまで空白またはパターンを挿入します。

rjust ​

文字列を右揃えにし、指定した長さになるまで空白またはパターンを挿入します。

構文 ​

String.rjust(length,character)

• String - 入力文字列。
• length - 出力文字列の長さ。
• character - (任意) 文字列に埋め込む文字。指定しない場合、デフォルトの埋め込み文字は空白になります。

使用例 ​

関連情報 ​

• ljust: 文字列を左揃えにし、指定した長さになるまで空白またはパターンを挿入します。

reverse ​

文字を逆順に並び替え、文字列を反転させます。大文字と小文字の区別は維持されます。

構文 ​

String.reverse

• String - 入力文字列。

使用例 ​

gsub ​

テキスト文字列の一部を置換します。置換された文字を含む新しい文字列を返します。

構文 ​

String.gsub(find,replace)

• String - 入力文字列。データピルまたは静的な文字列値を使用できます。
• find - 検索する文字列。/pattern/ 構文を使用できます。
• replace - 置換文字列。文字列またはハッシュを使用して、置換文字列を定義できます。

使用例 ​

高度な使用例 ​

gsub メソッドの高度な使用例の詳細については、Ruby のドキュメントを参照してください。

動作 ​

この formula は検索と置換に似た働きをします。次の2つの入力パラメータを受け取ります。

1. 1つ目の入力パラメータは、置換したい文字列です。大文字と小文字が区別されるため、大文字/小文字を正確に入力して、完全一致するすべての箇所を見つけるようにしてください。
2. 2つ目の入力パラメータは、1番目の入力パラメータに一致する箇所すべてを置換するのに使用する、新しい文字列です。

関連情報 ​

• sub: 検索用語に最初に一致した箇所を置換します。

sub ​

文字列内で1番目の入力値に最初に一致した箇所を、2番目の入力値で置換します。この formula は大文字と小文字を区別します。大文字と小文字の区別が重要である場合は、比較の前に、大文字と小文字を確認して入力するようにしてください。

構文 ​

String.sub(find,replace)

• String - 入力文字列。データピルまたは静的な文字列値を使用できます。
• find - 検索する文字列。/pattern/ 構文を使用できます。
• replace - 置換文字列。文字列またはハッシュを使用して、置換文字列を定義できます。

使用例 ​

length ​

入力文字列の文字数 (空白を含む) を返します。

構文 ​

String.length

• String - 入力文字列。

使用例 ​

slice ​

文字列内の一部の範囲を返します。

構文 ​

String.slice(start,end)

• String - 入力文字列。
• start - 文字列から抜き出す範囲の先頭のインデックス。
• end - (任意) 返される文字数。指定されていない場合は、1文字のみが返されます。

使用例 ​

動作 ​

この formula は文字列内の一部の範囲を返します。受け付けるパラメータは2つです。1番目のパラメータは、文字列のどの部分を起点に文字列を返すかを決めるインデックスです (1番目の文字は0であり、それ以降は1ずつ増加します。負の数の場合は、最後の文字から数えます)。2番目のパラメータは、返す文字数を指定します。1番目のパラメータのみが渡された場合は、1文字のみが返されます。

scan ​

取得したいパターンを探して文字列をスキャンし、配列を返します。

構文 ​

String.scan(pattern)

• String - 入力文字列。
• pattern - 検索するパターン。

使用例 ​

encode ​

指定されたエンコーディングで文字列を返します。

構文 ​

String.encode(encoding)

• String - 入力文字列。
• encoding - エンコーディングの名前 (例: Windows-1252)。Ruby のエンコーディングの詳細は、こちらを参照してください。

使用例 ​

transliterate ​

非 ASCII 文字を ASCII の近似文字に置き換えます。近似文字が存在しない場合、置換文字はデフォルトで「?」になります。

構文 ​

String.transliterate

• String - 入力文字列。

使用例 ​

• parameterize: 文字列内の特殊文字を置き換えます。

テキストの大文字と小文字の操作 ​

このセクションでは、単語の特定部分の大文字/小文字を変更できる formula について説明します。

capitalize ​

入力文字列をセンテンスケース、すなわち文頭の文字を大文字にする表記に変換します。

構文 ​

String.capitalize

• String - 入力文字列。

使用例 ​

titleize ​

入力文字列をタイトルケース、すなわち各単語の先頭の文字を大文字にする表記に変換します。

構文 ​

String.titleize

• String - 入力文字列。

使用例 ​

upcase ​

テキストを大文字に変換します。

構文 ​

String.upcase

• String - 入力文字列。

使用例 ​

動作 ​

この formula はすべての小文字を検索し、それを大文字に置き換えます。

関連情報 ​

• downcase: テキストを小文字に変換します。
• capitalize: テキストをセンテンスケースに変換します。
• titleize: テキストをタイトルケースに変換します。

downcase ​

テキストを小文字に変換します。

構文 ​

String.downcase

• String - 入力文字列。

使用例 ​

動作 ​

この formula はすべての大文字を検索し、それを小文字に置き換えます。

関連情報 ​

• upcase: テキストを大文字に変換します。
• capitalize: テキストをセンテンスケースに変換します。
• titleize: テキストをタイトルケースに変換します。

quote ​

文字列に引用符を付け、' (一重引用符) をエスケープします。

構文 ​

String.quote

• String - 入力文字列。

使用例 ​

配列との間の変換 ​

このセクションでは、文字列を配列に変換する方法を説明します。

split ​

この formula は、指定した文字を中心に文字列を分割し、文字列の配列を返します。

構文 ​

String.split(char)

• String - 入力文字列値。データピルまたは静的な値を使用できます。
• char - (任意) テキストを分割する際に基点となる文字。これは大文字と小文字が区別されます。文字が指定されていない場合、デフォルトでは、文字列は空白で分割されます。

使用例 ​

動作 ​

この formula は、指定された文字を入力文字列の中から見つけます。その文字が見つかるたびに、入力文字列が新しい文字列に分割されます。

関連情報 ​

• strip: 入力文字列の先頭と末尾にある空白を削除します。
• slice: 文字列内の一部の範囲を返します。
• match: 入力文字列をチェックして、特定のパターンを探します。
• join: リストの項目を結合して、1つの文字列にします。

bytes ​

与えられた文字列のバイト配列を返します。

構文 ​

String.bytes

• String - 入力文字列。

使用例 ​

変換の formula ​

数値や日付といったデータ型の値を文字列に変換するには、to_s formula を使用します。

他のデータ型から文字列への変換 ​

to_s ​

データを文字列 (テキスト) 型に変換します。

構文 ​

Input.to_s

• Input - 入力データ。数値や配列、オブジェクト、日時といったデータ型を使用できます。

使用例 ​

動作 ​

この formula は入力データの文字列表現を返します。

関連情報 ​

• to_f: データを浮動小数点 (数値) 型に変換します。
• to_i: データを整数型に変換します。

ordinalize ​

数値を、順序付きの列の中の位置を表すために使われる序数文字列 (1st、2nd、3rd、4th など) へと変換します。

構文 ​

Input.ordinalize

• Input - 任意の入力数値。

使用例 ​

文字列から他のデータ型への変換 ​

to_f ​

データを浮動小数点 (数値) 型に変換します。

構文 ​

Input.to_f

• Input - 数値の入力データ。文字列型または整数型を使用できます。

使用例 ​

動作 ​

この formula は入力データに数値が含まれているかどうかをチェックします。数値が含まれていない場合は0を返します。数値に小数点がない場合、.0 が数値に追加されます。

関連情報 ​

• to_i: データを整数データ型に変換します。

to_i ​

データを整数データ型に変換します。

構文 ​

Input.to_i

• Input - 数値の入力データ。文字列型または浮動小数点型を使用できます。

使用例 ​

動作 ​

この formula は入力データに数値が含まれているかどうかをチェックします。数値が含まれていない場合は0を返します。数値に小数点が含まれている場合、小数点以下のすべての数値が削除されます。

関連情報 ​

• to_f: データを浮動小数点 (数値) 型に変換します。

to_country_alpha2 ​

alpha-3 国名コードまたは国名を alpha2 国名コード (最初の2文字のイニシャル) に変換します。

構文 ​

Input.to_country_alpha2

• Input - 任意の入力文字列。

使用例 ​

to_country_alpha3 ​

alpha-2 国名コードまたは国名を alpha3 国名コード (最初の3文字のイニシャル) に変換します。

構文 ​

Input.to_country_alpha3

• Input - 任意の入力文字列。

使用例 ​

to_country_name ​

alpha-2/3の国名コードまたは国名を ISO3166 の国名に変換します。

構文 ​

Input.to_country_name

• Input - 任意の入力文字列。

使用例 ​

to_currency ​

整数/数値を通貨形式にします。

構文 ​

Input.to_currency

• Input - 任意の入力文字列。

使用例 ​

高度な使用例 ​

to_currency formula の高度な使用例を紹介します。これらをカンマで区切って組み合わせると、目的の通貨書式を作成できるでしょう。例:

"12345.678".to_currency(delimiter: ".", format: "%n %u", precision: 2, separator: ",", unit: "€")

to_currency_code ​

alpha-2/3の国名コードまたは国名を ISO4217 の通貨コードに変換します

構文 ​

Input.to_currency_code

• Input - 任意の入力文字列。

使用例 ​

to_currency_name ​

alpha-3 の通貨コード、alpha-2/3の国名コード、または国名を ISO4217 の通貨名に変換します。

構文 ​

Input.to_currency_name

• Input - 任意の入力文字列。

使用例 ​

to_currency_symbol ​

alpha-3 の通貨コード、alpha-2/3の国名コード、または国名を ISO4217 の通貨記号に変換します。

構文 ​

Input.to_currency_symbol

• Input - 任意の入力文字列。

使用例 ​

to_phone ​

文字列または数値を (ユーザー定義の) 書式付きの電話番号に変換します。

構文 ​

Input.to_phone

• Input - 任意の入力文字列または数値。

使用例 ​

to_state_code ​

州の名前をコードに変換します。

構文 ​

Input.to_state_code

• Input - 任意の入力文字列。

使用例 ​

to_state_name ​

州のコードを名前に変換します。

構文 ​

Input.to_state_name

• Input - 任意の入力文字列。

使用例 ​

bytesize ​

与えられた文字列の長さをバイト単位で返します。

構文 ​

Input.bytesize

• Input - 任意の入力文字列。

使用例 ​