EXCELアドインのセレクタ（要素）取得に苦戦中の方は是非ご一読ください
- 本記事では、EXCELアドインをインストールし、対象ツールの独自ダイアログのUI自動化で期待結果を得られない経験をお持ちの方向けの内容を扱います。
- SuperXLe という、100超の「使える」機能が満載の無料Excelアドインをもちいて実装例を記載しています。
操作対象の「設定ダイアログ」（「スイッチ」タブの例）
ダイアログ起動の実装例
Excelのリボンはメニューバーでアドイン名をシングルクリックしても、次のクリック操作の前に閉じてしまいます。
このため、対象リボンを虫ピンで固定してしまう、または次の様なキー操作での起動が有効です。
ラジオボタンやチェックボックスの実装例
要素認識できる場合、基本的には 「クリック」アクティビティでオプションの説明文または親要素をアンカーにする のがおススメです。
（ダイアログに機能追加や修正が入ったときなどの変更リスクを抑えることができます。）
ファイルパス入力の実装例
「文字を入力」ではなく 「テキストを設定」アクティビティ の利用がおススメです。
「文字を入力」アクティビティはユーザーが実際にキーボード入力する際の挙動となるため、1文字ずつ対象要素に値を渡します。「テキストを設定」は指定した文字列を1回で入力するため、外部要因（ハードやアプリの状態起因）で意図した文字列が入力されないリスク等を軽減できます。
他と見た目が異なり、上手く要素認識しないパターン
ダイアログ全体でしか要素認識しないケースでは、まずF4ボタンを押下しUIフレームワークの切り替えを試してください。
このパターンではUIフレームワークは『AA』に切り替えることで要素取得ができました。（UIフレームワークについては以下の記事などをご参考ください）
プルダウンの実装例
以下の様に、クリックで期待結果を得られるケースはありますが、
基本的には 「項目を選択」アクティビティ での実装がおススメです↓↓↓
個人的な経験上は、「項目を選択」アクティビティはスコープ内では単独で簡単に利用できるのがほとんどでしたが、本例のダイアログでは次の2つのエラーに遭遇しました。
■セレクタ取得時のエラー
→ こちらは、プルダウンボタンを押下してリストが開いた状態にすることでセレクタ取得できました。
■実行時のエラー
→ 「項目を選択」の直前に同項目の「クリック」を挟むことで解消しました。
なお、「項目を選択」が非対応で利用できないコンポーネントの場合、『「フォーカスを設定」＋キー操作（上または下キー等）』 をおススメします↓↓↓
本例のダイアログでは、コンポーネントとの相性がわるくエラーとなりました。
→ 「CV ドロップダウン リストから選択」アクティビティ を利用し実現できました。
CV は Computer Vision の略です。Orchestrator との接続がない場合にも、ローカルサーバーのオプションを True にして利用できます。
画像からの要素認識
次の様なダイアログがあります。
ターゲットとしては緑枠までしか要素認識できません。（内側はおそらく画像）
本ツールの利用にあたっては不要な技術ですが、CVアクティビティを利用すれば値の取得や操作が可能であることをおみせします↓↓↓
おまけ
まとめ
おススメの実装方法：
■ボタンやラジオボタン、チェックボックスの操作など
→ 「クリック」アクティビティのアンカー利用
■テキスト入力欄
→ 「テキストを設定」アクティビティ
■ドロップダウンリスト
→ 「項目を選択」アクティビティ
→ 「フォーカスを設定」＆キー操作
→ 「CV ドロップダウンリストから選択」アクティビティ
■その他、要素認識しないパターン
→ F4押下のUIフレームワーク変更
→ CV（Computer Vision）アクティビティの利用
最後までお読みいただきありがとうございますヾ(＠⌒ー⌒＠)ノ