Documentation – Outlook 아이템 작업

Java: MSG 파일 만들기 및 저장

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email은 Outlook 메시지(MSG) 파일 생성을 지원합니다. 이 문서에서는 다음 방법을 설명합니다:

MSG 메시지를 생성합니다.
첨부 파일이 있는 MSG 메시지를 생성합니다.
RTF 본문을 가진 MSG 메시지를 생성합니다.
메시지를 초안으로 저장합니다.
본문 압축 작업.

Outlook 메시지 만들기 및 저장

다음은 MailMessage 클래스에는 저장 디스크 또는 스트림에 Outlook MSG 파일을 저장할 수 있는 메서드. 아래 코드 조각은 다음 클래스의 인스턴스를 생성합니다. MailMessage 클래스이며, from, to, subject 및 body와 같은 속성을 설정합니다. 해당 저장 메서드는 파일 이름을 인수로 받습니다. 또한 Outlook 메시지는 다음과 함께 생성될 수 있습니다. 압축된 RTF 본문 다음 사용 MapiConversionOptions.

새 인스턴스를 생성합니다 MailMessage 클래스이며 From, To, Subject 및 Body 속성을 설정합니다.
다음을 호출합니다. MapiMessage 클래스 fromMailMessage 객체를 받아들이는 메서드 MailMessage 형식. 해당 fromMailMessage 메서드는 변환합니다 MailMessage 으로 MapiMessage (MSG).
다음을 호출합니다. MapiMessage.save MSG 파일을 저장하는 메서드.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

// Create an instance of the MailMessage class
MailMessage mailMsg = new MailMessage();

// Set from, to, subject and body properties
mailMsg.setFrom(MailAddress.to_MailAddress("sender@domain.com"));
mailMsg.setTo(MailAddressCollection.to_MailAddressCollection("receiver@domain.com"));
mailMsg.setSubject("This is test message");
mailMsg.setBody("This is test body");

// Create an instance of the MapiMessage class and pass MailMessage as argument
MapiMessage outlookMsg = MapiMessage.fromMailMessage(mailMsg);

// Save the message (MSG) file
String strMsgFile = "CreatingAndSavingOutlookMessages_out.msg";
outlookMsg.save(dataDir + strMsgFile);

첨부 파일이 포함된 MSG 파일 만들기

위 예제에서, 우리는 간단한 MSG 파일을 만들었습니다. Aspose.Email은 첨부 파일이 포함된 메시지 파일 저장도 지원합니다. 필요한 것은 첨부 파일을 다음에 추가하는 것입니다. MailMessage 인스턴스. addItem 메서드를 호출하여 첨부 파일을 추가합니다. MailMessage.Attachments 컬렉션.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

String[] files = new String[2];
files[0] = "attachment.doc";
files[1] = "attachment.png";

// Create an instance of the MailMessage class
MailMessage mailMsg = new MailMessage();

// Set from, to, subject and body properties
mailMsg.setFrom(MailAddress.to_MailAddress("sender@domain.com"));
mailMsg.setTo(MailAddressCollection.to_MailAddressCollection("receiver@domain.com"));
mailMsg.setSubject("This is test message");
mailMsg.setBody("This is test body");

// Add the attachments
for (String strFileName : files)
{
    mailMsg.getAttachments().addItem(new Attachment(strFileName));
}

// Create an instance of MapiMessage class and pass MailMessage as argument
MapiMessage outlookMsg = MapiMessage.fromMailMessage(mailMsg);
String strMsgFile = "CreateMessagesWithAttachments.msg";
outlookMsg.save(dataDir + strMsgFile);

RTF 본문을 포함한 MSG 파일 만들기

Aspose.Email을 사용하면 서식이 풍부한 텍스트(RTF) 본문을 가진 Outlook 메시지(MSG) 파일도 만들 수 있습니다. RTF 본문은 텍스트 서식을 지원합니다. 이를 만들려면 다음을 설정하십시오. MailMessage.HtmlBody 속성. 변환할 때 MailMessage 인스턴스를 MapiMessage 인스턴스에서는 HTML 본문이 RTF로 변환됩니다. 이렇게 하면 이메일 본문의 서식이 보존됩니다.

다음 예제는 RTF 본문을 가진 MSG 파일을 생성합니다. HTML 본문에 하나의 헤딩과 굵게, 밑줄 서식이 적용되어 있습니다. 이 서식은 HTML이 RTF로 변환될 때 유지됩니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

// Create an instance of the MailMessage class
MailMessage mailMsg = new MailMessage();

// Set from, to, subject and body properties
mailMsg.setFrom(MailAddress.to_MailAddress("sender@domain.com"));
mailMsg.setTo(MailAddressCollection.to_MailAddressCollection("receiver@domain.com"));
mailMsg.setSubject("This is test message");
mailMsg.setHtmlBody("<h3>rtf example</h3><p>creating an <b><u>outlook message (msg)</u></b> file using Aspose.Email.</p>");

MapiMessage outlookMsg = MapiMessage.fromMailMessage(mailMsg);
outlookMsg.save(dataDir + "CreatingMSGFilesWithRTFBody_out.msg");

초안 상태로 메시지 저장

이메일은 작성 중이지만 나중에 계속 작업하려는 경우 초안으로 저장됩니다. Aspose.Email은 메시지 플래그를 설정하여 이메일 메시지를 초안 상태로 저장하는 것을 지원합니다. 아래는 Outlook 이메일 메시지(MSG)를 초안으로 저장하는 샘플 코드입니다.

초안 상태에서는 Outlook이 MapiMessage에 할당된 발신자 정보를 표시하지 않음을 유의하십시오. 발신자 정보를 표시하려면 MSGFLAG_READ 플래그를 설정해야 합니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

// Change properties of an existing MSG file
String strExistingMsg = "message.msg";

// Load the existing file in MailMessage and Change the properties
MailMessage msg = MailMessage.load(dataDir + strExistingMsg, new MsgLoadOptions());
msg.setSubject(msg.getSubject() + " NEW SUBJECT (updated by Aspose.Email)");
msg.setHtmlBody(msg.getHtmlBody() + " NEW BODY (udpated by Aspose.Email)");

// Create an instance of type MapiMessage from MailMessage, Set message flag to un-sent (draft status) and Save it
MapiMessage mapiMsg = MapiMessage.fromMailMessage(msg);
mapiMsg.setMessageFlags(MapiMessageFlags.MSGFLAG_UNSENT);
mapiMsg.save(dataDir + "SavingMessageInDraftStatus_out.msg");

본문 압축의 영향

RTF 본문 압축 방법을 사용하면 더 작은 크기의 MSG를 생성할 수 있습니다. 하지만 이 경우 생성 속도가 느려집니다. 속도를 개선하려면 플래그를 false 로 설정하십시오. 이 플래그는 생성된 PST에도 영향을 미칩니다: 작은 MSG 파일은 작은 PST를 만들고, 큰 MSG 파일은 PST 생성 속도를 늦춥니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String fileName = "outlook/test.msg";

MailMessage message = MailMessage.load(fileName);
MapiConversionOptions options = new MapiConversionOptions();
options.setUseBodyCompression(true);
MapiMessage ae_mapi = MapiMessage.fromMailMessage(message, options);

Java: MSG 파일 로드, 보기 및 구문 분석

Mon, 01 Jan 0001 00:00:00 +0000

이 항목에서는 Microsoft Outlook 메시지 파일 (*.msg)을 로드하는 방법을 설명합니다. MapiMessage 클래스는 MSG 파일을 로드하는데 사용되며 다양한 시나리오를 위한 여러 정적 로드 함수를 제공합니다. 다음 코드 스니펫은 파일 또는 스트림에서 MSG 파일을 로드하는 방법을 보여줍니다.

MSG 파일 로드

다음 코드 스니펫은 MSG 파일을 로드하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();

// Create an instance of MapiMessage from file
MapiMessage msg = MapiMessage.fromFile(dataDir + "message.msg");

// Get subject
System.out.println("Subject:" + msg.getSubject());

// Get from address
System.out.println("From:" + msg.getSenderEmailAddress());

// Get body
System.out.println("Body" + msg.getBody());

// Get recipients information
System.out.println("Recipient: " + msg.getRecipients());

// Get attachments
for (MapiAttachment att : msg.getAttachments())
{
    System.out.println("Attachment Name: " + att.getFileName());
    System.out.println("Attachment Display Name: " + att.getDisplayName());
}

다음 코드 예제는 MailMessage를 사용하여 MSG 형식의 메시지를 로드하는 방법을 보여줍니다.

MailMessage eml = MailMessage.load("message.msg");

결과 메시지는 임베디드 메시지 첨부 파일을 포함하여 EML 형식으로 변환됩니다. 원본 메시지의 특정 msg 형식 속성을 보존하려면 이 로드 방법을 사용하지 마십시오.

임베디드 메시지 첨부 파일의 원본 형식을 보존하려면 다음을 사용하십시오 MsgLoadOptions.PreserveEmbeddedMessageFormat 속성.

MsgLoadOptions msgLoadOptions = new MsgLoadOptions();
msgLoadOptions.setPreserveEmbeddedMessageFormat(true);
MailMessage msg = MailMessage.load(stream, msgLoadOptions);

스트림에서 로드

다음 코드 스니펫은 스트림에서 파일을 로드하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an instance of MapiMessage from file
try (FileInputStream stream = new FileInputStream(dataDir + "message.msg"))
{
    // Create an instance of MapiMessage from file
    MapiMessage msg = MapiMessage.fromStream(stream);

    // Get subject
    System.out.println("Subject:" + msg.getSubject());

    // Get from address
    System.out.println("From:" + msg.getSenderEmailAddress());

    // Get body
    System.out.println("Body" + msg.getBody());

}

임베디드 EML 형식을 보존하면서 EML을 MSG로 변환

EML 파일을 로드할 수 있습니다 MapiMessage 클래스를 인스턴스화하여 MailMessage 객체를 생성하고 이를 MapiMessage.fromMailMessage 메서드. EML 파일에 임베디드 EML 파일이 포함된 경우, 사용하십시오 MapiConversionOptions.setPreserveEmbeddedMessageFormat 임베디드 EML 파일의 형식을 유지합니다. 아래 코드 스니펫은 EML 파일을 로드하는 방법을 보여줍니다. MapiMessage 임베디드 EML 파일의 형식을 보존하면서.

사용해 보세요!

무료로 이메일 및 메시지 아카이브를 온라인에서 변환하세요 Aspose.Email 변환 앱.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String dataDir = RunExamples.getDataDir_Email();

MailMessage eml = MailMessage.load(dataDir + "sample.eml", new EmlLoadOptions());

MapiConversionOptions options = MapiConversionOptions.getUnicodeFormat();

//Preserve Embedded Message Format
options.setPreserveEmbeddedMessageFormat(true);

//Convert EML to MSG with Options
MapiMessage msg = MapiMessage.fromMailMessage(eml, options);

Java: Aspose.Email.Outlook을 사용한 메시지 파일 관리

Mon, 01 Jan 0001 00:00:00 +0000

MSG를 MIME 메시지로 변환

Aspose.Email API는 다음을 사용하여 MSG 파일을 MIME 메시지로 변환하는 기능을 제공합니다. toMailMessage 메서드.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
MapiMessage msg = new MapiMessage(
                            "sender@test.com",
                            "recipient1@test.com; recipient2@test.com",
                            "Test Subject",
                            "This is a body of message.");
MailConversionOptions options = new MailConversionOptions();
options.setConvertAsTnef(true);
MailMessage mail = msg.toMailMessage(options);

MSG를 EML로 변환하면서 RTF 본문 보존

API는 MSG를 EML로 변환하는 동안 RTF 본문을 보존하기 위한 다음 메서드를 제공합니다:

MsgLoadOptions.PreserveRtfContent - MailMessage에서 RTF 본문을 유지할지 여부를 나타내는 값을 가져오거나 설정합니다.
MailConversionOptions.PreserveRtfContent - MailMessage에서 RTF 본문을 유지할지 여부를 나타내는 값을 가져오거나 설정합니다.

다음 코드 샘플은 MailMessage에서 RTF 본문을 유지하는 방법을 보여줍니다:

사용하여 MsgLoadOptions.PreserveRtfContent

MsgLoadOptions options = new MsgLoadOptions();
options.setPreserveRtfContent(true);
MailMessage message = MailMessage.load("fileName", options);

사용하여 MailConversionOptions.PreserveRtfContent

MapiMessage mapi = MapiMessage.load("fileName");
MailConversionOptions options = new MailConversionOptions();
options.setPreserveRtfContent(true);
MailMessage message = mapi.toMailMessage(options);

카테고리 헤더를 보존하면서 MSG를 MHTML로 변환

