【ブラウザ操作】この要素が出るまで待つ

★アクションの説明、概要

WEBページに指定した要素が出るまで処理を待機させる方法について説明します。


★アクションの作成方法


★アクションの設定画面について

アクション設定画面の設定項目についての説明は以下の通りです。

1.基本設定

1-1. 待ち時間

ロボットが処理を停止する時間を設定します。単位は秒です。変数参照可能です。

・この要素が表示されるまで待つ

指定した要素が表示されるまで待つ場合に選択します。

・この要素が消えるまで待つ

指定した要素が消えるまで待つ場合に選択します。


2.高度な設定

rangename、xpath、Attribute、Value、テキストパターンの設定をすることで、ロボットが操作する要素を指定します。要素にフォーカスボタンで設定した内容で操作したい要素をロボットが見つけられるか確認することができます。

2-1.rangename

指定した要素を探す対象範囲を設定します。要素のループの中で行う場合に設定します。

2-2.xpath

要素の指定を行います。変数参照可能です。

2-3.Attribute

要素の指定を行います。バージョン0.10.2から標準で自動設定されないようになりました。必要に応じてプルダウンで選択することができます。

2-4.Value

要素の指定を行います。バージョン0.10.2から標準で自動設定されないようになりました。Attributeで選択した設定に応じて内容が変わります。
バージョン0.10.7から変数参照が可能になりました。

2-5. テキストパターン

Webサイト内に表示されている文字を設定します。変数参照可能です。

2-6.要素のインデックス

ここまで設定した内容で1つの要素に絞り込めない場合、何番目の要素を操作するか指定します。1番目の場合、0を設定します。変数参照可能です(0.10.9から)。

2-7. 要素に対してフォーカスを移動する

本アクションが実行されるときに、指定した要素にフォーカスを当てる場合、チェックを入れます。

2-8.アラートが出ていればエラーとする

本アクションを実行するときにブラウザからアラートメッセージが表示されていた場合にエラーとするときは、チェックを入れます

2-9.アクション有効

このアクションを無効にする場合は、チェックを外します。


3.エラー発生時の対応

3-1. エラー時の処理

エラーが発生したときの設定を行います。詳細はこちらをご確認ください。

3-2.基点となる条件分岐

エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。

3-3. エラー時にログ出力

エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。

【エクセル操作】画像の挿入

★アクションの説明、概要

エクセルのシート内へ画像を挿入する方法について説明しています。

本アクションは共有設定がかかっているエクセルに実行することができません。


★アクションの作成方法


★アクションの設定画面について

アクション設定画面の設定項目についての説明は以下の通りです。

1.基本設定

1-1.ブック

ロボットが開いているエクセルのうち、どのエクセルを操作対象にするか選択します。名前とインデックスから選択します。

・名前

エクセル名で指定します。変数参照可能です。

・インデックス

インデックスで指定します。ロボットがエクセルを開いた順番でインデックスが定義されます。

1-2.シート名

ロボットが操作するシートを選択します。名前とインデックスから選択します。
※0.10.10からエクセルを開くアクションでCSVファイルを開いた場合は、デフォルトでインデックスが選択されています。

・名前

シート名で指定します。変数参照可能です。

・インデックス

インデックスで指定します。シートが作成された順番でインデックスが定義されています。

1-3.行番号

操作対象のセルが何行目にあるかを設定します。変数参照可能です。

1-4.列番号

操作対象のセルが何列目にあるかを設定します。アルファベットでも数字でも設定できます。変数参照可能です。

1-5.画像倍率指定(%)

差し込む画像の倍率を設定します。

1-6.ファイル

差し込む画像のファイルパスを設定します。変数参照可能です。


2.高度な設定

2-1.アクション有効

このアクションを無効にする場合は、チェックを外します。


3.エラー発生時の対応

3-1. エラー時の処理

エラーが発生したときの設定を行います。詳細はこちらをご確認ください。

3-2.基点となる条件分岐

エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。

3-3. エラー時にログ出力

エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。

【アプリ操作】【要素】値取得

★アクションの説明、概要

画面内の操作したい個所を要素による指定を行います。そして指定した箇所から値を取得する方法について説明しています。


★アクションの作成方法


★アクションの設定画面について

アクション設定画面の設定項目についての説明は以下の通りです。画面を読み込みと操作対象にフォーカス、背景色についてはこちらをご覧ください。

1.基本設定

1-1.要素が見つかるまでのタイムアウト(秒)

