StudioX ユーザーガイド

最終更新日時 2024年11月18日

チュートリアル: 自動化されたメールからデータを抽出し、デスクトップアプリケーションにデータを移動する

このチュートリアルでは、特定のデータを特定の書式設定に準拠したテキストブロックから容易に抽出できるようにするオートメーションを作成します。銀行勤務で、新しい入金取引に関連する多数のメール通知を受信しているとします。各メールを開き、手動で金額をコピーしてテラーアプリケーションに貼り付け、処理済みの各メールを Outlook フォルダーに移動する必要があります。メールは自動化され、すべて同じテンプレートに準拠し、同じテキストがメール本文の必要な金額の隣に常に表示されます。例:

!!!This is an automated message, please do not respond.
A new deposit transaction can be submitted:
Cash in: $10
On Us Check: $20
Not On Us Check: $15
Thank you.!!!This is an automated message, please do not respond.
A new deposit transaction can be submitted:
Cash in: $10
On Us Check: $20
Not On Us Check: $15
Thank you.

既定のプロジェクトノートブックには、必要な金額のみを抽出できる数式が含まれています。「手順 2: プロジェクトを設定し、必要なファイルを取得する」で説明されているように、プロジェクトノートブックを手動で編集し、1 通のメールから値を抽出します。オートメーションを設定して類似するすべてのメールから同じ値を抽出します。

オートメーションにより、入金取引に関連する自動化された最新の未読メールを格納する Outlook 検索フォルダー内の各メールについて、次のタスクが実行されます。

メールの本文がコピーされ、データがプロジェクトノートブックに貼り付けられます。ここで、テキストを操作するために Excel の数式を使用して特定のデータが抽出されます。
デスクトップアプリケーションでデータがフィールドごとに入力され、送信されます。
メールが既読になり、処理済みメール用の Outlook フォルダーに移されます。

プロジェクトを作成したら始めに、使用する Outlook アカウントを指定する [デスクトップ版 Outlook アプリを使用] アクティビティを追加します。次に、[繰り返し (各メール)] アクティビティを追加し、オートメーションが各メールに対して必ず実行されるよう指定するために、後続のすべてのアクティビティを [繰り返し (各メール)] 内に追加します。[セルに書き込み] アクティビティを追加して、各メールの本文をプロジェクトノートブックの特定のセルにコピーします。次に、デスクトップアプリケーションへのデータ入力に必要な UI 自動化アクティビティを追加し、最後に、メールを既読にし、メールを移動するアクティビティを追加します。

Outlook にフォルダーを 2 つ作成する

この例では、件名が New Deposit Available で前述の本文を持つメールを使用します。

指定の件名を持つ、本日以降の未読メール用の検索フォルダーを作成するには、次の操作を行います。
1. Outlook を開き、[フォルダー] ペインで [検索フォルダー] を右クリックし、[新しい検索フォルダー] を選択します。
2. [新しい検索フォルダー] ウィンドウで、[カスタム検索フォルダーを作成する] > [選択] を選択します。
3. [検索フォルダーのカスタマイズ] ウィンドウの [名前] ボックスに Today's deposits を入力し、[条件] を選択します。
4. [検索フォルダーの条件] ウィンドウの [メッセージ] タブで、以下の手順を実行します。
  - [時間の条件] の隣にあるドロップダウンメニューから、[受信日時] と [今日] を選択します。
  - [検索する文字列] ボックスに、「New Deposit Available」と入力します。
  - [検索対象] ドロップダウンメニューから、[件名] を選択します。
5. [詳細設定] タブで、[開封状況] を選択し、隣接するドロップダウンメニューから [未読] を選択します。
6. [OK] を 3 回クリックして、ウィンドウを選択し、フォルダーを保存します。
7. 受信ボックスに ProcessedDeposits というフォルダーを作成します。これは、処理後にメールが移されるフォルダーです。
8. 特定の件名と特定のテンプレートに準拠した本文を利用するオートメーションで使用するメールアカウントに、メールを 2、3 通送信します。ただし、各メールには異なる金額を入力します。
9. 送信後、Today's deposits 検索フォルダーに該当のメールが表示されることを確認します。
プロジェクトを設定し、必要なファイルを取得します。
1. 既定の設定を使用して新しい空のプロジェクトを作成します。
2. 該当のプロジェクトのプロジェクトノートブックを開き、メールの本文を Text シートのセル B4 にコピーし、セル D5:D7 の 3 つの値それぞれの左側にテキストを手動で入力します。セル D5 には Cash in: 、セル D6 には On Us Check: 、セル D7 には Not On Us Check: を入力します。値の右側にはテキストは存在しないため、セル E5:E7 は空になるはずです。セル F5:F7 に既に入っている数式は、下図のように、値を抽出します。
  
  プロジェクトノートブックを保存して閉じます。
