エクスプレッション

エクスプレッションからは通常、テキストが求められます。例えば、エクスプレッション "The author of the book " + Book.title + " is " + Book.author + "." からは、Book 変数の各属性 title および author に、テキスト "Gone with the Wind" および "Margaret Mitchell" がそれぞれ含まれる場合は、テキスト "The author of the book Gone with the Wind is Margaret Mitchell." が求められます。

エクスプレッションで数値を計算することもできます。例えば、属性 Book.price に本の価格が含まれる場合、次のエクスプレッションを使用して、これに 100 を掛けることができます。

Book.price * 100

エクスプレッションの場所に応じて、入力テキストがエクスプレッション内で使用できるようになります。この入力テキストをエクスプレッション内で参照するには、INPUT 表記を使用します。例えば、入力テキストが「The time is「 で、現在の時間を追加したい場合、次のエクスプレッションを使用できます。

INPUT + time(now())

エクスプレッション タイプ

エクスプレッション タイプ

表記

説明

定数

"text"

固定テキスト。

バックスラッシュ文字 (\) を使用すると、特殊文字を入力できます。

\n は改行

\r はキャリッジ リターン

\f はフォーム フィード

\t は水平タブ

\b はバックスペース

\」は二重引用符

\' は一重引用符

\\ はバックスラッシュ

\uxxxx は xxxx エンコードの Unicode 文字。xxxx は 4 つの 16 進数の値。

"This is some \"quoted\」text."

"This a text with line break\n, tab \t and a unicode \u0035 character"

定数

>>text<<

固定テキスト。この表記には引用符文字などあらゆるものを含めることができます。ただし、終了シンボル (<<) を除きます。バックスラッシュ (\) 文字は、特殊文字の入力に使用できません。

>>This is some "quoted" text.<<

変数

variable.attribute

変数

変数の値。変数がコンプレックス タイプの場合、属性の名前も必要になります。

Book.title

整数

入力テキスト

INPUT

ある場合は、エクスプレッションへの入力テキスト。

INPUT

連結

expr1 + expr2

2 つのエクスプレッション expr1 および expr2 の連結。

"Title:"+ Book.title

サブパターン マッチ

$n

n > 0 の場合、パターン内のサブパターン n に一致するテキスト。n = 0 の場合、パターン全体に一致するテキスト。

注意:このエクスプレッションが意味を持つのは、エクスプレッションに関連するパターンがある場合に限ります。

$1

数式

演算子:+, -, *, /, %

数式の結果。

Book.price * 100

ブール式

演算子:&& (and), || (or)

ブール式の結果。

performTransactions && Book.price < 30

条件式

condition ? expr1 : expr2

条件の評価結果が true の場合、expr1 の値を使用します。そうでない場合は、expr2 の値を使用します。

Book.price < 30 ? "cheap" : "expensive"

関数

func(expr)

エクスプレッション expr の結果に適用される func 関数。利用できる関数については、このテーブルの後の「関数」のセクションを参照してください。

capitalize(Book.title)

現在の URL

URL

現在の URL

URL

現在のウィンドウ

WINDOW

現在のウィンドウの固有 ID。

WINDOW

ロボット名

Robot.name

ロボット名。

Robot.name

実行 ID

Robot.executionId

ロボットの現在の実行 ID。

Robot.executionId

実行エラー

Robot.executionErrors

最も近いトライ ステップの、前の分岐で発生した実行エラー。

Robot.executionErrors

テキスト定数に対する >>text<< 表記は、HTML など、引用符文字を多く含む長いテキストを指定するのに便利です。>>text<< 表記を使用すると、前後に >> および << のシンボルを配置するだけで、テキストをそのまま使えます。 "text" 表記を使用する場合は、テキスト内のすべての引用符文字を、2 つの連続する引用符文字に置き換える必要があります。

関数

関数 説明

abs(arg)

数の絶対値を返します。

base64Decode(arg)

Base64 でエンコードされたデータをデコードします。

base64Encode(arg)

