4D Doc Center : SMTP

4D Internet Commands v14

SMTP_Attachment


SMTP_Attachment ( smtp_ID ; fileName ; encodeType {; deleteOption {; attachmentID}} ) -> 戻り値

引数	型	説明
smtp_ID	倍長整数	メッセージ参照
fileName	テキスト	添付するファイル名
encodeType	整数	0 = エンコードなし (データフォークのみ送信), +-1 = BinHex, +-2 = Base64; (データフォークのみ送信), +-3 = AppleSingle, +-4 = AppleDouble, +-5 = AppleSingle と Base64, +-6 = AppleDouble と Base64, +-7 = UUEncode
deleteOption	整数	0 = 既存のリストに追加, 1 = すべての添付をfileNameで置き換え, 2 = この添付を削除
attachmentID	テキスト	ID of attachment (HTML messages only)
戻り値	整数	エラーコード

説明

SMTP_Attachment コマンドは、MIMEフォーマットでテキストやバイナリファイルをメッセージに添付できるようにします。このコマンドは、一つのメールに複数のドキュメントを添付する際には複数回呼ばれます。0より大きな値がencodeType 引数に渡されると、このコマンドはメッセージの送信時にエンコードを実行します。

smtp_ID はSMTP_New コマンドで作成されるメッセージ参照です。

fileName はメッセージに添付するファイルを指定します。この値は以下三種の方法で指定できます:

""	= 標準のファイルを開くダイアログを表示する
"FileName"	= データベースストラクチャと同階層でファイルを検索する
"Path:FileName"	= ファイル名を含む完全なパス名

encodeType は、メッセージにファイルを含める際に適用するエンコーディングのタイプを指定する整数値です。添付ファイルがバイナリの場合、正しい変換がおこなわれるようエンコーディングメソッドを適用しなければなりません (BinHex, AppleSingle)。もっとも使用されるエンコーディングはBinHexです。

encodeTypeに正数を渡すと、コマンドはメッセージの送信時に自動でファイルをエンコードします。エンコーディングは SMTP_Send コマンドの実行時に行われます。ファイルのサイズが大きい場合、SMTP_Send コマンドの実行に時間がかかることになります。同じファイルを何度か送信する場合などは、IT_Encode コマンドでエンコーディングを行い、そのエンコード済みのファイルを encodeType に負数を渡して添付すると、時間を節約できます。encodeTypeに負数を渡すと、エンコーディングは行いませんが、メッセージヘッダに添付ファイルに関する正しいエンコーディング情報を設定します。受信者のメールアプリケーションはこの情報を使用して添付ファイルを解析する正しい方法を知ることができます。

Note: 配列要素を encodeType 引数に渡すことはできません。

deleteOption は添付をどのように扱うかを指定するオプションの整数引数です。0を指定すると、現在の添付リストに指定した添付ファイルを追加します。1を指定すると、すべての添付ファイルを添付ファイルfileNameで置き換えます。fileName が空の文字列の場合、すべての添付ファイルが取り除かれます。2を指定すると、添付リストからfileNameのみが取り除かれます。

0を指定すると、現在の添付リストに指定した添付ファイルを追加します。
1を指定すると、すべての添付ファイルを添付ファイルfileNameで置き換えます。fileName が空の文字列の場合、すべての添付ファイルが取り除かれます。
2を指定すると、添付リストからfileNameのみが取り除かれます。
この値が省略された場合、デフォルトで0の値が使用されます。

attachmentID 引数はHTML タグ <img src=\"cid:ID\">を使用して、添付ファイルをメッセージボディで定義された参照と関連付けます。これはファイルの中身(例えばピクチャなど)を、e-メールクライアントにおいてメッセージ内に表示することが出来るという事です。
この機能はHTMLでのメッセージにのみ対応しています。また、最終的な表示はe-メールクライアントによって異なる可能性があるという事に留意して下さい。

例題

ピクチャを含めたHTMLメッセージを送信する場合:

 $error:=SMTP_New($smtp_id)

 $error:=SMTP_Host($smtp_id;"smtp.gmail.com")

 $error:=SMTP_From($smtp_id;"henry@gmail.com")

 $error:=SMTP_ReplyTo($smtp_id;"replies@gmail.com")

 $error:=SMTP_Subject($smtp_id;"HTML Test  &  picture included")

 $error:=SMTP_To($smtp_id;"john@4d.com";1)

 $error:=SMTP_Body($smtp_id;"<html><B><I>Hello world in bold!</I></B> <img src=\"cid:myID123\">(normal text)</HTML>";4)

 $error:=SMTP_Attachment($smtp_id;"c:\\temp\\tulips.jpg";2;0;"myID123")

 $error:=SMTP_Auth($smtp_id;"henry@gmail.com";"*******")

 $error:=SMTP_Send($smtp_id;1)

 $error:=SMTP_Clear($smtp_id)