Aspose.Email API는 메시지를 MHTML로 변환할 때 카테고리 헤더를 추가할 수 있는 기능을 제공합니다. 이 기능은 다음에 의해 지정됩니다. MhtSaveOptions MailMessage를 MHTML 형식으로 저장할 때 추가 옵션으로 사용되는 클래스.

다음 코드 샘플은 MapiMessage 객체에서 MHT(MHTML) 파일을 생성하고, MhtSaveOptions를 사용해 MHT 파일의 서식 및 헤더를 맞춤 설정하며, 이메일 메시지에 카테고리를 설정한 뒤 저장하기 전에 MHT 파일의 형식 템플릿과 렌더링 헤더를 수정하는 방법을 보여줍니다.

 MapiMessage msg = new MapiMessage("from@aaa.com", "to@aaa.com", "subj", "body");

msg.setCategories(new String[] { "Urgently", "Important" });

MhtSaveOptions saveOptions = new MhtSaveOptions();

saveOptions.getFormatTemplates().set_Item(MhtTemplateName.CATEGORIES,

    saveOptions.getFormatTemplates().get_Item(MhtTemplateName.CATEGORIES).replace("Categories", "Les catégories"));

saveOptions.getRenderingHeaders().add(MhtTemplateName.CATEGORIES);

msg.save("fileName.mhtml", saveOptions);

Outlook 템플릿 파일(.OFT) 읽기 및 쓰기

Outlook 템플릿은 유사한 이메일을 반복해서 보낼 때 매우 유용합니다. 매번 처음부터 메시지를 준비하는 대신, 먼저 Outlook에서 메시지를 작성하고 Outlook 템플릿(OFT)으로 저장합니다. 이후 메시지를 보내야 할 때마다 템플릿을 사용해 만들 수 있어 본문이나 제목에 동일한 텍스트를 작성하고 서식을 설정하는 데 드는 시간을 절약할 수 있습니다. Aspose.Email MailMessage 클래스를 사용하여 Outlook 템플릿(OFT) 파일을 로드하고 읽을 수 있습니다. Outlook 템플릿이 해당 인스턴스에 로드되면 MailMessage 클래스를 사용하면 발신자, 수신자, 본문, 제목 및 기타 속성을 업데이트할 수 있습니다. 속성을 업데이트한 후:

다음으로 이메일을 보냅니다 SmtpClient 클래스 또는
메시지를 MSG로 저장하고 Microsoft Outlook을 사용하여 추가 업데이트/검증을 수행합니다.

아래 코드 예시에서 우리는:

다음으로 템플릿을 로드합니다 MailMessage 클래스.
몇몇 속성을 업데이트합니다.
메시지를 MSG 형식으로 저장합니다.

다음 코드 스니펫은 OFT 파일을 로드하고, 메시지를 업데이트한 후 MSG 형식으로 저장하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

// Load the Outlook template (OFT) file in MailMessage's instance
MailMessage message = MailMessage.load(dataDir + "sample.oft", new MsgLoadOptions());

// Set the sender and recipients information
String senderDisplayName = "John";
String senderEmailAddress = "john@abc.com";
String recipientDisplayName = "William";
String recipientEmailAddress = "william@xzy.com";

message.setSender(new MailAddress(senderEmailAddress, senderDisplayName));
message.getTo().addMailAddress(new MailAddress(recipientEmailAddress, recipientDisplayName));
message.setHtmlBody(message.getHtmlBody().replace("DisplayName", "<b>" + recipientDisplayName + "</b>"));

// Set the name, location and time in email body
String meetingLocation = "<u>" + "Hall 1, Convention Center, New York, USA" + "</u>";
String meetingTime = "<u>" + "Monday, June 28, 2010" + "</u>";
message.setHtmlBody(message.getHtmlBody().replace("MeetingPlace", meetingLocation));
message.setHtmlBody(message.getHtmlBody().replace("MeetingTime", meetingTime));

// Save the message in MSG format and open in Office Outlook
MapiMessage mapimessage = MapiMessage.fromMailMessage(message);
mapimessage.setMessageFlags(MapiMessageFlags.MSGFLAG_UNSENT);
mapimessage.save(dataDir + "ReadAndWritingOutlookTemplateFile_out.msg");

Outlook MSG 파일을 템플릿으로 저장

다음 코드 스니펫은 Outlook MSG 파일을 템플릿으로 저장하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

try (MapiMessage mapi = new MapiMessage("test@from.to", "test@to.to", "template subject", "Template body")) {
    mapi.saveAsTemplate(dataDir + "mapiToOft.msg");
}

Outlook MSG 파일에 색상 카테고리 설정

색상 카테고리는 이메일 메시지에 특정 중요도나 범주를 표시합니다. Microsoft Outlook에서는 사용자가 색상 카테고리를 할당하여 이메일을 구분할 수 있습니다. 색상 카테고리를 처리하려면 다음을 사용하십시오 FollowUpManager. 다음과 같은 함수들을 포함합니다 addCategory, removeCategory, clearCategories 및 getCategories.

addCategory 받습니다 MapiMessage 그리고 색상 카테고리 문자열을 인수로 사용합니다. 예: "Purple Category" 또는 "Red Category".
removeCategory 받습니다 MapiMessage 그리고 메시지에서 제거할 색상 카테고리 문자열입니다.
clearCategories 메시지에서 모든 색상 카테고리를 제거하는 데 사용됩니다.
getCategories 특정 메시지에서 모든 색상 카테고리를 검색하는 데 사용됩니다.

다음 예제는 아래와 같이 작업을 수행합니다:

색상 카테고리를 추가합니다.
다른 색상 카테고리를 추가합니다.
모든 카테고리의 목록을 검색합니다.
모든 카테고리를 제거합니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage msg = MapiMessage.fromFile(dataDir + "message.msg");

// Add Two category
FollowUpManager.addCategory(msg, "Purple Category");
FollowUpManager.addCategory(msg, "Red Category");

// Retrieve the list of available categories
IList categories = FollowUpManager.getCategories(msg);

// Remove the specified category and then Clear all categories
FollowUpManager.removeCategory(msg, "Red Category");
FollowUpManager.clearCategories(msg);

MSG 파일에서 후속 정보 액세스

Aspose.Email API는 보낸 또는 받은 메시지에서 후속 정보를 액세스할 수 있는 기능을 제공합니다. 메시지 파일에서 읽음, 배달 영수증 및 투표 결과 정보를 검색할 수 있습니다.

읽음 및 배달 영수증 정보 가져오기

다음 코드 스니펫은 읽음 및 배달 영수증 정보를 검색하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage msg = MapiMessage.fromFile(dataDir + "message.msg");
for (MapiRecipient recipient : msg.getRecipients()) {
    System.out.println("Recipient: " + recipient.getDisplayName());

    // Get the PR_RECIPIENT_TRACKSTATUS_TIME_DELIVERY property
    System.out.println("Delivery time: " + recipient.getProperties().get_Item(MapiPropertyTag.PR_RECIPIENT_TRACKSTATUS_TIME_DELIVERY).getDateTime());

    // Get the PR_RECIPIENT_TRACKSTATUS_TIME_READ property
    System.out.println("Read time" + recipient.getProperties().get_Item(MapiPropertyTag.PR_RECIPIENT_TRACKSTATUS_TIME_READ).getDateTime());
}

전달 및 회신 메시지 만들기

Aspose.Email API는 전달 및 회신 메시지를 만들고 포맷팅하는 기능을 제공합니다. 해당 ReplyMessageBuilder 및 ForwardMessageBuilder API의 클래스는 각각 회신 및 전달 메시지를 만드는 데 사용됩니다. 회신 또는 전달 메시지는 다음 모드 중 任意 하나를 사용해 생성하도록 지정할 수 있습니다. OriginalMessageAdditionMode 열거형. 이 열거형은 다음 값을 가집니다:

OriginalMessageAdditionMode.None - 원본 메시지가 응답 메시지에 포함되지 않습니다.
OriginalMessageAdditionMode.Attachment - 원본 메시지가 응답 메시지에 첨부 파일로 포함됩니다
OriginalMessageAdditionMode.Textpart - 원본 메시지가 응답 메시지 본문에 텍스트로 포함됩니다

회신 메시지 만들기

다음 코드 조각은 회신 메시지를 만드는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage originalMsg = MapiMessage.fromFile(dataDir + "message1.msg");
ReplyMessageBuilder builder = new ReplyMessageBuilder();

// Set ReplyMessageBuilder Properties
builder.setReplyAll(true);
builder.setAdditionMode(OriginalMessageAdditionMode.Textpart);
builder.setResponseText(
        "<p><b>Dear Friend,</b></p> I want to do is introduce my co-author and co-teacher. <p><a href=\"www.google.com\">This is a first link</a></p><p><a href=\"www.google.com\">This is a second link</a></p>");

MapiMessage replyMsg = builder.buildResponse(originalMsg);
replyMsg.save(dataDir + "reply_out.msg");

전달 메시지 만들기

다음 코드 조각은 전달 메시지를 만드는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage originalMsg = MapiMessage.fromFile(dataDir + "message1.msg");
ForwardMessageBuilder builder = new ForwardMessageBuilder();
builder.setAdditionMode(OriginalMessageAdditionMode.Textpart);
MapiMessage forwardMsg = builder.buildResponse(originalMsg);
forwardMsg.save(dataDir + "forward_out.msg");

메시지 변환 시 빈 날짜 보존

MapiConversionOptions.setPreserveEmptyDates(boolean) 메시지를 변환할 때 빈 날짜를 유지해야 하는지를 나타내는 속성. 이 API는 Aspose.Email 21.5에 등장했습니다. 다음 코드 조각은 빈 날짜를 보존하는 방법을 보여줍니다.

MailMessage mailMessage = MailMessage.load("message.eml");
System.out.println(mailMessage.getDate()); // zero date
MapiConversionOptions mco = MapiConversionOptions.getUnicodeFormat();
// keep empty dates when converting a message
mco.setPreserveEmptyDates(true);
MapiMessage mapiMessage = MapiMessage.fromMailMessage(mailMessage, mco);
System.out.println(mapiMessage.getClientSubmitTime()); // zero date
// check zero date
if (mapiMessage.getClientSubmitTime().equals(JavaHelper.ZERO_DATE))
    System.out.println("ZERO DATE");

Java: MapiMessage를 사용한 투표 옵션 작업

Mon, 01 Jan 0001 00:00:00 +0000

MapiMessage를 사용한 투표 옵션 만들기

Microsoft Outlook은 새 메시지를 작성할 때 사용자가 설문을 만들 수 있게 합니다. Yes, No, Maybe 등과 같은 투표 옵션을 포함할 수 있습니다. Aspose.Email도 새로운 Outlook 메시지를 만들 때 동일한 기능을 제공합니다. FollowUpOptions class는 다음을 제공합니다 VotingButtons 투표 옵션 값을 설정하거나 가져오는 데 사용할 수 있는 속성입니다. 이 문서는 설문을 만드는 자세한 예제를 제공합니다. MapiMessage 설문 작성을 위한 투표 옵션과 함께.

MapiMessage를 사용한 설문 만들기

다음 코드 스니펏은 설문을 만드는 방법을 보여줍니다. FollowUpManager 클래스는 다음 코드 스니펏에 표시된 대로 사용할 수 있습니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String address = "firstname.lastname@aspose.com";
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
MailMessage message = createTestMessage(address);

// Set FollowUpOptions Buttons
FollowUpOptions options = new FollowUpOptions();
options.setVotingButtons("Yes;No;Maybe;Exactly!");
client.send(message, options);

MapiMessage에서 투표 옵션 읽기

다음 코드 스니펏은 다음에서 투표 옵션을 읽는 방법을 보여줍니다 MapiMessage.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String fileName = "outlook/message.msg";

MapiMessage message = MapiMessage.fromFile(fileName);

// This method can be useful when except voting buttons it is necessary to get other parameters (ex. a category)
FollowUpOptions options = FollowUpManager.getOptions(message);

// Voting buttons will be introduced as a string with semi-column as a separator
String votingButtons = options.getVotingButtons();

투표 버튼만 읽기

다음 코드 스니펏은 투표 버튼만 읽는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
InputStream ms = new FileInputStream(dataDir + "MapiMsgWithPoll_out.msg");
MapiMessage testMsg = MapiMessage.fromStream(ms);

// This method can be useful when it is necessary to read only voting buttons
// Voting buttons will be introduced as a collection of string values
IList buttons = FollowUpManager.getVotingButtons(testMsg);

기존 메시지에 투표 버튼 추가

