その他のFormula ​

このセクションでは、複数のデータ型で動作するFormulaについて説明します。

WorkatoのFormulaは、許可リストに登録されたRubyメソッドです。 これらのFormulaの構文と機能は、通常変更されていません。 Formulaがnull（Rubyではnilと表されます）に対して動作する場合、present?、presence、blank?を除き、ほとんどのFormulaはエラーを返し、ジョブを停止します。

RubyメソッドがWorkatoドキュメントに見つからない場合、そのメソッドは許可リストに含まれておらず、サポートされません。 許可リストへの新しいFormulaの追加をリクエストするには、Customer Success Managerにお問い合わせください。

角かっこを使用してネストされた値にアクセスする ​

角かっこ（[]）を使用すると、Workatoでハッシュ内の値にアクセスできます。 ネストされたハッシュでは、data["a"]["b"]["c"]のようにルックアップを連結できます。 ただし、チェーンのいずれかの部分が存在しない場合（たとえば、"b"がない場合）、このメソッドはNoMethodErrorを発生させます。

エラーなしでネストされた値に安全にアクセスするには、代わりに安全ナビゲーション演算子（&.）を使用します。 たとえば、data["a"]&.[]("b")&.[]("c")です。 チェーンのいずれかの部分がnilの場合、これはnilを返します。

null ​

null/nil値を返します。

clear ​

ターゲットアプリのフィールドの値をnull/nilにクリアします。 フィールドをFormulaモードに切り替えることを忘れないでください。

ターゲットアプリのフィールドをクリアする場合は、nullではなくclear Formulaを使用します

skip ​

このフィールドについて宛先アプリに何も渡しません。 フィールドに既存の値がある場合、その値は変更されません。

例 ​

この例では、更新されたSalesforceレコードを使用してMarketoのリードを更新しようとします。 SalesforceのCompanyが存在するかどうかを確認します。 存在する場合、SalesforceのCompanyをMarketoに出力します。 それ以外の場合、Marketoレコードは変更されません。

skip Formulaのユースケース例

uuid ​

UUIDを生成します。

例 ​

encrypt ​

AES-256-CBCアルゴリズムを使用し、シークレットキーで入力文字列を暗号化します。 暗号化された出力文字列はRNCryptor V3形式でパックされ、base64でエンコードされます。

例 ​

encrypt([ssn], [encryption_key])

decrypt ​

AES-256-CBCアルゴリズムを使用し、シークレットキーで暗号化された入力文字列を復号します。 暗号化された入力文字列はRNCryptor V3形式でパックされ、base64でエンコードされている必要があります。

Ruby decryptメソッドは、デフォルトで文字列ではなくバイト配列を返します。 Formulaに.as_string()または.as_utf8関数を追加することで、decryptメソッドの出力を文字列に変換できます。

例 ​

decrypt([encrypted_ssn], [encryption_key])

encode_sha256 ​

SHA256アルゴリズムを使用して文字列またはバイナリ配列をエンコードします

例 ​

"hello".encode_sha256

encode_hex ​

バイナリ文字列をその16進表現に変換します

例 ​

decode_hex ​

16進数をバイナリ文字列にデコードします

例 ​

decode_url ​

文字列をURLデコードします。 このFormulaはURLデコードにCGI.unescapeを使用します。

例 ​

encode_base64 ​

Base64アルゴリズムを使用してエンコードします

例 ​

decode_base64 ​

Base64アルゴリズムを使用してデコードします

例 ​

encode_url ​

文字列をURLエンコードします

例 ​

encode_urlsafe_base64 ​

Base64アルゴリズムのurlsafe変更を使用してエンコードします

例 ​

decode_urlsafe_base64 ​

Base64アルゴリズムのurlsafe変更を使用してデコードします

例 ​

as_string ​

指定されたエンコーディングでバイトシーケンスを文字列としてデコードします

例 ​

as_utf8 ​

バイトシーケンスをUTF-8文字列としてデコードします

例 ​

to_hex ​

バイナリ文字列をその16進表現に変換します

例 ​

SHA1 ​

SHA1暗号化アルゴリズムを使用して、指定された文字列を暗号化します。 詳細については、Ruby SHA1ドキュメントを参照してください。

例 ​

HMAC Formula ​

さまざまな署名アルゴリズムでHMAC署名を作成します

例 ​

md5_hexdigest ​

文字列を受け入れ、MD5 Message-Digest Algorithmを使用してメッセージダイジェストを作成します

