272 UTL_MAIL

UTL_MAILパッケージは、電子メールを管理するためのユーティリティで、添付、CCおよびBCCなど一般に使用される電子メール機能が組み込まれています。

この章のトピックは、次のとおりです:

• セキュリティ・モデル

• 操作上のノート

• ルールおよび制限

• UTL_MAILサブプログラムの要約

272.1 UTL_MAILのセキュリティ・モデル

インストールによってSMTP_OUT_SERVERの構成が必要になり、これに関連してセキュリティが公開されるため、UTL_MAILはデフォルトではインストールされません。UTL_MAILをインストールする場合は、SMTP_OUT_SERVERによって定義されるポートにデータ送信が集中しないようにステップをとる必要があります。

このパッケージは実行者権限のパッケージになったため、起動するユーザーには、接続するリモート・ネットワーク・ホストに割り当てられたアクセス制御リストで接続権限が付与されている必要があります。

ノート:

ファイングレイン・アクセスの管理の詳細は、『Oracle Databaseセキュリティ・ガイド』を参照してください。

272.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が起動され、適切に実行するように定義されることが保証されています。

272.3 UTL_MAILのルールおよび制限

UTL_MAILは、American Standard Code for Information Interchange(ASCII)コードおよびExtended Binary-Coded Decimal Interchange Code(EBCDIC)コードのコンテキストのみで使用してください。

272.4 UTL_MAILサブプログラムの要約

この表は、UTL_MAILサブプログラムを示し、簡単に説明しています。

表272-1 UTL_MAILパッケージのサブプログラム

サブプログラム	説明
SENDプロシージャ	電子メール・メッセージを適切な形式にパッケージし、SMTP情報を探し、受信者に転送するためのSMTPサーバーにメッセージを配信します。
SEND_ATTACH_RAWプロシージャ	RAW添付がオーバーロードされるSENDプロシージャです。
SEND_ATTACH_VARCHAR2プロシージャ	VARCHAR2添付がオーバーロードされるSENDプロシージャです。

272.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);

パラメータ

表272-2 SENDプロシージャのパラメータ

パラメータ	説明
sender	送信者の電子メール・アドレス。
recipients	受信者の電子メール・アドレス。複数の場合はカンマで区切ります。
cc	CC受信者の電子メール・アドレス。複数の場合はカンマで区切ります。デフォルトはNULLです。
bcc	BCC受信者の電子メール・アドレス。複数の場合はカンマで区切ります。デフォルトはNULLです。
subject	電子メールの件名文字列として含める文字列。デフォルトはNULLです。
message	テキスト・メッセージ本体。
mime_type	メッセージのMIMEタイプ。デフォルトは'text/plain; charset=us-ascii'です。
priority	メッセージの優先順位。X-priorityフィールドにマッピングされます。1が最高の優先順位で、5が最低の優先順位です。デフォルトは3です。
replyto	応答メールの送信先ユーザーを定義します。

272.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);

パラメータ

表272-3 SEND_ATTACH_RAWプロシージャのパラメータ

パラメータ	説明
sender	送信者の電子メール・アドレス。
recipients	受信者の電子メール・アドレス。複数の場合はカンマで区切ります。
cc	CC受信者の電子メール・アドレス。複数の場合はカンマで区切ります。デフォルトはNULLです。
bcc	BCC受信者の電子メール・アドレス。複数の場合はカンマで区切ります。デフォルトはNULLです。
subject	電子メールの件名文字列として含める文字列。デフォルトはNULLです。
message	テキスト・メッセージ本体。
mime_type	メッセージのMIMEタイプ。デフォルトは'text/plain; charset=us-ascii'です。
priority	メッセージの優先順位。X-priorityフィールドにマッピングされます。1が最高の優先順位で、5が最低の優先順位です。デフォルトは3です。
attachment	RAW添付。
att_inline	添付をメッセージ本体とともにインライン表示可能にするかどうかを指定します。デフォルトはTRUEです。
att_mime_type	添付のMIMEタイプ。デフォルトは'application/octet'です。
att_filename	添付を含むファイル名を指定する文字列。デフォルトはNULLです。
replyto	応答メールの送信先ユーザーを定義します。

272.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);

パラメータ

表272-4 SEND_ATTACH_VARCHAR2プロシージャのパラメータ

パラメータ	説明
sender	送信者の電子メール・アドレス。
recipients	受信者の電子メール・アドレス。複数の場合はカンマで区切ります。
cc	CC受信者の電子メール・アドレス。複数の場合はカンマで区切ります。デフォルトはNULLです。
bcc	BCC受信者の電子メール・アドレス。複数の場合はカンマで区切ります。デフォルトはNULLです。
subject	電子メールの件名文字列として含める文字列。デフォルトはNULLです。
message	テキスト・メッセージ本体。
mime_type	メッセージのMIMEタイプ。デフォルトは'text/plain; charset=us-asciiです。
priority	メッセージの優先順位。X-priorityフィールドにマッピングされます。1が最高の優先順位で、5が最低の優先順位です。デフォルトは3です。
attachment	テキスト添付。
att_inline	添付をインライン表示するかどうかを指定します。デフォルトはTRUEです。
att_mime_type	添付のMIMEタイプ。デフォルトは'text/plain; charset=us-ascii'です。
att_filename	添付を含むファイル名を指定する文字列。デフォルトはNULLです。
replyto	応答メールの送信先ユーザーを定義します。