Email コネクタのメソッド

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む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 いいえ 電子メール コネクタを使用した Gmail へのアクセスは現在サポートされていません。必ずデフォルト値を変更してください。
    ImapMailServer IMAP サーバーの名前 データ入力 文字列 imap.gmail.com いいえ 電子メール コネクタを使用した Gmail へのアクセスは現在サポートされていません。必ずデフォルト値を変更してください。
    SSL セキュアソケットレイヤープロトコルを使用する データ入力 ブール 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. パスを囲む引用符を削除します。

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