다음 코드 스니펏은 기존 메시지에 투표 버튼을 추가하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage mapi = MapiMessage.fromFile(dataDir + "message.msg");
FollowUpManager.addVotingButton(mapi, "Indeed!");
mapi.save(dataDir + "AddVotingButtonToExistingMessage_out.msg");

메시지에서 투표 버튼 삭제

다음 코드 스니펏은 메시지에서 투표 버튼을 삭제하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

// Create New Message and set FollowUpOptions, FollowUpManager properties
MapiMessage msg = createTestMessage(false);

FollowUpOptions options = new FollowUpOptions();
options.setVotingButtons("Yes;No;Maybe;Exactly!");
FollowUpManager.setOptions(msg, options);
msg.save(dataDir + "MapiMsgWithPoll.msg");
FollowUpManager.removeVotingButton(msg, "Exactly!"); // Deleting a single button OR
FollowUpManager.clearVotingButtons(msg); // Deleting all buttons from a MapiMessage
msg.save(dataDir + "MapiMsgWithPoll.msg");

투표 결과 정보 읽기

다음 코드 스니펏은 투표 결과 정보를 읽는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage msg = MapiMessage.fromFile(dataDir + "AddVotingButtonToExistingMessage.msg");
for (MapiRecipient recipient : msg.getRecipients()) {
    System.out.println("Recipient: " + recipient.getDisplayName());

    // Get the PR_RECIPIENT_AUTORESPONSE_PROP_RESPONSE property
    System.out.println("Response: " + recipient.getProperties().get_Item(MapiPropertyTag.PR_RECIPIENT_AUTORESPONSE_PROP_RESPONSE).getString());

    // Get the PR_RECIPIENT_TRACKSTATUS_TIME property
    System.out.println("Response time: " + recipient.getProperties().get_Item(MapiPropertyTag.PR_RECIPIENT_TRACKSTATUS_TIME).getDateTime());

    System.out.println();
}

예제에서 사용된 샘플 메서드

다음 코드 스니펫은 예제에서 사용되는 샘플 메시지를 만드는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static MapiMessage createTestMessage(boolean draft) {
    MapiMessage msg = new MapiMessage("from@test.com", "to@test.com", "Flagged message",
            "Make it nice and short, but descriptive. The description may appear in search engines' search results pages...");

    if (!draft) {
        msg.setMessageFlags(msg.getFlags() ^ MapiMessageFlags.MSGFLAG_UNSENT);
    }
    return msg;
}

Java: Outlook 메시지 파일 구문 분석

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for Java를 사용하면 개발자는 Outlook 메시지 파일을 로드하고 내용을 구문 분석할 수 있습니다.

디스크에서 MSG 파일을 로드하려면 다음을 사용하십시오 MapiMessage 클래스 정적 Load 메서드.
MSG 파일 내용을 구문 분석하려면 MapiMessage 여러 메서드를 제공합니다.

이 항목에서는 MSG 파일을 로드하고 구문 분석하여 내용을 표시하는 방법을 보여줍니다.

Aspose.Email for Java는 MapiMessage MSG 파일을 열고 구문 분석하는 데 사용되는 클래스입니다. MSG 파일에 수신자가 다수 있을 수 있으므로 MapiMessage 클래스는 다음을 노출합니다 getRecipients() 반환하는 메서드 MapiRecipientCollection 컬렉션을 나타내는 MapiRecipient 객체. MapiRecipient 객체는 수신자 속성을 처리하기 위한 추가 메서드를 제공합니다.

다음 단계 순서가 이 목적을 수행합니다:

다음의 인스턴스를 생성합니다. MapiMessage 클래스를 사용하여 MSG 파일을 로드합니다 Load 정적 메서드.
MSG 파일에서 발신자 이름, 제목 및 본문을 표시하려면 다음을 사용합니다 getSenderName(), getSubject() 및 getBody() 메서드들.
다음을 호출합니다. getRecipients() 에 의해 노출된 메서드 MapiRecipient 컬렉션에 대한 참조를 얻기 위한 클래스 MapiRecipient MSG 파일과 연관된 객체들.
반복합니다 MapiRecipientCollection 각 항목의 내용을 표시하기 위한 컬렉션 MapiRecipient 객체를 공개 메서드를 통해 사용합니다.

// The path to the resource directory.
String dataDir = Utils.getSharedDataDir(ParsingOutlookMessageFiles.class) + "outlook/";

//Instantiate an MSG file to load an MSG file from disk
MapiMessage outlookMessageFile = MapiMessage.fromFile(dataDir + "message.msg");
//Display sender's name
System.out.println("Sender Name : " + outlookMessageFile.getSenderName());
//Display Subject
System.out.println("Subject : " + outlookMessageFile.getSubject());
//Display Body
System.out.println("Body : " + outlookMessageFile.getBody());
//Display Recipient's info
System.out.println("Recipients : \n");

//Loop through the recipients collection associated with the MapiMessage object
for (int i = 0; i < outlookMessageFile.getRecipients().size(); i++) {
	//Set a reference to the MapiRecipient object
	MapiRecipient rcp = (MapiRecipient) outlookMessageFile.getRecipients().get_Item(i);
	//Display recipient email address
	System.out.println("Email : " + rcp.getEmailAddress());
	//Display recipient name
	System.out.println("Name : " + rcp.getDisplayName());
	//Display recipient type
	System.out.println("Recipient Type : " + rcp.getRecipientType());
}

사용해 보세요!

무료로 이메일 파일을 온라인에서 구문 분석하세요 Aspose.Email 파서 앱.

MAPI 메시지의 항목 유형 가져오기

Aspose.Email은 MapiItemType 항목 유형을 나타내는 열거형입니다. 이는 해당 클래스에서 파생된 객체로 메시지를 변환하는 데 사용할 수 있습니다. IMapiMessageItem 인터페이스. 이는 메시지 변환 전에 사용자가 MessageClass 속성 값을 확인하는 것을 방지합니다.

다음 코드 샘플은 폴더 내 메시지를 반복하면서 각 MAPI 메시지를 해당 메시지 유형에 따라 적절한 MAPI 항목 유형으로 변환하는 방법을 보여줍니다:

for (MessageInfo messageInfo : folder.enumerateMessages()) {
    MapiMessage msg = pst.extractMessage(messageInfo);

    switch (msg.getSupportedType()) {
        // Non-supported type. MapiMessage cannot be converted to an appropriate item type.
        // Just use in MSG format.
        case MapiItemType.None:
            break;
        // An email message. Conversion isn't required.
        case MapiItemType.Message:
            break;
        // A contact item. Can be converted to MapiContact.
        case MapiItemType.Contact:
            MapiContact contact = (MapiContact) msg.toMapiMessageItem();
            break;
        // A calendar item. Can be converted to MapiCalendar.
        case MapiItemType.Calendar:
            MapiCalendar calendar = (MapiCalendar) msg.toMapiMessageItem();
            break;
        // A distribution list. Can be converted to MapiDistributionList.
        case MapiItemType.DistList:
            MapiDistributionList dl = (MapiDistributionList) msg.toMapiMessageItem();
            break;
        // A Journal entry. Can be converted to MapiJournal.
        case MapiItemType.Journal:
            MapiJournal journal = (MapiJournal) msg.toMapiMessageItem();
            break;
        // A StickyNote. Can be converted to MapiNote.
        case MapiItemType.Note:
            MapiNote note = (MapiNote) msg.toMapiMessageItem();
            break;
        // A Task item. Can be converted to MapiTask.
        case MapiItemType.Task:
            MapiTask task = (MapiTask) msg.toMapiMessageItem();
            break;
    }
}

Java: Outlook MSG 파일의 Follow Up 및 마감일 작업

Mon, 01 Jan 0001 00:00:00 +0000

Outlook MSG 파일에 대한 팔로업 및 기한 설정

팔로업 플래그는 이메일 메시지를 특정 작업을 위해 표시합니다. Microsoft Outlook은 사용자가 메시지에 플래그를 지정하고, 플래그 설정에서 팔로업 기한을 할당할 수 있게 합니다. Microsoft Outlook은 수신자에게 이메일을 팔로업하도록 알림을 보냅니다. 이메일에 플래그를 지정하고 기한을 프로그래밍 방식으로 설정하면 소프트웨어 개발자가 특정 유형의 이메일을 자동화하고 수신자가 조치를 기억하도록 도울 수 있습니다. 예를 들어, 영업 팀에 월별 메시지를 보내 보고서 작성을 상기시키거나, 모든 직원에게 회사 회의를 알리는 메시지를 보낼 수 있습니다. Aspose.Email for Java는 팔로업 플래그와 기한 설정을 지원합니다. MapiMessage 객체 사용 FollowUpManager 및 FollowUpOptions. 메시지에 팔로업 플래그를 설정할 수 있는 여러 변형이 있습니다. 아래 코드 샘플에서 모두 사용됩니다:

메시지에 팔로업 플래그를 설정합니다.
메시지에 기한 및 알림 날짜를 추가합니다.
수신자의 메시지에 플래그를 추가합니다.
완료로 표시.
플래그 제거.
Follow-up 옵션을 읽습니다.

FollowUp 플래그 설정

다음 코드 스니펫은 Follow-up 플래그를 설정하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MailMessage mailMsg = new MailMessage();
mailMsg.setSender(new MailAddress("AETest12@gmail.com"));
mailMsg.getTo().addMailAddress(new MailAddress("receiver@gmail.com"));
mailMsg.setBody("This message will test if follow up options can be added to a new mapi message.");
MapiMessage mapi = MapiMessage.fromMailMessage(mailMsg);

Calendar calendar = Calendar.getInstance();
calendar.set(2013, Calendar.MAY, 23, 14, 40, 0);
Date dtStartDate = calendar.getTime();

calendar.set(2013, Calendar.MAY, 23, 16, 40, 0);
Date dtReminderDate = calendar.getTime();

calendar.add(Calendar.DATE, 1);
Date dtDueDate = calendar.getTime();

FollowUpOptions options = new FollowUpOptions("Follow Up", dtStartDate, dtDueDate, dtReminderDate);
FollowUpManager.setOptions(mapi, options);
mapi.save(dataDir + "SetFollowUpflag_out.msg");

수신자에 대한 Follow Up 설정

다음 코드 스니펫은 수신자에게 Follow-up를 설정하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MailMessage mailMsg = new MailMessage();
mailMsg.setSender(new MailAddress("AETest12@gmail.com"));
mailMsg.getTo().addMailAddress(new MailAddress("receiver@gmail.com"));
mailMsg.setBody("This message will test if follow up options can be added to a new mapi message.");

MapiMessage mapi = MapiMessage.fromMailMessage(mailMsg);
mapi.setMessageFlags(MapiMessageFlags.MSGFLAG_UNSENT); // mark this message as draft

Calendar calendar = Calendar.getInstance();
calendar.set(2013, Calendar.MAY, 23, 16, 40, 0);
Date dtReminderDate = calendar.getTime();

// Add the follow up flag for recipient now
FollowUpManager.setFlagForRecipients(mapi, "Follow up", dtReminderDate);
mapi.save(dataDir + "SetFollowUpForRecipients_out.msg");

FollowUp 플래그를 완료로 표시

다음 코드 스니펫은 Follow-up 플래그를 완료된 것으로 표시하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage mapi = MapiMessage.fromFile(dataDir + "message.msg");
FollowUpManager.markAsCompleted(mapi);
mapi.save(dataDir + "MarkedCompleted_out.msg");

FollowUp 플래그 제거

다음 코드 스니펫은 Follow-up 플래그를 제거하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage mapi = MapiMessage.fromFile(dataDir + "message.msg");
FollowUpManager.clearFlag(mapi);
mapi.save(dataDir + "FollowUpFlagRemoved_out.msg");

메시지의 Follow-up 플래그 옵션 읽기

다음 코드 스니펫은 메시지의 Follow-up 플래그 옵션을 읽는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage mapi = MapiMessage.fromFile(dataDir + "message.msg");
FollowUpOptions options = FollowUpManager.getOptions(mapi);

Java: MAPI 속성 작업

Mon, 01 Jan 0001 00:00:00 +0000

Outlook MAPI 속성 설정 및 액세스

Aspose.Email for Java는 MapiProperty MAPI 속성을 나타내는 클래스:

Name: 속성 이름.
Tag: 속성 태그.
Data: 속성 데이터.

이 주제에서는 Aspose.Email for Java를 사용하여 Outlook Message (MSG) 파일의 MAPI 속성을 설정하고 액세스하는 방법을 설명합니다. 또한 MSG와 첨부 파일에서 속성을 제거하는 방법에 대한 샘플 코드가 제공됩니다.

속성 읽기

MSG 파일에서 MAPI 속성 데이터를 읽으려면:

