その他の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を保持するプロジェクト。
• Table name: クエリする特定のData tables。
• Column name: 一致を見つけるために使用される列。
• Value to search on: キー列内の行を識別する値。
• Return column: 結果を提供する列。

例 ​

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

サンプル"Wedding Guests" Data table