Studio ガイド

最終更新日時 2025年3月24日

インポートしたライブラリプロジェクトをコード化されたオートメーションで使用する

このチュートリアルでは、インポートしたライブラリプロジェクトから取得したオブジェクトをコード化されたオートメーション内で使用する方法について説明します。この例では、インポートしたライブラリプロジェクトから取得したオブジェクトリポジトリの要素とワークフローを使用する方法を示します。指定のシナリオでは、ACME Web サイトを自動化して、学生のスコアカードに必要事項を入力し、それをデータベースに追加します。

前提条件

UI Automation アクティビティパッケージのバージョン 23.10.13 以降をインストールします。
注: 使用しているメジャーバージョンに対応する最新のマイナーバージョンを使用することをお勧めします。たとえば、メジャーバージョン 23.10 のアクティビティパッケージを使用している場合は、利用可能な最新のマイナーバージョン (23.10.x) にアップグレードすることをお勧めします。
ACME ライブラリのサンプルをパブリッシュし、作業中のプロジェクトにインストールします。

1. ライブラリプロジェクトを作成する

ACME アプリの自動化 (厳密には学生のスコアカードへの入力) に不可欠な UI 要素を格納するライブラリプロジェクトを作成します。さらに、ライブラリプロジェクト内にローコード (.xaml) またはコード化されたワークフロー (.cs) を作成します。これは、後で別のコード化されたオートメーション内で使用するものです。

AcmeLibrary という名前のライブラリプロジェクトを作成します。
[オブジェクトリポジトリ] と [記述子] セクション内で使用する、すべての UI 要素をキャプチャします。
[ファイル] グループから、新しいコード化されたワークフローを作成します。
この手順は、別のプロジェクトにライブラリをインポートするときに、コード化されたオートメーション内のオブジェクトリポジトリにアクセスできるようにするために重要です。
Main ローコードワークフローの名前を Send message box に変更し、[メッセージボックス] アクティビティを、「You've added a new score card for a student in Acme. (ACME の学生用に新しいスコアカードを追加しました。)」というテキストと共に追加します。
注: チュートリアルで説明されている手順に従って、[メッセージボックス] アクティビティをコード化されたワークフローとして再作成することもできます。
ライブラリプロジェクトを保存し、フィードにパブリッシュします。
このパブリッシュされたライブラリは、コード化されたオートメーション内の別のプロジェクトにインストールして使用します。

2. コード化されたオートメーションを作成する

ライブラリプロジェクトの作成後、それを別のプロジェクトにインストールして、その再利用可能なアセット (オブジェクトリポジトリの要素やワークフローなど) を、それらがローコード (.xaml) かコード化 (.cs) かにかかわらず活用します。

ヒント: UI Automation API を使用する場合、IScreenDescriptor または IElementDescriptor を含むオーバーロードはオブジェクトリポジトリの要素を操作するためのものであるのに対し、TargetAnchorableModel を含むオーバーロードは UI Explorer で取得されたネイティブセレクターで使用するためのものであることに注意してください。UI Automation API でセレクターを活用する方法について詳しくは、UI Automation API をご覧ください。

[ファイル] グループから、新しいコード化されたワークフローを作成します。
[パッケージを管理] に移動し、以前に作成したライブラリプロジェクトをインストールします。
[ファイル] グループから、新しいワークフローを作成します。
1. ワークフローに notifyStudentScoreCardAdded という名前を付けます。
2. [アクティビティ] パネル、[インストール済み] セクションの順に移動します。
3. インポートしたライブラリプロジェクトの名前 (この例では AcmeLibrary) を検索します。
4. Send message box アクティビティを notifyStudentScoreCardAdded 内にドラッグアンドドロップします。
  これで、notifyStudentScoreCardAdded の動作は、インポートしたライブラリプロジェクトから取得した Send message box ワークフローと同じになります。
読みやすくするために、インポートしたオブジェクトリポジトリアプリケーションを変数として定義し、ワークフローの先頭に using ステートメントを適用できます。以下に例を示します。using app = <ProjectName>.ObjectRepository.Descriptors
この方法では、app.<AppName>.<ScreenName>.<UiElementName> 形式で記述子を簡単に呼び出すことができます。
この例では、ACME オブジェクトリポジトリを次のように定義します。
```
 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]namespace UsingImportedLibraryProjects
{
    using AcmeApp = AcmeLibrary.ObjectRepository.Descriptors;
```