다음의 인스턴스를 생성합니다. MapiMessage 클래스는 다음을 사용하여 MSG 파일을 로드합니다 Load() 정적 메서드.
참조를 설정합니다 MapiMessage 객체 getProperties() 메서드로 가져옵니다 MapiPropertyCollection.
가져오기 MapiProperty 객체 MapiPropertyCollection 에 의해 MapiPropertyTag 키.
적절한 getXXX() 메서드를 사용하여 속성 데이터를 가져옵니다.

추가 속성 설정

다음 코드 샘플은 Outlook의 추가 속성을 설정하는 데 사용할 수 있습니다 MapiMessage.

속성 제거

이메일 메시지에서 명명된 Mapi 속성 읽기

Microsoft Outlook은 MSG 파일에 명명된 MAPI 속성을 추가하는 것을 지원합니다. 이러한 속성은 사용자가 추가합니다. 개발자는 Aspose.Email을 사용하여 예를 들어 “MyProp”과 같은 명명된 속성을 MSG 파일에 추가할 수 있습니다.

이 문서는 Aspose.Email을 설명합니다 MapiMessage getNamedProperties() MSG 파일에서 명명된 MAPI 속성을 읽기 위한 컬렉션.

명명된 MAPI 속성 읽기

첨부 파일에서 명명된 Mapi 속성 읽기

Java: 메시지 첨부 파일 작업

Mon, 01 Jan 0001 00:00:00 +0000

첨부 파일 파싱 및 저장

Outlook 메시지 파일에는 하나 이상 첨부 파일이 포함될 수 있습니다. Aspose.Email을 사용하면 개발자가 MSG 파일의 첨부 파일을 순회하여 디스크에 저장할 수 있습니다. 이 항목에서는 그 과정을 설명하고 첨부 파일을 삽입하는 방법도 다룹니다.

Aspose.Email MapiMessage 클래스는 디스크에서 MSG 파일을 로드하고 다음을 노출합니다. getAttachments() 참조하는 메서드 MapiAttachment MSG 파일과 연관된 객체 컬렉션. 해당 MapiAttachment 객체는 첨부 파일에 대한 작업을 수행하는 메서드를 추가로 제공합니다.

원본 이름과 확장자를 유지하여 MSG 파일의 첨부 파일을 디스크에 저장하려면:

다음의 인스턴스를 생성합니다. MapiMessage 클래스는 다음을 사용하여 MSG 파일을 로드합니다 Load() 정적 메서드.
다음을 호출합니다. MapiRecipient 클래스 getAttachments() 컬렉션에 대한 참조를 얻는 메서드 MapiAttachment MSG 파일과 연관된 객체들.
반복합니다 MapiAttachmentCollection 각 항목에 대한 내용을 표시하려면 MapiAttachment 객체를 공개 메서드를 통해 사용합니다.
다음을 호출합니다. MapiAttachment 클래스 save() 첨부 파일을 디스크에 저장하는 메서드.

첨부 파일로 메시지 삽입

Microsoft Outlook 메시지는 첨부 파일로 다른 Outlook 메시지를 일반 메시지(위에 설명) 또는 삽입된 메시지 형태로 포함할 수 있습니다. 해당 MapiAttachmentCollection add 메서드의 오버로드된 멤버를 제공하여 두 종류의 첨부 파일이 있는 Outlook 메시지를 생성합니다. MSG 파일에 삽입된 Outlook MSG 파일은 값이 5인 PR_ATTACH_METHOD를 포함합니다.

첨부 파일에서 삽입된 메시지 읽기

첨부 파일 MSG 삽입 및 교체

Aspose.Email API는 부모 메시지의 특정 인덱스에 첨부 파일을 삽입할 수 있는 기능을 제공합니다. 또한 한 첨부 파일의 내용을 다른 메시지 첨부 파일로 교체하는 기능도 제공합니다.

특정 위치에 MSG 첨부 파일 삽입

Aspose.Email API는 부모 MSG에 MSG 첨부 파일을 삽입하는 기능을 제공합니다. MapiAttachmentCollection.Insert() 메서드.

삽입된 MSG 첨부 파일 내용 교체

이를 사용하여 삽입된 첨부 파일 내용을 새로운 것으로 교체할 수 있습니다. 교체 메서드입니다. 그러나 collection.Count = 2인 컬렉션에 PR_ATTACH_NUM = 4(예)와 같은 첨부 파일을 삽입하는 데는 사용할 수 없습니다.

디지털 서명된 메시지에서 첨부 파일 저장

Aspose.Email API는 클리어 서명된 메시지를 디코딩할지 여부를 나타내는 값을 가져오거나 설정하는 기능을 제공합니다.

MapiMessage에서 첨부 파일 이름 바꾸기

Aspose.Email을 사용하면 다음을 편집할 수 있습니다 표시 이름 속성 값 MapiMessage 첨부 파일.

다음 코드 샘플은 로드된 Mapi 메시지에서 첫 번째와 두 번째 첨부 파일의 표시 이름을 업데이트하는 방법을 보여줍니다.

MapiMessage msg = MapiMessage.load(fileName);
msg.getAttachments().get_Item(0).setDisplayName("New display name 1");
msg.getAttachments().get_Item(1).setDisplayName("New display name 2");

첨부 파일이 인라인인지 일반인지 확인

인라인 첨부 파일과 일반 첨부 파일의 차이는 이메일 내에서 표시되는 방식입니다. 인라인 첨부 파일은 이메일 본문에 삽입되어 별도의 파일을 열거나 다운로드하지 않아도 볼 수 있습니다. 반면 일반 첨부 파일은 이메일에 첨부된 별도의 파일이며 본문에 직접 표시되지 않아 다운로드 후 외부에서 열어야 합니다. 해당 MapiAttachment.IsInline 속성 MapiAttachment 클래스는 첨부 파일이 인라인인지 일반인지 나타내는 값을 가져옵니다.

다음 코드 샘플은 파일에서 이메일 메시지를 로드한 뒤 첨부 파일 정보를 가져옵니다. 특히 각 첨부 파일의 표시 이름과 메시지 내에 인라인인지 여부를 출력합니다.

MapiMessage message = MapiMessage.load("fileName");

for (MapiAttachment attach : message.getAttachments()) {
    System.out.println(attach.getDisplayName() + ": " + attach.isInline());
}

Java: Outlook 연락처 작업

Mon, 01 Jan 0001 00:00:00 +0000

Outlook 연락처 만들기

Aspose.Email for Java는 Outlook 연락처(VCards)를 생성하는 것을 지원합니다 MapiContact 클래스. MapiContact 많은 메서드가 포함되어 있으며, 그 중 일부는 아래에 나와 있습니다.

MapiContactElectronicAddressPropertySet 다음과 같은 집합을 포함합니다 MapiContactElectronicAddress.
MapiContactEventPropertySet
MapiContactNamePropertySet
MapiContactPersonalInfoPropertySet
MapiContactPhysicalAddressPropertySet 다음과 같은 집합을 포함합니다 MapiContactPhysicalAddress.
MapiContactProfessionalPropertySet
MapiContactTelephonePropertySet

Aspose.Email for Java의 연락처 구조

아래는 Aspose.Email for Java에서 연락처에 대해 구현된 계층 구조입니다. 각 속성 옆에 해당 클래스 이름이 표시되어 있습니다. 자세한 참고를 위해 온라인 문서에 대한 하이퍼링크가 제공됩니다.

Contact (MapiContact)
1. 전자 주소 (MapiContactElectronicAddressPropertySet)
  1. 이메일1 (MapiContactElectronicAddress)
    1. 주소 유형
    2. 표시 이름
    3. 이메일 주소
    4. 팩스 번호
  2. 이메일2
  3. 이메일3
  4. 집 팩스
  5. 주 팩스
  6. 업무 팩스
2. 이벤트 (MapiContactEventPropertySet) 이벤트 설정 예시는 아래를 참조하십시오.
  1. 생일
  2. 결혼 기념일
3. 이름 정보 (MapiContactNamePropertySet)
  1. 표시 이름
  2. 표시 이름 접두사
  3. 파일 아래
  4. 파일 아래 ID
  5. 세대
  6. 이름
  7. 이니셜
  8. 중간 이름
  9. 별명
  10. 성
4. 개인 정보 (MapiContactPersonalInfoPropertySet)
  1. 계정
  2. 비즈니스 홈페이지
  3. 컴퓨터 네트워크 이름
  4. 고객 ID
  5. 무료 사업 위치
  6. FTP 사이트
  7. 성별
  8. 정부 ID 번호
  9. 취미
  10. HTML
  11. 인스턴트 메신저 주소
  12. 언어
  13. 위치
  14. 메모
  15. 조직 ID 번호
  16. 개인 홈페이지
  17. 소개자 이름
  18. 배우자 이름
5. 실제 주소 (MapiContactPhysicalAddressPropertySet)
  1. 집 주소 (MapiContactPhysicalAddress)
    1. 주소
    2. 도시
    3. 국가
    4. 국가 코드
    5. 우편 번호
    6. 우편함
    7. 주 또는 지방
  2. 기타 주소
  3. 근무지 주소
6. 전문 정보
  1. 보조
  2. 회사 이름
  3. 부서 이름
  4. 관리자 이름
  5. 사무실 위치
  6. 직업
  7. 직함
7. 전화 번호 (MapiContactTelephonePropertySet)
  1. 보조 전화 번호
  2. 업무2 전화 번호
  3. 업무 전화 번호
  4. 콜백 전화 번호
  5. 차량 전화 번호
  6. 회사 주요 전화 번호
  7. 집2 전화 번호
  8. 집 전화 번호
  9. ISDN 번호
  10. 휴대전화 번호
  11. 기타 전화 번호
  12. 호출기 전화 번호
  13. 주 전화 번호
  14. 라디오 전화 번호
  15. 전신 번호
  16. TTY/TDD 전화 번호

다음 코드는 Aspose.Email을 사용하여 Outlook 연락처를 생성하고 이름, 직업 관련 속성, 실제 주소 및 이메일로 채웁니다. 또한 추가하는 방법을 보여줍니다. MapiContactEventPropertySet 연락처에.

|| | :- | |Figure: Aspose.Email으로 코딩된 Microsoft Outlook 연락처|

MapiContact에 연락처 이벤트 정보 추가

Microsoft Outlook은 사용자가 연락처에 이벤트 정보를 추가할 수 있게 합니다. 이 이벤트는 생일 및 결혼 기념일을 포함합니다. Aspose.Email는 MapiContactEventPropertySet 연락처에 이 정보를 추가하기 위한 클래스입니다. 다음 예제에서 자세히 설명합니다.

Outlook 연락처 생성, 저장 및 읽기

Aspose.Email는 개발자가 Microsoft Outlook 연락처 및 이메일 메시지를 생성할 수 있도록 합니다. MapiContact 클래스는 Outlook 연락처를 만들기 위해 필요한 모든 연락처 속성을 제공합니다. 이 문서에서는 해당 클래스를 사용하여 Outlook 연락처를 생성, 저장 및 읽는 방법을 보여줍니다. MapiContact 클래스.

MapiContact 생성 및 저장

다음 단계는 연락처를 생성하고 디스크에 저장하는 데 사용할 수 있습니다:

새 객체를 인스턴스화합니다 MapiContact 클래스.
연락처의 다양한 속성과 관련된 정보를 입력합니다.
연락처에 사진 데이터를 추가합니다(있는 경우).
연락처를 MSG 또는 VCard 형식으로 저장합니다.

버전 3 VCF 형식으로 연락처 저장

연락처를 버전 3 VCF 형식으로 저장하려면 다음을 사용하십시오 VCardVersion 값을 설정하기 위한 열거형 VCardSaveOptions.Version 속성. 다음 샘플 코드는 사용 방법을 보여줍니다. VCardVersion 연락처를 VCF 버전 3 형식으로 저장하기 위한 열거형.

MapiContact 읽기

다음은 MapiContact 클래스를 사용하면 Microsoft Outlook MSG 파일과 VCard 형식 연락처를 모두 로드할 수 있습니다. 다음 코드 샘플은 MSG 및 VCF 형식으로 저장된 Outlook 연락처를 로드하는 방법을 보여줍니다. MapiContact.

MSG에서 연락처 로드

VCard에서 연락처 로드

다음 코드는 다음을 생성하는 방법을 보여줍니다 MapiContact VCard 파일에서 데이터를 로드하여 VCardLoadOptions:

MapiContact mapiContact = MapiContact.fromVCard("contact.vcf", new VCardLoadOptions());
System.out.println(mapiContact.getNameInfo().getDisplayName());

지정된 인코딩으로 VCard 연락처 로드

지원되는 메서드: MapiContact.fromVCard(String, Encoding)

