--- sourceDocument: Yokohama データと自動化 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications Release : - yokohama ft:locale : - ja-JP ft:publication_title : - Yokohama データと自動化 ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # Email コネクタのメソッド # Email コネクタのメソッド {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：7分 Email コネクタのメソッドは、メールメッセージを取得、送信、返信し、添付ファイルをダウンロードします。最初に SetConfig メソッドを使用して、メール サーバーへの接続を設定します。 SetConfig メソッドを使用して、メールサーバーのプロパティとアクセス認証情報を構成します。このメソッドは、自動化の他のすべての Email コネクタメソッドよりも優先する必要があります。 GetMails メソッドは、メールサーバーからメッセージを取得し、1 つ以上のメッセージを含むオブジェクトとして他のメソッドに渡します。ReadMail、ReplyMail、および SaveAllAttachments メソッドは、1 つのメッセージに対して同時に動作します。これらのメソッドが複数のメッセージを含むオブジェクトを受け取る場合、自動化は For Each メソッドまたは For Loop メソッドを使用して、コレクション内の各メッセージを反復処理する必要があります。 * For Each メソッドの使用方法については、「[For Each コンポーネントの使用](https://servicenow-prod.fluidtopics.net/zwxIiGPamveSdthEYKP7nQ "RPA デスクトップデザインスタジオ の For Each コンポーネントを使用して、コレクション内の各アイテムを先頭から最後までの順序で走査します。コレクションには、アレイ、リスト、またはテーブルを使用できます。")」を参照してください。 * For Loop メソッドの使用方法については、「[For Loop コンポーネントの使用](https://servicenow-prod.fluidtopics.net/3zIEMd60zuETZ9vrikEI7Q "RPA デスクトップデザインスタジオ の For Loop コンポーネントを使用して、コードを再帰的に実行し、反復性のあるタスクを実行します。For Loop は、反復処理を指定するためのコントロールフローコンポーネントです。")」を参照してください。 {#email-connector-methods__ul_rkc_ss4_lzb} ## SetConfig {#email-connector-methods__section_psc_jv2_mtb} 自動化がメッセージを処理できるように、メールサーバーへの接続を設定します。 注: このメソッドは、Email コネクタの他のメソッドを実行する前に実行する必要があります。 パラメーターの設定方法については、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#email-connector-methods__table_qrp_jx2_mtb__entry__7} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須 | メモ | |-|-|-|-|-|-|-| | ユーザー名 | メールサーバーにログインするためのユーザー名。 | データ入力 | 文字列 | (なし) | はい | | | パスワード | メールサーバーにログインするためのパスワード | データ入力 | 文字列 | (なし) | はい | | | 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 | いいえ | | [表 : 1. SetConfig メソッドのパラメーター] {#email-connector-methods__table_qrp_jx2_mtb} ## GetMails {#email-connector-methods__section_rw5_4mk_mtb} 他のメソッドで使用するためにメールサーバーからメッセージを返します。既読 (開封済み) または未読 (未開封) のメッセージを取得するようにメソッドを設定し、収集されるフォルダーを指定できます。 パラメーターの設定方法については、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#email-connector-methods__table_uvc_1nk_mtb__entry__7} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須 | メモ | |-|-|-|-|-|-|-| | FolderName | メソッドがコレクションをフェッチする IMAP フォルダーの名前 (例：受信ボックス) | データ入力 | 文字列 | 受信箱 | はい | ネストされた IMAP フォルダーを指定するには、バックスラッシュ記号を使用してフォルダー階層を入力します (例：プロジェクト\\会議) | | フィルター | 未読 (未開封) または既読 (開封済み) メッセージのみを取得するように設定 | データ入力 | FilterMode | 未開封 | はい | | | 戻る | メールコレクションをオブジェクトとして返します。 | データ出力 | オブジェクト | オブジェクト | はい | | [表 : 2. GetMails メソッドのパラメーター] {#email-connector-methods__table_uvc_1nk_mtb} ## MarkAsRead {#email-connector-methods__section_uhb_31l_mtb} 指定したフォルダーのメッセージを既読としてマークします。 パラメーターの設定方法については、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#email-connector-methods__table_zhf_kbl_mtb__entry__7} | パラメーター | 説明 | ポートタイプ | データタイプ | デフォルト値 | 必須 | メモ | |-|-|-|-|-|-|-| | MailObject | 対応するメッセージを既読としてマークしたメールオブジェクト | データ入力 | オブジェクト | オブジェクト | はい | | | FolderName | メールオブジェクトがフェッチされる IMAP フォルダーの名前 | データ入力 | 文字列 | 受信箱 | はい | ネストされた IMAP フォルダーを指定するには、バックスラッシュ記号を使用してフォルダー階層を入力します (例：プロジェクト\\会議) | [表 : 3. MarkAsRead メソッドのパラメーター] {#email-connector-methods__table_zhf_kbl_mtb} ## MarkAsUnread {#email-connector-methods__section_l3t_hcl_mtb} 指定したフォルダーのメッセージを未読としてマークします。 パラメーターの設定方法については、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#email-connector-methods__table_phg_mcl_mtb__entry__7} | パラメーター | 説明 | ポートタイプ | データタイプ | デフォルト値 | 必須 | メモ | |-|-|-|-|-|-|-| | MailObject | 未読としてマークされた、対応するメールに基づくメールオブジェクト。 | データ入力 | オブジェクト | オブジェクト | はい | | | FolderName | メールオブジェクトがフェッチされる IMAP フォルダーの名前。 | データ入力 | 文字列 | 受信箱 | はい | ネストされた IMAP フォルダーを指定するには、バックスラッシュ記号を使用してフォルダー階層を入力します (例：プロジェクト\\会議) | [表 : 4. MarkAsRead メソッドのパラメーター] {#email-connector-methods__table_phg_mcl_mtb} ## ReadMail {#email-connector-methods__section_iqz_tfl_mtb} メッセージを読み取り、件名、本文、送信者 (差出人)、\[CC\] フィールドの受信者、\[BCC\] フィールドの受信者、添付ファイルの数などの詳細を返します。 パラメーターの設定方法については、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#email-connector-methods__table_uts_bgl_mtb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須 | |-|-|-|-|-|-| | MailObject | 受信した最後のメッセージの詳細を渡す MailObject | データ入力 | オブジェクト | オブジェクト | はい | | 件名 | メッセージの件名 | データ出力 | 文字列 | なし | いいえ | | 本文 | メッセージの本文 | データ出力 | 文字列 | なし | いいえ | | 送信者 | メッセージの送信者 | データ出力 | 文字列 | なし | いいえ | | CC | CC でマークされた受信者 | データ出力 | 文字列 | なし | いいえ | | BCC | BCC でマークされた受信者 | データ出力 | 文字列 | なし | いいえ | | AttachmentsCount | メッセージ内の添付ファイルの数 | データ出力 | 整数 | なし | いいえ | [表 : 5. ReadMail メソッドのパラメーター] {#email-connector-methods__table_uts_bgl_mtb} ## ReplyMail {#email-connector-methods__section_l11_gyy_mtb} メッセージに自動的に返信します。パラメーターを使用して、メッセージの本文とその他の詳細を設定します。添付ファイルを含めることができます。 パラメーターの設定方法については、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#email-connector-methods__table_hm3_kmz_mtb__entry__7} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須 | メモ | |-|-|-|-|-|-|-| | MailObject | メッセージの詳細を含むメッセージオブジェクト | データ入力 | オブジェクト | オブジェクト | はい | | | ReplyToAll | メールの宛先フィールドと CC フィールドのすべての受信者に返信します。 | データ入力 | ブール | False | いいえ | | | BCC | メールの BCC フィールドのすべての受信者に返信します。 | データ入力 | 文字列 | なし | いいえ | | | 本文 | 返信メッセージの本文 | データ入力 | 文字列 | なし | いいえ | | | IsHtmlBody | 返信の本文が HTML 形式かどうかを示すオプション | データ入力 | ブール | False | いいえ | | | 添付ファイル | 返信メッセージの添付ファイル | データ入力 | 文字列 | なし | いいえ | ファイルを添付するには、次の方法があります。 1. ファイルへのパスをフィールドに貼り付けます。 2. パスを囲む引用符を削除します。 {#email-connector-methods__ol_v5m_j4z_mtb} 複数の添付ファイルを指定するには、パスをカンマで区切ります。 | [表 : 6. ReplyMail メソッドのパラメーター] {#email-connector-methods__table_hm3_kmz_mtb} ## SaveAllAttachments {#email-connector-methods__section_mz4_gyy_mtb} メッセージのすべての添付ファイルをローカルドライブに保存します。 パラメーターの設定方法については、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#email-connector-methods__table_vbt_5zy_mtb__entry__6} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須 | |-|-|-|-|-|-| | MailObject | メソッドが添付ファイルをダウンロードするメッセージ | データ入力 | オブジェクト | オブジェクト | はい | | FolderPath | 添付ファイルのダウンロード先ディレクトリのパス | データ入力 | 文字列 | なし | はい | [表 : 7. SaveAllAttachments メソッドのパラメーター] {#email-connector-methods__table_vbt_5zy_mtb} ## SendMail {#email-connector-methods__section_r4g_xqz_mtb} メッセージを送信します。パラメーターを使用して、メッセージの本文とその他の詳細を設定します。添付ファイルを含めることができます。 注: SetConfig メソッドを使用して、差出人アドレスを設定します。 パラメーターの設定方法については、「[ポートのプロパティを設定する](https://servicenow-prod.fluidtopics.net/EaXLWGHKbwyzLxOyWwOFpg "RPA デスクトップデザインスタジオのコンポーネントまたはメソッドの入力フィールドにデータを渡す方法を設定します。")」を参照してください。 {#email-connector-methods__table_qvr_frz_mtb__entry__7} | パラメーター | 説明 | データポートタイプ | データタイプ | デフォルト値 | 必須 | メモ | |-|-|-|-|-|-|-| | ToAddress | メッセージの送信先アドレス | データ入力 | 文字列 | なし | はい | | | CC | CC フィールドに含めるアドレス | データ入力 | 文字列 | なし | いいえ | | | BCC | BCC フィールドに含めるアドレス | データ入力 | 文字列 | なし | いいえ | | | 件名 | メッセージの件名 | データ入力 | 文字列 | なし | いいえ | | | 本文 | メッセージ本文 | データ入力 | 文字列 | なし | いいえ | | | IsHtmlBody | 返信の本文が HTML 形式かどうかを示すオプション | データ入力 | 文字列 | False | いいえ | | | 添付ファイル | メッセージの添付ファイル | データ入力 | 文字列 | なし | いいえ | ファイルを添付するには、次の方法があります。 1. ファイルへのパスをフィールドに貼り付けます。 2. パスを囲む引用符を削除します。 {#email-connector-methods__ol_jsq_kb4_lzb} 複数の添付ファイルを指定するには、パスをカンマで区切ります。 | [表 : 8. SendMail メソッドのパラメーター] {#email-connector-methods__table_qvr_frz_mtb}