Email コネクタのメソッド

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：7分

    • Email コネクタのメソッドは、メールメッセージを取得、送信、返信し、添付ファイルをダウンロードします。最初に SetConfig メソッドを使用して、メール サーバーへの接続を設定します。

    SetConfig メソッドを使用して、メールサーバーのプロパティとアクセス認証情報を構成します。このメソッドは、自動化の他のすべての Email コネクタメソッドよりも優先する必要があります。

    GetMails メソッドは、メールサーバーからメッセージを取得し、1 つ以上のメッセージを含むオブジェクトとして他のメソッドに渡します。ReadMail、ReplyMail、および SaveAllAttachments メソッドは、1 つのメッセージに対して同時に動作します。これらのメソッドが複数のメッセージを含むオブジェクトを受け取る場合、自動化は For Each メソッドまたは For Loop メソッドを使用して、コレクション内の各メッセージを反復処理する必要があります。

    SetConfig

    自動化がメッセージを処理できるように、メールサーバーへの接続を設定します。
    注:
    このメソッドは、Email コネクタの他のメソッドを実行する前に実行する必要があります。

    パラメーターの設定方法については、「ポートのプロパティを設定する」を参照してください。

    表 : 1. SetConfig メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須 メモ
    ユーザー名 メールサーバーにログインするためのユーザー名。 データ入力 文字列 (なし) はい
    パスワード メールサーバーにログインするためのパスワード データ入力 文字列 (なし) はい
    UseDefaultCredentials 現在ログインしているユーザーのデフォルトの認証情報を SMTP サーバーに送信します。 データ入力 ブール False いいえ
    SmtpMailServer SMTP サーバーの名前。 データ入力 文字列 smtp.gmail.com いいえ Email コネクタを使用した Gmail へのアクセスは現在サポートされていません。必ずデフォルト値を変更してください。
    ImapMailServer IMAP サーバーの名前 データ入力 文字列 imap.gmail.com いいえ Email コネクタを使用した Gmail へのアクセスは現在サポートされていません。必ずデフォルト値を変更してください。
    SSL Secure Socket Layer プロトコルを使用 データ入力 ブール true いいえ
    SmtpPort SMTP ポート番号 データ入力 整数 587 いいえ
    ImapPort IMAP ポート番号 データ入力 整数 993 いいえ

    GetMails

    他のメソッドで使用するためにメールサーバーからメッセージを返します。既読 (開封済み) または未読 (未開封) のメッセージを取得するようにメソッドを設定し、収集されるフォルダーを指定できます。

    パラメーターの設定方法については、「ポートのプロパティを設定する」を参照してください。

    表 : 2. GetMails メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須 メモ
    FolderName メソッドがコレクションをフェッチする IMAP フォルダーの名前 (例：受信ボックス) データ入力 文字列 受信ボックス はい ネストされた IMAP フォルダーを指定するには、バックスラッシュ記号を使用してフォルダー階層を入力します (例：プロジェクト\会議)
    フィルター 未読 (未開封) または既読 (開封済み) メッセージのみを取得するように設定 データ入力 FilterMode 未開封 はい
    戻る メールコレクションをオブジェクトとして返します。 データ出力 オブジェクト オブジェクト はい

    MarkAsRead

    指定したフォルダーのメッセージを既読としてマークします。

    パラメーターの設定方法については、「ポートのプロパティを設定する」を参照してください。

    表 : 3. MarkAsRead メソッドのパラメーター
    パラメーター 説明 ポートタイプ データタイプ デフォルト値 必須 メモ
    MailObject 対応するメッセージを既読としてマークしたメールオブジェクト データ入力 オブジェクト オブジェクト はい
    FolderName メールオブジェクトがフェッチされる IMAP フォルダーの名前 データ入力 文字列 受信ボックス はい ネストされた IMAP フォルダーを指定するには、バックスラッシュ記号を使用してフォルダー階層を入力します (例：プロジェクト\会議)

    MarkAsUnread

    指定したフォルダーのメッセージを未読としてマークします。

    パラメーターの設定方法については、「ポートのプロパティを設定する」を参照してください。

    表 : 4. MarkAsRead メソッドのパラメーター
    パラメーター 説明 ポートタイプ データタイプ デフォルト値 必須 メモ
    MailObject 未読としてマークされた、対応するメールに基づくメールオブジェクト。 データ入力 オブジェクト オブジェクト はい
    FolderName メールオブジェクトがフェッチされる IMAP フォルダーの名前。 データ入力 文字列 受信ボックス はい ネストされた IMAP フォルダーを指定するには、バックスラッシュ記号を使用してフォルダー階層を入力します (例：プロジェクト\会議)

    ReadMail

    メッセージを読み取り、件名、本文、送信者 (差出人)、[CC] フィールドの受信者、[BCC] フィールドの受信者、添付ファイルの数などの詳細を返します。

    パラメーターの設定方法については、「ポートのプロパティを設定する」を参照してください。

    表 : 5. ReadMail メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須
    MailObject 受信した最後のメッセージの詳細を渡す MailObject データ入力 オブジェクト オブジェクト はい
    件名 メッセージの件名 データ出力 文字列 なし いいえ
    本文 メッセージの本文 データ出力 文字列 なし いいえ
    送信者 メッセージの送信者 データ出力 文字列 なし いいえ
    CC CC でマークされた受信者 データ出力 文字列 なし いいえ
    BCC BCC でマークされた受信者 データ出力 文字列 なし いいえ
    AttachmentsCount メッセージ内の添付ファイルの数 データ出力 整数 なし いいえ

    ReplyMail

    メッセージに自動的に返信します。パラメーターを使用して、メッセージの本文とその他の詳細を設定します。添付ファイルを含めることができます。

    パラメーターの設定方法については、「ポートのプロパティを設定する」を参照してください。

    表 : 6. ReplyMail メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須 メモ
    MailObject メッセージの詳細を含むメッセージオブジェクト データ入力 オブジェクト オブジェクト はい
    ReplyToAll メールの宛先フィールドと CC フィールドのすべての受信者に返信します。 データ入力 ブール False いいえ
    BCC メールの BCC フィールドのすべての受信者に返信します。 データ入力 文字列 なし いいえ
    本文 返信メッセージの本文 データ入力 文字列 なし いいえ
    IsHtmlBody 返信の本文が HTML 形式かどうかを示すオプション データ入力 ブール False いいえ
    添付ファイル 返信メッセージの添付ファイル データ入力 文字列 なし いいえ ファイルを添付するには、次の方法があります。
    1. ファイルへのパスをフィールドに貼り付けます。
    2. パスを囲む引用符を削除します。

    複数の添付ファイルを指定するには、パスをカンマで区切ります。

    SaveAllAttachments

    メッセージのすべての添付ファイルをローカルドライブに保存します。

    パラメーターの設定方法については、「ポートのプロパティを設定する」を参照してください。

    表 : 7. SaveAllAttachments メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須
    MailObject メソッドが添付ファイルをダウンロードするメッセージ データ入力 オブジェクト オブジェクト はい
    FolderPath 添付ファイルのダウンロード先ディレクトリのパス データ入力 文字列 なし あり

    SendMail

    メッセージを送信します。パラメーターを使用して、メッセージの本文とその他の詳細を設定します。添付ファイルを含めることができます。
    注:
    SetConfig メソッドを使用して、差出人アドレスを設定します。

    パラメーターの設定方法については、「ポートのプロパティを設定する」を参照してください。

    表 : 8. SendMail メソッドのパラメーター
    パラメーター 説明 データポートタイプ データタイプ デフォルト値 必須 メモ
    ToAddress メッセージの送信先アドレス データ入力 文字列 なし あり
    CC CC フィールドに含めるアドレス データ入力 文字列 なし いいえ
    BCC BCC フィールドに含めるアドレス データ入力 文字列 なし いいえ
    件名 メッセージの件名 データ入力 文字列 なし いいえ
    本文 メッセージ本文 データ入力 文字列 なし いいえ
    IsHtmlBody 返信の本文が HTML 形式かどうかを示すオプション データ入力 文字列 False いいえ
    添付ファイル メッセージの添付ファイル データ入力 文字列 なし いいえ ファイルを添付するには、次の方法があります。
    1. ファイルへのパスをフィールドに貼り付けます。
    2. パスを囲む引用符を削除します。

    複数の添付ファイルを指定するには、パスをカンマで区切ります。