DA内のステップで設定するエクスプレッションには、関数も使用できます。
関数の仕様については、Java、C#、JavaScript などの一般的なプログラミング言語のエクスプレッションと非常によく似ています。
エクスプレッションで関数を使用する場合は、下記の2通りの方法があります。
①直接手入力をする。
②「Ctrl-Space」で関数の一覧を表示し、選択する。
なお、直接手入力する場合でも、スペルを入力すると候補が表示されます。
▼ ① 直接手入力(候補の一覧表示画面)
▼ ② 「Ctrl-Space」で一覧表示
また、エクスプレッションに「関数名()」を入力した後に、関数名の英字部分を選択(青地)すると説明文が表示されるので、参考にしてください。
<使用できる関数一覧>
■数値関数
関数 | 説明(英文) | 説明 |
abs(Integer) | Returns the absolute value of an integer |
整数の絶対値を返します |
abs(Number) | Returns the absolute value of a number |
数値の絶対値を返します |
ceil(Number) | Rounds numbers towards positive infinity |
プラス方向への切り上げ(切り捨て)を行います。 <正数> 3.14 → 4 <負数> -3.14 → -3 |
floor(Number) | Rounds numbers towards negative infinity |
マイナス方向への切り上げ(切り捨て)を行います。 <正数> 3.14 → 3 <負数> -3.14 → -4 |
round(Number) | Rounds numbers towards nearest integer |
数値を四捨五入します。 <正数> 3.5 → 4 <負数> -3.5 → -4 |
trunc(Number) | Rounds the number towards zero |
正数の場合は切り捨て、負数の場合は切り上げます <正数> 3.5 → 3 <負数> -3.5 → -3 |
max(Integer, Integer) | Returns the largest of two integers |
2つの整数の最大値を返します |
max(Number, Number) | Returns the largest of two numbers |
2つの数値の最大値を返します |
min(Integer, Integer) | Returns the smallest of two integers |
2つの整数の最小値を返します |
min(Number, Number) | Returns the smallest of two numbers |
2つの数値の最小値を返します |
random() | Returns a random number greater than or equal to 0.0 and less than 1.0 |
0.0 以上 1.0 未満の乱数を返します |
random(Integer, Integer) |
Returns a random integer in the interval defined by the two arguments |
第 1 オペランドの値以上、第 2 オペランドの値以下の ランダムな整数を返します。 |
■テキスト関数
関数 | 説明(英文) | 説明 |
length(Text) | Returns the length of the text | テキストの長さを返します |
substring(Text, Integer) |
Returns a sub-text of the text from the given index to the end of the text |
Integerで指定された文字位置から末尾までのテキストを返します <例>Text:あいうえお Integer:3 →えお |
substring(Text, Integer, Integer) |
Returns a sub-text of the text from the first index to the second index |
1つ目のIntegerで指定された文字位置から 2つめのIntegerまでのテキストを返します <例>Text:あいうえお Integer(1):3 Integer(2):4 →え |
indexOf(Text, Text) | Returns the index of the first occurrence of the specified sub-text |
Text(1)の文字列内でText(2)の文字列を探し、 最初に見つかったインデックスを返します。 <例>Text(1):abc Text(2):b →1 |
contains(Text, Text) | Returns true if this text contains the specified sub-text |
Text(1)にText(2)が含まれる場合、trueを返します |
trim(Text) | Returns a text whose value is the input text, with any leading and trailing whitespace removed |
文頭と文末の空白を削除したテキストを返します |
capitalize(Text) | Returns a text where the first letter of every word is in upper- case and all other letters are in lower-case |
単語の頭文字のみ大文字にしたテキストを返します。 <例>aaa bbb ccc →Aaa Bbb Ccc |
startsWith(Text, Text) | Tests if this text starts with the specified prefix text |
Text(1)の接頭辞がText(2)の場合、trueを返します |
endsWith(Text, Text) | Tests if this text end with the specified suffix text |
Text(1)の接尾辞がText(2)の場合、trueを返します |
toLowerCase(Text) | Returns a text whose value is the input text, with characters converted to lower case |
テキストを小文字に変換します |
toUpperCase(Text) | Returns a text whose value is the input text, with characters converted to upper case |
テキストを大文字に変換します |
matches(text: Text, regex: Text)* |
Return true if the given regular expression matches the text |
指定された正規表現がテキストと一致する場合、trueを返します |
replaceAll(text: Text, regex: Text, replacement: Text)* |
Replaces all subtext of the text that matches the given regular expression with the given replacement text |
正規表現に一致するすべての文字列を、 指定された置換文字に置き換えます |
※ regex: Text は正規表現で入力する必要があります。
特殊文字を使用する際は、エスケープを行ってください。
■変換関数
関数 | 説明(英文) | 説明 |
integer(Number) | Converts a number to an integer without loss of precision |
数値を整数に変換します |
integer(Text) | Converts a text representation of an integer into an integer. if the text does not represent an integer a Conversion Issue exception is thrown |
テキストとして格納された値を整数に変換します |
number(Integer) | Converts an integer to a number |
整数を数値に変換します |
number(Text) | Converts a text representation of a number into a number. if the text does not represent a number a Conversion Issue exception is thrown |
テキストとして格納された値を数値に変換します テキストが数値でない場合、エラーとなります |
text(Integer) | Converts an integer to a text |
整数をテキストに変換します |
text(Number) | Converts a number to a text |
数値をテキストに変換します |
text(Boolean) | Converts a boolean to a text | ブール値をテキストに変換します |
toJSON() |
■toJSON(Integer) ■toJSON(Number) ■toJSON(Boolean) ■toJSON(Text) ■toJSON(Binary) ■toJSON(Record) |
パスワード以外のあらゆるタイプの値を、 JSON オブジェクトとして フォーマットされたテキスト値に変換します。 パスワード タイプ属性を含むレコードタイプは JSON に変換できません。 <変換された値の例> ・5 は "5" となります (注) ワークフロー状態ビューには、 toJSON 関数は、[1,2,3] のような配列を生成することはありません。 詳細については、『JSON の使用』を参照してください。 |
※本記事の内容は、User's Guideにも記載があります。
【10.3】 Design Studio>デバイスオートメーション>デバイスオートメーションのエクスプレッション
【10.4】 Desktop Automation>Desktop Automationのエクスプレッション
また、エクスプレッション下部の、(?)ボタンをクリックするとヘルプページへ移動できます。