Control

制御系のアクションの一覧です。
If
概要
指定された条件により処理を分岐します。条件が真の場合、ブロック内に定義された処理を実行します。
パラメーター
名前
型
概要
例
condition
文字列
条件（変数利用可能）
${total > 90}
使用例
1
# 変数に保存
2
+store_value_1:
3
  action>: StoreValue
4
  key: total
5
  value: 100
6
​
7
# 真のとき
8
+if_1:
9
  if>: '${total > 90}'
10
  _do:
11
​
12
    # テキストを作成
13
    +text_1:
14
      action>: Text
15
      text: '合格'
Copied!
ForEach
概要
リストの各要素に対して一度ずつ処理を実行します。
パラメーター
名前
型
概要
例
iterable
配列
対象のリスト
["apple","orange","banana"]
element
文字列
要素を格納する変数名
fruit
withIndex
文字列
現在の繰り返し回数を格納する変数名。*変数名が設定されていない場合は、繰り返し回数を取得することができません。
count
使用例
1
# 各要素について繰り返す
2
+for_each_1:
3
  for_each>:
4
    fruit: ["apple","orange","banana"]
5
    withIndex: count
6
  _do:
7
​
8
    # テキストを作成
9
    +text_1:
10
      action>: Text
11
      text: "${count}回目の繰り返し\n${fruit}"
Copied!
Loop
概要
指定した回数だけ処理を繰り返します。
パラメーター
名前
型
概要
例
times
数値
繰り返す回数
5
使用例
1
# 繰り返し
2
+loop_1:
3
  loop>: 5
4
  _do:
5
​
6
    # テキストを作成
7
    +text_1:
8
      action>: Text
9
      text: Hello
Copied!
BreakIf
概要
Loop / ForEachブロックの中に配置します。 指定された条件が真の場合、繰り返し(Loop / ForEach)ブロックを抜けてブロック外の次のタスクに移動します。 繰り返しが入れ子になっている場合、一番内側の繰り返しブロックから抜けます。
パラメーター
名前
型
概要
例
condition
文字列
条件（変数利用可能）
${total > 90}
使用例
1
# 繰り返し
2
+loop_1:
3
  loop>: 5
4
  _do:
5
​
6
    # 繰り返しを終了する
7
    +break_if_1:
8
      break_if>: ${i === 3}
9
​
10
    # テキストを作成
11
    +text_1:
12
      action>: Text
13
      text: '${i}回目'
Copied!
Try
概要
ブロック内のエラーを捕捉します。Tryブロック内でエラーを捕捉した場合、Tryブロックを抜けてブロック外の次のタスクに移動します。エラーオブジェクトは、errorObjectNameパラメーターで設定した変数に格納されます。Tryブロック内でエラーが捕捉されたかどうかは、IfタスクでerrorObjectNameに値が入っているかどうかをチェックすることにより確認できます。エラーオブジェクトを使って、エラーの種類によって異なるエラーハンドリングを実装することができます。実際の使い方については、使用例をご覧ください。エラーが捕捉されない場合は、ブロックのおわりまでいきます。
パラメーター
名前
型
概要
例
errorObjectName
文字列
エラーオブジェクトを格納する変数名
error
エラーオブジェクトの中身
1
{
2
  "message": "Error: something went wrong.", // エラーメッセージ
3
  "task_name": "+try_1+sub_try+click_point_1", // エラーが発生したタスクの名前
4
  "attempt_id": "2611", // エラーが発生した試行のID
5
  "session_time": "2020-08-24T22:16:45+09:00" // エラーが発生したセッションの開始時刻
6
}
Copied!
使用例
1
# TRY
2
+try_1:
3
  try>: error
4
  _do:
5
​
6
    # ブラウザを開く
7
    +open_browser_1:
8
      action>: OpenBrowser
9
      url: 'https://tutorial.co.jp/'
10
      headless: true
11
​
12
    # XY座標でクリック
13
    +click_point_1:
14
      action>: ClickPoint
15
      browser: +open_browser_1
16
      x: 100
17
      y: 100
18
      selector: 'body > div.wrapper > section.module.divider-bottom.pt-5 > div > div.row.pt-5 > div > not > found'
19
      confirm: false
20
​
21
# 真のとき
22
+if_1:
23
  if>: ${error}
24
  _do:
25
​
26
    # 真のとき
27
    +if_2:
28
      if>: ${error.message.includes('Anchor point not found')}
29
      _do:
30
​
31
        # テキストを作成
32
        +text_1:
33
          action>: Text
34
          text: 'Handle this error as you like!'
Copied!
KillAttempt
概要
KillAttemptは、実行中のセッションを異常終了させます。実行されるとエラーステータスで完了となります。想定通り終了した場合もエラーステータスとなるので注意してください。
終了メッセージをつけることができるので、デバッグや条件により終了させたいときに使います。
パラメーター
*は、必須パラメーター
名前
型
概要
例
message
文字列
終了時に残すメッセージ
終了しました
アウトプット
無し
使用例
1
+kill_attempt_1:
2
  action>: KillAttempt
3
  message: 'この条件では、ワークフローが完了しないので終了させます。'
Copied!
AddToQueue
概要
AddToQueueは、指定したワークフローをセッションキューに追加します。
paramsパラメーターを使えば、ワークフローにデータを渡すことも可能です。
パラメーター
*は、必須パラメーター
名前
型
概要
例
workflow_id*
数値
セッションキューに追加するワークフローのID
1234
params
オブジェクト
ワークフローに渡すデータ
{"url":"https://www.roboticcrowd.com/"}​
アウトプット
タイプ
型
概要
例
Text
文字列
セッションキューのステータス
"running"
使用例
1
+add_to_queue_1:
2
  action>: AddToQueue
3
  workflow_id: 1234
4
  params:
5
    url: 'https://www.roboticcrowd.com/'
Copied!

Actions - Previous

Message

Next - Actions

WebService

Last modified 3mo ago