構造解析（オブジェクト認識）による操作¶
操作対象のアプリケーションや Web ページの内部構造を解析して画面項目を特定し操作することができます。
Web ページを操作する場合に対応しているブラウザは次の通りです。
- Chromium 版 Microsoft Edge
- Windows® 10（32bit / 64bit）
- ※動作確認済みバージョン：20H2, 21H1, 21H2
- Windows® 11（64bit）
- ※動作確認済みバージョン：21H2
注意
アプリケーションによっては、特定の画面項目が構造解析による操作に対応していない場合があります。
操作実行時に
- 指定の操作が動かず無反応
- 「値の取得に失敗しました」または「値の設定に失敗しました」というエラーが発生する
といった動作をする場合は、以下の点を確認してください。
- アクションの「操作対象」内「画面項目」欄にて画面項目が正しく認識されている
- 実行時のウィンドウタイトルがアクションの「操作対象」内「画面項目」欄の「ｳｨﾝﾄﾞｳ」項目の値と一致している
- 操作対象が「選択式入力欄」の場合に「次の値を選択する」に指定した値と完全に一致する選択肢が存在する
- 操作対象が「リスト」の場合に「次の値をセットする」に指定した値と完全に一致する選択肢が存在する
- 操作対象が「領域」の場合に指定した名前と部分的、または、完全に一致する表示名の選択肢が存在する
いずれも問題が無いにも関わらず動作しない場合は、構造解析以外のアクション（マウスアクションやキーボードアクション）をご利用ください。
構造解析（オブジェクト認識）とは¶
注釈
CELF RPA の構造解析では操作対象のウィンドウを、アプリケーションの種類とウィンドウタイトルで特定しています。
アクションセットの作成時と実行時でウィンドウタイトルが変更されている場合、
設定したウィンドウと同じアプリケーションが開かれているのであれば、そのアプリケーションで最前面に表示されているウィンドウに対して操作を行います。
設定したウィンドウと同じアプリケーションが開かれていなければ、操作対象を見つけることができずエラーになります。
注釈
Microsoft Edge のプロファイル機能をご利用されている場合、画面項目が見つからずエラーになる場合があります。
ロボットを実行する環境の Edge でプロファイル機能を使用している場合、アプリ開発時と同じプロファイル名が使用されていることを確認してください。
現在使用しているプロファイルは Microsoft Edge の設定画面で確認できます。
画面項目を入力・操作する¶
参考
「画面項目を入力・操作する」アクションの具体的な使用方法の例については 「構造解析を使用してデータを登録する」を参照してください。
「ロボット」タブから「画面項目を入力・操作する」アクションをドラッグし、エディットエリアに設定します。
「操作対象指定」ボタンをクリックします。
ヒント
操作対象の設定方法については「構造解析アクションの操作対象設定方法」を参照してください。
設定した画面項目に応じて入力する値を設定します。
参考
操作対象に設定できる画面項目の種類、および、種類毎の設定内容は「画面項目を入力・操作する ― 操作対象に設定できる画面項目と設定内容」を参照してください。
「画面項目の位置を次のセルにセットする」チェックボタンをチェックすると、指定した画面項目が実行時に表示されている位置と大きさの情報をセルにセットします。
注釈
画面項目の操作によって画面遷移が発生する、ウィンドウのタイトルが変化する、ページの構成が変化する、といった内部構造の変化を伴う処理が行われた場合、画面項目の位置の取得は失敗する場合があります。
参考
セットした位置情報は別のアクションの操作対象位置情報として使用できます。詳細は「セルにセットされた座標を使用する」を参照してください。
画面項目を入力・操作する ― 操作対象に設定できる画面項目と設定内容¶
「画面項目を入力・操作する」アクションでは以下の種類の画面項目を操作対象に設定できます。
文字入力欄
「次の値をセットする」で指定した値を入力します。値は上書きされます。
選択式入力欄
「次の値を選択する」で指定した項目を選択します。項目名が大文字小文字を含め完全に一致するものが選択の対象になります。
ちなみに
完全に一致するものが無ければ、最初に見つかった部分一致する項目が選択の対象になります。
リスト
「次の値をセットする」で指定した項目を選択します。項目名が大文字小文字を含め完全に一致するものが選択の対象になります。
ちなみに
完全に一致するものが無ければ、最初に見つかった部分一致する項目が選択の対象になります。
注釈
操作対象が「リスト」の場合に設定できるのはリストボックスの選択のみとなります。Web ページのレイアウトがリストで作成されている場合等、画面項目がリストボックスでない場合は値を設定することはできません。
スピン式入力欄
「次の値をセットする」で指定した値を入力します。値は上書きされます。
ちなみに
構造解析による操作に対応していないスピン式入力欄ではエラーにならなくても値がセットされない場合があります。
こういった入力欄については キーをタイプする 等の別のアクションを使用してください。
選択肢 (単一選択)
指定した項目を選択します。
選択肢 (複数選択)
指定した項目を選択、または、選択を解除します。
領域
指定した範囲内にある選択肢を一括で選択、選択解除します。
「+」ボタンをクリックして単一選択、複数選択それぞれの設定欄を追加します。
範囲内に単一選択、複数選択の設定欄はそれぞれ範囲内に「選択肢 (単一選択)」、「選択肢 (複数選択)」が存在する場合だけ表示されます。 選択肢が存在しない場合設定欄は表示されません。
注釈
領域指定で設定できるのは「選択肢 (単一選択)」と「選択肢 (複数選択)」のみとなります。それ以外の種類の画面項目は個別に選択して設定してください。
ボタン
指定したボタンをクリックします。
リンク
指定したハイパーリンクをクリックします。
画面項目から値を取得する¶
参考
「画面項目から値を取得する」アクションの具体的な使用方法の例については 「構造解析を使用してシステムの画面項目から値をコピーする」や 「構造解析を使用して画面上の表から値をコピーする」を参照してください。
「ロボット」タブから「画面項目から値を取得する」アクションをドラッグし、エディットエリアに設定します。
「操作対象指定」ボタンをクリックします。
ヒント
操作対象の設定方法については「構造解析アクションの操作対象設定方法」を参照してください。
取得した値をセットするセルを設定します。
参考
操作対象に設定できる画面項目の種類、および、種類毎の設定内容は「画面項目から値を取得する ― 操作対象に設定できる画面項目と設定内容」を参照してください。
「画面項目の位置を次のセルにセットする」チェックボタンをチェックすると、指定した画面項目が実行時に表示されている位置と大きさの情報をセルにセットします。
画面項目から値を取得する ― 操作対象に設定できる画面項目と設定内容¶
「画面項目から値を取得する」アクションでは以下の種類の画面項目を操作対象に設定できます。
文字
表示されている文字列を取得します。
文字入力欄
入力されている文字列を取得します。
選択式入力欄
選択されている項目の表示されている文字列を取得します。
リスト
選択されている項目の表示されている文字列を取得します。
ちなみに
選択したリストがリストボックスとして操作できない場合は「領域 (リスト)」として操作されます。リストボックスとして操作可能かどうかは自動的に判別されます。
スピン式入力欄
表示されている文字列を取得します。
選択肢 (単一選択)
指定した選択肢が選択されている場合「true」、選択されていない場合「false」をセルにセットします。
選択肢 (複数選択)
指定した選択肢が選択されている場合「true」、選択されていない場合「false」をセルにセットします。
表
指定した表のセルの値をコピーします。 「セルの結合状態をコピーする」チェックボタンをチェックすると指定した表と同じように CELF シートのセルを結合することができます。
領域 (リスト)
表を選択した場合と同様に、指定した領域内に表示されている文字をコピーします。
ちなみに
選択したリストがリストボックスとして操作できる場合は「リスト」として操作されます。リストボックスとして操作可能かどうかは自動的に判別されます。
領域 (リスト以外)
指定した領域内の選択されている「選択肢 (単一選択)」および「選択肢 (複数選択)」の項目名のリストを取得します。 リストは指定されたセルを先頭に下方向にセットされます。
注釈
領域指定で取得できるのは「選択肢 (単一選択)」と「選択肢 (複数選択)」のラベルのみとなります。それ以外の種類の画面項目は個別に選択して取得してください。
ちなみに
選択されている選択肢のリストは UTF-8 文字コードの昇順でソートされます。
構造解析アクションの操作対象設定方法¶
構造解析アクションの操作対象の設定では画面に表示されている項目の一覧の中から操作対象を選択することができます。
操作対象を設定する¶
操作対象指定ボタンをクリックします。
操作したい画面項目、または、画面項目が配置されている付近の領域をクリックします。
ちなみに
マウスカーソルを合せた時に青枠で囲まれる画面項目は RPA で操作可能な項目、灰色枠で囲まれるものは RPA で操作できない項目を表しています。灰色枠で囲まれた RPA で操作できない項目をクリックしても設定画面は表示され、その中に配置されている画面項目を一覧から選択することが可能です。操作対象設定画面に表示される画面項目一覧から操作したい項目を選択します。
ヒント
画面項目の左に [+] が表示されている場合、クリックするとその中に配置されている画面項目のリストが表示されます。
操作したい画面項目を選択して「設定」ボタンをクリックします。
指定した項目が操作対象として設定されます。
操作対象の設定をキャンセルする¶
操作対象の設定をキャンセルする場合、画面項目の選択中に「Esc」キーを押すか、または、画面項目を選択した後で表示される設定画面の「キャンセル」ボタンをクリックします。キャンセルした場合、操作対象の設定は変更されません。
選択している画面項目を確認する¶
操作対象設定画面で項目を選択すると、該当する画面項目がハイライトされます。
または、確認ボタンをクリックしても画面項目をハイライトで確認できます。
また、枠の右上にはその画面項目の種類が表示されます。
操作対象に設定できる項目と設定できない項目について¶
操作対象として設定できる項目は黒い太字で表示されます。
操作対象として設定できない項目は灰色の文字で表示されます。
操作対象として設定できる画面項目の種類はアクション毎に異なります。 詳細は各アクションの説明を参照してください。
注釈
CELF RPA の構造解析では操作対象のウィンドウを、アプリケーションの種類とウィンドウタイトルで特定しています。
アクションセットの作成時と実行時でウィンドウタイトルが変更されている場合、
設定したウィンドウと同じアプリケーションが開かれているのであれば、そのアプリケーションで最前面に表示されているウィンドウに対して操作を行います。
設定したウィンドウと同じアプリケーションが開かれていなければ、操作対象を見つけることができずエラーになります。
注釈
Microsoft Edge のプロファイル機能をご利用されている場合、画面項目が見つからずエラーになる場合があります。
ロボットを実行する環境の Edge でプロファイル機能を使用している場合、アプリ開発時と同じプロファイル名が使用されていることを確認してください。
現在使用しているプロファイルは Microsoft Edge の設定画面で確認できます。