設定した時間まで、選択した要素をロボットが探し続けます。

1-2.要素が最前面に表示されるまで待つ

設定した時間まで、選択した要素が最前面に表示されるまでロボットが処理を停止します。

・待つ

最前面に表示されるまで処理を停止します。

・待たない

最前面に表示されるまで処理を停止しません。

1-3.格納先

取得した値を格納する変数を設定します。

1-4.取得対象

選択した要素から取得する値を設定します。

・現在の値

表示されている値を取得します。

・テキスト値

要素が持つ文字を取得します。

・名前

要素が持つ名前を取得します。

・チェック状態

チェックボックスにチェックの状態を取得します。チェックが入っている場合は「1」、入っていない場合は「0」を取得します。

・取得値

取得対象の設定で取得できる値が表示されます。

1-5.対象の要素(0.10.9から追加)

操作対象として設定した要素の画像が表示されます。


2.高度な設定

2-1.アクション有効

このアクションを無効にする場合は、チェックを外します。

2-2.キャッシュクリア

処理速度をあげるために要素の情報をもっています。その情報をクリアして再取得するときにチェックを入れます。アプリの画面表示に変化があった後に行うアクションの場合は、チェックを入れておきましょう。

2-3.要素をアクティブにする

要素をアクティブな状態にしてから実行する場合は、チェックを入れます。

2-4.名前

要素を名前で指定するときに設定します。変数参照可能です。
変数参照する場合はチェックボックスにチェックを入れてから、参照する変数の設定を行います。
こちらも参考にしてください。

2.アプリ操作でうまくいかないときは(要素マッチング)1ー名前で正規表現を使う

2-5.クラス

要素をクラスで指定するときに設定します。

2-6.タイプ

要素をタイプで指定するときに設定します。
こちらも参考にしてください。

2-7.AID

要素をAIDで指定するときに設定します。変数参照可能です。
変数参照する場合はチェックボックスにチェックを入れてから、参照する変数の設定を行います。

2-8.要素インデックス

ここまで設定した内容で1つの要素に絞り込めない場合、何番目の要素を操作するか指定します。1番目の場合、0を設定します。変数参照可能です。変数参照したときに変数の中身が空だった場合など、インデックスが空のときは自動的に0が設定されます。


3.エラー発生時の対応

3-1. エラー時の処理

エラーが発生したときの設定を行います。詳細はこちらをご確認ください。

3-2.基点となる条件分岐

エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。

3-3. エラー時にログ出力

エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。

【ブラウザ操作】マウス操作(チェックボックス)

WEBサイト内にあるチェックボックスに対する操作の方法について説明しています。

アクション設定画面の設定項目についての説明は以下の通りです

1.基本設定

1-1.マウス操作の種類を選択します

クリック
ダブルクリック
右クリック
マウス移動

1-2.ダウンロードの場合はチェックを入れてください

ダウンロードの場合はチェックを入れます

1-3.保存先

ダウンロードの保存先を設定します。変数参照可能です。またシステム値を使用可能です。システム値の説明はこちら。

—保存先をファイル名まで設定した場合
C:\temp\sample.csv
この場合、tempフォルダへsample.csvが保存されます

—保存先をフォルダ名まで設定した場合
C:\temp\
この場合、tempフォルダへダウンロード先のWebサイトが命名したファイル名で保存されます。※\を最後に指定する必要があります

1-4.ダウンロード開始までのタイムアウト(秒)

設定した秒数までロボットがアラートメッセージを探します


2.高度な設定

rangename、xpath、Attribute、Value、テキストパターンの設定をすることで、ロボットが操作する要素を指定します。要素にフォーカスボタンで設定した内容で操作したい要素をロボットが見つけられるか確認することができます

2-1.rangename

指定した要素を探す対象範囲を設定します。要素のループの中で行う場合に設定します。要素のループ内でアクションを実行させたいのにrangenameがanywhereになっていると、意図した箇所で動いてくれません

2-2.xpath

要素の指定を行います。変数参照可能です

2-3.Attribute

要素の指定を行います。バージョン0.10.2から標準で自動設定されないようになりました。必要に応じてプルダウンで選択することができます。

2-4.Value

要素の指定を行います。バージョン0.10.2から標準で自動設定されないようになりました。Attributeで選択した設定に応じて内容が変わります。
バージョン0.10.7から変数参照が可能になりました。

2-5.テキストパターン