例 ​

jwt_decode ​

次のいずれかのアルゴリズム（RS256、RS384、RS512、HS256、HS384、HS512、ES256、ES384、またはES512）を使用してJSON web token（JWT）をデコードします。

例 ​

jwt_encode ​

次のいずれかのアルゴリズム（RS256、RS384、RS512、HS256、HS384、HS512、ES256、ES384、またはES512）を使用してJSON web token（JWT）を作成します。 次の例のkidなど、その他の名前付きパラメータをヘッダーに追加します。

例 ​

parse_yaml ​

YAML文字列を解析します。 true、false、nil、数値、文字列、配列、ハッシュをサポートします

例 ​

render_yaml ​

オブジェクトをYAML文字列にレンダリングします。

例 ​

lookup ​

このFormulaを使用すると、キーを使用してWorkatoルックアップ テーブルから値をルックアップできます。 lookup Formulaではデータ型と大文字小文字が区別されます。

lookup Formulaでデータピルを使用する場合は、データを正しい形式に変換することをお勧めします。 たとえば、整数と文字列の両方を含む列を比較する予定がある場合は、.to_s Formulaを使用して整数型のデータピルを文字列に変換します。

構文 ​

Formulaを構成するには、次の構文を使用します。

lookup('Lookup table name', 'Match column': 'Match value')['Return column']

このFormulaは、指定されたルックアップ テーブル内でMatch columnがMatch valueと一致する行を検索します。 その後、その行の指定されたReturn columnから値を返します。

Formulaには次のパラメーターが含まれます。

• Lookup table name: クエリするルックアップ テーブル。
• Match column: ルックアップキーとして使用される列。
• Match value: キー列内の行を識別する値。
• Return column: 結果を提供する列。

例 ​

たとえば、名前がDepartment CodeでIDが6の次のルックアップ テーブルを使用します。

部門コードのサンプルルックアップ テーブル

https://app.workato.com/lookup_tables/<lookup_table_id>

lookup_table ​

このFormulaを使用すると、静的ルックアップ テーブルを作成し、キーと値を定義できます。 大文字小文字とデータ型が区別されます。

例 ​

data_table_lookup ​

このFormulaを使用すると、キーを使用してData tablesから値をルックアップできます。 lookup Formulaでは大文字小文字とデータ型が区別されます。

lookup Formulaでデータピルを使用する場合は、データを正しい形式に変換することをお勧めします。 たとえば、文字列型の列を比較する予定がある場合は、.to_s Formulaを使用して整数型のデータピルを文字列に変換します。

プロジェクト名、テーブル名、ルックアップキー、およびルックアップ条件は、適切な大文字小文字を含め、Data tablesに保存されているとおりに正確に記述してください。

構文 ​

Formulaを構成するには、次の構文を使用します。

data_table_lookup('Project name', 'Table name', 'Column name': 'Value to search on')['Return column']

このFormulaは、指定されたData tables内でColumn nameがValue to search onと一致する行を検索します。 その後、その行の指定されたReturn columnから値を返します。

Formulaには次のパラメーターが含まれます。

• Project name: Data tablesを保持するプロジェクト。 この値には、プロジェクト内のフォルダ名を/で区切って含めることもできます（例：'Project name/Folder name'）。
• Table name: クエリする特定のData tables。
• Column name: 一致を見つけるために使用される列。
• Value to search on: キー列内の行を識別する値。
• Return column: 結果を提供する列。

例 ​

たとえば、Weddingプロジェクト内にある名前がWedding Guestsの次のデータテーブルを使用します。

サンプル"Wedding Guests" Data table

data_table_query ​

このFormulaでは、柔軟なフィルタ条件を使用してdata tablesからレコードをクエリできます。 等価性に一致して単一行のフィールド値のみを返すdata_table_lookupとは異なり、data_table_queryでは次のこともできます。

• 1回の呼び出しで、一致する複数のレコードを返す。
• 各レコードのID（後続のアクションでそのレコードの更新、削除、または関連付けに使用可能）、作成時刻、最終更新時刻を含める。
• 等価性に加えて、より大きい、より小さい、または指定可能な値のリストなどの演算子を使用してフィルタする。

クエリでは大文字と小文字、およびデータ型が区別されます。 プロジェクト名、テーブル名、列名、およびフィルタ値が、大文字と小文字の区別を含め、Data tablesに保存されているとおりに正確に記述されていることを確認してください。

