その他の formula ​

ここでは、多数のデータ型に使用する formula について説明します。

null ​

null または nil 値を与えます。これを入力項目に渡しても、値が null に更新されるわけではないことに注意してください。項目の値を null に更新するには、clear formula を使用します。入力項目は必ず formula モードに切り替えてください。

clear ​

ターゲットアプリの項目の値をクリアして null または nil にします。入力項目は必ず formula モードに切り替えてください。

ターゲットアプリの項目をクリアするには、null formula ではなく clear formula を使用する

skip ​

ターゲットアプリのこの項目には何も渡しません。すでに項目に値がある場合は、そのまま変更されません。

例 ​

以下の例では、更新された Salesforce レコードを使って Marketo のリードを更新します。Salesforce の Company が存在するかどうかをチェックし、存在する場合は Salesforce の Company を Marketo に出力します。存在しない場合、Marketo レコードを変更しません。

skip formula のサンプルユースケース

uuid ​

UUID を生成します。

例 ​

encrypt ​

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

注 : 暗号鍵をレシピにハードコードしないでください。暗号鍵の格納には、アカウントプロパティ (名前の key または password) を使用してください。

例 ​

encrypt([ssn], [encryption_key])

decrypt ​

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

注 : 暗号鍵をレシピにハードコードしないでください。暗号鍵の格納には、アカウントプロパティ (名前の key または password) を使用してください。

例 ​

decrypt([encrypted_ssn], [encryption_key])

encode_sha256 ​

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

例 ​

"hello".encode_sha256

encode_hex ​

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

例 ​

decode_hex ​

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

例 ​

decode_url ​

文字列を URL デコードします。この formula では CGI.unescape を使用して URL デコードを行います。

例 ​

encode_base64 ​

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

例 ​

decode_base64 ​

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

例 ​

encode_url ​

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

例 ​

encode_urlsafe_base64 ​

URL セーフの修正が盛り込まれた Base64 アルゴリズムを使用してエンコードします。

例 ​

decode_urlsafe_base64 ​

URL セーフの修正が盛り込まれた Base64 アルゴリズムを使用してデコードします。

例 ​

as_string ​

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

例 ​

as_utf8 ​

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

例 ​

to_hex ​

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

例 ​

SHA1 ​

SHA1 暗号化アルゴリズムを使用して、指定された文字列を暗号化します。詳しくは、こちらを参照してください。

例 ​

HMAC formula ​

さまざまなアルゴリズムを使って HMAC 署名を生成します。

例 ​

md5_hexdigest ​

文字列を受け取り、MD5 メッセージダイジェストアルゴリズムを使ってメッセージダイジェストを生成します。

例 ​

jwt_encode ​

RS256、RS384、RS512、HS256 のいずれかのアルゴリズムを使用して、JWT を作成します。追加の名前付きパラメータがヘッダーに追加されます (次の例の kid)。

例 ​

parse_yaml ​

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

例 ​

render_yaml ​

オブジェクトを YAML 文字列に変換します。

例 ​

lookup ​

この formula を使用すると、Workato の Lookup table からキーを使って値を検索することができます。大文字と小文字が区別され、データ型も区別されます。

lookup formula でデータピルを使う場合、データを適切な形式に変換することをお勧めします。たとえば、整数と文字列の両方を含んだカラムと比較する場合、整数型のデータピルは .to_s formula で文字列に変換する必要があります。

例 ​

例として、名前が Department Codes で ID が6の次の Lookup table を使用します。

サンプルの部門コード Lookup table

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

lookup_table ​

この formula を使用すると、静的な Lookup table を作成してキーと値を定義できます。大文字と小文字が区別され、データ型も区別されます。

例 ​