RPAで動的IDを使わずにXPathでWeb要素を指定する方法|JobAuto

RPA × XPATH × DYNAMIC ID × WEB AUTOMATION

Webサイトで自動生成されるIDを使わずに、JobAutoでXPathを指定する方法を紹介します。画面を開くたびにHTMLのIDが変化すると、IDを含むXPathで対象が見つからなくなることがあります。

メールの受信ボックスから件名を取得する例を使い、「値取得」アクションの高度な設定で「ID付きのxpathを受け取る」のチェックを外す手順を操作画像7点で解説します。

動的IDを含むXPathで「要素が見つからない」原因

Webページの操作対象を指定する方法の一つが、HTML要素の位置や属性を表すXPathです。例えば //*[@id="item1"] のようなXPathは、id 属性の値が item1 の要素を指定します。

Webシステムによっては、画面表示や再ログインのたびにIDが生成され直すことがあります。ロボット作成時のIDをそのまま使うと、次回実行時に同じ要素を見つけられない場合があります。

すべてのIDが不安定なわけではありません。 IDが固定されているWebページでは、IDを利用したXPathが有効です。問題になるのは、実行ごとに変化するIDへ依存していることです。

受信ボックスのメール件名を取得する例

EXAMPLE / GET EMAIL SUBJECT

Webメールの一覧にある件名を値取得する

JobAutoでブラウザ上の受信ボックスを開き、一覧に表示されたメールの件名を取得する処理を考えます。

JobAutoでWebメールの受信ボックスから件名を取得する操作の例
件名を取得する処理を行う

XPathのid属性が実行ごとに変わる場合がある

次の画面例では、操作対象のXPathに id 属性の値が含まれています。そのIDが動的に作られる場合、画面の再読み込みなどで値が変わり、件名を取得できなくなることがあります。

メール件名のXPathに動的に生成されたid属性が含まれている画面
Xpathのidが動的に作られている

このようなときは、IDを使わない形式のXPathを取得する方法を検討します。

手順1|操作したいWeb要素をクリックして選択する

STEP 01 / SELECT THE ELEMENT

JobAutoのロボデザインで目的のページを開き、値を取得したいメールの件名など、操作対象の要素をマウスでクリックして選択します。

JobAutoのロボデザインで件名を取得したいWeb要素をクリックして選択する画面
操作したい個所をクリックする

対象が正しく選択されているか確認してください。メール一覧のように同じ構造の要素が複数並ぶ画面では、ほかの件名と取り違えないようにします。

手順2|右クリックしてアクションメニューを表示する

STEP 02 / OPEN CONTEXT MENU

選択した要素の上で右クリックし、ブラウザ操作のアクション一覧が含まれるメニューを表示します。

選択したWeb要素を右クリックしJobAutoのアクションメニューを表示する画面
メニューを表示する

メニューが表示されない場合は、JobAutoでWeb要素を選択できているか、ロボデザインの操作状態を確認します。

手順3|「値取得」アクションを選択する

STEP 03 / CREATE GET VALUE ACTION

右クリックメニューの「値取得」を選択します。これにより、選択した要素から文字や値を取得するためのアクション設定画面が開きます。

右クリックメニューから値取得アクションを選択する画面
値取得をクリックする

取得したメール件名を後続処理で使う場合は、アクションの基本設定で取得結果を格納する変数も指定します。

手順4|「高度な設定」タブを開く

STEP 04 / OPEN ADVANCED SETTINGS

値取得アクションの設定画面で「高度な設定」タブを開きます。この画面でXPathをはじめ、Attribute・Value・テキストパターンなどの条件を確認できます。

JobAutoの値取得アクションで高度な設定タブを開く画面
高度な設定タブを表示

まずはXPath欄がIDを含む形式になっているかを確認します。例えば //*[@id="item1"] なら、そのIDの値に依存した指定です。

手順5|「ID付きのxpathを受け取る」のチェックを外す

STEP 05 / WITHOUT ID-BASED XPATH

チェックを外してIDを使わない指定にする

「高度な設定」にある「ID付きのxpathを受け取る」のチェックを外します。JobAuto公式マニュアルでは、チェックを外した場合に /html/body/div/div/div のような、IDを利用しない形式のXPathを取得する設定として説明されています。

