読み書き可能。MIME マルチパートエンティティのプリアンブルです。
このプロパティは、Content-Type が multipart の場合に適用されます。それ以外の場合、このプロパティは空ストリングです。
IBM Domino® では、MIME アイテムのテキストの先頭にプリアンブルが組み込まれます。
マルチパートエンティティの親エンティティの場合、getContentAsText はプリアンブルを返します。
プリアンブルを設定すると、復帰や改行が自動的に追加され、明示的な末尾の復帰文字や改行文字が置き換えられます。
// Do not automatically convert MIME to rich text
session.setConvertMIME(false);
var mime:NotesMIMEEntity = currentDocument.getDocument().getMIMEEntity();
if (mime != null) {
// If multipart MIME entity
if (mime.getContentType().equals("multipart")) {
// Print preamble
if (!mime.getPreamble().equals("")) {
requestScope.status = "Preamble:¥t" + mime.getPreamble() + "¥n";
}
// Print content of each child entity
var child1:NotesMIMEEntity = mime.getFirstChildEntity();
while (child1 != null) {
requestScope.status +=
child1.getBoundaryStart() + child1.getContentAsText() +
child1.getBoundaryEnd() + "¥n";
var child2:NotesMIMEEntity = child1.getFirstChildEntity();
if (child2 == null) {
child2 = child1.getNextSibling();
if (child2 == null) {
child2 = child1.getParentEntity();
if (child2 != null) {
child2 = child2.getNextSibling();
}
}
}
child1 = child2;
}
}
// If not multipart, just print content
else {
requestScope.status = mime.getContentAsText();
}
} else {
requestScope.status = "Not MIME";
}
// Restore conversion
session.setConvertMIME(true);
var stream:NotesStream = session.createStream();
// Do not automatically convert MIME to rich text
session.setConvertMIME(false);
var doc:NotesDocument = database.createDocument();
// Create parent entity
doc.replaceItemValue("Form", "Memo");
var body:NotesMIMEEntity = doc.createMIMEEntity();
var header:NotesMIMEHeader = body.createHeader("Content-Type");
header.setHeaderVal("multipart/mixed");
header = body.createHeader("Subject");
header.setHeaderVal("MIME message");
header = body.createHeader("To");
header.setHeaderVal(requestScope.query);
// Create preamble
body.setPreamble("Preamble to multipart message.¥n");
// Create first child entity
var child:NotesMIMEEntity = body.createChildEntity();
stream.writeText("Text of message for child 1.¥n");
child.setContentFromText(stream, "text/plain", NotesMIMEEntity.ENC_NONE);
stream.truncate();
// Create second child entity
child = body.createChildEntity();
stream.writeText("Text of message for child 2.¥n");
child.setContentFromText(stream, "text/plain", NotesMIMEEntity.ENC_NONE);
doc.send(false);
// Restore conversion
session.setConvertMIME(true);