연락처 정보를 MHTML로 렌더링

Outlook 연락처는 Aspose.Email API를 사용해 MHTML로 변환할 수 있습니다. 이 예제는 VCard를 로드하는 방법을 보여줍니다 MapiContact 그런 다음 다음을 사용하여 MHTML로 변환합니다 MailMessage API.

Java: Outlook 작업 다루기

Mon, 01 Jan 0001 00:00:00 +0000

Outlook 작업 생성, 저장 및 읽기

Aspose.Email for Java를 사용하면 개발자가 Outlook 작업을 생성하고 MSG 형식으로 저장할 수 있습니다. 해당 MapiTask 클래스는 다음과 같은 여러 속성을 제공합니다 PercentComplete, EstimatedEffort, ActualEffort, History, LastUpdate, 등, Outlook 작업에 필요한 정보를 설정하고 수용합니다. 이 문서는 를 생성, 저장 및 읽는 방법을 보여줍니다 MapiTask 디스크에서.

MapiTask 생성 및 저장

다음 단계는 작업을 생성하고 디스크에 저장하는 데 사용할 수 있습니다.

새 객체를 인스턴스화합니다 MapiTask 클래스.
작업의 다양한 속성에 대한 정보를 입력합니다.
작업을 MSG 형식으로 디스크에 저장합니다.

MapiTask 읽기

다음은 MapiTask 클래스 객체는 다음을 변환하는데 사용됩니다 MapiMessage 디스크에서 MSG 형식으로 작업을 로드하는 객체.

VToDo 작업 읽기

iCalendar 형식으로 VToDo 이벤트로 내보낸 Google Tasks는 다음을 사용하여 로드할 수 있습니다. MapiTask 다음 코드 샘플에 표시된 클래스.

MapiTask에 알림 정보 추가

Microsoft Outlook과 유사하게, Aspose.Email은 작업에 알림 정보를 추가할 수 있습니다. MapiTask. 다음 코드 스니펏은 작업에 알림 정보를 추가하는 방법을 보여줍니다. MapiTask.

MapiTask에 첨부 파일 추가

다음 코드 스니펏은 작업에 첨부 파일을 추가하는 방법을 보여줍니다. MapiTask.

Outlook 작업을 MHT로 변환

Aspose.Email은 생성할 수 있습니다 MapiMessage 변환 중 출력과 같이 MapiTask MHT로.

Java: Outlook 메모 작업

Mon, 01 Jan 0001 00:00:00 +0000

Outlook 메모 생성, 저장 및 읽기

Aspose.Email는 Outlook 메모를 생성하고 MSG 형식으로 디스크에 저장하는 기능을 제공합니다. MapiNote 클래스는 메모에 필요한 정보를 설정하기 위한 속성과 메서드를 제공합니다. 이 문서는 메모를 생성, 저장 및 읽는 방법을 보여줍니다. MapiNote 디스크에서

Outlook 메모 생성 및 저장

다음 단계는 메모를 생성하고 디스크에 저장하는 데 사용할 수 있습니다.

다음 객체를 인스턴스화합니다 MapiNote 클래스.
원하는대로 다양한 속성을 설정합니다.
메모를 MSG 파일로 디스크에 저장합니다.

MapiNote 읽기

다음은 MapiNote 클래스 객체는 다음을 변환하는데 사용됩니다 MapiMessage 디스크에서 MSG 형식으로 메모를 로드하는 객체.

Java: 디지털 서명된 메시지 관리

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email은 전체 S/MIME 이메일 객체 알고리즘을 구현합니다. 이를 통해 API는 이메일 메시지에 디지털 서명을 추가하고, 형식 변환 시 서명을 보존하거나 제거하는 등 완전한 기능을 제공합니다.

이메일에 서명 첨부

다음은 SecureEmailManager.attachSignature 메서드를 사용하면 이메일 메시지에 디지털 서명을 첨부할 수 있습니다. 서명을 첨부한 후에는 다음과 같은 속성을 통해 결과를 확인합니다 IsSigned, MessageClass그리고 첨부 파일 세부 정보를 포함합니다.

MailMessage 또는 MapiMessage, 개인 인증서 및 서명 옵션을 제공하여 서명 첨부 프로세스를 사용자 지정할 수 있습니다 SignatureOptions 서명 첨부 시 분리형 또는 비분리형 서명을 포함한 다양한 옵션을 지정할 수 있게 해주는 클래스.

다음 코드 샘플은 파일에서 메시지를 로드하고, 개인 인증서를 사용해 분리형 및 비분리형 디지털 서명을 첨부한 뒤, 서명이 성공적으로 첨부되었는지 확인하는 방법을 보여줍니다.

String fileName = "message.msg";
String privateCertFile = "certFile.pfx";
X509Certificate2 privateCert = new X509Certificate2(privateCertFile, "password");

MapiMessage msg = MapiMessage.load(fileName);

SignatureOptions opt = new SignatureOptions();
opt.setDetached(true);
MapiMessage signedDetached = new SecureEmailManager().attachSignature(msg, privateCert, opt);

if (signedDetached.isSigned()) {
    System.out.println("Detached Signature Attached Successfully.");
}

opt.setDetached(false);
MapiMessage signedNonDetached = new SecureEmailManager().attachSignature(msg, privateCert, opt);

if (signedNonDetached.isSigned()) {
    System.out.println("Non-Detached Signature Attached Successfully.");
}

EML을 MSG로 변환할 때 서명 보존

Aspose.Email은 EML을 MSG로 변환할 때 디지털 서명을 보존합니다. 다음 코드 스니펫은 EML을 MSG로 변환하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

// Load mail message
MailMessage message = MailMessage.load(dataDir + "Message.eml", new EmlLoadOptions());
// Save as MSG
message.save(dataDir + "ConvertEMLToMSG_out.msg", SaveOptions.getDefaultMsgUnicode());

Outlook 메시지 파일에서 서명 제거

호환성 등 이유로 MAPI 형식 메시지에서 서명을 제거해야 하는 경우, Aspose.Email은 다음을 제공합니다: MapiMessage.removeSignature 메서드와 MapiMessage.isSigned 속성.

다음 코드 스니펫은 파일에서 MAPI 메시지를 로드하고, 디지털 서명 여부를 확인한 뒤, 서명된 경우 디지털 서명 없이 새 메시지를 생성하는 방법을 보여줍니다:

MapiMessage msg = MapiMessage.load(fileName);

if (msg.isSigned()) {
    MapiMessage unsignedMsg = msg.removeSignature();
}

MSG에서 EML로 S/MIME 메시지 변환

Aspose.Email은 MSG를 EML로 변환할 때 디지털 서명을 보존합니다. 다음 코드 스니펫을 참고하십시오.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MailMessage msg = MailMessage.load(dataDir + "message.eml");
MapiMessage mapi = MapiMessage.fromMailMessage(msg, new MapiConversionOptions(OutlookMessageFormat.Unicode));
// Save File to disk
mapi.save(dataDir + "ConvertMIMEMessagesFromMSGToEML_out.msg");

인증서를 사용해 MSG 파일 복호화

암호화된 MAPI 메시지가 있고, 인증서에 저장된 개인키를 사용해 복호화해야 하는 경우, Aspose.Email의 다음 기능이 유용할 수 있습니다:

MapiMessage.isEncrypted - 메시지가 암호화되었는지 여부를 나타내는 값을 가져옵니다.
MapiMessage.decrypt() - 이 메시지를 복호화합니다 (메서드는 현재 사용자와 컴퓨터의 My 저장소에서 적절한 인증서와 개인 키를 검색합니다).
MapiMessage.decrypt(X509Certificate2 certificate) - 인증서를 사용하여 이 메시지를 복호화합니다.

다음 코드 스니펫은 암호화된 MAPI 메시지를 처리하는 방법을 보여줍니다:

X509Certificate2 privateCert = new X509Certificate2("privateCertFile", "password");
MapiMessage msg = MapiMessage.load("encrypted.msg");

if (msg.isEncrypted()) {
    MapiMessage decryptedMsg = msg.decrypt(privateCert);
    //MapiMessage decryptedMsg = msg.decrypt(/*byte[]*/rawPrivateCert, "password");
}

Java: Outlook 캘린더 항목 작업

Mon, 01 Jan 0001 00:00:00 +0000

MapiCalendar 작업

Aspose.Email의 MapiCalendar 클래스는 캘린더 항목의 다양한 속성을 설정하는 메서드와 속성을 제공합니다. 이 문서는 다음과 같은 코드 샘플을 제공합니다:

캘린더 항목 생성 및 저장

다음 코드 스니펫은 캘린더 항목을 ICS 형식으로 생성하고 저장하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

Calendar cal = Calendar.getInstance();
cal.set(2012, Calendar.OCTOBER, 2, 13, 0, 0);
Date startDate = cal.getTime();
cal.set(2012, Calendar.OCTOBER, 2, 14, 0, 0);
Date endDate = cal.getTime();

MapiCalendar calendar = new MapiCalendar("LAKE ARGYLE WA 6743", 
                                         "Appointment", 
                                         "This is a very important meeting :)", 
                                         startDate, 
                                         endDate);

calendar.save(dataDir + "CalendarItem_out.ics", AppointmentSaveFormat.Ics);

캘린더 항목을 MSG로 저장

다음 코드 스니펫은 캘린더 항목을 MSG로 저장하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
calendar.save(dataDir + "CalendarItemAsMSG_out.Msg", AppointmentSaveFormat.Msg);

캘린더 항목을 ICS로 저장할 때 제품 ID 설정

다음은 ProductIdentifier 속성 MapiCalendarIcsSaveOptions 클래스는 원본 날짜와 시간 정보를 보존하고 사용자 지정 제품 식별자를 포함하여 MAPI 캘린더 항목을 iCalendar (ICS) 파일로 저장하는 데 사용됩니다. 해당 속성은 iCalendar 객체를 만든 제품의 식별자를 지정합니다.

다음 코드 샘플은 MAPI 캘린더 객체 내에서 iCalendar (ICS) 데이터를 다루는 방법을 보여줍니다:

MapiCalendarIcsSaveOptions icsSaveOptions = new MapiCalendarIcsSaveOptions();
icsSaveOptions.setKeepOriginalDateTimeStamp(true);
icsSaveOptions.setProductIdentifier("Foo Ltd");

mapiCalendar.save("my.ics", icsSaveOptions);

캘린더에 표시 알림 추가

다음 코드 스니펫은 캘린더에 표시 알림을 추가하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";
Calendar jCalendar = Calendar.getInstance();
jCalendar.add(Calendar.HOUR, 1);
Date startDate = jCalendar.getTime();
Date endDate = jCalendar.getTime();

MailAddressCollection attendees = new MailAddressCollection();
attendees.addItem(new MailAddress("attendee@domain.com", "Attendee"));
// Create Appointment
Appointment app = new Appointment("Home", 
                                  startDate, 
                                  endDate, 
                                  new MailAddress("organizer@domain.com", "Organizer"), 
                                  attendees);
MailMessage msg = new MailMessage();
msg.addAlternateView(app.requestApointment());
MapiMessage mapi = MapiMessage.fromMailMessage(msg);
MapiCalendar calendar = (MapiCalendar) mapi.toMapiMessageItem();

// Set calendar Properties
calendar.setReminderSet(true);
calendar.setReminderDelta(5); // 45 min before start of event

String savedFile = (dataDir + "calendarWithDisplayReminder.ics");
calendar.save(savedFile, AppointmentSaveFormat.Ics);

캘린더에 오디오 알림 추가

다음 코드 스니펫은 캘린더에 오디오 알림을 추가하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";
Calendar jCalendar = Calendar.getInstance();
jCalendar.add(Calendar.HOUR, 1);
Date startDate = jCalendar.getTime();
Date endDate = jCalendar.getTime();

MailAddressCollection attendees = new MailAddressCollection();
attendees.addItem(new MailAddress("attendee@domain.com", "Attendee"));

Appointment app = new Appointment("Home", 
                                  startDate, 
                                  endDate, 
                                  new MailAddress("organizer@domain.com", "Organizer"), 
                                  attendees);

MailMessage msg = new MailMessage();
msg.addAlternateView(app.requestApointment());
MapiMessage mapi = MapiMessage.fromMailMessage(msg);
MapiCalendar cal = (MapiCalendar) mapi.toMapiMessageItem();

cal.setReminderSet(true);
cal.setReminderDelta(58); // 58 min before start of event
cal.setReminderFileParameter(dataDir + "Alarm01.wav");

String savedFile = dataDir + "calendarWithAudioReminder_out.ics";
cal.save(savedFile, AppointmentSaveFormat.Ics);

