通知を受け取る

UiPath StudioX

UiPath StudioX ガイド

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

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

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

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

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

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

ステップ 1: Outlook にフォルダーを 2 つ作成します。

For this example, we'll use emails with the subject New Deposit Available and a body as mentioned earlier.
指定の件名を持つ、本日以降の未読メール用の検索フォルダーを作成するには、次の操作を行います。

  1. Outlook を開き、[フォルダー] ペインで [検索フォルダー] を右クリックし、[新しい検索フォルダー] を選択します。
  2. [新しい検索フォルダー] ウィンドウで、[カスタム検索フォルダーを作成する] > [選択] を選択します。
  3. In the Custom Search Folder window, enter Today's deposits in the Name box and then select Criteria.
  4. [検索フォルダーの条件] ウィンドウの [メッセージ] タブで、以下の手順を実行します。
    • [時間の条件] の隣にあるドロップダウン メニューから、[受信日時][今日] を選択します。
    • [検索する文字列] ボックスに、「New Deposit Available」と入力します。
    • [検索対象] ドロップダウン メニューから、[件名] を選択します。
  5. [詳細設定] タブで、[開封状況] を選択し、隣接するドロップダウン メニューから [未読] を選択します。
  6. [OK] を 3 回クリックして、ウィンドウを選択し、フォルダーを保存します。
  7. 受信ボックスに ProcessedDeposits というフォルダーを作成します。これは、処理後にメールが移されるフォルダーです。
  8. 特定の件名と特定のテンプレートに準拠した本文を利用するオートメーションで使用するメール アカウントに、メールを 2、3 通送信します。ただし、各メールには異なる金額を入力します。
  9. After sending them, make sure they show up in the Today's deposits search folder.

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

  1. 既定の設定を使用して新しいプロジェクトを作成します
  2. Open the Excel Workspace for the project and copy the body of an email to cell B3 in the Text sheet, then manually enter the text to the left of each of our three values in cells D4:D6, Cash in: in cell D4, On Us Check: in cell D5, Not On Us Check: in cell D6. Because there is no text to the right of the values, cells E4:E6 must be empty. The formulas already in cells F4:F6 should extract the values, as you can see in the image below.
14371437

