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

このチュートリアルでは、特定のデータを特定の書式設定に準拠したテキスト ブロックから容易に抽出できるようにするオートメーションを作成します。銀行勤務で、新しい入金取引に関連する多数のメール通知を受信しているとします。各メールを開き、手動で金額をコピーしてテラー アプリケーションに貼り付け、処理済みの各メールを 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.

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

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

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

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

1. 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 検索フォルダーに該当のメールが表示されることを確認します。

2. プロジェクトを設定し、必要なファイルを取得します。

   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 アプリケーションを開きます。

3. Outlook アカウントをプロジェクトに追加し、検索フォルダーでメッセージを反復処理する

   1. [アクティビティ] パネルで [メール] タブを選択し、[デスクトップ版 Outlook アプリを使用] をダブルクリックします。アクティビティがデザイナー パネルに追加されます。

   2. このアクティビティの [アカウント] フィールドには、あらかじめ既定のメール アカウントが入力されています。別のアカウントを使用する場合は、ドロップダウン メニューから選択します。

      [参照名] フィールドは既定値 Outlook のままとして、オートメーションでアカウントを参照するときは、この名前を使用します。

   3. [アクティビティ] パネルで [繰り返し (各メール)] アクティビティをドラッグし、[デスクトップ版 Outlook アプリを使用] アクティビティ内にドロップします。

   4. In the For Each Email activity, click Plus on the right side of the In emails from field, and then select Outlook > [Search Folders] > [Today's deposits].

      これで、Outlook 検索フォルダー「Today's deposits (今日の預金)」内のメールに対して反復処理を実行するように指定したことになります。

      

4. メール本文をプロジェクト ノートブックのセルにコピーし、テキストを抽出する

   1. [アクティビティ] パネルで [Excel] タブを選択し、[Excel ファイルを使用] アクティビティをドラッグして [繰り返し (フォルダー内の各ファイル)] アクティビティ内にドロップします。
   2. [Excel ファイル] フィールドで、Excel ファイル「Project_Notebook.xlsx」を参照します。
   3. [Excel ファイルを使用] アクティビティ内に [セルに書き込み] アクティビティを追加します。
   4. [セルに書き込み] アクティビティで、以下の手順を実行します。

      • Click Plus on the right side of the What to write field and then select CurrentMail > Body to indicate that you want to copy the body of the current mail in the iteration.

      • Click Plus on the right side of the Where to write field, and then select Notebook > Indicate in Excel to open the file in Excel. In the file, select the Text sheet, and then the B4 cell, and click Confirm in the UiPath tab in the Excel ribbon. You have indicated that you want to paste the email body to cell B4 in the Text sheet of the Project Notebook.

        

5. デスクトップ アプリケーションとアプリケーション内で実行するアクティビティを追加する

   1. [アクティビティ] パネルで [アプリ/Web] タブを選択し、[アプリケーション/ブラウザーを使用] アクティビティをドラッグして、[セルに書き込み] アクティビティの下にある [繰り返し (各メール)] アクティビティ内にドロップします。[アプリケーション/ブラウザーを使用] アクティビティがデザイナー パネルに追加されます。

   2. [アプリケーション/ブラウザーを使用] アクティビティで、[アプリケーションを指定] をクリックして、マウス ポインターを DoubleUI アプリケーションの上に移動します。ウィンドウが強調表示されるので、DoubleUI の任意の場所をクリックします。

      [アプリケーション/ブラウザーを使用] アクティビティが更新され、ウィンドウのスクリーンショットがアクティビティに表示されます。

   3. [アクティビティ] パネルで [ アプリ/Web ] タブを選択し、[ 文字を入力 ] アクティビティをドラッグして [アプリケーション/ブラウザーを使用] アクティビティ内にドロップします。[文字を入力] アクティビティが [アプリケーション/ブラウザーを使用] アクティビティに追加されます。

   4. [文字を入力] アクティビティで次の操作を行います。

      • [画面上でターゲットを指定] をクリックし、DoubleUI.exe アプリケーションの [Cash In] フィールドにマウス ポインターを移動します。フィールドが強調表示されたらクリックします。テキスト フィールドがターゲットとして、フィールドの横の [Cash In] ラベルがアンカーとして識別されます。[選択オプション] ウィンドウの [確認] をクリックして選択内容を保存します。ターゲットとアンカーの画像が [文字を入力] アクティビティに表示されます。

        これで、DoubleUI.exe アプリケーションの [Cash In] フィールドに文字を入力するように指定したことになります。

      • Click Plus on the right side of the Type this field, and then select Excel > Indicate in Excel. In the Excel file, select the F4 cell (the Cash In value) and click Confirm in the UiPath tab of the Excel ribbon. The Type this field displays your selection as [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] ボタンをクリックするように指定したことになります。

      

6. メールを既読にし、Outlook フォルダーに移動する

   1. [アクティビティ] パネルで [メール] タブを選択し、[メールを既読/未読にする] アクティビティをドラッグして [アプリケーション/ブラウザーを使用] の下にある [繰り返し (各メール)] アクティビティ内にドロップします。[メールを既読/未読にする] アクティビティがデザイナー パネルに追加されます。

   2. [メールを既読にする] アクティビティで、次の操作を行います。

      • Click Plus on the right side of the Email field and then select CurrentMail to indicate that you want to mark the current mail in the iteration.
      • [マーク] ドロップダウン メニューから [既読] を選択します。

   3. [アクティビティ] パネルで、[メールを移動] アクティビティを [メールを既読/未読にする] アクティビティの下にある [繰り返し (各メール)] アクティビティ内にドラッグします。[ファイルを移動] アクティビティがデザイナー パネルに追加されます。

   4. [メールを移動] アクティビティで、以下の手順を実行します。

      • Click Plus on the right side of the Email field and then select CurrentMail to indicate that you want to move the current mail in the iteration.

      • Click Plus on the right side of the Move to field, and then select Outlook > [Inbox] > [ProcessedDeposits]. You have indicated that you want to move the email to the ProcessedDeposits folder.

        

   5. StudioX のリボンで [保存] をクリックしてオートメーションを保存し、[実行] をクリックしてオートメーションを実行します。

      Outlook の検索フォルダーにあるメールごとに、本文が Excel にコピーされ、データが抽出されて DoubleUI デスクトップ アプリケーションに入力された後、メールは既読としてマークされ、別のフォルダーに移動されます。サンプルをダウンロード