【ブラウザ操作】ブラウザアクションを追加できないとき

メニューが表示されない

ロボットへブラウザを操作するアクションを追加しています。

通常ブラウザ上で操作したいか所を選択、右クリック、メニューからアクションを選択…という手順でアクションを追加していきます。このときXpathは自動的に取得されます。

RPA ブラウザ 追加

まれに右クリックしてもメニューが表示されず、アクションを選択できないWEBサイトが存在します。

RPA ブラウザ 追加

アクションを追加する方法

メニュー以外からアクションを追加する場合は、以下の方法で行ってください。

1.追加したいアクションをほかのところからコピー&ペースト

追加したいアクションをロボットのほかの場所からコピー&ペーストします。値入力アクションを使って説明します。

RPA ブラウザ 追加
RPA ブラウザ 追加

2.操作したい個所のXpathをコピーします

操作したい個所のXpathをコピーします。

ブラウザへのフォーカス(ピンクの四角が表示される)が邪魔になるので、フォーカス中断をします。コントロールパネルのフォーカス中断をクリックします。

ブラウザ上でF12キーを押し、DevToolsを表示します。

Elementsを選択します。

Ctrl+Shift+Cキーを押しながらXpathをコピーしたい(操作したい個所)へマウスカーソルをあわせます。Elements内のHTMLが展開されます。

Elements内のXpathをコピーしたい(操作したい個所)へマウスで選択します。

右クリックしてメニューを表示、Xpathをコピーします。

3.Xpathをアクションへ貼り付けます

高度な設定タブのxpathへコピーしたXpathを貼り付けます。

【ブラウザ操作】JavaScriptを使った値の書き込み

WEBサイトの入力するテキストボックスの構成によっては、値の入力アクションによる入力ができないことがあります。

その場合の対処方法として、Javascriptの実行アクションを使った入力方法についてご説明します。

1.Javascriptの実行アクションを作成

Javascriptの実行アクションを作成して、設定画面を開きます

2.jQueryを使えるように設定

高度な設定タブの$sとしてjQueryを使えるようにする、にチェックを入れます

JavaScript 値 書き込み

3.コマンドを作成

以下のコマンドを作成します。実行するJavaScriptへ設定します。

$s(“入力個所のID“).val(“入力する値“);

入力個所のIDの調べかた

値入力アクションを作成し、設定画面の高度な設定タブのXPATHのid=となっている””で囲われた文字がIDです

JavaScript 値 書き込み

accountというIDへnoguchiという文字を入力するコマンドです。

JavaScript 値 書き込み

【ブラウザ操作】ロボットをGoogleへログインした状態に

Googleにログインできない

ロボットでGoogleドライブなどの操作を行います。ロボットで起動したChromeでは、以下のような画面が出てしまいます。ログインすることができません。この時の解決方法について、説明します

ロボット Google ログイン

Googleにログインしたままにしておく

ブラウザ起動アクションでChromeを起動します。このときにログインした状態でChromeを起動する方法があります。

プロファイルにログインした状態を記憶させる

ロボットが操作するChromeにもプロファイルがあります。このプロファイルへGoogleへログインした状態になっていることを記憶させます。

1.アプリを開くアクションでChromeを起動します

引数へ設定へはプロファイルのフォルダを指定します。

ロボット Google ログイン

2.ブラウザ起動アクションの高度な設定タブのChromeの設定

プロファイルを使用にチェックを入れ、フォルダを先ほどの1の引数で設定したフォルダを設定します。

ロボット Google ログイン

3.Googleへログイン

chromeが起動したら手でGoogleへログインしましょう。2で指定したプロファイルにログインされたことが記憶されます。

ここまでできたら、1-2で作成したアクションはいらないので削除します

4.Googleへログインした状態で起動

ブラウザ起動アクションを作成します。高度な設定タブのプロファイルを使用にチェックを入れ、フォルダを先ほどの1の引数で設定したフォルダを設定します。

Googleへログインした状態でページが開きました

【ブラウザ操作】ロボットのChromeでアクセスできない時

ブラウザ起動アクションで起動したChormeで、ページを開くアクションを使いWEBサイトを開きます。このときに、WEBサイトが開かなかった場合の手順について説明します。

0.10.9からEdgeが追加します。使い方はChromeと同じです。

1.アプリを開くアクションを使ってChromeを起動

アプリを開くアクションで項目名「プログラム」の下の▼をクリックします。表示されるメニュー内のChromeを起動するをクリックします。

クリックすると以下のように設定されるので、実行をクリックします。Chromeのインストール場所が違う場合はプログラムに表示されているChromeの場所を変更してください

2.ブラウザ起動アクションを実行

ブラウザ起動アクションが自動的に表示されます。実行するをクリックします

ロボット Chrome アクセス

Chrome(アプリケーション)が選択されています。またChrome(アプリケーション)のポート番号が設定されています


3.ページを開くアクションを実行

ここまで来たら通常のブラウザアクションと手順は同じです。自動的に開いたページを開くアクションへURLを設定して実行します

ロボット Chrome アクセス

4.ご注意ください

このページでご案内した方法で起動したChromeでファイルのダウンロードを行うには方法で行います。

