createMIMEEntity (NotesDocument - JavaScript)

初期化されていない最上位レベルの MIME エンティティを文書内に作成します。

定義場所

構文

createMIMEEntity() : NotesMIMEEntity

createMIMEEntity(itemName:string) : NotesMIMEEntity

パラメータ	説明
`itemName`	MIME エンティティを含むアイテムの名前です。デフォルトは `Body` です。

戻り値	説明
`NotesMIMEEntity`	新規 MIME エンティティ。

使用法

このメソッドで作成したアイテムの種類は MIME_PART です。

MIME エンティティを初期化するには、何らかのコンテンツを入力して、そのエンティティが含まれている文書を保存します。

「Body」という名前 (大文字/小文字の区別あり) が付いた MIME エンティティは、Domino® メールメッセージとして特別な扱いを受けます。特に、Content 以外のヘッダーが文書内のアイテムになります。 Body 以外のアイテム名を指定すると、そのアイテムが含まれている文書をメール送信することはできません。

XPage でのリッチテキストコントロールの型は、com.ibm.xsp.http.MimeMultipart です。その getHTML メソッドは、リッチテキストコントロールの内容を XML として取得します。この XML を setContentFromText で使用して、新しい NotesMIMEEntity オブジェクトを初期化することができます。

getContentAsText によって設定されたリッチテキストコントロールは、com.ibm.xsp.http.MimeMultipart オブジェクトとしてすぐにアクセス可能にはならないため、プログラムでアクセスしても null が返されます。最初に、ユーザーがこのコントロールを編集する必要があります。

例

このボタンは、文書を MIME 形式でメール送信します。send も参照してください。

var stream:NotesStream = session.createStream();
session.setConvertMime(false); // do not convert mime to rich text
var doc:NotesDocument = database.createDocument();
doc.appendItemValue("Form", "Memo");
var body:NotesMIMEEntity = doc.createMIMEEntity();
var header:NotesMIMEHeader = body.createHeader("Subject");
if (!header.setHeaderVal("MIME message")) {
	requestScope.status = "Cannot set header val for Subject";
	return;
}
header = body.createHeader("To");
if (!header.setHeaderVal(requestScope.query)) { // address of mail recipient
	requestScope.status = "Cannot set header val for To";
	return;
}
stream.writeText("This is the text of the message.");
body.setContentFromText(stream, "text/plain;charset=UTF-8", NotesMIMEEntity.ENC_NONE);
doc.send();
session.setConvertMime(true); // restore coversion

以下のボタンは、現在の XPage 上のコンテンツから文書を作成します。

var doc:NotesDocument = database.createDocument();
doc.replaceItemValue("Form", "main");
doc.replaceItemValue("subject", requestScope.subject);
if (requestScope.body != null) {
	//requestScope.body is bound to an inputRichText control
	var body:com.ibm.xsp.http.MimeMultipart = requestScope.body;
	var stream:NotesStream = session.createStream();
	stream.writeText(body.getHTML());
	var entity:NotesMIMEEntity = doc.createMIMEEntity("body");
	entity.setContentFromText(stream,"text/html;charset=UTF-8", 1725);
	stream.close();
} else {
	requestScope.status = "no content";
}
doc.save();

言語間の参照

LotusScript® NotesDocument クラスの CreateMIMEEntity メソッド

Java™ Document クラスの createMIMEEntity メソッド