UiPath-モダン/クラシックアクティビティ相互利用について

モダン/クラシックアクティビティ相互利用について Yoichi Suetake

2 #UiPathFriends #UiFes 自己紹介名前：　末武　陽一（すえたけ　よういち）(Suetake, Yoichi)　 Twitter : @SuetakeYoichi LinkedIn
: yoichi-suetake-144784aa 所属：　株式会社オプテージ　ＲＰＡソリューションチーム　チームマネージャー属性： IＴ屋（技術士（総合技術監理・情報工学部門））　天文屋　　気象屋（気象予報士） UiPath使用歴：約5年 (Academy Lv1修了2017/5/24) UiPath Japan MVP 2019-2022 UiPath Community MVP 2022 (Global)

3 #UiPathFriends #UiFes ・21.10よりモダンデザインエクスペリエンスがデフォルトで有効となり、モダンデザインを標準としている組織も多いかと思います。・一方で、クラシックデザインで作成したライブラリや共用ファイル等の資産がある場合、モダンデザインとクラシックデザインを併用せざる得ないケースもしばらくはあるかと思います。・このセッションでは、上記のようなケースで想定される相互利用方法について技術的な観点で見ていきます。セッションの概要

4 #UiPathFriends #UiFes モダンアクティビティとクラシックアクティビティ UiAutomationクラシック　個々のアクティビティはフルセレクターを指定して単独で利用するか、上記アクティビティのコンテナ内で部分セレクターを指定して利用する。　同一ブラウザやウインドウを担保するため
に、UiPath.Core.Windowや UiPath.Core.Browserを使う。　個々のアクティビティはフルセレクターを指定して単独で利用するか、上記アクティビティのコンテナ内で部分セレクターを指定して利用する。　同一ブラウザやウインドウを担保するために、UiPath.Core.Windowや UiPath.Core.Browserを使う。

5 #UiPathFriends #UiFes モダンアクティビティとクラシックアクティビティ UiAutomationモダン　個々のアクティビティは原則として「アプリケーション/ブラウザを使用」アクティビティの内部で使用する。　同一ウインドウまたはプロセス配下であることを担保するために、UiPath.Core.UiElement
を使う。　個々のアクティビティは原則として「アプリケーション/ブラウザを使用」アクティビティの内部で使用する。　同一ウインドウまたはプロセス配下であることを担保するために、UiPath.Core.UiElement を使う。このあたりの差異をどのように吸収するか？

6 #UiPathFriends #UiFes ライブラリやXAMLファイル自体の引数の入力がUiPath.Core.Browserの場合にどうするか？ケース１：モダンプロジェクトから UiPath.Core.Browserインスタンスを渡したい。

7 #UiPathFriends #UiFes ケース１：モダンプロジェクトから UiPath.Core.Browserインスタンスを渡したい。アプリケーション／ブラウザを使用アクティビティ UiElement.GetBrowser()を使う。 ※状況により、事前にUiElement.IsBrowserプロパティで　Browserを取得できるか確認すると吉 UiElement.GetBrowser()を使う。
※状況により、事前にUiElement.IsBrowserプロパティで　Browserを取得できるか確認すると吉

8 #UiPathFriends #UiFes ケース２：モダンプロジェクトで UiPath.Core.Browserインスタンスを使う。ライブラリや呼び出し先XAMLファイルからUiPath.Core.Browserが返ってきた場合にどうするか？

9 #UiPathFriends #UiFes ケース２：モダンプロジェクトで UiPath.Core.Browserインスタンスを使う。「アプリケーション/ブラウザを使用」アクティビティの入力要素プロパティでBrowser.Elementプロパティを使う「アプリケーション/ブラウザを使用」アクティビティの入力要素プロパティでBrowser.Elementプロパティを使う

10 #UiPathFriends #UiFes （実は）UiPath.Core.BrowserとUiPath.Core.UiElementは相互に暗黙の変換が可能なので前述したメソッドやプロパティは省略可能暗黙の変換 vatUiElement.GetBrowser()と同じ vatUiElement.GetBrowser()と同じ

11 #UiPathFriends #UiFes varWindow = varUiElement.GetTopLevelWindow() varUiElement = New UiElement(varWindow)
を使う。暗黙変換可能なので、メソッドやコンストラクタは省略可能。ケース３：Windowインスタンスを．．．

12 #UiPathFriends #UiFes 設定ファイルにフルセレクター文字列が格納されており、それをUiAutomationのアクティビティで使う。例：モダンのUiAutomationアクティビティは原則「アプリケーション/ブラウザを使用」アクティビティ配下で使うので、フルセレクター文字列をそのまま入力してもアクティビティ単独では動作しない。ケース４：フルセレクター文字列を
モダンプロジェクトで使う。 <html app='firefox.exe' title='UiPath Community Forum' /><webctrl tag='IMG' />

13 #UiPathFriends #UiFes 「アプリケーション/ブラウザを使用アクティビティ」の統合アプリケーションターゲット-セレクタープロパティにトップレベルセレクターのみを指定→例えば正規表現で抽出 System.Text.RegularExpressions.Regex.Match(in_selector,".*?>").Value 内部のアクティビティは、「アプリケーション/ブラウザを使用」アクティビティのウインドウアタッチモードによって指定するセレクターを変える。
ケース４：フルセレクター文字列をモダンプロジェクトで使う。「アプリケーション/ブラウザを使用」アクティビティのウインドウアタッチモード内部のアクティビティのセレクターで指定する内容アプリケーションインスタンスフルセレクター（またはウインドウセレクター要素にトップレベル、セレクターに部分セレクター）単一ウインドウトップレベルを省いた部分セレクター