캘린더 파일에서 첨부 파일 추가/검색

다음 코드 스니펫은 캘린더 파일에서 첨부 파일을 추가/검색하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";
Calendar jCalendar = Calendar.getInstance();
jCalendar.add(Calendar.HOUR, 1);
Date startDate = jCalendar.getTime();
Date endDate = jCalendar.getTime();

String[] files = new String[3];
files[0] = "attachment_1.doc";
files[1] = "download.png";
files[2] = "Desert.jpg";

MailAddressCollection attendees = new MailAddressCollection();
attendees.addItem(new MailAddress("attendee@domain.com", "Attendee"));

Appointment app1 = new Appointment("Home", 
                                   startDate, 
                                   endDate, 
                                   new MailAddress("organizer@domain.com", "Organizer"), 
                                   attendees);
for (String file : files) {
    app1.getAttachments().addItem(new Attachment(dataDir + file));
}

app1.save(dataDir + "appWithAttachments_out.ics", AppointmentSaveFormat.Ics);

Appointment app2 = Appointment.load(dataDir + "appWithAttachments_out.ics");
System.out.println(app2.getAttachments().size());
for (Attachment att : app2.getAttachments())
    System.out.println(att.getName());

회의 요청 수신자의 상태

다음 코드 스니펫은 회의 요청에서 수신자의 상태를 가져오는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String fileName = "outlook/test.msg";

MapiMessage message = MapiMessage.fromFile(fileName);
for (MapiRecipient recipient : message.getRecipients()) {
    System.out.println(recipient.getRecipientTrackStatus());
}

캘린더 약속 상태를 명시적으로 설정

Aspose.Email을 사용하면 MapiCalendar 객체를 명시적으로 설정하여 기본 동작을 재정의합니다. 해당 setStateForced 메서드는 캘린더 이벤트 상태에 대한 더 나은 제어를 제공하며, 특히 수신된 회의 요청을 처리할 때 유용합니다. 기본적으로 회의가 생성될 때 상태는 MapiCalendarState.Meeting. 수신자의 받은 편지함에 도착하면 자동으로 다음으로 변경됩니다 MapiCalendarState.Received, 그리고 해당 메시지 클래스가 다음으로 업데이트됩니다 IPM.Schedule.Meeting.Request. 사용 SetStateForced 수동으로 상태를 Received(수신됨)으로 설정할 수 있게 하며, 캘린더를 MSG 파일로 저장할 때 주최자 정보를 보존하는 데 유용합니다. 그러나 이는 회의를 올바르게 전달하거나 다시 보내는 것을 방해할 수 있습니다.

다음 코드 샘플은 이 기능을 구현하는 데 도움이 될 것입니다:

Calendar c = Calendar.getInstance();
c.set(2024, Calendar.MAY, 10, 12, 30, 0);
Date startDate = c.getTime();
c.set(2024, Calendar.MAY, 10, 13, 30, 0);
Date endDate = c.getTime();
MapiCalendar appointment = new MapiCalendar(
        "LAKE ARGYLE WA 6743",
        "Appointment",
        "This is a very important meeting :)",
        startDate,
        endDate);

MapiElectronicAddress organizer = new MapiElectronicAddress();
organizer.setEmailAddress("test@aaa.com");
organizer.setDisplayName("test display Name");
appointment.setOrganizer(organizer);

appointment.setStateForced(MapiCalendarState.Meeting | MapiCalendarState.Received);

appointment.save("appointment.msg", AppointmentSaveFormat.Msg);

표준 시간대에서 MapiCalendarTimeZone 생성

다음 코드 스니펫은 생성하는 방법을 보여줍니다 MapiCalendarTimeZone 표준 시간대에서.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
MapiCalendarTimeZone timeZone = new MapiCalendarTimeZone("Eastern Standard Time");

생성된 약속으로 알림 설정

약속이 생성될 때 알림을 추가할 수 있습니다. 이러한 알람은 일정 시작 n분 전, n번 반복, n간격 등 다양한 기준에 따라 트리거될 수 있습니다. BEGIN:VALARM과 END:VALARM 사이에 포함된 스크립트에서 다양한 태그를 사용해 이러한 트리거를 만들 수 있습니다. 약속에 알림을 설정하는 방법에는 여러 변형이 있습니다.

태그 추가를 통한 알림 설정

다음 코드 스니펫은 태그를 추가하여 알림을 설정하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();
long MIN_MS = 60 * 1000;
long HR_MS = 60 * MIN_MS;
long DAY_MS = 24 * HR_MS;

String location = "Meeting Location: Room 5";
Date startDate = getDate(1997, 3, 18, 18, 30, 00);
Date endDate = getDate(1997, 3, 18, 19, 30, 00);
MailAddress organizer = new MailAddress("aaa@amail.com", "Organizer");
MailAddressCollection attendees = new MailAddressCollection();
attendees.addItem(new MailAddress("bbb@bmail.com", "First attendee"));

Appointment target = new Appointment(location, startDate, endDate, organizer, attendees);

// Audio alarm that will sound at a precise time and
// Repeat 4 more times at 15 minute intervals:
AppointmentReminder audioReminder = new AppointmentReminder();
audioReminder.setTrigger(new ReminderTrigger(getDate(1997, 3, 17, 13, 30, 0)));
audioReminder.setRepeat(4);
audioReminder.setDuration(new ReminderDuration(15 * MIN_MS));
audioReminder.setAction(ReminderAction.Audio);
ReminderAttachment attach = new ReminderAttachment(new URI("ftp://Host.com/pub/sounds/bell-01.aud"));
audioReminder.getAttachments().addItem(attach);
target.getReminders().addItem(audioReminder);


// Display alarm that will trigger 30 minutes before the
// Scheduled start of the event it is
// Associated with and will repeat 2 more times at 15 minute intervals:
AppointmentReminder displayReminder = new AppointmentReminder();
ReminderDuration dur = new ReminderDuration(-30 * MIN_MS);
displayReminder.setTrigger(new ReminderTrigger(dur, ReminderRelated.Start));
displayReminder.setRepeat(2);
displayReminder.setDuration(new ReminderDuration(15 * MIN_MS));
displayReminder.setAction(ReminderAction.Display);
displayReminder.setDescription("Breakfast meeting with executive team at 8:30 AM EST");
target.getReminders().addItem(displayReminder);

// Email alarm that will trigger 2 days before the
// Scheduled due date/time. It does not
// Repeat. The email has a subject, body and attachment link.
AppointmentReminder emailReminder = new AppointmentReminder();
ReminderDuration dur1 = new ReminderDuration(-2 * DAY_MS);
emailReminder.setTrigger(new ReminderTrigger(dur1, ReminderRelated.Start));
ReminderAttendee attendee = new ReminderAttendee("john_doe@host.com");
emailReminder.getAttendees().addItem(attendee);
emailReminder.setAction(ReminderAction.Email);
emailReminder.setSummary("REMINDER: SEND AGENDA FOR WEEKLY STAFF MEETING");
emailReminder.setDescription("A draft agenda needs to be sent out to the attendees to the weekly managers meeting (MGR-LIST). Attached is a pointer the document template for the agenda file.");
ReminderAttachment attach1 = new ReminderAttachment(new URI("http://Host.com/templates/agenda.doc"));
emailReminder.getAttachments().addItem(attach1);
target.getReminders().addItem(emailReminder);

// Procedural alarm that will trigger at a precise date/time
// And will repeat 23 more times at one hour intervals. The alarm will
// Invoke a procedure file.
AppointmentReminder procReminder = new AppointmentReminder();
procReminder.setTrigger(new ReminderTrigger(getDate(1998, 1, 1, 5, 0, 0)));
procReminder.setRepeat(23);
procReminder.setDuration(new ReminderDuration(1 * DAY_MS));
procReminder.setAction(ReminderAction.Procedure);
ReminderAttachment attach2 = new ReminderAttachment(new URI("ftp://Host.com/novo-procs/felizano.exe"));
procReminder.getAttachments().addItem(attach2);
target.getReminders().addItem(procReminder);
target.save(dataDir + "savedFile_out.ics");

HTML 본문을 포함한 약속 EML을 MSG로 변환

버전 19.3부터, Aspose.Email은 약속의 HTML 본문을 유지하면서 Appointment EML을 MSG로 변환하는 기능을 제공합니다. Aspose.Email은 MapiConversionOptions.ForcedRtfBodyForAppointment 속성은 기본값이 true 입니다. 값이 MapiConversionOptions.ForcedRtfBodyForAppointment 가 true 로 설정되면 약속 본문이 RTF 형식으로 변환됩니다. 약속 본문 형식을 HTML 형식으로 유지하려면, 값 MapiConversionOptions.ForcedRtfBodyForAppointment false 로

다음 예제는 사용을 보여줍니다 MapiConversionOptions.ForcedRtfBodyForAppointment 약속 본문 형식을 HTML 형식으로 유지하는 속성.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MailMessage mailMessage = MailMessage.load(dataDir + "TestAppointment.eml");

MapiConversionOptions conversionOptions = new MapiConversionOptions();
conversionOptions.setFormat(OutlookMessageFormat.Unicode);

// default value for ForcedRtfBodyForAppointment is true
conversionOptions.setForcedRtfBodyForAppointment(false);

MapiMessage mapiMessage = MapiMessage.fromMailMessage(mailMessage, conversionOptions);

if (mapiMessage.getBodyType() == BodyContentType.Html) {
    System.out.println("Body Type: Html");
} else if (mapiMessage.getBodyType() == BodyContentType.Rtf) {
    System.out.println("Body Type: Rtf");
}

mapiMessage.save(dataDir + "TestAppointment_out.msg");

Java: 배포 목록 작업

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email API를 사용하여 다수의 연락처를 모은 배포 목록을 만들 수 있습니다. 배포 목록은 Outlook MSG 형식으로 디스크에 저장할 수 있으며, MS Outlook에서 열어 확인/조작할 수 있습니다.

배포 목록 생성 및 저장

다음 코드 스니펏은 배포 목록을 생성하고 저장하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

String displayName1 = "Sebastian Wright";
String email1 = "SebastianWright@dayrep.com";

String displayName2 = "Wichert Kroos";
String email2 = "WichertKroos@teleworm.us";

String strEntryId1;
String strEntryId2;

// Create distribution list from contacts
try (PersonalStorage personalStorage = PersonalStorage.create(dataDir + "CreateDistributionListInPST_out.pst", FileFormatVersion.Unicode)) {
    // Add the contact folder to pst
    FolderInfo contactFolder = personalStorage.createPredefinedFolder("Contacts", StandardIpmFolder.Contacts);

    // Create contacts
    strEntryId1 = contactFolder.addMapiMessageItem(new MapiContact(displayName1, email1));
    strEntryId2 = contactFolder.addMapiMessageItem(new MapiContact(displayName2, email2));

    // Create distribution list on the base of the created contacts
    MapiDistributionListMember member1 = new MapiDistributionListMember(displayName1, email1);
    member1.setEntryIdType(MapiDistributionListEntryIdType.Contact);
    member1.setEntryId(Base64.getDecoder().decode(strEntryId1));

    MapiDistributionListMember member2 = new MapiDistributionListMember(displayName2, email2);
    member2.setEntryIdType(MapiDistributionListEntryIdType.Contact);
    member2.setEntryId(Base64.getDecoder().decode(strEntryId2));

    MapiDistributionListMemberCollection members = new MapiDistributionListMemberCollection();
    members.add(member1);
    members.add(member2);

    MapiDistributionList distributionList = new MapiDistributionList("Contact list", members);
    distributionList.setBody("Distribution List Body");
    distributionList.setSubject("Sample Distribution List using Aspose.Email");

    // Add distribution list to PST
    contactFolder.addMapiMessageItem(distributionList);
}

// Create one-off distribution list members (for which no separate contacts were created)
try (PersonalStorage personalStorage = PersonalStorage.create(dataDir + "CreateDistributionListInPST_OneOffmembers_out.pst", FileFormatVersion.Unicode)) {
    // Add the contact folder to pst
    FolderInfo contactFolder = personalStorage.createPredefinedFolder("Contacts", StandardIpmFolder.Contacts);

    MapiDistributionListMemberCollection oneOffmembers = new MapiDistributionListMemberCollection();
    oneOffmembers.add(new MapiDistributionListMember("John R. Patrick", "JohnRPatrick@armyspy.com"));
    oneOffmembers.add(new MapiDistributionListMember("Tilly Bates", "TillyBates@armyspy.com"));

    MapiDistributionList oneOffMembersList = new MapiDistributionList("Simple list", oneOffmembers);
    contactFolder.addMapiMessageItem(oneOffMembersList);
}