バイナリ データを Base64 エンコーディングでエンコードします。

binaryToText(data[, encoding])

バイナリ データをデコードしてテキストにします。指定のエンコーディングが有れば使用します。無い場合は、デフォルトで UTF-8 エンコーディングを使用します。

capitalize(arg)

すべての単語の最初の文字を大文字に、他の文字をすべて小文字にします。

ceil(arg)

数を一番近い整数に切り上げます。

collapseSpaces(arg)

スペースが 2 つ連続しないようにします。

contains(source, key)

ソースに指定されたキーが含まれるかを返します。

date()

現在の日付を標準的な日付の形式 (yyyy-mm-dd) で返します。

day(args)

引数として与えられた日付の日を返します。

endsWith(source, key)

ソース文字列が指定されたキーで終わる場合は true を、そうでない場合は false を返します。

excelColStringToNumberFunction

Excel スプレッドシートの文字列を数に変換します。

excelNumberToColStringFunction

数を Excel スプレッドシート内の文字列に変換します。

floor(arg)

数を最も近い整数に切り捨てます。

guid()

ランダムに生成された、グローバルな固有 ID (GUID) を返します。

hexDecode(arg)

16 進エンコードのデータをデコードします。

hexEncode(arg)

バイナリ データを 16 進エンコーディングでエンコードします。

indexOf(source, key)

ソース内のキーの最初のインデックスを返します。無い場合は -1 を返します。

length(arg)

テキスト内の文字数をカウントするか、バイナリ データが与えられた場合はバイト数をカウントします。

max(a, b)

2 つの数のうちの大きい方の値を返します。

md5(arg)

引数として与えられたバイナリ データの MD5 チェックサムを計算します。

min(a, b)

2 つの数のうちの最小値を返します。

month(args)

引数として与えられた日付の月を返します。

now()

現在の日付と時刻を返します。

random()

0 ~ 1 の間の乱数を返します。

removeSpaces(args)

SPACE、\t、\n などの、引数内の空白文字をすべて除去します。

replacePattern(source, pattern, newText)

テキスト "source" 内に "pattern" パターンが発生する度に、テキスト "newText" に置き換えます。パターンの一致は大文字と小文字を区別しません。

replaceText(source, oldText, newText)

テキスト "source" 内にテキスト "oldText" が発生する度に、テキスト "newText" に置き換えます。 "oldText" との一致は大文字と小文字を区別しません。

resolveURL(arg)

現在の URL を使用して、相対の URL を絶対に変換します。

round(arg)

最も近い整数に四捨五入します。

shortTime(arg)

引数として与えられた日付に対して、秒の小数部が無い時間 (hh:mm:ss) を返します。

substring(source, startIndex, endIndex)

startIndex で始まり endIndex に至り、endIndex の文字を含まないソース文字列の部分を返します。endIndex を指定しない場合、関数は、ソース文字列の長さが endIndex として与えられたかのように作用します。

startsWith(source, key)

ソース文字列が指定されたキーで始まる場合は true を、そうでない場合は false を返します。

textToBinary(text[, encoding])

テキストをバイナリ データにエンコードします。指定のエンコーディングが有れば使用します。無い場合は、デフォルトで UTF-8 エンコーディングを使用します。

time(arg)

引数として与えられた日付の時間 (hh:mm:ss.fff) を返します。

toInteger(args)

テキストを整数に変換します。計算に含めたい場合に便利です。

toNumber(args)

テキストを浮動小数点数に変換します。計算に含めたい場合に便利です。

toLowerCase(arg)

テキスト内のすべての文字を小文字に変換します。

toUpperCase(arg)

テキスト内のすべての文字を大文字に変換します。

trim(arg)

テキストの両端からすべてのスペースを除去します。

urlDecode(arg)

URL にエンコードされたテキストをデコードします。

urlEncode(arg)

テキストを URL にエンコードします。

weekday(arg)

引数として与えられた日付の曜日の名前を (英語で) 返します。

year(args)

引数として与えられた日付の年を返します。