1.マウス操作のダウンロードの場合はチェックしてください、へチェックを入れない

2.C:\Users\windowsのユーザー名\Downloads\内のダウンロードしたファイルを処理する

【ブラウザ操作】マウス操作(クリック)

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

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.range_name

指定した要素を探す対象範囲を設定します。要素のループの中で行う場合に設定します。要素のループ内でアクションを実行させたいのに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-12. ダウンロードが完了するまでのタイムアウト(秒) (0.10.9から追加)

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

2-13. アクション有効

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


3.エラー発生時の対応

3-1. エラー時の処理

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

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

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

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

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

【ブラウザ操作】ページを開く

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

WEBページの開き方について説明しています。


★アクションの作成方法


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

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

1.基本設定

1-1.URL

ブラウザで開くWebサイトのURLを入力します。変数参照できます。


2.高度な設定

2-1.ベーシック認証

ブラウザで開くWebサイトにベーシック認証が必要な場合に設定をします。

・ユーザー名

ユーザー名を入力します。変数参照できます。

・パスワード

パスワードを入力します。変数参照できます。

2-2.タイムアウト

WEBサイトが開くまでのタイムアウト時間を入力します。単位は秒です。

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

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

2-4.アクション有効

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


3. エラー発生時の対応

3-1. エラー時の処理

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

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

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

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

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

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

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

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. エラー時にログ出力

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

【ロボット講習】ページをまたがって繰り返し処理を行う

以下のページのように検索の結果の表示がいくつかのページにまたがって表示されており、各ページからデータを取得するにはどうしたらいいでしょうか。

sample001

表示されるページは検索の結果によって異なるため、次頁というリンクをクリックできる限り処理を繰り返すというフローを作成します。(次頁というリンクをクリックできなくなるまで繰り返し処理を行う)

 

作成したフローが以下となります。

sample003

 

 

 

 

ページ内の値取得が終わったら、「次頁」をクリックします。このとき、Webページは次のページが表示されます。

sample004

次に「ブックマークにジャンプ」が実行され、ブックマークへ処理が移ります

sample005

検索結果の表示が最後のページになった場合、次頁が見つからずにエラーになります。このときに鰓発生時の対応の設定を「後続処理をしない」にしておきます。ブックマークにジャンプが実行されず、後続のアクションへ進みます

ロボットはこちらからダウンロードできます。

【ブラウザ操作】要素をうまく設定するコツ

1.要素にフォーカスボタンを使う

設定を変更したら、要素にフォーカスを行って確認しましょう

focus

2.再フォーカスで要素を再設定

編集画面を開いた状態で、ブラウザ内の操作したい個所を選択します。右クリックすると操作個所の再設定ができます

refocus

3.テキストパターンによる設定

画面に表示されている文字で操作個所を指定することもできます。テキストパターンをうまく使いましょう

textpattern

4.classは基本的に使わない

アクションを作成したときにAttibuteに自動的に設定される値としてclassという値があります。classは操作個所のデザインの設定を表しています。デザインは変わることが多いので、classは空白にするのをおすすめします

class

5.ID付きのxpath

操作個所のHTMLにIDがある場合、xpathはID付きの設定になります。IDがよく変わるサイトであれば、チェックを外して指定をするのをおすすめします。

is_xpath

6.要素の繰り返しにおいて実行のたびにxpathが変わるとき

要素の繰り返し処理で以下のようなxpathを指定しています。
//*[@id=”testdayo”]/div/div[2]/div[6]/img

しかし実行するタイミングによっては以下のようなxpathでないといけないことが。
//*[@id=”testdayo”]/div/div[2]/div[8]/img

アクションを設定したときはdiv[6]でした。実行したときにdiv[8]となっていたためエラーとなってしまいました。以下のように設定するとxpathが変わったことを吸収することがあります。
//*[@id=”testdayo”]/div/div[2]/div/img

【ブラウザ操作】フリーハンド

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

オリジナルのブラウザ操作のアクションを作成する方法について説明しています

テンプレートを2ファイル用意しました。以下フォルダに格納されているので、インポートしてご使用ください。

\support\web_freehand

GoogleSpreadSheetをソートするテンプレートです。
スプレッドシート_ソート.web

GoogleSpreadSheetへフィルタを設定するテンプレートです。
スプレッドシート_フィルター.web

また戻り値は以下のように記述してください。
# 戻り値の設定
return_value = 戻したい値

戻り値を格納する変数の設定は、Advancedタブで行います。


★アクションの作成方法


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

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

1.基本設定

1-1.テンプレート メニュー

テンプレートの操作を行います。

・反映

プルダウンで選択したテンプレートを開きます。

・ テンプレートをインポート

テンプレートファイルをインポートします。インポートしたテンプレートはプルダウンで選択できるようになります。

・ テンプレートをエクスポート

このアクションで編集中の内容をテンプレートファイルとしてエクスポートします。

1-2.テンプレート 編集

テンプレートはシステム値を使用可能です。システム値の説明はこちら。


2.高度な設定

2-1.戻り値

REST APIの実行結果を格納する変数を設定します。

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

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

2-3.アクション有効

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


3.エラー発生時の対応

3-1. エラー時の処理

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

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

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

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

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