E メールの送信
E メール・メッセージを送信します。
コマンドの可用性: IBM RPA SaaS および IBM RPA オンプレミス
Description
E メール・メッセージを送信します。
スクリプト構文
IBM RPA の専有スクリプト言語の構文は、他のプログラミング言語と似ています。 スクリプト構文は、スクリプト・ファイル内のコマンドの構文を定義します。 この構文は、 IBM RPA Studioの 「スクリプト」 モードで操作できます。
emailSend --connection(EmailConnection) --to(List<String>) [--from(String)] [--cc(List<String>)] [--bcc(List<String>)] [--subject(String)] [--bodytype(BodyType)] --body(String) [--attachments(List<String>)] [--headers(StringDictionary<Variant>)] [--labels(List<String>)]
依存関係
個別 (
forEach) コマンドを使用して、E メール・メッセージ・インスタンスを取得します。 それ以外の場合、コマンドは最初の結果のみを返します。E メール・サーバーに接続するには、以下のコマンドを使用します。
Exchange E メール・サーバーに接続 (
exchangeConnect)IMAP E メール・サーバーへの接続 (
imapConnect)Outlook サーバーへの接続 (
outlookConnect)SMTP サーバーへの接続 (
smtpConnect)
E メールを送信するには、接続で別名ではなく元の E メール・アカウントを使用する必要があります。
入力パラメーター
以下の表は、このコマンドで使用可能な入力パラメーターのリストを示しています。 この表では、 IBM RPA Studioのスクリプト・モードで作業しているときのパラメーター名と、それに相当する Designer モードのラベルを確認できます。
| 「デザイナー」モードのラベル | 「スクリプト」モードの名前 | 必須 | 使用可能な変数タイプ | Description |
|---|---|---|---|---|
| 接続 | connection |
Required |
Email Connection |
確立された E メール接続を保持する変数。 |
| 終了 | to |
Required |
List<Text> |
受信者の E メール・アドレスを保持するリスト。 |
| 送信元 | from |
Optional |
Text |
送信者の E メール・アドレスのリスト。 Microsoft Exchange などの一部の E メール・プロバイダーでは、このパラメーターを設定する必要があります。 |
| Cc | cc |
Optional |
List<Text> |
メッセージのコピーを受け取る受信者の E メール・アドレスのリスト。 |
| Bcc | bcc |
Optional |
List<Text> |
メッセージのブラインド・コピーを受け取る受信者の E メール・アドレスのリスト。 |
| 件名 | subject |
Optional |
Text |
E メール・メッセージの件名。 |
| 本文タイプ | bodytype |
Optional |
BodyType |
E メール・メッセージの本文を構成するテキストのタイプ。bodytype パラメーター・オプションを参照してください。 |
| E メール本文 | body |
Required |
Text |
Body Type パラメーターで指定されたフォーマットのタイプに従って、E メール・メッセージの本文を構成するテキスト。 |
| 添付ファイル | attachments |
Optional |
List<Text> |
E メール・メッセージに添付するファイルのパスのリスト。 |
| headers | headers |
Optional |
String Dictionary<Any> |
送信するメッセージに関してヘッダーに記述する必要があるあらゆる情報 (送信者、受信者、サーバーなど) を参照するキーと値。 |
| カテゴリー | labels |
Optional |
List<Text> |
E メール・メッセージの分類の カテゴリー |
bodytype パラメーター・オプション
次の表は、bodytype 入力パラメーターで使用可能なオプションを示しています。 この表は、「スクリプト」モードで作業するときに使用可能なオプションと、「デザイナー」モードでそれに相当するラベルを示しています。
| 「デザイナー」モードのラベル | 「スクリプト」モードの名前 | Description |
|---|---|---|
| Html | Html |
html 形式のテキスト。 |
| Rtf | Rtf |
rtf 形式のテキスト。 |
| Text | Text |
プレーン・テキスト。 |
例
例 1: Google サーバーへの接続から、ある受信者にプレーン・テキストの E メール・メッセージを送信し、コピーとブラインド・コピーを他の受信者に送信します。
defVar --name connection --type EmailConnection
defVar --name destinataryList --type List --innertype String --value "[user1@gmail.com,user2@hotmail.com]"
defVar --name cc --type List --innertype String --value "[user3@gmail.com,user@outlook.com]"
defVar --name bcc --type List --innertype String --value "[user5@hotmail.com]"
defVar --name category --type List --innertype String --value "[main]"
// Connect to the SMTP email server to send the message.
smtpConnect --smtphost "smtp.gmail.com" --smtpport 465 --smtpusername "useremail@gmail.com" --smtppassword userpassword --smtpusesslconnection=value
emailSend --connection ${connection} --to ${destinataryList} --from "useremail@gmail.com" --cc ${cc} --bcc ${bcc} --subject "Sending email in plain text" --bodytype "Html" --body "Good Morning!\r\nWould you like to make a reservation, which day is available?" --labels ${category}
例 2: SMTP E メール・サーバーに接続した後、HTML 形式の E メール・メッセージが 1 人の受信者に送信され、コピーとブラインド・コピーが他の受信者に送信されます。
defVar --name connection --type EmailConnection
defVar --name destinataryList --type List --innertype String --value "[user1@gmail.com,user2@hotmail.com]"
defVar --name cc --type List --innertype String --value "[user3@gmail.com,user@outlook.com]"
defVar --name bcc --type List --innertype String --value "[user5@hotmail.com]"
defVar --name category --type List --innertype String --value "[principal]"
// Connect to the SMTP email server to send the message.
smtpConnect --smtphost "smtp.gmail.com" --smtpport 465 --smtpusername "useremail@gmail.com" --smtppassword userpassword --smtpusesslconnection=value
emailSend --connection ${connection} --to ${destinataryList} --from "useremail@gmail.com" --cc ${cc} --bcc ${bcc} --subject "Sending email in HTML format" --bodytype "Html" --body "<p><strong>Good Morning!</strong></p>\r\n<p>I would like to make a <em>reservation</em>, what days are available?</p>" --labels ${category}
注: このサンプル・スクリプトを実行するには、有効な E メール接続を使用してください。