Mapi 배포 목록을 하나의 다중 연락처 VCF 파일로 저장

다음은 void save(String fileName, MapiDistributionListSaveOptions options) 이 메서드는 제공된 저장 옵션을 사용하여 지정된 파일 이름으로 Mapi 배포 목록을 저장할 수 있게 합니다. 파일 이름과 해당 클래스의 인스턴스를 제공할 수 있습니다. MapiDistributionListSaveOptions 매개변수로서의 클래스. The MapiDistributionListSaveOptions 이 클래스는 Mapi 배포 목록 저장 옵션을 포함합니다. 이 경우 저장 형식을 VCard(ContactSaveFormat.VCard)로 지정하여 배포 목록을 다중 연락처 VCF 파일로 저장할 수 있습니다.

다음 코드 스니펏은 배포 목록을 다중 연락처 VCF 파일로 저장하는 방법을 보여줍니다:

MapiDistributionList dlist = (MapiDistributionList)msg.toMapiMessageItem();
MapiDistributionListSaveOptions options = new MapiDistributionListSaveOptions(ContactSaveFormat.VCard);
dlist.save("distribution_list.vcf", options);

PST에서 배포 목록 읽기

다음 코드 스니펏은 PST 파일에서 배포 목록을 읽는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String fileName = "outlook/message.msg";

MapiMessage message = MapiMessage.fromFile(fileName);
MapiDistributionList dlist = (MapiDistributionList)message.toMapiMessageItem();

Java: 반복 작업 다루기

Mon, 01 Jan 0001 00:00:00 +0000

일간 반복 작업

Aspose.Email은 일간 반복 생성을 다음을 사용하여 지원합니다 MapiCalendarDailyRecurrencePattern. EndAfterNOccurrences, EndAfterDate, NeverEnd를 포함한 세 가지 다른 Mapi 캘린더 반복 종료 유형을 사용할 수 있습니다. 이 섹션에서는 다양한 일간 반복 패턴 생성 방법을 보여줍니다.

일간 반복: EndAfterNOccurrence 종료 유형

이 유형의 반복에서는 다음과 같이 다른 정보와 함께 반복 횟수를 설정해야 합니다:

시작, 종료 및 마감 날짜를 설정합니다.
다음을 생성합니다 MapiTask.
작업 상태를 NotAssigned로 설정합니다.
PatternType, Period, WeekStartDay, EndType, OccurenceCount와 같은 속성을 설정하여 일간 반복 객체를 만듭니다.
MapiTask.setRecurrence 속성을 이 일간 반복 객체에 설정합니다.
이 메시지를 디스크에 저장합니다.

다음 코드 스니펏은 반복 종료 유형을 EndAfterNOccurrence로 설정한 작업을 생성하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();

Date startDate = getDate(2015, 7, 16);
Date dueDate = getDate(2015, 7, 16);
Date endByDate = getDate(2015, 8, 1);
 
MapiTask task = new MapiTask("This is test task", "Sample Body", startDate, dueDate);
task.setState(MapiTaskState.NotAssigned);

// Set the Daily recurrence
MapiCalendarDailyRecurrencePattern rec = new MapiCalendarDailyRecurrencePattern();
rec.setPatternType(MapiCalendarRecurrencePatternType.Day);
rec.setPeriod(1);
rec.setWeekStartDay(DayOfWeek.Sunday);
rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=DAILY"));

if (rec.getOccurrenceCount() == 0)
{
    rec.setOccurrenceCount(1);
}

task.setRecurrence(rec);
task.save(dataDir + "Daily_out.msg", TaskSaveFormat.Msg);

다음 함수는 두 날짜 사이의 이벤트 수를 계산하는 데 사용할 수 있습니다:

private static long getOccurrenceCount(Date start, Date endBy, String rrule)
{
    DateFormat formatter = new SimpleDateFormat("yyyyMMdd");
    CalendarRecurrence pattern = new CalendarRecurrence("DTSTART:" + formatter.format(start) + "\r\nRRULE:" + rrule);
    DateCollection dates = pattern.generateOccurrences(start, endBy);
    return dates.size();
}

발생 횟수 값 설정

다음 코드 스니펏은 발생 횟수 값을 설정하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Daily recurrence
MapiCalendarDailyRecurrencePattern record = new MapiCalendarDailyRecurrencePattern();

record.setPatternType(MapiCalendarRecurrencePatternType.Day);
record.setPeriod(1);
record.setWeekStartDay(DayOfWeek.Sunday);
record.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
record.setOccurrenceCount(5);
task.setRecurrence(record);

일간 반복: EndAfterDate 종료 유형

"End By" 옵션은 getOccurrenceCount() 함수가 계산한 OccurrenceCount 속성을 설정하여 Mapi 작업에서 구현됩니다. 이 함수는 시작 날짜, 종료 날짜 및 RRULE 문자열을 입력받습니다.

일간 반복: Every Day 값 설정

다음 코드 스니펏은 RRULE 문자열에서 period 값을 1, INTERVAL 값을 1로 설정하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Daily recurrence
MapiCalendarDailyRecurrencePattern record = new MapiCalendarDailyRecurrencePattern();

record.setPatternType(MapiCalendarRecurrencePatternType.Day);
record.setPeriod(1);
record.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
record.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=DAILY;INTERVAL=1"));
record.setEndDate(endByDate);

Every Day 값은 아래 예시와 같이 적절한 값으로 설정할 수 있습니다:

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Daily recurrence
MapiCalendarDailyRecurrencePattern record = new MapiCalendarDailyRecurrencePattern();

record.setPatternType(MapiCalendarRecurrencePatternType.Day);
record.setPeriod(2);
record.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
record.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=DAILY;INTERVAL=2"));

일간 반복: NeverEnd 종료 유형

끝 유형은 MapiCalendarRecurrenceEndType.NeverEnd를 사용하여 설정할 수 있습니다. 다음 예제에서는 Period 또는 INTERVAL를 필요한 값, 예를 들어 1로 설정합니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Daily recurrence
MapiCalendarDailyRecurrencePattern record = new MapiCalendarDailyRecurrencePattern();

record.setPatternType(MapiCalendarRecurrencePatternType.Day);
record.setPeriod(1);
record.setEndType(MapiCalendarRecurrenceEndType.NeverEnd);

주간 반복 작업

Aspose.Email은 다음을 사용하여 주간 반복 생성에 대한 풍부한 기능을 제공합니다 MapiCalendarWeeklyRecurrencePattern. EndAfterNOccurrences, EndAfterDate, NeverEnd를 포함한 세 가지 다른 Mapi 캘린더 반복 종료 유형을 사용할 수 있습니다. 이 섹션에서는 다양한 주간 반복 패턴 생성 방법을 보여줍니다.

주간 반복: EndAfterNOccurrences 종료 유형

이 유형의 반복에서는 다음과 같이 다른 정보와 함께 반복 횟수를 설정해야 합니다:

시작, 종료 및 마감 날짜를 설정합니다.
다음을 생성합니다 MapiTask.
작업 상태를 NotAssigned로 설정합니다.
PatternType, Period, WeekStartDay, EndType, OccurenceCount와 같은 속성을 설정하여 주간 반복 객체를 만듭니다.
MapiTask.setRecurrence 속성을 이 주간 반복 객체에 설정합니다.
이 메시지를 디스크에 저장합니다.

다음 코드 스니펏은 반복 종료 유형을 EndAfterNOccurrence로 설정한 작업을 생성하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();

Date startDate = getDate(2015, 7, 16);
Date dueDate = getDate(2015, 7, 16);
Date endByDate = getDate(2015, 9, 1);

MapiTask task = new MapiTask("This is test task", "Sample Body", startDate, dueDate);
task.setState(MapiTaskState.NotAssigned);

// Set the weekly recurrence
MapiCalendarWeeklyRecurrencePattern rec = new MapiCalendarWeeklyRecurrencePattern();
rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
rec.setPatternType(MapiCalendarRecurrencePatternType.Week);
rec.setPeriod(1);
rec.setWeekStartDay(DayOfWeek.Sunday);
rec.setDayOfWeek(MapiCalendarDayOfWeek.Friday);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=WEEKLY;BYDAY=FR"));

if (rec.getOccurrenceCount() == 0)
{
    rec.setOccurrenceCount(1);
}

task.setRecurrence(rec);
task.save(dataDir + "Weekly_out.msg", TaskSaveFormat.Msg);

다음 함수를 사용하여 두 날짜 사이의 이벤트 수를 계산할 수 있습니다:

private static long getOccurrenceCount(Date start, Date endBy, String rrule)
{
    DateFormat formatter = new SimpleDateFormat("yyyyMMdd");
    CalendarRecurrence pattern = new CalendarRecurrence("DTSTART:" + formatter.format(start) + "\r\nRRULE:" + rrule);
    DateCollection dates = pattern.generateOccurrences(start, endBy);
    return dates.size();
}

한 주에서 여러 요일 선택

다음 코드 스니펏은 한 주에서 여러 요일을 선택하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the weekly recurrence
MapiCalendarWeeklyRecurrencePattern rec = new MapiCalendarWeeklyRecurrencePattern();

rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
rec.setPatternType(MapiCalendarRecurrencePatternType.Week);
rec.setPeriod(1);
rec.setWeekStartDay(DayOfWeek.Sunday);
rec.setDayOfWeek(MapiCalendarDayOfWeek.Friday | MapiCalendarDayOfWeek.Monday);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=WEEKLY;BYDAY=FR,MO"));

한 주에서 여러 요일 선택 및 간격 설정

다음 코드 스니펏은 한 주에서 여러 요일을 선택하고 간격을 설정하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the weekly recurrence
MapiCalendarWeeklyRecurrencePattern rec = new MapiCalendarWeeklyRecurrencePattern();
rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
rec.setPatternType(MapiCalendarRecurrencePatternType.Week);
rec.setPeriod(2);
rec.setWeekStartDay(DayOfWeek.Sunday);
rec.setDayOfWeek(MapiCalendarDayOfWeek.Friday | MapiCalendarDayOfWeek.Monday);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=WEEKLY;BYDAY=FR,MO;INTERVAL=2"));

주간 반복: EndAfterDate 종료 유형

주간 반복: Every Day 값 설정

다음 코드 스니펏은 RRULE 문자열에서 period 값을 1, INTERVAL 값을 1로 설정하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the weekly recurrence
MapiCalendarWeeklyRecurrencePattern rec = new MapiCalendarWeeklyRecurrencePattern();
rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
rec.setPatternType(MapiCalendarRecurrencePatternType.Week);
rec.setPeriod(1);
rec.setWeekStartDay(DayOfWeek.Sunday);
rec.setDayOfWeek(MapiCalendarDayOfWeek.Friday);
rec.setEndDate(endByDate);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=WEEKLY;BYDAY=FR;INTERVAL=1"));

Every Day 값은 적절한 값으로 설정할 수 있으며, 아래 예시와 같이 여러 요일을 선택할 수 있습니다:

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
MapiCalendarWeeklyRecurrencePattern record = new MapiCalendarWeeklyRecurrencePattern();
record.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
record.setPatternType(MapiCalendarRecurrencePatternType.Week);
record.setPeriod(2);
record.setWeekStartDay(DayOfWeek.Sunday);
record.setEndDate(endByDate);
record.setDayOfWeek(MapiCalendarDayOfWeek.Friday | MapiCalendarDayOfWeek.Monday);
record.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=WEEKLY;BYDAY=FR,MO;INTERVAL=2"));

주간 반복: NeverEnd 종료 유형

끝 유형은 MapiCalendarRecurrenceEndType.NeverEnd를 사용하여 설정할 수 있습니다. 다음 예제에서는 Period 또는 INTERVAL를 필요한 값, 예를 들어 1로 설정합니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the weekly recurrence
MapiCalendarWeeklyRecurrencePattern recurrence = new MapiCalendarWeeklyRecurrencePattern();
recurrence.setEndType(MapiCalendarRecurrenceEndType.NeverEnd);
recurrence.setPatternType(MapiCalendarRecurrencePatternType.Week);
recurrence.setPeriod(1);
recurrence.setWeekStartDay(DayOfWeek.Sunday);
recurrence.setDayOfWeek(MapiCalendarDayOfWeek.Friday);
recurrence.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=WEEKLY;BYDAY=FR"));

월간 반복 작업

Aspose.Email은 월간 반복 생성을 다음을 사용하여 지원합니다 MapiCalendarMonthlyRecurrencePattern. EndAfterNOccurrences, EndAfterDate, NeverEnd를 포함한 세 가지 다른 Mapi 캘린더 반복 종료 유형을 사용할 수 있습니다. 이 섹션에서는 다양한 월간 반복 패턴 생성 방법을 보여줍니다.

