Exchange メールメッセージを取得

UiPath.Mail.Exchange.Activities.GetExchangeMailMessages

Exchange からメールメッセージを取得します。

プロパティ

共通

表示名 - アクティビティの表示名です。
タイムアウト (ミリ秒) - エラーがスローされる前にアクティビティが実行されるまで待機する時間 (ミリ秒単位) を指定します。既定値は 30000 ミリ秒 (30 秒) です。

Exchange の設定

メール自動検出 - Exchange サーバーからのメールアドレスを使用して Exchange サーバーを自動的に検索します。Exchange サーバーの自動検出が有効化されている場合にのみ機能します。
ExchangeVersion - 使用される Exchange サーバーの最低バージョンを指定します。このフィールドに表示されるオプションは、2007 から 2013 バージョンまでの範囲です。バージョン番号は、サポートしているサービスの最低レベルを示しています。つまり、2016 Exchange Server がある場合は、Exchange 2013 オプションを選択することができます。
サーバー - 使用するメールサーバーホストです。

ログオン

Domain - 接続先の Active Directory ドメインです。
Password - メッセージの取得に使用される Exchange アカウントのパスワードです。
セキュリティで保護されたパスワード - 使用している Exchange アカウントのパスワードを、セキュリティで保護された文字列で表したものです。
User - メッセージの取得に使用される Exchange アカウントのユーザー名です。

その他

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

Office 365 の設定

アプリケーション ID - お使いの Azure Active Directory アプリケーションの ID です。このフィールドは、文字列と String 型変数のみをサポートします。
認証の種類 - Office 365 サービスの認証オプションです。使用可能なオプションは次のとおりです。
- ユーザー名とパスワード - 標準のユーザー名とパスワードのログイン。
  
  重要: [ユーザー名とパスワード] 認証を選択する場合は、[アプリケーション ID] プロパティが必須になります。これにより、基本認証の代わりに確実に ROPC 認証が使用されます。基本認証は Exchange Online で非推奨となっています。
- 対話型 - 対話型トークン (Auth 2.0)。
- Windows 統合 - 統合 Windows 認証。
ディレクトリ ID - お使いの Azure Active Directory の ID です。このフィールドは、文字列と String 型変数のみをサポートします。

オプション

メッセージ ID でフィルター - 指定したメッセージ ID を持つメールメッセージのみを返します。設定した場合、[フィルター式] パラメーターは無視されます。このフィールドでは String[] 変数のみサポートされています。
注: メッセージ ID によるフィルター処理は、Exchange Server 2013 以降サポートされています。
フィルター式 - フィルター式に一致するメールメッセージのみを返します。
注: Exchange Server 2010 以降、フィルター式を使用できます。
添付ファイルを取得 - メールメッセージの添付ファイルを取得するかどうかを指定します。既定では、このチェックボックスはオフになっています。
注: Exchange Server 2007 SP1 では、このアクティビティはインライン添付ファイルを含むすべての添付ファイルを返します。これは、Exchange API の制限です。
IsBodyHtml - メッセージの本文が HTML 形式で記述されているかどうかを指定します。
MarkAsRead - 取得したメッセージを既読としてマークするかどうかを指定します。既定では、このチェックボックスはオフになっています。
OnlyUnreadMessages - 未読のメッセージのみを取得するかどうかを指定します。既定では、このチェックボックスはオンになっています。
日付で並べ替え - メールメッセージを日付で並べ替えます。[NewestFirst] と [OldestFirst] の 2 つのオプションのどちらかを選択します。既定値は [NewestFirst] です。
上限数 - [日付で並べ替え] パラメーターの設定に応じて、最新または最も古いメッセージから取得するメッセージの数です。

出力

Messages - MailMessage オブジェクトのコレクションとして取得されたメッセージです。
注: UiPath.Mail.Activities バージョン 1.10.4 からは、MailMessage オブジェクトは以下を公開します。
- メールメッセージのメッセージ ID (例: MailMessage.Headers("Message-ID"))
- メールメッセージに関連付けられているカテゴリ (例: MailMessage.GetCategories())

ターゲット

メールフォルダー - メッセージの取得元のメールフォルダーです。
重要:
- パブリックフォルダーからメールを取得する場合、[メールフォルダー] フィールドの値は、[お気に入り] に表示されるパブリックフォルダーの名前と正確に一致している必要があります。
- パブリックフォルダーを使用する際、メールボックスに同じ名前の個人用フォルダーが存在する場合、アクティビティは個人用フォルダーからメールを返します。パブリックフォルダーからメールを返すには、個人用フォルダーの名前を変更する必要があります。
- アクティビティは、投稿アイテムをサポートしていません。パブリックフォルダーに投稿アイテムがある場合、適切なフィルター式を指定しない限り (例: FilterExpression = “kind:emails”)、アクティビティは失敗します。
共有メールボックス - Exchange ユーザーアカウントにリンクされている共有メールボックスからのメッセージの取得を有効化します。

フィルター処理の例

次の表は、Exchange のメールメッセージに対するクエリを実行するときに役立つ可能性があるフィルターの例です。

クエリ	フィルター式
件名に「welcome」を含むすべてのメールメッセージ	"subject:welcome"
件名に「welcome」を含み、送信元が「john.smith@example.com」であるすべてのメールメッセージ	"subject:welcome AND from:""john.smith@example.com"""
「example.com」のメールアカウントから送信されたすべてのメールメッセージ	"from:example.com"
本文に「please review」を含むすべてのメールメッセージ	"body:please review"
添付ファイルを含むすべてのメールメッセージ	"hasattachment:true"
pdf ファイルが添付された、重要度が「高」のすべてのメールメッセージ	"importance:high AND attachments:.pdf"
カテゴリが「Red category」かつ「Blue category」のすべてのメールメッセージ	"category:Red category, Blue category"
会議の種類 (例: 予定表の招待、応答) であるすべてのメールメッセージ	"kind:meetings"
今日受信したすべてのメールメッセージ	"received:today"
2020 年 10 月 23 日に受信されたすべてのメールメッセージ	"received:10/23/2020"
2020 年 10 月 23 日以降に受信されたすべてのメールメッセージ	"received: >=10/23/2020"