Send-Mail
電子メールメッセージを作成して送信します。Send-Mail は、メッセージの件名および本文と同様に、プライマリ、コピー、およびブラインドコピーの受信者の指定をサポートします。複数のメッセージ本文タイプを含んでいる、複数の部分から構成される MIME メッセージを作成して送信できます。これによって、メッセージ本文を Webject パラメータを使用した簡単なテキスト、またはタスク入力ストリームを使用した BLOB として指定できます。
構文
<ie:webject name="Send-Mail" type="MSG">
<ie:param name="BCC" data="e-mail_address"/>
<ie:param name="BLOB_COUNT" data="number"/>
<ie:param name="CC" data="e-mail_address"/>
<ie:param name="CONNECTION_TIMEOUT" data="milliseconds"/>
<ie:param name="CONTENT" data="message_body"/>
<ie:param name="CONTENT_TYPE" data="MIME_type"/>
<ie:param name="CONTENT_URL_LANGUAGE" data="
<ie:param name="DBUSER" data="username"/>
<ie:param name="FROM" data="e-mail_address"/>
<ie:param name="GROUP_OUT" data="results"/>
<ie:param name="HEADERS_CHARSET" data="
<ie:param name="MAIL_SERVER" data="host_name"/>
<ie:param name="MAX_DELIVERY_TIME" data="
<ie:param name="MULTIPART_TYPE" data="
<ie:param name="PASSWD" data="password"/>
<ie:param name="PASSWORD" data="password"/>
<ie:param name="REPLY_TO" data="e-mail_address"/>
<ie:param name="SUBJECT" data="message_subject"/>
<ie:param name="TIMEOUT" data="milliseconds"/>
<ie:param name="TO" data="e-mail_address"/>
<ie:param name="USERNAME" data="user_name"/>
</webject>
パラメータ
|
必須
|
選択
|
オプション
|
|
以下のように変更します。
|
BLOB_COUNT
|
CC
|
|
|
CONNECTION_TIMEOUT
|
|
CONTENT
|
BCC
|
|
CONTENT_LINE_BREAK
|
DBUSER
|
|
CONTENT_TYPE
|
FROM
|
|
CONTENT_URL
|
GROUP_OUT
|
|
|
HEADER
|
|
|
HEADERS_CHARSET
|
|
|
MAIL_SERVER
|
|
|
MAX_DELIVERY_TIME
|
|
|
MULTIPART_TYPE
|
|
|
PASSWD
|
|
|
PASSWORD
|
|
|
REPLY_TO
|
|
|
SUBJECT
|
|
|
TIMEOUT
|
|
|
USERNAME
|
BCC
メッセージのブラインドコピー受信者の電子メールアドレス。これらの受信者はそれぞれメッセージのコピーを受信しますが、これらのアドレスはほかのブラインドコピー受信者を含めて、ほかの受信者に公開されません。このパラメータを複数回指定して、複数のブラインドコピー受信者を指定できます。パラメータのインスタンスごとに 1 つのアドレスを指定します。このパラメータはオプションです。
BLOB_COUNT
入力ストリームから読み取る BLOB 数。CONTENT パラメータも指定した場合、BLOB は添付資料としてメッセージに追加されます。CONTENT パラメータを指定しない場合は、BLOB はメッセージになります。
CC
メッセージのコピーを送信する、プライマリ以外の受信者の電子メールアドレス。このパラメータを複数回指定して、複数のコピー受信者を指定できます。パラメータのインスタンスごとに 1 つのアドレスを指定します。このパラメータはオプションです。
CONTENT
メッセージ本文のテキスト。CONTENT パラメータの各インスタンスは CONTENT_TYPE パラメータのインスタンスに対応し、CONTENT パラメータの MIME コンテンツタイプを指定します。CONTENT_TYPE を指定しない場合、BLOB_COUNT パラメータを指定しないと CONTENT パラメータはデフォルトのプレーンテキストに指定されます。このパラメータには複数の値を指定できます。
CONTENT_LINE_BREAK
このパラメータは改行に使用する文字列 (複数も可) を指定できる複数値のパラメータです。電子メールのコンテンツに、このパラメータで示される値が見つかると、改行に置き換えられます。
CONTENT_TYPE
対応する CONTENT パラメータの MIME コンテンツタイプ。CONTENT_TYPE パラメータの各インスタンスは、CONTENT パラメータのインスタンスに対応し、そのパラメータの MIME コンテンツタイプを指定します。CONTENT_TYPE パラメータを指定しない場合、CONTENT パラメータの MIME コンテンツタイプはデフォルト値である text/plain になります。同様に、CONTENT パラメータよりも CONTENT_TYPE パラメータのほうが少ない場合、text/plain 値が CONTENT_TYPE パラメータのリストに暗黙的に追加されます。
CONTENT_URL
CONTENT_URL パラメータには、複数の値を指定できます。各値は、開いて読み取られる URL を指定します。URL から読み取られたコンテンツは、送信されるメッセージ本文 (メインボディまたはアタッチメント) になります。
DBUSER
SMTP メールサーバーへの接続時に使用するユーザー名。このパラメータはオプションです。
FROM
メッセージの発信者の電子メールアドレス。このパラメータのデフォルトでは、com.infoengine.mail.originator プロパティの値が使用されます。プロパティが存在せず、FROM パラメータを指定していない場合は、例外が発生します。このパラメータはオプションです。
GROUP_OUT
出力グループのオプションの名前。このパラメータが指定されると、sent、unsent、および invalid の 3 つの属性を持つ 1 つの要素を含んだ出力グループが返されます。
◦ sent 属性は、メッセージが送信されたアドレスを示します。
◦ unsent 属性は、有効であるが (たとえば、メールサーバーが使用不可であったために) メッセージを送信できなかったアドレスを示します
◦ invalid 属性は、無効なアドレスを示します。
HEADER
送信メッセージに追加するオプションのヘッダー。このパラメータには複数の値を指定できます。
このパラメータのフォーマットは name=value です (value は引用符で囲みません)。
たとえば、次の値を指定すると、そのユーザーが実際に CC リストに含まれていない (電子メールを受信しない) 場合でも、CC ヘッダーがメッセージに追加されます。
cc=user@host.com
|
|
このパラメータは、電子メールを複数の言語で受信者に送信する場合に便利です。受信者グループに異なる言語ロケールが設定されている場合、Windchill はロケール別に電子メールを送信します。ただし、言語ごとに電子メールを送信する場合、受信者リストには同じロケールを共有するユーザーしか表示されません。1 つの電子メールに対して複数のロケールグループが含まれているかどうかについて混乱しないように、HEADER を cc=user@host.com に設定できます。
|
HEADERS_CHARSET
件名ヘッダーなどの電子メールヘッダーで使用する文字セットの名前。
MAIL_SERVER
受信者に送信されるルーティング用メッセージの SMTP メールサーバーのインターネットドメイン名。このパラメータのデフォルトでは、com.infoengine.mail.smtp.server プロパティからメールサーバー名を取得します。プロパティが存在せず、MAIL_SERVER を指定していない場合、メールサーバーはデフォルトで値ある localhost になります。このパラメータはオプションです。
MAX_DELIVERY_TIME
有効なアドレスにメッセージの配信を試みる時間の最大長さ (秒単位)。このパラメータは、メールの転送において (メールサーバーの一時的な使用不可や混雑などの理由により) 有効なアドレスがメールサーバーで承認されない場合に使用されます。デフォルト値は 60 秒です。
MULTIPART_TYPE
複数の CONTENT および CONTENT_URL パラメータ値が指定された場合の、マルチパートメッセージの MIME サブタイプ。このパラメータのデフォルト値は mixed です。
PASSWD
DBUSER パラメータと関連付けられているパスワード。このパラメータはオプションです。
PASSWORD
SMTP メールサーバーへの認証時に指定するパスワード。PASSWORD は USERNAME とともに使用できますが、両方のパラメータを指定する必要はありません。このパラメータのデフォルトでは、.mail.smtp.password プロパティからパスワードを取得します。このパラメータはオプションです。
REPLY_TO
返信先の電子メールアドレス。このパラメータには複数の値を指定できます。パラメータのインスタンスごとに 1 つの電子メールアドレスを指定します。このパラメータのデフォルトでは、FROM によって指定されたアドレスに返信します。このパラメータはオプションです。
SUBJECT
メッセージの件名ヘッダー。指定していない場合、メッセージに件名ヘッダは含まれません。このパラメータはオプションです。
以下のように変更します。
メッセージのプライマリ受信者の電子メールアドレス (複数も可)。複数回指定して、複数のプライマリ受信者を指定できます。パラメータのインスタンスごとに 1 つのアドレスを指定します。これは必須のパラメータです。
USERNAME
SMTP メールサーバーへの認証時に指定するパスワード。USERNAME は PASSWORD とともに使用できますが、両方のパラメータを指定する必要はありません。このパラメータのデフォルトでは、.mail.smtp.username プロパティからユーザー名を取得します。プロパティが存在せず、USERNAME を指定していない場合、メールサーバーに匿名のバインディングを試みます。このパラメータはオプションです。
例
以下の例は、ユーザー入力に基づいて電子メールを送信します。
<%@page language="java" session="false"%>
<%@taglib uri="http://www.ptc.com/infoengine/taglib/core"
prefix="ie"%>
<ie:webject name="Send-Mail" type="MSG">
<ie:param name="USERNAME" data="$(@FORM[]user[])"/>
<ie:param name="PASSWORD" data="$(@FORM[]password[])"/>
<ie:param name="TO" data="$(@FORM[]to[])"/>
<ie:param name="FROM" data="$(@FORM[]from[])"/>
<ie:param name="SUBJECT" data="$(@FORM[]subject[])"/>
<ie:param name="CONTENT_TYPE"
data="$(@FORM[]contentType[])"/>
<ie:param name="CONTENT" data="$(@FORM[]content[])"/>
</ie:webject>
この例を実際に実行するには、user、password、to、from、subject、contentType、および content 変数を識別するフォームを指定する必要があります。