월간 반복: EndAfterNOccurrences 종료 유형

이 유형의 반복에서는 다음과 같이 다른 정보와 함께 반복 횟수를 설정해야 합니다:

시작, 종료 및 마감 날짜를 설정합니다.
다음을 생성합니다 MapiTask.
작업 상태를 NotAssigned로 설정합니다.
PatternType, Period, WeekStartDay, EndType, OccurenceCount와 같은 속성을 설정하여 월별 반복 객체를 만듭니다.
MapiTask.setRecurrence 속성을 이 월별 반복 객체에 설정합니다.
이 메시지를 디스크에 저장합니다.

다음 코드 스니펏은 반복 종료 유형을 EndAfterNOccurrence로 설정한 작업을 생성하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();

Date startDate = getDate(2015, 7, 16);
Date DueDate = getDate(2015, 7, 16);
Date endByDate = getDate(2015, 12, 31);

MapiTask task = new MapiTask("This is test task", "Sample Body", startDate, dueDate);
task.setState(MapiTaskState.NotAssigned);

// Set the Monthly recurrence
MapiCalendarMonthlyRecurrencePattern rec = new MapiCalendarMonthlyRecurrencePattern();
rec.setDay(15);
rec.setPeriod(1);
rec.setPatternType(MapiCalendarRecurrencePatternType.Month);
rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=MONTHLY;BYMONTHDAY=15;INTERVAL=1"));
rec.setWeekStartDay(DayOfWeek.Monday);

if (rec.getOccurrenceCount() == 0)
{
    rec.setOccurrenceCount(1);
}

task.setRecurrence(rec);
task.save(dataDir + "Monthly_out.msg", TaskSaveFormat.Msg);

다음 함수는 두 날짜 사이의 이벤트 수를 계산하는 데 사용할 수 있습니다:

private static long getOccurrenceCount(Date start, Date endBy, String rrule)
{
    DateFormat formatter = new SimpleDateFormat("yyyyMMdd");
    CalendarRecurrence pattern = new CalendarRecurrence("DTSTART:" + formatter.format(start) + "\r\nRRULE:" + rrule);
    DateCollection dates = pattern.generateOccurrences(start, endBy);
    return dates.size();
}

고정 발생 횟수 설정

다음 코드 스니펏은 고정된 발생 횟수를 설정하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Monthly recurrence
MapiCalendarMonthlyRecurrencePattern records = new MapiCalendarMonthlyRecurrencePattern();
records.setDay(15);
records.setPeriod(1);
records.setPatternType(MapiCalendarRecurrencePatternType.Month);
records.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
records.setOccurrenceCount(5);
records.setWeekStartDay(DayOfWeek.Monday);

월간 반복: EndAfterDate 종료 유형

"End By" 옵션은 getOccurrenceCount() 함수가 계산한 OccurrenceCount 속성을 설정하여 Mapi 작업에서 구현됩니다. 이 함수는 시작 날짜, 종료 날짜 및 RRULE 문자열을 입력받습니다. 다음 코드 스니펏은 시작과 종료 날짜 사이의 매월 15일에 반복을 생성하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();

Date startDate = getDate(2015, 7, 1);
Date dueDate = getDate(2015, 7, 1);
Date endByDate = getDate(2015, 12, 31);

MapiTask task = new MapiTask("This is test task", "Sample Body", startDate, dueDate);
task.setState(MapiTaskState.NotAssigned);

// Set the Monthly recurrence
MapiCalendarMonthlyRecurrencePattern recurrence = new MapiCalendarMonthlyRecurrencePattern();
recurrence.setDay(15);
recurrence.setPeriod(1);
recurrence.setPatternType(MapiCalendarRecurrencePatternType.Month);
recurrence.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
recurrence.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=MONTHLY;BYMONTHDAY=15;INTERVAL=1"));
recurrence.setWeekStartDay(DayOfWeek.Monday);
recurrence.setEndDate(endByDate);

task.setRecurrence(recurrence);
task.save(dataDir + "SetMonthlyEndAfterDateRecurrence_out.msg", TaskSaveFormat.Msg);

월간 반복: NeverEnd 종료 유형

다음 코드 스니펏은 MapiCalendarRecurrenceEndType.NeverEnd를 사용하여 종료 유형을 설정하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
MapiCalendarMonthlyRecurrencePattern recurrence = new MapiCalendarMonthlyRecurrencePattern();
recurrence.setDay(15);
recurrence.setPeriod(1);
recurrence.setPatternType(MapiCalendarRecurrencePatternType.Month);
recurrence.setEndType(MapiCalendarRecurrenceEndType.NeverEnd);
recurrence.setWeekStartDay(DayOfWeek.Monday);

연간 반복 작업

Aspose.Email은 연간 반복 생성을 다음을 사용하여 지원합니다 MapiCalendarMonthlyRecurrencePattern. period 속성을 12로 설정하면 연간 반복 패턴을 구현할 수 있습니다. EndAfterNOccurrences, EndAfterDate, NeverEnd를 포함한 세 가지 다른 Mapi 캘린더 반복 종료 유형을 사용할 수 있습니다. 이 섹션에서는 다양한 연간 반복 패턴 생성 방법을 보여줍니다.

연간 반복: EndAfterNOccurrences 종료 유형

이 유형의 반복에서는 다음과 같이 다른 정보와 함께 반복 횟수를 설정해야 합니다:

시작, 종료 및 마감 날짜를 설정합니다.
다음을 생성합니다 MapiTask.
작업 상태를 NotAssigned로 설정합니다.
PatternType, Period, WeekStartDay, EndType, OccurenceCount와 같은 속성을 설정하여 월별 반복 객체를 만듭니다.
연간 반복을 달성하려면 MapiTask.setRecurrence 속성을 이 월별 반복 객체에 설정하세요.
이 메시지를 디스크에 저장합니다.

다음 코드 스니펏은 반복 종료 유형을 EndAfterNOccurrence로 설정한 작업을 생성하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
Date startDate = getDate(2015, 7, 1);
Date dueDate = getDate(2015, 7, 1);

MapiTask task = new MapiTask("This is test task", "Sample Body", startDate, dueDate);
task.setState(MapiTaskState.NotAssigned);

// Set the Yearly recurrence
MapiCalendarMonthlyRecurrencePattern recurrence = new MapiCalendarMonthlyRecurrencePattern();
recurrence.setDay(15);
recurrence.setPeriod(12);
recurrence.setPatternType(MapiCalendarRecurrencePatternType.Month);
recurrence.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
recurrence.setOccurrenceCount(3);

task.setRecurrence(recurrence);
task.save("Yearly.msg", TaskSaveFormat.Msg);

연간 반복: EndAfterDate 종료 유형

"End By" 옵션은 getOccurrenceCount() 함수가 계산한 OccurrenceCount 속성을 설정하여 Mapi 작업에서 구현됩니다. 이 함수는 시작 날짜, 종료 날짜 및 RRULE 문자열을 입력받습니다. 다음 코드 스니펏은 시작과 종료 날짜 사이의 매 7개월마다 15일에 반복을 생성하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Yearly recurrence
MapiCalendarMonthlyRecurrencePattern rec = new MapiCalendarMonthlyRecurrencePattern();
rec.setDay(15);
rec.setPeriod(12);
rec.setPatternType(MapiCalendarRecurrencePatternType.Month);
rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
rec.setEndDate(endByDate);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=YEARLY;BYMONTHDAY=15;BYMONTH=7;INTERVAL=1"));

연간 반복: NeverEnd 종료 유형

다음 코드 스니펏은 MapiCalendarRecurrenceEndType.NeverEnd를 사용하여 종료 유형을 설정하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Yearly recurrence
MapiCalendarMonthlyRecurrencePattern recurrence = new MapiCalendarMonthlyRecurrencePattern();
recurrence.setDay(15);
recurrence.setPeriod(12);
recurrence.setPatternType(MapiCalendarRecurrencePatternType.Month);
recurrence.setEndType(MapiCalendarRecurrenceEndType.NeverEnd);

반복 규칙에서 반복 생성

Aspose.Email API는 반복 규칙(RRULE)에서 반복 패턴을 생성하는 기능을 제공합니다. RFC 5545 iCal 사양에 따라 RRULE에서 정보를 파싱하고 MapiCalendarRecurrencePatternFactory.fromString 메서드를 사용하여 반복 패턴을 생성합니다. 다음 코드 스니펏은 반복 규칙에서 반복 패턴을 생성하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();

Date startDate = getDate(2015, 7, 16);
Date endDate = getDate(2015, 8, 1);
MapiCalendar app1 = new MapiCalendar("test location", "test summary", "test description", startDate, endDate);

app1.setStartDate(startDate);
app1.setEndDate(endDate);

String pattern = "DTSTART;TZID=Europe/London:20150831T080000\r\nDTEND;TZID=Europe/London:20150831T083000\r\nRRULE:FREQ=DAILY;INTERVAL=1;COUNT=7\r\nEXDATE:20150831T070000Z,20150904T070000Z";
app1.getRecurrence().setRecurrencePattern(MapiCalendarRecurrencePatternFactory.fromString(pattern));

반복 캘린더 이벤트에 첨부 파일 추가

Aspose.Email API는 반복 캘린더 이벤트에 첨부 파일을 추가하는 기능을 제공합니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String dataDir = RunExamples.getDataDir_Outlook();

Date startDate = addHours(getDate(2018, 7, 19), 12);
MapiCalendar calendar = new MapiCalendar("location1", "summary1", "description1", startDate, addHours(startDate, 1));

MapiCalendarEventRecurrence recurrence = new MapiCalendarEventRecurrence();
MapiCalendarRecurrencePattern pattern = new MapiCalendarDailyRecurrencePattern();
recurrence.setRecurrencePattern(pattern);
pattern.setPatternType(MapiCalendarRecurrencePatternType.Day);
pattern.setPeriod(1);
pattern.setEndType(MapiCalendarRecurrenceEndType.NeverEnd);

Date exceptionDate = addDays(startDate, 3);
MapiCalendarExceptionInfo exception = new MapiCalendarExceptionInfo();
exception.setLocation("exceptionLoc");
exception.setSubject("exceptionSubj");
exception.setBody("exceptionBody");
exception.setOriginalStartDate(exceptionDate);
exception.setStartDateTime(exceptionDate);
exception.setEndDateTime(addHours(exceptionDate, 5));
exception.setAttachments(new MapiAttachmentCollection(calendar));
exception.getAttachments().add("file.txt", "hello, world!".getBytes());

pattern.getExceptions().addItem(exception);
pattern.getModifiedInstanceDates().addItem(exceptionDate);
pattern.getDeletedInstanceDates().addItem(exceptionDate);
calendar.setRecurrence(recurrence);

try (PersonalStorage newPst = PersonalStorage.create(dataDir + "AddAttachmentToMapiExceptionInfo.pst", FileFormatVersion.Unicode))
{
    FolderInfo newFolder = newPst.createPredefinedFolder("Calendar", StandardIpmFolder.Appointments);
    newFolder.addMapiMessageItem(calendar);
}

캘린더 이벤트 시간대 설정

Aspose.Email API는 캘린더 시간대를 설정하는 기능을 제공합니다:

시작/종료 날짜에 대한 시간대 정보
반복 회의를 위한 시간대 정보
반복 시리즈의 회의 일시를 UTC와 상호 변환하는 방법을 설명하는 시간대 정보

다음 코드 스니펏은 캘린더 시간대 정보를 설정하는 방법을 보여줍니다:

MapiCalendar event = new MapiCalendar("location", "summary", "description", startDate, endDate);
// UTC time zone
MapiCalendarTimeZone utcTimeZone = new MapiCalendarTimeZone("UTC");
event.setStartDateTimeZone(utcTimeZone);
event.setEndDateTimeZone(utcTimeZone);

MapiCalendarDailyRecurrencePattern pattern = new MapiCalendarDailyRecurrencePattern();
pattern.setPeriod(1);
pattern.setStartDate(startDate);
pattern.setEndDate(untilDate);
pattern.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
pattern.setPatternType(MapiCalendarRecurrencePatternType.Day);
pattern.setDayOfWeek(DayOfWeek.Monday);

MapiCalendarEventRecurrence r = new MapiCalendarEventRecurrence();
r.setRecurrencePattern(pattern);
r.setClipStart(startDate);
r.setClipEnd(pattern.getEndDate());
//https://docs.microsoft.com/en-us/office/client-developer/outlook/mapi/pidlidappointmenttimezonedefinitionrecur-canonical-property
r.setAppointmentTimeZoneDefinitionRecur(utcTimeZone); // <---
r.setTimeZoneStruct(utcTimeZone); // <---
event.setRecurrence(r);