Webサイト内に表示されている文字を設定します。変数参照可能です

2-6.要素のインデックス

ここまで設定した内容で1つの要素に絞り込めない場合、何番目の要素を操作するか指定します。1番目の場合、0を設定します。変数参照可能です(0.10.9から)。

2-7.ダウンロード時のファイル名格納先

別名でダウンロードしたファイルを保存しない場合、またはできない場合に設定します。ダウンロードしたときに自動保存されたファイル名を格納する変数を設定します

2-8.ダウンロード対象ファイルの拡張子

サイトによってはダウンロードするファイルの拡張子を設定しないと処理が正常に行われない場合があります。

2-9.要素に対してフォーカスを移動する

本アクションが実行されるときに、指定した要素にフォーカスを当てる場合、チェックを入れます

2-10.アラートが出ていればエラーとする

本アクションを実行するときにブラウザからアラートメッセージが表示されていた場合にエラーとするときは、チェックを入れます

2-11.要素が見つかるまでのタイムアウト(秒)

設定した2数までロボットが要素を探します

2-12. ダウンロードが完了するまでのタイムアウト(秒) (0.10.9から追加)

設定した秒数を超えてもダウンロードが完了しなかった場合にエラーにします。

2-13.アクション有効

このアクションを無効にする場合は、チェックを外します


3.エラー発生時の対応

3-1.エラー時の処理

エラーが発生したときの設定を行います。詳細はこちらをご確認ください。

3-2.基点となる条件分岐

エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。

3-3.エラー時にログ出力

エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。

【エクセル操作】セルに値入力

★アクションの説明、概要

Excelへ値を書き込む方法について説明しています。


★アクションの作成方法


★アクションの設定画面について

アクション設定画面の設定項目についての説明は以下の通りです。

1.基本設定

1-1.ブック

ロボットが開いているエクセルのうち、どのエクセルを操作対象にするか選択します。名前とインデックスから選択します。

・名前

エクセル名で指定します。変数参照可能です。

・インデックス

インデックスで指定します。ロボットがエクセルを開いた順番でインデックスが定義されます。

1-2.シート名

ロボットが操作するシートを選択します。名前とインデックスから選択します。
※0.10.10からエクセルを開くアクションでCSVファイルを開いた場合は、デフォルトでインデックスが選択されています。

・名前

シート名で指定します。変数参照可能です。

・インデックス

インデックスで指定します。シートが作成された順番でインデックスが定義されています。

0.10.9から1-3と1-4のいずれかを選択してから設定します。

1-3.アドレスを行列で指定

・行番号

操作対象のセルが何行目にあるかを設定します。変数参照可能です。

・列番号

操作対象のセルが何列目にあるかを設定します。アルファベットでも数字でも設定できます。変数参照可能です。

1-4.アドレスを名前で指定(0.10.9から追加)

エクセルの機能「名前の定義」で作成した名前を設定します

1-5.入力値

セルへ入力する値を設定します。変数参照可能です。またシステム値を使用可能です。システム値の説明はこちら。


2.高度な設定

2-1.実行時にシートを切り替える

アクションを実行したときにシートを表示する場合にチェックを入れます。

2-2.アクション有効

このアクションを無効にする場合は、チェックを外します。


3.エラー発生時の対応

3-1. エラー時の処理

エラーが発生したときの設定を行います。詳細はこちらをご確認ください。

3-2.基点となる条件分岐

エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。

3-3. エラー時にログ出力

エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。

【エクセル操作】Excel内の繰り返し_ヘッダーなし

ヘッダーがないExcelのデータを繰り返し操作する方法について説明をしています。

シートの保護が設定されているエクセルで行の繰り返しを行うと、1行ループして処理が終わります。
シートの保護の解除アクションを使い、シートの保護を解除してから行の繰り返しを実行してください。


アクション設定画面の設定項目についての説明は以下の通りです

1.基本設定

1-1.ブック

名前、インデックス、変数参照から選択して設定を行います。

>名前
操作対象のブック(エクセルファイル)をプルダウンで選択します

>インデックス
操作対象のブック(エクセルファイル)はロボデザインで開いたまたは作成した順番にインデックスが定義されています。プルダウンで選択します。

>変数参照
操作対象のブック名(エクセルファイル名)が格納されている変数を設定します

1-2.シート名

名前、インデックス、変数参照から選択して設定を行います。
※0.10.10からエクセルを開くアクションでCSVファイルを開いた場合は、デフォルトでインデックスが選択されています。