Excel ワークスペースを保存して閉じます。

  1. このチュートリアルでは、このページの下部にあるボタンを使用して、オートメーション プロジェクトを含むアーカイブをダウンロードして展開します。ファイル DoubleUI.exe をダブルクリックし、DoubleUI アプリケーションを開きます。

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

  1. [アクティビティ] パネルで、[Outlook] タブを選択し、[Outlook アカウント カード] をダブルクリックします。[Outlook アカウント カード] アクティビティがデザイナー パネルに追加されます。
  2. アクティビティの [メール アカウントを選択] フィールドでは、既定のメール アカウントが既に選択されています。別のアカウントを使用する場合は、ドロップダウン メニューから選択します。
    In the And reference it later as field, leave the default value Outlook as the name under which to refer to the account in the automation.
  3. [アクティビティ] パネルで、[繰り返し (メール メッセージ)] アクティビティをドラッグし、[Outlook アカウント カード] 内にドロップします。
  4. In the For Each Mail Message activity, click plus buttonplus button on the right side of the Use mails from field, and then select Outlook > [Search Folders] > [Today's deposits].
    これで、Outlook 検索フォルダー「Today's deposits (今日の預金)」内のメールに対して反復処理を実行するように指定したことになります。
602602

ステップ 4: メール本文を Excel ワークスペースのセルにコピーし、テキストを抽出します。

  1. [アクティビティ] パネルで [Excel] タブを選択し、[セルに書き込み] アクティビティをドラッグして [繰り返し (フォルダー内の各ファイル)] アクティビティ内にドロップします。
  2. [セルに書き込み] アクティビティで、以下の手順を実行します。
    • [書き込む内容] フィールドの右側にある plus buttonplus button をクリックし、[現在のメール] > [本文] を選択して、反復処理で現在のメールの本文をコピーすることを指定します。
    • [書き込む場所] フィールドの右側にある plus buttonplus button をクリックし、[ワークスペース: Excel] > [Excel 内で示す] を選択して Excel でファイルを開きます。ファイルの Text シートを選択し、セル B3 を選択し、Excel のリボン メニューの [UiPath] タブで [Confirm (確定)] をクリックします。これで、メール本文を Excel ワークスペースの Text シートのセル B3 に貼り付けるよう指定したことになります。
642642

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

  1. [アクティビティ] パネルで、[アプリケーション] タブを選択し、[アプリケーション カード] アクティビティをドラッグして、[セルに書き込み] アクティビティの下にある [繰り返し (メール メッセージ)] アクティビティ内にドロップします。[アプリケーション カード] アクティビティがデザイナー パネルに追加されます。
  2. [アプリケーション カード] アクティビティで、[アプリケーションを指定] をクリックして、マウス ポインターを DoubleUI アプリケーションの上に移動します。ウィンドウが強調表示されるので、DoubleUI の任意の場所をクリックします。
    アプリケーション カードが更新され、ウィンドウのスクリーンショットがアクティビティに表示されます。
  3. [アクティビティ] パネルで、[アプリケーション] タブを選択し、[文字を入力] アクティビティをドラッグして [アプリケーション カード] アクティビティ内にドロップします。[文字を入力] アクティビティが [アプリケーション カード] に追加されます。
  4. [文字を入力] アクティビティで次の操作を行います。
    • [ターゲットを指定] をクリックして、DoubleUI.exe アプリケーションの [Cash In] フィールドにマウス ポインターを移動し、強調表示されたらそのフィールドをクリックします。[Cash In] ラベルではなく、その横の入力可能なフィールドをクリックします。[文字を入力] アクティビティでは、アンカー要素の画像 (フィールドのラベル) が [これを検索] に表示され、ターゲット要素の画像 (入力先のフィールド) が [ここに入力] に表示されます。アクティビティの名前が更新され、フィールドのラベルも表示された状態になっています。
    • Click plus buttonplus button 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 menu. The Type this field displays your selection as [Excel] Text!F4.
      これで、Excel ファイルから入金の額を DoubleUI.exe アプリケーションの [Cash In] フィールドにコピーするように指定したことになります。
  5. ステップ 3 ~ 4 を 2 回以上繰り返し、[文字を入力] アクティビティを追加し、Excel ファイル (それぞれセル F5 および F6) から [自行払い小切手 (On Us Check)] および [他行払い小切手 (Not On Us Check)] の値を DoubleUI アプリケーションの対応するフィールドにコピーします。
  6. [アクティビティ] パネルで、[アプリケーション] タブを選択し、[クリック] アクティビティをドラッグして [テキストを取得] アクティビティの後にある [アプリケーション カード] アクティビティ内にドロップします。[クリック] アクティビティが [アプリケーション カード] に追加されます。
  7. [クリック] アクティビティの [ターゲットを指定] をクリックし、DoubleUI.exe アプリケーションの [Accept] ボタンにマウス ポインターを移動します。ボタンが強調表示されたら、クリックします。この [クリック] アクティビティでは、ターゲット要素の画像が [これをクリック] に表示されます。アクティビティの名前が更新され、ボタンのラベルも表示された状態になっています。
    これで、DoubleUI.exe アプリケーションの [Accept] ボタンをクリックするように指定したことになります。
350350

ステップ 6: メールを既読にし、Outlook フォルダーに移動します。

  1. [アクティビティ] パネルで、[Outlook] タブを選択し、[メールを既読にする] アクティビティをドラッグして [アプリケーション カード] の下にある [繰り返し (メール メッセージ)] アクティビティ内にドロップします。[メールを既読にする] アクティビティがデザイナー パネルに追加されます。
  2. [メールを既読にする] アクティビティで、次の手順を実行します。
    • [メール メッセージ] フィールドの右側にある plus buttonplus button をクリックし、[CurrentMail] を選択し、現在のメールの状態の設定処理を繰り返すよう指定します。
    • [マーク] ドロップダウン メニューから [既読] を選択します。
  3. [アクティビティ] パネルで、[Outlook メールを移動] アクティビティを [メールを既読にする] アクティビティの下にある [繰り返し (メール メッセージ)] アクティビティ内にドラッグします。[Outlook メールを移動] アクティビティがデザイナー パネルに追加されます。
  4. [Outlook メールを移動] アクティビティで、以下の手順を実行します。
    • [メール メッセージ] フィールドの右側にある plus buttonplus button をクリックし、[CurrentMail] を選択し、現在のメールの移動処理を繰り返すよう指定します。
    • [移動先] フィールドの右側にある plus buttonplus button をクリックし、[Outlook] > [受信トレイ] > [ProcessedDeposits] を選択します。これで、メールを ProcessedDeposits フォルダーに移動するように指定したことになります。
464464
  1. リボン メニューで [保存] をクリックしてオートメーションを保存し、[実行] をクリックしてそのオートメーションを実行します。
    Outlook 検索フォルダー内の各メールについて、本文が Excel にコピーされ、データが抽出されて DoubleUI デスクトップ アプリケーションに取り込まれます。次に、メールが既読にされ、別のフォルダーに移されます。

サンプルをダウンロード

2 年前に更新


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


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。