264 UTL_MAIL
UTL_MAIL
パッケージは、電子メールを管理するためのユーティリティで、添付、CCおよびBCCなど一般に使用される電子メール機能が組み込まれています。
この章のトピックは、次のとおりです:
264.1 UTL_MAILのセキュリティ・モデル
インストールによってSMTP_OUT_SERVER
の構成が必要になり、これに関連してセキュリティが公開されるため、UTL_MAIL
はデフォルトではインストールされません。UTL_MAIL
をインストールする場合は、SMTP_OUT_SERVER
によって定義されるポートにデータ送信が集中しないように対策を講じる必要があります。
このパッケージは実行者権限のパッケージになったため、起動するユーザーには、接続するリモート・ネットワーク・ホストに割り当てられたアクセス制御リストで接続権限が付与されている必要があります。
ノート:
ファイングレイン・アクセスの管理の詳細は、『Oracle Databaseセキュリティ・ガイド』を参照してください。
264.2 UTL_MAILの操作上のノート
UTL_MAIL
のインストールとSMTP_OUT_SERVER
の定義の両方を行う必要があります。
-
UTL_MAILをインストールするには次のように指定します。
sqlplus sys/<pwd> SQL> @$ORACLE_HOME/rdbms/admin/utlmail.sql SQL> @$ORACLE_HOME/rdbms/admin/prvtmail.plb
-
SMTP_OUT_SERVER
パラメータは、init
.ora
rdbms
初期化ファイルで定義します。ただしSMTP_OUT_SERVER
が定義されない場合は、デフォルトのDB_DOMAIN
が起動され、適切に実行するように定義されることが保証されています。
264.3 UTL_MAILのルールおよび制限
UTL_MAIL
は、American Standard Code for Information Interchange(ASCII)コードおよびExtended Binary-Coded Decimal Interchange Code(EBCDIC)コードのコンテキストのみで使用してください。
264.4 UTL_MAILサブプログラムの要約
この表は、UTL_MAIL
サブプログラムを示し、簡単に説明しています。
表264-1 UTL_MAILパッケージのサブプログラム
サブプログラム | 説明 |
---|---|
電子メール・メッセージを適切な形式にパッケージし、SMTP情報を探し、受信者に転送するためのSMTPサーバーにメッセージを配信します。 |
|
|
|
|
264.4.1 SENDプロシージャ
このプロシージャは、電子メール・メッセージを適切な形式にパッケージし、SMTP情報を探し、受信者に転送するためのSMTPサーバーにメッセージを配信します。
使いやすくするため、SMTP APIは表示せず、1行の電子メール機能を表示します。
構文
UTL_MAIL.SEND ( sender IN VARCHAR2 CHARACTER SET ANY_CS, recipients IN VARCHAR2 CHARACTER SET ANY_CS, cc IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL, bcc IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL, subject IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL, message IN VARCHAR2 CHARACTER SET ANY_CS, mime_type IN VARCHAR2 DEFAULT 'text/plain; charset=us-ascii', priority IN PLS_INTEGER DEFAULT 3, replyto IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL);
パラメータ
表264-2 SENDプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
送信者の電子メール・アドレス。 |
|
受信者の電子メール・アドレス。複数の場合はカンマで区切ります。 |
|
CC受信者の電子メール・アドレス。複数の場合はカンマで区切ります。デフォルトは |
|
BCC受信者の電子メール・アドレス。複数の場合はカンマで区切ります。デフォルトは |
|
電子メールの件名文字列として含める文字列。デフォルトは |
|
テキスト・メッセージ本体。 |
|
メッセージのMIMEタイプ。デフォルトは |
|
メッセージの優先順位。X-priorityフィールドにマッピングされます。1が最高の優先順位で、5が最低の優先順位です。デフォルトは3です。 |
|
応答メールの送信先ユーザーを定義します。 |
264.4.2 SEND_ATTACH_RAWプロシージャ
このプロシージャは、RAW
添付がオーバーロードされるSEND
プロシージャです。
構文
UTL_MAIL.SEND_ATTACH_RAW ( sender IN VARCHAR2 CHARACTER SET ANY_CS, recipients IN VARCHAR2 CHARACTER SET ANY_CS, cc IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL, bcc IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL, subject IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL, message IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL, mime_type IN VARCHAR2 DEFAULT CHARACTER SET ANY_CS DEFAULT 'text/plain; charset=us-ascii', priority IN PLS_INTEGER DEFAULT 3, attachment IN RAW, att_inline IN BOOLEAN DEFAULT TRUE, att_mime_type IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT 'text/plain; charset=us-ascii', att_filename IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL, replyto IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL);
パラメータ
表264-3 SEND_ATTACH_RAWプロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
送信者の電子メール・アドレス。 |
|
受信者の電子メール・アドレス。複数の場合はカンマで区切ります。 |
|
CC受信者の電子メール・アドレス。複数の場合はカンマで区切ります。デフォルトは |
|
BCC受信者の電子メール・アドレス。複数の場合はカンマで区切ります。デフォルトは |
|
電子メールの件名文字列として含める文字列。デフォルトは |
|
テキスト・メッセージ本体。 |
|
メッセージのMIMEタイプ。デフォルトは |
|
メッセージの優先順位。X-priorityフィールドにマッピングされます。1が最高の優先順位で、5が最低の優先順位です。デフォルトは3です。 |
|
|
|
添付をメッセージ本体とともにインライン表示可能にするかどうかを指定します。デフォルトは |
|
添付のMIMEタイプ。デフォルトは'application/octet'です。 |
|
添付を含むファイル名を指定する文字列。デフォルトは |
|
応答メールの送信先ユーザーを定義します。 |
264.4.3 SEND_ATTACH_VARCHAR2プロシージャ
このプロシージャは、VARCHAR2
添付がオーバーロードされるSEND
プロシージャです。
構文
UTL_MAIL.SEND_ATTACH_VARCHAR2 ( sender IN VARCHAR2 CHARACTER SET ANY_CS, recipients IN VARCHAR2 CHARACTER SET ANY_CS, cc IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL, bcc IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL, subject IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL, message IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL, mime_type IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT 'text/plain; charset=us-ascii', priority IN PLS_INTEGER DEFAULT 3, attachment IN VARCHAR2 CHARACTER SET ANY_CS, , att_inline IN BOOLEAN DEFAULT TRUE, att_mime_type IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT 'text/plain; charset=us-ascii, att_filename IN VARCHAR2CHARACTER SET ANY_CS DEFAULT NULL, replyto IN VARCHAR2 CHARACTER SET ANY_CS DEFAULT NULL);
パラメータ
表264-4 SEND_ATTACH_VARCHAR2プロシージャのパラメータ
パラメータ | 説明 |
---|---|
|
送信者の電子メール・アドレス。 |
|
受信者の電子メール・アドレス。複数の場合はカンマで区切ります。 |
|
CC受信者の電子メール・アドレス。複数の場合はカンマで区切ります。デフォルトは |
|
BCC受信者の電子メール・アドレス。複数の場合はカンマで区切ります。デフォルトは |
|
電子メールの件名文字列として含める文字列。デフォルトは |
|
テキスト・メッセージ本体。 |
|
メッセージのMIMEタイプ。デフォルトは |
|
メッセージの優先順位。X-priorityフィールドにマッピングされます。1が最高の優先順位で、5が最低の優先順位です。デフォルトは3です。 |
|
テキスト添付。 |
|
添付をインライン表示するかどうかを指定します。デフォルトは |
|
添付のMIMEタイプ。デフォルトは |
|
添付を含むファイル名を指定する文字列。デフォルトは |
|
応答メールの送信先ユーザーを定義します。 |