14 #UiPathFriends #UiFes モダンアクティビティとクラシックアクティビティクラシックモダン EXCEL ・同一ワークブックを担保するために UiPath.Excel.Workboo
kApplicationを使う。・同一ワークブックを担保するために UiPath.Excel.Workboo kApplicationを使う。・ワークブックのファイル名（フルパス）にて同一ワークブックを担保。（そもそもエクセルは同じ名前のワークブックは同時に開くことができない）・Excelアプリケーションスコープ内で使用できるアクティビティは、「Excelファイルを使用」内でも使用できる。・ワークブックのファイル名（フルパス）にて同一ワークブックを担保。（そもそもエクセルは同じ名前のワークブックは同時に開くことができない）・Excelアプリケーションスコープ内で使用できるアクティビティは、「Excelファイルを使用」内でも使用できる。

15 #UiPathFriends #UiFes ケース５　モダンプロジェクトで WorkbookApplicationインスタンスを使う。ライブラリや呼び出し先XAMLファイルからWorkbookApplicationが返ってきた場合にどうするか？

16 #UiPathFriends #UiFes WorkbookApplication.CurrentWorkbook.FullNameでワークブックのフルパスを抽出して渡す。ケース５　モダンプロジェクトで WorkbookApplicationインスタンスを使う。

17 #UiPathFriends #UiFes あまりスマートな方法がなく…. WorkbookApplicationコンストラクタで生成。 Excelアプリケーションスコープアクティビティを使う。ケース６　モダンプロジェクトから WorkbookApplicationインスタンスを渡したい

18 #UiPathFriends #UiFes ・UiPath.Core.Browser または UiPath.Core.Windowと、UiPath.Core.UiElementは相互変換が可能（しかも暗黙での変換も可能）。　→モダンの「アプリケーション/ブラウザを使用」アクティビティで　クラシックのアクティビティが必要な型の受け渡し、あるいはクラシックアクティビティからの出力の利用が可能。・フルセレクター文字列をモダンで扱う場合は、トップレベルのセレクター文字列を抽出して、
「アプリケーション・ブラウザを使用」アクティビティに入力する。内部のアクティビティのセレクター指定はウインドウアタッチモードによってフルセレクター、部分セレクターを使い分ける。・WorkbookApplicationインスタンスを受け取ったら、ファイルパスを抽出して、それをExcel ファイルを使用アクティビティに与える。その逆の、モダンアクティビティだけで WorkbookApplicationインスタンスを生成することは難しいので、WorkbookApplicationコンストラクタで生成するか、素直にExcelApplicationScopeを使う。以上、みなさんのモダン・クラシックの相互利用時の参考になればと思います。まとめ

UiPath-モダン/クラシックアクティビティ相互利用について

UiPath-モダン/クラシックアクティビティ相互利用について

Yoichi

More Decks by Yoichi

Other Decks in Programming

Featured

Transcript

モダン/クラシックアクティビティ相互利用について Yoichi Suetake

2 #UiPathFriends #UiFes 自己紹介名前：　末武　陽一（すえたけ　よういち）(Suetake, Yoichi)　 Twitter : @SuetakeYoichi LinkedIn

6 #UiPathFriends #UiFes ライブラリやXAMLファイル自体の引数の入力がUiPath.Core.Browserの場合にどうするか？ケース１：モダンプロジェクトから UiPath.Core.Browserインスタンスを渡したい。

8 #UiPathFriends #UiFes ケース２：モダンプロジェクトで UiPath.Core.Browserインスタンスを使う。ライブラリや呼び出し先XAMLファイルからUiPath.Core.Browserが返ってきた場合にどうするか？

10 #UiPathFriends #UiFes （実は）UiPath.Core.BrowserとUiPath.Core.UiElementは相互に暗黙の変換が可能なので前述したメソッドやプロパティは省略可能暗黙の変換 vatUiElement.GetBrowser()と同じ vatUiElement.GetBrowser()と同じ

11 #UiPathFriends #UiFes varWindow = varUiElement.GetTopLevelWindow() varUiElement = New UiElement(varWindow)

14 #UiPathFriends #UiFes モダンアクティビティとクラシックアクティビティクラシックモダン EXCEL ・同一ワークブックを担保するために UiPath.Excel.Workboo

15 #UiPathFriends #UiFes ケース５　モダンプロジェクトで WorkbookApplicationインスタンスを使う。ライブラリや呼び出し先XAMLファイルからWorkbookApplicationが返ってきた場合にどうするか？

16 #UiPathFriends #UiFes WorkbookApplication.CurrentWorkbook.FullNameでワークブックのフルパスを抽出して渡す。ケース５　モダンプロジェクトで WorkbookApplicationインスタンスを使う。

17 #UiPathFriends #UiFes あまりスマートな方法がなく…. WorkbookApplicationコンストラクタで生成。 Excelアプリケーションスコープアクティビティを使う。ケース６　モダンプロジェクトから WorkbookApplicationインスタンスを渡したい