構文 ​

Formulaを構成するには、次の構文を使用します。

data_table_query('Project name', 'Table name', {query options})

Formulaには次のパラメーターが含まれます。

• Project name: Data tablesを保持するプロジェクト。 この値には、プロジェクト内のフォルダ名を/で区切って含めることもできます（例：'Project name/Folder name'）。
• Table name: クエリする特定のData tables。
• query options：何を返すか、および結果のフィルタ、並べ替え、制限の方法を定義するハッシュ。 クエリオプションを参照してください。

クエリオプション ​

query optionsハッシュは次を受け入れます。

列は名前で参照できます。また、whereおよびorderで組み込みフィールド$record_id、$created_at、$updated_atを使用できます。 これらの組み込みフィールドは常に結果に含まれるため、selectにはリストできません。 列名自体が$で始まる場合は、それを参照するために追加の$を付けます（たとえば、$ spentという名前の列は$$ spentとして参照されます）。

クエリオプションキー、演算子、およびフィールド名は、それぞれシンボルまたは文字列のいずれかを受け入れます。 たとえば、where: {...}と'where' => {...}は同じように動作します。

Link to a table列とFile列は、フィルタリングおよび値の読み取りの両方で、少し異なる動作をします。

• Link to a table列でフィルタするには、リンク先レコードのIDを使用します。
• File列でフィルタするには、ファイル名を使用します。
• 返されたLink to a table列には、リンクされたレコードのrecord_idとそのdisplay_nameの両方が含まれます。
• 返されたFile列には、ファイルのfilenameが含まれます。
• multivalue column（複数の値を保持できる列）は、単一の値ではなく値のリストを返します。

Mode ​

modeは、クエリが一致を想定するレコード数、および0件、1件、または複数のレコードが一致した場合にFormulaが返す内容を制御します。

例 ​

次の例では、Company name、Region、Revenue、Status列を持つCustomers Data tablesを使用します。

data_table_query('Sales', 'Customers', {where: {'Company name': 'Globex Inc'}, mode: 'one_unique'})['record_id']

data_table_query('Sales', 'Customers', {where: {'Company name': 'Nonexistent Co'}, mode: 'one_unique_optional'})&.[]('fields')&.[]('Region') || 'Unknown region'

data_table_query('Sales', 'Customers', {where: {'Company name': {'$starts_with': 'Acme'}}, mode: 'all', limit: 50, select: ['Revenue']})['records'].pluck('fields').pluck('Revenue').sum

data_table_query('Sales', 'Customers', {where: {'Region': 'West'}, mode: 'all', limit: 50})['records'].pluck('fields').pluck('Company name')

data_table_query('Sales', 'Customers', {order: {by: 'Revenue', direction: 'desc'}, mode: 'one_first_optional'})&.[]('fields')

戻り値 ​

レコードは、record_id、created_at、updated_at、およびfieldsキーを持つハッシュです。 one_unique、one_unique_optional、one_first、およびone_first_optionalは、この形状の単一レコード、またはnilを返します。 例:

data_table_query('Sales', 'Customers', {where: {'Company name': 'Globex Inc'}, mode: 'one_unique'})

このクエリは次のレコードを返します。

{
  "record_id": "9309e4c0-2548-4508-b938-c781e77a7dda",
  "created_at": "2026-07-28T15:00:00.000+00:00",
  "updated_at": "2026-07-28T15:00:00.000+00:00",
  "fields": {
    "Company name": "Globex Inc",
    "Region": "East",
    "Revenue": 200000,
    "Status": "Active"
  }
}

allとsomeは、recordsキーを持つハッシュを返します。このキーの値は、この形状のレコードの配列です。 例:

data_table_query('Sales', 'Customers', {where: {'Company name': {'$starts_with': 'Acme'}}, mode: 'all', limit: 50})

このクエリは4社に一致します。 次に最初の2件を示します。

{
  "records": [
    {
      "record_id": "...",
      "created_at": "...",
      "updated_at": "...",
      "fields": {
        "Company name": "Acme Corp",
        "Region": "West",
        "Revenue": 120000,
        "Status": "Active"
      }
    },
    {
      "record_id": "...",
      "created_at": "...",
      "updated_at": "...",
      "fields": {
        "Company name": "Acme Consulting",
        "Region": "East",
        "Revenue": 95000,
        "Status": "Active"
      }
    }
  ]
}