これで、ACME 内で指定のシナリオを自動化できるようになりました。最初に、OpenAPI を使用して ACME のログイン画面を開きます。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object] [Workflow]
        public void Execute()
        {
          // 1.Open the Acme app on the Login screen
          var AcmeLoginScreen = uiAutomation.Open(AcmeApp.Acme.LoginScreen);

TypeInto API を使用して、ACME にログインするために必要な資格情報を入力します。

 // 2.Type in the necessary credentials
         AcmeLoginScreen.TypeInto(AcmeApp.Acme.LoginScreen.Email, "john.doe2023@uipath.com");
         AcmeLoginScreen.TypeInto(AcmeApp.Acme.LoginScreen.Password, "12345678");  // 2.Type in the necessary credentials
         AcmeLoginScreen.TypeInto(AcmeApp.Acme.LoginScreen.Email, "john.doe2023@uipath.com");
         AcmeLoginScreen.TypeInto(AcmeApp.Acme.LoginScreen.Password, "12345678");

Click API とネイティブセレクターを使用して、[Login] ボタンをクリックします。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]// 3.Use a native selector to click the Login button
AcmeLoginScreen.Click(Target.FromSelector("<webctrl tag='BUTTON' type='submit'/>"));

ログインプロセスが実行されると、ACME Web アプリケーションの [Dashboard] 画面が表示されます。そのため、Attach API を使用して新しい画面にフォーカスします。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]// 4. Focus on the Dashboard screen
var DashboardScreen = uiAutomation.Attach(AcmeApp.Acme.Dashboard);

Click API を使用して、Web サイトで [Students] エントリを選択します。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]// 5. Click the Students entry
DashboardScreen.Click(AcmeApp.Acme.Dashboard.Students);

Click API を使用して、[Score card] を選択し、[Students - Score Card] フォームを開きます。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]// 6. Click Score card, to start filling in a student score card
DashboardScreen.Click(AcmeApp.Acme.Dashboard.Students.ScoreCard);

Attach API を使用して、[Students - Score Card] 画面にフォーカスします。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]// 7. Focus on the Score Card screen where you fill in the necessary information
var ScoreCardScreen = uiAutomation.Attach(AcmeApp.Acme.StudentsScoreCard);

TypeInto API を使用して、[Students - Score Card] フォームのフィールドの半分と、オブジェクトリポジトリから取得した要素に入力します。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]ScoreCardScreen.TypeInto(AcmeApp.StudentsScoreCard.StudentEmail, "john.doe@uipath.com");
ScoreCardScreen.TypeInto(AcmeApp.Acme.StudentsScoreCard.FirstName, "John");
ScoreCardScreen.TypeInto(AcmeApp.Acme.StudentsScoreCard.LastName, "Doe");
ScoreCardScreen.TypeInto(AcmeApp.Acme.StudentsScoreCard.ParentEmail, "johnny.doe@uipath.com");
ScoreCardScreen.TypeInto(AcmeApp.Acme.StudentsScoreCard.Tuition, "Private");

TypeInto API と、UI Explorer で見つけたネイティブセレクターを組み合わせて使用し、フォームの残りのフィールドに入力します。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='mathematics' tag='INPUT' />"), "A");
ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='physics' tag='INPUT' />"), "B");
ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='biology' tag='INPUT' />"), "C");
ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='chemistry' tag='INPUT' />"), "A");
ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='geography' tag='INPUT' />"), "C");
ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='history' tag='INPUT' />"), "A");
ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='english' tag='INPUT' />"), "A");
ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='computer Science' tag='INPUT' />"), "C");
ScoreCardScreen.TypeInto(Target.FromSelector("<webctrl id='professorComments' tag='INPUT' />"), "The student is doing okay, very hardworking and does its best");

Click API を使用して、[Add score card details] を選択します。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]// 10. Click the "Add score card details" button using an Object Repository descriptor
ScoreCardScreen.Click(AcmeApp.Acme.StudentsScoreCard.AddScoreCardDetailsButton);

RunWorkflow() メソッドを使用して、ライブラリプロジェクトからインポートしたワークフローを呼び出します。このメソッドにプロジェクト内のワークフローのパスを指定します。
```
 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]// 11. Invoke imported workflow from library
RunWorkflow("notifyStudentScoreCardAdded.xaml");
```

Dispose() API を使用して、シナリオを自動化するために開いたブラウザータブを閉じます。

 [object Object],[object Object],[object Object],[object Object],[object Object],[object Object],[object Object]// 12. Close the applications/browsers you opened, to finish he automation
ScoreCardScreen.Dispose();

サンプルプロジェクト

To follow the steps and try out the tutorial yourself, see the following sample project: Using imported library projects in coded automations. The file contains the library project, as well.