>名前
操作対象のシートをプルダウンで選択します

>インデックス
操作対象のシートは作成された順番にインデックスが定義されています。プルダウンで選択します。

>変数参照
操作対象のシート名が格納されている変数を設定します

1-3.データ範囲設定

繰り返し処理を行う範囲を固定する場合は、現在の範囲を選択します。
処理のたびに繰り返し処理を行う範囲が変わる可能性がある場合は、範囲を拡張するを選択します。
繰り返しの対象範囲をALL列まで指定することができます。

1-4.対象となるセル

繰り返し処理を行う範囲を設定します。変数参照可能です。
エクセルの機能「名前の定義」で作成した名前でも設定ができます(0.10.9から)

1-5.1行目を列名とする

繰り返し処理を行う範囲の1行目を列名(ヘッダー)として、処理対象から外す場合はチェックを入れます。作成済の同アクションを編集で開き、チェックを入れる、またはチェックを外す場合は、列名と変数の対比表の再作成が必要です。

1-6.列名と変数の対比表

繰り返し処理では対象となるセルから取得したデータを列ごとに変数へ格納します。どの列をどの変数へ格納するかをここで定義します

・+

定義を追加します。

ー列名と変数の対比表作成

・列名

列を設定します。

・変数名

格納先の変数を設定します。

・ー

定義を削除します。

・列名を変数に登録する

1行目を列名とするへチェックを入れた場合、列名を変数名として登録します。
※0.10.10から対比表を再作成しますか?というダイアログが表示されません。

・開始行

繰り返し処理をスタートさせる行を指定します。繰り返しの範囲の中で3行目から開始したい場合は「3」を設定します。

ー列名と変数の対比表

・グループ名

列名を新しい変数グループ内に作成します。新しく作成する変数グループ名を設定します。

・変数の識別子

変数を固有に識別するための文字を設定します。


2.高度な設定

2-1.範囲の名前

ループの名前を設定します。ここで設定した名前は、セルに値入力などのMainタブのシート名の名前で選択することができます

2-2.取得する値

セルの保持している値は2019/8/29だが、表示されている値は2019年8月
2019/8/29を取得する場合、エクセルが保持している値を選択します。
2019年8月を取得する場合、セルが表示している値を選択します

2-3.セルへのフォーカス

アクションを実行したときに処理対象のセルを選択状態にする場合は、フォーカスするを選びます。選択状態にしない場合は、フォーカスしないを選びます。

2-4.非表示セルの扱い ※バージョン0.10.3から追加

フィルタなどで非表示になっているセルをループの対象にする場合は、処理対象に含めるを選びます。ループの対象にしない場合は、処理対象に含めないを選びます

2-5.アクション有効

このアクションを無効にする場合は、チェックを外します


3.エラー発生時の対応

3-1. エラー時の処理

エラーが発生したときの設定を行います。詳細はこちらをご確認ください。

3-2.基点となる条件分岐

エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。

3-3. エラー時にログ出力

エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。

【ブラウザ操作】現在のタブを閉じる

★アクションの説明、概要

ブラウザで表示中のタブを閉じる方法について説明しています。


★アクションの作成方法


★アクションの設定画面について

アクション設定画面の設定項目についての説明は以下の通りです。

1.基本設定

1-1.現在のタブかタブ以外か

>現在のタブを閉じる

複数開いているタブのうち、現在表示されているタブを閉じます。本アクションではこちらが選択状態になっています(0.10.10から)。

>現在のタブ以外を閉じる

複数開いているタブのうち、現在表示されているタブ以外を閉じます

1-2.画面を閉じた後、最初の画面に制御を戻す

このアクションの実行後、一番最初に開いたタブを表示する場合はチェックを入れます。本アクションではこちらはチェックが入っている状態になっています。

2.高度な設定

2-1.アクション有効

このアクションを無効にする場合は、チェックを外します。


3.エラー発生時の対応

3-1. エラー時の処理

エラーが発生したときの設定を行います。詳細はこちらをご確認ください。

3-2.基点となる条件分岐

エラー時の処理で条件分岐の次のフローに移動を選択したときに、設定することができます。アクションでエラーが発生した場合、移動先の条件分岐を選択します。

3-3. エラー時にログ出力

エラーが発生したときにログに出力するか設定します。スケジュール実行したときのログへ出力されます。エラーとして扱わない場合は、チェックを外します。詳細はこちらをご確認ください。