繰り返し (各メール)

UiPath.Mail.Activities.Business.ForEachEMailX

重要:

新しいバージョンの Outlook アプリケーションは、このアクティビティに影響を与えます。詳しくは、「新しい Outlook が UiPath Outlook Desktop アクティビティに与える影響」をご覧ください。

指定した Outlook フォルダー内または指定した Gmail ラベルが付いたメールまたは招待メールごとに、1 つ以上のアクティビティを実行します。このアクティビティは、[ Outlook 365 を使用]、[ Gmail を使用]、または [デスクトップ版 Outlook アプリを使用 ] アクティビティ内に追加する必要があります。

複数のメッセージが作業対象で、各メッセージに対して 1 つ以上のアクティビティを繰り返す場合は、このアクティビティを使用します。

• デスクトップ版 Outlook アプリの場合、メールを反復処理するフォルダーを指定するか、プロジェクトの実行時に Outlook で選択されたフォルダーまたはメールを反復処理します。
• Outlook 365 の場合、メールを反復処理するフォルダーを指定します。
• Gmail の場合、メールを反復処理するラベルを指定します。カスタム ラベルまたは既定のラベル (受信トレイ、送信済み、および迷惑メール) のいずれかを選択できます。

[繰り返し (各メール)] 内で繰り返すアクティビティを追加し、アクティビティを設定するときに、プラス記号 メニューから [CurrentMail] を選択して、反復処理で各メッセージに対してアクションが繰り返されるように指定します。一部のアクティビティでは、使用する特定のメッセージ フィールドを各メールから選択する必要があります。 [件名]、[ 本文 ] (プレーン テキストのメッセージ本文)、 本文 (HTML 形式のメッセージ本文)、 日付 (テキストとして)、[ Bcc]、[ Cc]、[ 宛先]、[ 送信元 ] (送信者と受信者のフィールドはセミコロンで区切られたメール アドレスのリストを返します)、または [優先度] (高、低、標準) です。

このアクティビティの使い方については、以下のリソースをご覧ください。

• チュートリアル: Outlook メールを反復処理し、添付ファイルを保存する。
• チュートリアル: 添付ファイルを保存する、名前を変更する、移動する。

アクティビティの構成

アクティビティの本体

• 繰り返し - 反復処理内の現在のメールを参照するときに使用する名前を入力します。メールの種類を表す名前を使用すると、[繰り返し (各メール)] に追加したアクティビティを設定するときに、現在のメール オプションを簡単に識別して選択できます。たとえば、請求書を含むメールを選択する場合は、「Invoice」と入力します。既定値は CurrentMail です。
• In emails from - Select Plus on the right side of the field and then, from the menu, select the folder or label you want to use, or, when automating the Outlook desktop app, choose Selected Mails or Selected Folder to use the messages or the folder selected in Outlook when the project is executed. Alternatively, you can select Open in Advanced Editor and enter a VB expression.
• メールの上限数 - 処理するメールの最大数の制限を入力または選択します。処理時間を短縮する場合は下限を設定してください。既定値は 100 通のメールです。
• 未読メール - 未読メールのみを処理する場合は、このオプションを選択します。このオプションは既定で選択されていません。
• 添付ファイルを取得 - メールと一緒に添付ファイルも取得する場合は、このオプションを選択します。
• 添付ファイルがある場合のみ - 添付ファイルがあるメールのみを処理する場合は、このオプションを選択します。既定では、このオプションは選択されていません。
• サブフォルダーを含む - このオプションを選択すると、選択したメール フォルダーのすべてのサブフォルダーが反復処理の対象に含まれます。既定では、このオプションは選択されていません。
• Additional filters - Select this button to configure an advanced filter for the emails to process. In the Filter window:

  • 最初のドロップダウン メニューで、フィルター処理するときの基準となるフィールドを、[Bcc]、[本文]、[Cc]、[日付]、[送信元]、[宛先]、[件名]、[カテゴリ] の中から選択します。

  • 2 つ目のドロップダウン メニューから、メール フィールドを評価する演算子を選択します。

    • [日付] および [カテゴリ] を除くすべてのフィールドの場合: [次を含む]、[次を含まない]、[次で終わる]、[次で始まる]、[次の値と等しい]、[空である]、または [空でない]。
    • [日付] フィールドの場合: 3 つ目のフィールドで指定された期間に対して、[次より古い]、[次より新しい]、[次の値と等しい]。
    • [カテゴリ] フィールドの場合: [次を含む]、[次を含まない]。

  • Select Plus on the right side of the third field, and then use one of the options in the menu to indicate the value against which to evaluate the selected email field:

    • プロジェクト ノートブック、親の Excel ファイルまたはメール アカウントからのデータです。たとえば、プロジェクトの実行時に Outlook で選択されているメールのフィールドを指定します。
    • 保存された値を使用 - プロジェクトで後で使用するために以前保存したデータを使用します。
    • テキスト - テキスト ビルダーでテキストを入力します。
    • 実行時に確認 - プロジェクトの実行時に値の入力を求めます。
    • クリップボードから貼り付け - プロジェクトのクリップボードに以前にコピーした値を貼り付けます。
    • 詳細エディターを開く - VB の式を入力します。

  • Select Add if you want to add other conditions, and select if All or Any of the conditions should be used to filter.

  重要:

  .NET 5 プロジェクトの [Outlook 365 を使用] アクティビティで使用する場合、一部のフィルターはサポートされません。 [本文]、[宛先]、[Cc]、[Bcc] フィールドに適用されるフィルターはいずれもサポートされません。サポートされないフィルターの詳細なリストについては、以下の表をご覧ください。

サポートされないフィルター

フィールド	フィルター
件名	次を含まない
件名	行末
件名	空でない
件名	空である
元	行末
元	次に等しい
元	空でない
元	空である

プロパティ パネル

共通

• 表示名 - デザイナー パネルに表示されるアクティビティの名前です。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

オプション

• 「アクティビティの本体」のオプションを確認してください。
  注:

  デスクトップ版 Outlook アプリを自動化する場合、アクティビティは Outlook データ ファイルにローカルに保存されているメールのみを処理します。一部のメールが処理されない場合の対処方法については、『StudioX ガイド』の「Outlook のトラブルシューティング」をご覧ください。