IMAP メールのリストを取得

UiPath.Mail.IMAP.Activities.GetIMAPMailMessages

説明

指定されたサーバーから IMAP メールメッセージを取得します

注: このアクティビティは、1.24 より古いバージョンでは [IMAP メールメッセージを取得] と呼ばれています。

プロジェクトの対応 OS

Windows - レガシ | Windows | クロスプラットフォーム

Windows - レガシでの設定

共通

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

ホスト

メールフォルダー - メッセージの取得元のメールフォルダーです。
サーバー - 使用するメールサーバーホストです。
ポート - メールメッセージの取得に使用されるポートです。
注: [サーバー] フィールドで DNS 名ではなく IP アドレスを使用できるのは、SSL 接続がない場合か、その IP アドレスに対して発行された SSL 証明書がある場合のみです。

ログオン

Client Name - The Name property of the IMAP client implementation.
Client Version - The Version property of the IMAP client implementation.
メール - メッセージの取得に使用されるメールアカウントです。
パスワード - メッセージの取得に使用されるメールアカウントのパスワードです。[OAuth を使用] を選択した場合、このパラメーターの値は OAuth2 アクセストークンである必要があります。
Secure Password - The password of the email account used, as a secure string. If UseOAuth is selected, the value of this parameter must be an OAuth2 access token.
Use OAuth - Indicates whether to use an OAuth2 access token instead of a password. By default, this option is not selected.

その他

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

オプション

DeleteMessages - 既読メッセージを削除対象としてマークする必要があるかどうかを指定します。
フィルター式 - フィルター式に一致するメールメッセージのみを返します。
フィルター式の文字セット - フィルター式に使用する文字セットの MIME 名です。

注: 使用できる有効な MIME 名のリストは、[文字セット] にあります。
CRL を無視 - 接続時に証明書失効リスト (CRL) の検証を無視するかどうかを指定します。このフィールドには Boolean 型の変数のみ指定できます。空のままにすると、既定の False 値が使用されます。
MarkAsRead - 取得したメッセージを既読としてマークするかどうかを指定します。既定では、このチェックボックスはオフになっています。
OnlyUnreadMessages - 未読のメッセージのみを取得するかどうかを指定します。既定では、このチェックボックスはオンになっています。
日付で並べ替え - メールメッセージを日付で並べ替えます。[NewestFirst] と [OldestFirst] の 2 つのオプションのどちらかを選択します。既定値は [NewestFirst] です。
SecureConnection - 接続に使用する SSL/TLS 暗号化を指定します。
上限数 - [日付で並べ替え] パラメーターの設定に応じて、最新または最も古いメッセージから取得するメッセージの数です。

出力

Messages - MailMessage オブジェクトのコレクションとして取得されたメッセージです。

Windows、クロスプラットフォームでの設定

コネクション - Integration Service でメールコネクタ用に確立されたコネクションです。
メールフォルダー - メッセージの取得元のメールフォルダーです。
追加フィルター - フィルター式に一致するメールメッセージのみを返します。

共通

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

Connection details

Use Integration Service - Whether to use an Integration Service connection or not. Default value is True. When set to false, the server connection fields are displayed.
Server - The email server host to be used. This field supports String type input.
Port - The port used to get the email message. This field supports Int32 type input.
Use OAuth - Indicates whether to use an OAuth2 access token instead of a password. By default, this option is not selected.
Email - The email account used to get the message. This field supports String type input.
Password - The password of the email account used to get the message. If Use OAuth is enabled, the value of this parameter must be an OAuth2 access token. This field supports String type input.
Secure password - The password of the email account used, as a secure string. If Use OAuth is selected, the value of this parameter must be an OAuth2 access token.
Ignore CRL - Indicates whether to ignore the Certificate Revocation List validation when connecting. Boolean value. Default is False.
Secure connection - Specifies the SSL and/or TSL encryption to be used for the connection.
Client name - Specifies a value for the Name property of the IMAP client implementation.
Client version - Specifies a value for the Version property of the IMAP client implementation.

オプション

メールの上限数 - リストの一番上から取得するメッセージの数です。このフィールドでは Int32 型の入力がサポートされています。
未読のみ - 未読メッセージのみを取得するかどうかを指定します。既定値は True です。
既読にする - 取得したメッセージを既読としてマークするかどうかを指定します。
DeleteMessages - 既読メッセージを削除対象としてマークする必要があるかどうかを指定します。
日付で並べ替え - メールメッセージを日付で並べ替えます。[NewestFirst] と [OldestFirst] の 2 つのオプションのどちらかを選択します。既定値は [NewestFirst] です。
フィルター式の文字セット - フィルター式に使用する文字セットの MIME 名です。使用できる有効な MIME 名のリストは、[文字セット] にあります。

出力

メールのリスト - UiPathMailMessage オブジェクトのコレクションとして取得したメッセージです。

フィルター処理の例

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

クエリ	フィルター式
件名に「Welcome」を含むすべてのメールメッセージ	"SUBJECT ""Welcome"""
件名に「Welcome」を含み、送信元が「john.smith@example.com」であるすべてのメールメッセージ	"SUBJECT ""Welcome"" FROM john.smith@example.com"
件名に「Welcome」を含み、送信元が「john.smith@example.com」ではないすべてのメールメッセージ	"SUBJECT ""Welcome"" NOT FROM john.smith@example.com"
本文に「Please review」を含むすべてのメールメッセージ	"BODY ""Please review"""
フラグが付けられたすべてのメールメッセージ (例: Flagged フラグセット)	"FLAGGED"
2021 年 2 月 23 日以降のすべてのメールメッセージ	"SINCE 23-Feb-2021"
2021 年 2 月 23 日または 2021 年 1 月 23 日に受信されたすべての配信不能レポートのメールメッセージ	"OR (ON 23-Feb-2021 FROM postmaster@outlook.com) (ON 23-Jan-2021 FROM postmaster@outlook.com)"
本日未回答であり、かつ送信元が「examples.com」を含むメールアドレスであるすべてのメールメッセージ	"UNANSWERED ON " + DateTime.Today.ToString("dd-MMM-yyyy") + " FROM examples.com"