値取得の高度な設定でID付きのxpathを受け取るチェックを外した画面
ID付きのチェックを外した状態

設定したあと、XPath欄に意図した指定が反映されているかを確認してください。使用しているJobAutoの画面でXPathがすぐに変更されない場合は、要素の再選択やXPathの取得し直しが必要か確認します。

「要素にフォーカス」で対象を確かめる

設定したXPathで目的のメール件名が選択されるか、「要素にフォーカス」で確認します。その後、アクションを実行して取得結果の変数に正しい件名が格納されるかテストします。

注意:IDなしのXPathが常に安定するわけではありません。 /html/body/div/div/div のようなフルパス形式は、ページの途中に要素が追加されたりHTML構造が変わったりすると、別の要素を指す可能性があります。動的IDを回避できても、画面構造の変更には注意が必要です。

ID付き・IDなしのXPathの違い

指定方法XPathの例注意点
IDを利用//*[@id="item1"]IDが動的に変更されると一致しなくなる
IDを使わないフルパス/html/body/div/div/divHTMLの階層や並び順が変わると影響を受けやすい
安定した属性を利用する例//a[@data-role='subject']該当属性が実際のHTMLに存在し、安定していることが前提

上表のXPathは指定方法を示す例です。実際に使用できるかどうかは操作対象のHTML構造によって異なります。固定されたIDがある場合は無理に外す必要はありません。

XPathを安定させるために確認すること

安定した属性が利用できるか

Webページに安定した name・class・data-* 属性などがあれば、対象を絞り込む条件に利用できます。JobAutoの「値取得」では、XPathに加えてAttribute・Value・テキストパターンも設定できます。

同じ件名のメールが複数ある場合

件名の文字だけで検索すると、同じ件名のメールを取り違えるおそれがあります。メール一覧で繰り返し処理を行うときは、「rangename」で現在の繰り返し範囲を指定し、行ごとに正しい件名を取得できるか確認します。

要素の表示に時間がかかる場合

ページの読み込みが完了していないと、正しいXPathでも要素を取得できないことがあります。高度な設定の「要素が見つかるまでのタイムアウト(秒)」を設定し、対象が表示されるまで待つ構成を検討します。

再読み込みや再ログイン後もテストする

動的IDが原因のエラーは、ロボット作成直後の1回の実行だけでは見つからないことがあります。ページを再読み込みする、別のメールを選ぶ、再ログインして同じ処理を実行するなど、条件を変えてテストしてください。

Web要素が見つからない場合の確認ポイント

  1. 値取得の対象として正しいメール件名を選択しているか
  2. XPathに動的に変化するIDが含まれていないか
  3. 「ID付きのxpathを受け取る」のチェック状態とXPath欄が意図した内容になっているか
  4. IDを外したXPathが別の要素や別のメール件名に一致していないか
  5. 「要素にフォーカス」で正しい要素を選択できるか
  6. HTML構造の変化に弱い長いフルパスXPathになっていないか
  7. Attribute・Value・テキストパターンなど、より安定した条件を使えるか
  8. 要素の繰り返し処理内でrangenameが適切な検索範囲になっているか
  9. 画面の読み込みを待つタイムアウトが十分か
  10. 取得した値が正しい変数へ格納され、再実行後も同じ対象を取得できるか

まとめ|動的IDを避けてXPathによる値取得を設定する

JobAutoでは、値取得アクションの「高度な設定」→「ID付きのxpathを受け取る」のチェックを外すことで、IDを使わない形式のXPathを取得できます。Webページの動的IDが原因で値取得に失敗するときの対処方法の一つです。

ただし、IDなしのフルパスXPathもHTML構造の変更によって影響を受けます。「要素にフォーカス」で取得対象を確認し、必要に応じて安定した属性やテキストパターン、検索範囲を組み合わせることで、操作内容に合った設定へ調整してください。

Webページのデータ取得をJobAutoで自動化

Webシステムの一覧からデータを取得したり、画面の変更に合わせて操作対象を指定したりする業務にJobAutoを活用できます。実際のWebページに合ったXPathや変数の設定についてもご相談いただけます。

コメントを残す