3. このチュートリアルでは、このページの下部にあるボタンを使用して、オートメーションプロジェクトを含むアーカイブをダウンロードして展開します。ファイル DoubleUI.exe をダブルクリックし、DoubleUI アプリケーションを開きます。
Outlook アカウントをプロジェクトに追加し、検索フォルダーでメッセージを反復処理する
1. [アクティビティ] パネルで [メール] タブを選択し、[デスクトップ版 Outlook アプリを使用] をダブルクリックします。アクティビティがデザイナーパネルに追加されます。
2. このアクティビティの [アカウント] フィールドには、あらかじめ既定のメールアカウントが入力されています。別のアカウントを使用する場合は、ドロップダウンメニューから選択します。
  
  [参照名] フィールドは既定値 Outlook のままとして、オートメーションでアカウントを参照するときは、この名前を使用します。
3. [アクティビティ] パネルで [繰り返し (各メール)] アクティビティをドラッグし、[デスクトップ版 Outlook アプリを使用] アクティビティ内にドロップします。
4. [繰り返し (各メール)] アクティビティで、[対象フォルダー] フィールドの右側にあるプラス記号 をクリックし、[Outlook] > [フォルダーを検索] > [Today's deposits] を選択します。
  
  これで、Outlook 検索フォルダー「Today's deposits (今日の預金)」内のメールに対して反復処理を実行するように指定したことになります。
メール本文をプロジェクトノートブックのセルにコピーし、テキストを抽出する
1. [アクティビティ] パネルで [Excel] タブを選択し、[Excel ファイルを使用] アクティビティをドラッグして [繰り返し (フォルダー内の各ファイル)] アクティビティ内にドロップします。
2. [Excel ファイル] フィールドで、Excel ファイル「Project_Notebook.xlsx」を参照します。
3. [Excel ファイルを使用] アクティビティ内に [セルに書き込み] アクティビティを追加します。
4. [セルに書き込み] アクティビティで、以下の手順を実行します。
  - [書き込む内容] フィールドの右側にあるプラス記号 をクリックし、[CurrentMail] > [本文] を選択して、反復処理で現在のメールの本文をコピーすることを指定します。
  - [書き込む場所] フィールドの右側にあるプラス記号 をクリックし、[ノートブック] > [Excel 内で示す] を選択してファイルを Excel で開きます。ファイルの Text シートを選択し、セル B4 を選択し、Excel のリボンの [UiPath] タブで [Confirm] をクリックします。これで、メール本文をプロジェクトノートブックの Text シートのセル B4 に貼り付けるように指定したことになります。
デスクトップアプリケーションとアプリケーション内で実行するアクティビティを追加する
1. [アクティビティ] パネルで [アプリ/Web] タブを選択し、[アプリケーション/ブラウザーを使用] アクティビティをドラッグして、[セルに書き込み] アクティビティの下にある [繰り返し (各メール)] アクティビティ内にドロップします。[アプリケーション/ブラウザーを使用] アクティビティがデザイナーパネルに追加されます。
2. [アプリケーション/ブラウザーを使用] アクティビティで、[アプリケーションを指定] をクリックして、マウスポインターを DoubleUI アプリケーションの上に移動します。ウィンドウが強調表示されるので、DoubleUI の任意の場所をクリックします。
  
  [アプリケーション/ブラウザーを使用] アクティビティが更新され、ウィンドウのスクリーンショットがアクティビティに表示されます。
3. [アクティビティ] パネルで [アプリ/Web] タブを選択し、[文字を入力] アクティビティをドラッグして [アプリケーション/ブラウザーを使用] アクティビティ内にドロップします。[文字を入力] アクティビティが [アプリケーション/ブラウザーを使用] アクティビティに追加されます。
4. [文字を入力] アクティビティで次の操作を行います。
  - [画面上でターゲットを指定] をクリックし、DoubleUI.exe アプリケーションの [Cash In] フィールドにマウスポインターを移動します。フィールドが強調表示されたらクリックします。テキストフィールドがターゲットとして、フィールドの横の [Cash In] ラベルがアンカーとして識別されます。[選択オプション] ウィンドウの [確認] をクリックして選択内容を保存します。ターゲットとアンカーの画像が [文字を入力] アクティビティに表示されます。
    
    これで、DoubleUI.exe アプリケーションの [Cash In] フィールドに文字を入力するように指定したことになります。
  - [以下を入力] フィールドの右側にあるプラス記号 をクリックし、[Excel] > [Excel 内で示す] を選択します。Excel ファイルで F4 セル (入金額の値) を選択し、Excel のリボンの [UiPath] タブで [Confirm] をクリックします。[以下を入力] フィールドに「[Notes] Text!F5」の形で選択内容が表示されます。
    
    これで、Excel ファイルから入金の額を DoubleUI.exe アプリケーションの [Cash In] フィールドにコピーするように指定したことになります。
5. ステップ 3 ~ 4 を 2 回以上繰り返し、[文字を入力] アクティビティを追加し、Excel ファイル (それぞれセル F6 および F7) から [On Us Check] および [Not On Us Check] の値を DoubleUI アプリケーションの対応するフィールドにコピーします。
6. [アクティビティ] パネルで [アプリ/Web] タブを選択し、[クリック] アクティビティをドラッグして、[アプリケーション/ブラウザーを使用] アクティビティ内の最後の [テキストを取得] アクティビティの後にドロップします。[クリック] アクティビティが [アプリケーション/ブラウザーを使用] アクティビティに追加されます。
7. [クリック] アクティビティで [画面上でターゲットを指定] をクリックし、DoubleUI.exe アプリケーションの [Accept] ボタンにマウスポインターを移動します。ボタンが強調表示されたらクリックします。[Accept] ボタンがターゲットとして、[Cancel] ボタンがアンカーとして識別されます。[選択オプション] ウィンドウの [確認] をクリックして選択内容を保存します。ターゲットとアンカーの画像が [クリック] アクティビティに表示されます。
  
  これで、DoubleUI.exe アプリケーションの [Accept] ボタンをクリックするように指定したことになります。
メールを既読にし、Outlook フォルダーに移動する
1. [アクティビティ] パネルで [メール] タブを選択し、[メールを既読/未読にする] アクティビティをドラッグして [アプリケーション/ブラウザーを使用] の下にある [繰り返し (各メール)] アクティビティ内にドロップします。[メールを既読/未読にする] アクティビティがデザイナーパネルに追加されます。
2. [メールを既読にする] アクティビティで、次の操作を行います。
  - [メール] フィールドの右側にあるプラス記号 をクリックし、[CurrentMail] を選択し、現在のメールの状態の設定処理を繰り返すよう指定します。
  - [マーク] ドロップダウンメニューから [既読] を選択します。
3. [アクティビティ] パネルで、[メールを移動] アクティビティを [メールを既読/未読にする] アクティビティの下にある [繰り返し (各メール)] アクティビティ内にドラッグします。[ファイルを移動] アクティビティがデザイナーパネルに追加されます。
4. [メールを移動] アクティビティで、以下の手順を実行します。
  - [メール] フィールドの右側にあるプラス記号 をクリックし、[CurrentMail] を選択し、現在のメールを移動するよう指定します。
  - [移動先] フィールドの右側にあるプラス記号 をクリックし、[Outlook] > [受信トレイ] > [ProcessedDeposits] を選択します。これで、メールを ProcessedDeposits フォルダーに移動するように指定したことになります。
5. StudioX のリボンで [保存] をクリックしてオートメーションを保存し、[実行] をクリックしてオートメーションを実行します。
  
  Outlook 検索フォルダー内の各メールについて、本文が Excel にコピーされ、データが抽出されて DoubleUI デスクトップアプリケーションに取り込まれます。次に、メールが既読にされ、別のフォルダーに移されます。
サンプルをダウンロードする