組み込み関数
Workflow Builder アプリケーションでは、いくつかの組み込み関数を使用することができます。
テキストフィールドから関数を呼び出すには、関数の前に等号を付けます。例:=length("howmanycharactersareinthisstring")
説明
各関数の説明は以下の通りです。
formatdatetime(int unixtimestamp, string フォーマット)
この関数は、フォーマット引数で指定された形式に従って時刻をフォーマットします。この形式は、Javaの SimpleDateFormat
で指定される形式と同じです。
例:「yyyy-MM-dd'T'HH:mm'Z'」
と指定すると、2012-07-20T20:45:44.0973928Z
となります
formatduration(秒単位の期間)
この関数は、秒単位で指定された duration を MM:SS または HHH:MM:SS の形式に変換します。出力としてフォーマット済みの文字列を返します(例:formatduration(121) は「02:01」を返します)。
hmac(ハッシュ関数, 鍵, メッセージ)
この関数は、MD5、SHA-1、および SHA-256 用の認証ハッシュ (HMAC) を作成するために使用されます。ここで、Hash_function = (“MD5” | “SHA-1” | “SHA-256”) となります。 戻り値は、Base64エンコードされたハッシュを含む文字列です。
length(string)
この関数は、文字列に含まれる文字数を返します。
lowercase(string)
文字列内のすべての文字を小文字に変換します。この関数は変数とともに使用することができます。
例:
=lowercase("AbCdEfG") は "abcdefg" を返します。
now()
Unix タイムスタンプ(つまり、1970年1月1日 00:00:00 UTC からの経過秒数)を返します。 Bright Pattern Contact Center バージョン 5.7.0 より前に now("time zone") を使用していた場合は、「time zone」が無視されていたことにご注意ください。
parsedatetime(文字列 datetime, 文字列 フォーマット)
この関数は、指定された日時を Unix フォーマット(1970年1月1日 00:00:00 UTC からの経過秒数)で返します。日時の入力は、ICU の Java SimpleDateFormat.
replace(string, search_pattern, replace_pattern, flags)
- この関数は、入力文字列内の検索と置換を行います。置換が実行された文字列を返します。
- パラメータは以下の通りです:
- string は、検索対象となる入力文字列です。
- search_pattern は、入力文字列内で適合させる正規表現パターンです。サポートされているパターンのリストは、以下の表をご参照ください。エスケープ文字に余分な \ が含まれている点にご注意ください。これは、" や改行記号をリテラルとして挿入できるようにするために必要です。
- replace_pattern は、検索パターンに従って適合したテキストの代わりに挿入するテキストです。置換には \\0 ~ \\9 を使用できます。
- フラグ付き条件は、以下の追加条件のうち1つ以上を指定します:
- i – 検索時に大文字と小文字を区別しない
- g – すべての適合を置換します。これを指定しないと、最初の一致のみが置換されます(例:replace("abcdefg","c","z","ig") の結果は "abzdefg" となります)。
変数「fullname」から名前を取り出し、「変数の設定」ブロックの「値」セクションで使用できる例:=replace("$(fullname)","(.*)\s+(.*)","\1","i")
round(floating_number, precision)
この関数は、小数点以下の桁数を <precision> 桁に丸めます。結果は引き続き浮動小数点数となります。
stripnondigits(文字列)
この関数は、文字列から数字以外の文字を消去し、0 から 9 までの数字、および * と # の記号のみを残します(例:stripnondigits("123abc456") は "123456" を返します)。
titlecase(string)
この関数は、文字列をタイトルケース(つまり、各単語の頭文字を大文字にする)に変換します。
tostring(整数)
この関数は、整数を文字列に変換します(例:tostring(-2+1) は、文字列として「-1」を返します)。
uppercase(文字列)
文字列内のすべての文字を大文字に変換します。この関数は変数とともに使用できます。
例:
「$(item.from)」が「user_name」の場合、=uppercase("$(item.from)")
は「USER_NAME」
を返します。
urlencode(文字列)
文字列をURLエンコードし、特殊文字を %dd 表記で置換します。これは、許可された文字に明示的に含まれていないすべての文字を置換する、保守的な実装です。
パターンの種類
パターンの種類については、以下のように説明されています。
| パターン | 説明 |
| ^ | バッファの先頭と適合させる |
| $ | バッファの末尾に適合する |
| () | グループ化と部分文字列のキャプチャ |
| […] | 指定された文字セットに含まれる任意の文字に適合 |
| [^…] | 指定された文字セットに含まれない任意の文字に適合させる |
| \\s | 空白文字に適合 |
| \\S | 空白文字以外の文字に適合します |
| \\d | 10進数の数字に適合 |
| \\D | 10進数の数字以外の任意の文字に適合します |
| \\r | キャリッジリターンを適合させます |
| \\n | 改行に適合します |
| + | 1回以上適合させる(貪欲) |
| +? | 1回以上適合(非貪欲) |
| * | 0回以上適合(貪欲) |
| *? | 0回以上適合(非貪欲) |
| ? | 0回または1回適合させる |
| \\meta | メタ文字のいずれか1つに適合します:^$().[*+?\ |