Documentation – ทำงานกับ Exchange EWS Client

Java: การเชื่อมต่อกับ Exchange Server

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

เพื่อเชื่อมต่อกับ Exchange server 2007, 2010 และ 2013 โดยใช้ Exchange Web Service, Aspose.Email มี IEWSClient อินเทอร์เฟซที่ทำงานตาม EWSClient คลาส. เมธอด EWSClient.getEWSClient เมธอดสร้างอินสแตนซ์และคืนค่า IEWSClient ออบเจกต์ที่ใช้ต่อไปเพื่อทำการดำเนินการที่เกี่ยวกับกล่องเมล Exchange และโฟลเดอร์อื่น ๆ บทความนี้แสดงวิธีสร้างอินสแตนซ์ของออบเจกต์ IEWSClient.

เชื่อมต่อกับ Exchange Server ด้วย EWS

โค้ดส่วนต่อไปนี้จะแสดงวิธีเชื่อมต่อโดยใช้ Exchange Web Service (EWS).

private static IEWSClient getExchangeEWSClient() {
    final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
    final String domain = "";
    final String username = "username@onmicrosoft.com";
    final String password = "password";
    NetworkCredential credentials = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
    return client;
}

เชื่อมต่อกับ Exchange Server ด้วย IMAP

Microsoft Exchange Server รองรับโปรโตคอล IMAP สำหรับการเข้าถึงรายการในกล่องเมล ใช้ของ Aspose.Email’s ImapClient คลาสเพื่อเชื่อมต่อกับ Exchange Server ด้วยโปรโตคอล IMAP ข้อมูลเพิ่มเติมเกี่ยวกับ ImapClient คลาส ก่อนแรกให้แน่ใจว่า IMAP service เปิดใช้งานสำหรับ Exchange Server ของคุณ:

เปิด Control Panel.
ไปที่ Administrator Tools แล้วเลือก Services.
ตรวจสอบสถานะของบริการ Microsoft Exchange IMAP4.
หากยังไม่ได้ทำงาน ให้เปิดใช้งาน/เริ่มต้นมัน.

โค้ดส่วนต่อไปนี้จะแสดงวิธีเชื่อมต่อและแสดงรายการข้อความจากโฟลเดอร์ Inbox ของ Microsoft exchange server โดยใช้โปรโตคอล IMAP.

// Connect to Exchange Server using ImapClient class
ImapClient imapClient = new ImapClient("ex07sp1", "Administrator", "Evaluation1");
imapClient.setSecurityOptions(SecurityOptions.Auto);

// Select the Inbox folder
imapClient.selectFolder(ImapFolderInfo.IN_BOX);

// Get the list of messages
ImapMessageInfoCollection msgCollection = imapClient.listMessages();
for (ImapMessageInfo msgInfo : (Iterable<ImapMessageInfo>) msgCollection) {
    System.out.println(msgInfo.getSubject());
}
// Disconnect from the server
imapClient.dispose();

โค้ดส่วนต่อไปนี้จะแสดงวิธีใช้ SSL.

public static void run() {
    // Connect to Exchange Server using ImapClient class
    ImapClient imapClient = new ImapClient("ex07sp1", 993, "Administrator", "Evaluation1");
    imapClient.setSecurityOptions(SecurityOptions.SSLExplicit);

    // Select the Inbox folder
    imapClient.selectFolder(ImapFolderInfo.IN_BOX);

    // Get the list of messages
    ImapMessageInfoCollection msgCollection = imapClient.listMessages();
    for (ImapMessageInfo msgInfo : (Iterable<ImapMessageInfo>) msgCollection) {
        System.out.println(msgInfo.getSubject());
    }
    // Disconnect from the server
    imapClient.dispose();
}

หลังจากเชื่อมต่อกับ Exchange server ด้วย IMAP และรับ IMapMessageInfoCollection, โค้ดส่วนต่อไปนี้จะแสดงวิธีใช้ MessageInfo ลำดับเลขของออบเจกต์เพื่อบันทึกข้อความเฉพาะ.

// Select the Inbox folder
imapClient.selectFolder(ImapFolderInfo.IN_BOX);
// Get the list of messages
ImapMessageInfoCollection msgCollection = imapClient.listMessages();
for (ImapMessageInfo msgInfo : (Iterable<ImapMessageInfo>) msgCollection) {
    // Fetch the message from inbox using its SequenceNumber from msgInfo
    MailMessage message = imapClient.fetchMessage(msgInfo.getSequenceNumber());

    // Save the message to disc now
    message.save(dataDir + msgInfo.getSequenceNumber() + "_out.msg", SaveOptions.getDefaultMsgUnicode());
}

Java: ทำงานกับกล่องเมล Exchange และข้อความ - อ่านอีเมลจากเซิร์ฟเวอร์ Exchange ด้วย Java

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

รับข้อมูลกล่องเมลโดยใช้ EWS

นี้ EWSClient คลาสมีสมาชิกที่สามารถใช้ดึงข้อมูลกล่องจดหมายจาก Exchange Server โดยเรียก IEWClient.getMailboxInfo() เมธอด คืนค่าอินสแตนซ์ของชนิด ExchangeMailboxInfo. รับข้อมูลกล่องจดหมายจากคุณสมบัติ เช่น MailboxUri, InboxUri และ DraftsUri. บทความนี้แสดงวิธีเข้าถึงข้อมูลกล่องเมลโดยใช้ Exchange Web Services.

หากคุณต้องการเชื่อมต่อกับ Exchange Server โดยใช้ Exchange Web Services (EWS) ให้ใช้ EWSClient class. คลาสนี้ใช้ EWS เชื่อมต่อและจัดการรายการบน Exchange Server โค้ด Java ต่อไปนี้แสดงวิธีรับข้อมูลกล่องเมลโดยใช้ Exchange Web Services.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get mailbox size, exchange mailbox info, Mailbox and Inbox folder URI
System.out.println("Mailbox size: " + client.getMailboxSize() + " bytes");
ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
System.out.println("Mailbox URI: " + mailboxInfo.getMailboxUri());
System.out.println("Inbox folder URI: " + mailboxInfo.getInboxUri());
System.out.println("Sent Items URI: " + mailboxInfo.getSentItemsUri());
System.out.println("Drafts folder URI: " + mailboxInfo.getDraftsUri());

การส่งข้อความอีเมล

คุณสามารถส่งข้อความอีเมลโดยใช้ Exchange Server ด้วยความช่วยเหลือของเครื่องมือใน Aspose.Email.Exchange. เมธอด IEWSClient.Send() รับ MailMessage อินสแตนซ์เป็นพารามิเตอร์และส่งอีเมล บทความนี้อธิบายวิธีส่งข้อความอีเมลโดยใช้ Exchange Web Services.

Aspose.Email มีคลาส IEWSClient เพื่อเชื่อมต่อกับ Microsoft Exchange Server ด้วย Exchange Web Services โค้ดสคริปต์ต่อไปนี้แสดงวิธีใช้ EWS ส่งอีเมลด้วย Microsoft Exchange Server โค้ด Java ต่อไปนี้แสดงวิธีส่งข้อความอีเมลโดยใช้ EWS.

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Create instance of type MailMessage
MailMessage msg = new MailMessage();
msg.setFrom(MailAddress.to_MailAddress("sender@domain.com"));
msg.setTo(MailAddressCollection.to_MailAddressCollection("recipient@ domain.com "));
msg.setSubject("Sending message from exchange server");
msg.setHtmlBody("<h3>sending message from exchange server</h3>");

// Send the message
client.send(msg);

รับคลาสของข้อความ

นี้ getMessageClass() เมธอดของ ExchangeMessageInfo class รับสตริงที่แสดงประเภทของข้อความ ตัวอย่างโค้ดด้านล่างแสดงวิธีรับคลาสของข้อความ:

try (IEWSClient client = EWSClient.getEWSClient(uri, credentials))
{
    ExchangeMessageInfoCollection messageInfoCollection = client.listMessagesFromPublicFolder(publicFolder);

    for (ExchangeMessageInfo messageInfo : messageInfoCollection)
    {
        System.out.println("Message Class: " + messageInfo.getMessageClass());
    }
}

การอ่านอีเมลจากกล่องเมลของผู้ใช้อื่น

บัญชีบางบัญชีบนเซิร์ฟเวอร์ Exchange มีสิทธิ์เข้าถึงหลายกล่องเมล และผู้ใช้บางคนมีหลายบัญชีอีเมลบนเซิร์ฟเวอร์ Exchange เดียวกัน ในทั้งสองกรณี ผู้ใช้สามารถเข้าถึงกล่องเมลของผู้ใช้คนอื่นโดยใช้ Aspose.Email สำหรับ Java API นี้ให้กลไกสำหรับเข้าถึงโฟลเดอร์และอีเมลจากกล่องเมลอื่นโดยใช้ IEWSClient class. ความสามารถนี้สามารถทำได้โดยใช้เวอร์ชันโอเวอร์โหลดของ getMailboxInfo() เมธอดและให้ที่อยู่อีเมลของผู้ใช้เป็นพารามิเตอร์.

โค้ดสคริปต์ต่อไปนี้แสดงวิธีอ่านอีเมลโดยใช้ IEWSClient คลาส.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get Exchange mailbox info of other email account
ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo("otherUser@domain.com");

การแสดงรายการข้อความ

สามารถดึงรายการอีเมลในกล่องจดหมาย Exchange ได้โดยเรียก IEWClient.listMessages เมธอด ใช้เพื่อรับข้อมูลพื้นฐานของข้อความ เช่น หัวเรื่อง, ผู้ส่ง, ผู้รับ และ ID ของข้อความ โดยใช้ listMessages เมธอด.

รายการข้อความอย่างง่าย

เพื่อแสดงรายการข้อความในกล่องเมล Exchange:

สร้างอินสแตนซ์ของ IEWSClient คลาส.
เรียกเมธอด listMessages และสร้างคอลเลกชันของข้อความ.
วนลูปผ่านคอลเลกชันและแสดงข้อมูลข้อความ

โค้ด Java ต่อไปนี้แสดงวิธีเชื่อมต่อกับเซิร์ฟเวอร์ Exchange ด้วย EWS และแสดงรายการข้อความจากโฟลเดอร์ Inbox.

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "UserName", "Password");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to display the basic information
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    System.out.println("Subject: " + msgInfo.getSubject());
    System.out.println("From: " + msgInfo.getFrom().toString());
    System.out.println("To: " + msgInfo.getTo().toString());
    System.out.println("Message ID: " + msgInfo.getMessageId());
    System.out.println("Unique URI: " + msgInfo.getUniqueUri());
}

รายการข้อความจากหลายโฟลเดอร์

โค้ดสคริปต์ข้างต้น, แสดงรายการข้อความทั้งหมดในโฟลเดอร์ Inbox. สามารถรับรายการข้อความจากโฟลเดอร์อื่น ๆ ได้เช่นกัน. IEWClient.listMessages() เมธอดรับ URI ของโฟลเดอร์เป็นพารามิเตอร์ ตราบใดที่ URI ของโฟลเดอร์ถูกต้อง คุณสามารถรับรายการข้อความจากโฟลเดอร์นั้นได้ ใช้คุณสมบัติ IEWSClient.getMailboxInfo().getXXXFolderUri เพื่อรับ URI ของโฟลเดอร์ต่าง ๆ ส่วนที่เหลือของโค้ดเหมือนกับการรับรายการข้อความ โค้ดสคริปต์ต่อไปนี้แสดงวิธีรายการข้อความจากโฟลเดอร์ต่าง ๆ ด้วย EWS.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get folder URI
String strFolderURI = "";
strFolderURI = client.getMailboxInfo().getInboxUri();
strFolderURI = client.getMailboxInfo().getDeletedItemsUri();
strFolderURI = client.getMailboxInfo().getDraftsUri();
strFolderURI = client.getMailboxInfo().getSentItemsUri();

// Get list of messages from the specified folder
ExchangeMessageInfoCollection msgCollection = client.listMessages(strFolderURI);

รายการข้อความพร้อมการสนับสนุนการแบ่งหน้า

โค้ด Java ต่อไปนี้แสดงวิธีรับรายการข้อความพร้อมการสนับสนุนการแบ่งหน้า.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final IEWSClient client = EWSClient.getEWSClient("exchange.domain.com", "username", "password");
try {
    try {
        // Create some test messages to be added to server for retrieval later
        int messagesNum = 12;
        int itemsPerPage = 5;
        MailMessage message = null;
        for (int i = 0; i < messagesNum; i++) {
            message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35157_1 - " + UUID.randomUUID().toString(),
                    "EMAILNET-35157 Move paging parameters to separate class");
            client.appendMessage(client.getMailboxInfo().getInboxUri(), message);
        }
        // Verfiy that the messages have been added to the server
        ExchangeMessageInfoCollection totalMessageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());
        System.out.println(totalMessageInfoCol.size());

        ////////////////// RETREIVING THE MESSAGES USING PAGING SUPPORT ////////////////////////////////////

        List<ExchangeMessagePageInfo> pages = new ArrayList<ExchangeMessagePageInfo>();
        ExchangeMessagePageInfo pageInfo = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage);
        // Total Pages Count
        System.out.println(pageInfo.getTotalCount());

        pages.add(pageInfo);
        while (!pageInfo.getLastPage()) {
            pageInfo = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage, pageInfo.getPageOffset() + 1);
            pages.add(pageInfo);
        }
        int retrievedItems = 0;
        // foreach to while statements conversion
        for (ExchangeMessagePageInfo pageCol : pages) {
            retrievedItems += pageCol.getItems().size();
        }
        // Verify total message count using paging
        System.out.println(retrievedItems);
    } finally {
    }
} finally {
    client.dispose();
}

รับข้อมูลประเภทข้อความจาก ExchangeMessageInfo

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

ExchangeMessageInfoCollection list = client.listMessages(client.getMailboxInfo().getDeletedItemsUri());
System.out.println(list.get_Item(0).getMessageInfoType()); // MessageInfoType

การบันทึกข้อความ

บทความนี้แสดงวิธีรับข้อความจากกล่องเมล Exchange Server และบันทึกลงดิสก์ในรูปแบบ EML และ MSG:

บันทึกเป็น EML ลงดิสก์.
บันทึกไปยังสตรีมหน่วยความจำ.
บันทึกเป็น MSG.

บันทึกข้อความเป็น EML

เพื่อดึงข้อความและบันทึกในรูปแบบ EML:

สร้างอินสแตนซ์ของคลาส IEWSClient.
ระบุ mailboxUri, ชื่อผู้ใช้, รหัสผ่านและโดเมน.
เรียกเมธอด IEWSClient.listMessages() เพื่อรับอินสแตนซ์ของคอลเลกชัน ExchangeMessagesInfoCollection.
วนลูปผ่านคอลเลกชัน ExchangeMessagesInfoCollection เพื่อรับ URI เฉพาะสำหรับแต่ละข้อความ.
เรียกเมธอด IEWSClient.saveMessage() และส่ง URI ที่ไม่ซ้ำกันเป็นพารามิเตอร์.
ให้เมธอด saveMessage() กับพาธที่คุณต้องการบันทึกไฟล์.

โค้ดสคริปต์ต่อไปนี้แสดงวิธีใช้ EWS เชื่อมต่อกับ Exchange Server และบันทึกข้อความเป็นไฟล์ EML.

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    String strMessageURI = msgInfo.getUniqueUri();

    // Now save the message in disk
    client.saveMessage(strMessageURI, dataDir + msgInfo.getMessageId() + "out.eml");
}

บันทึกข้อความไปยังสตรีมหน่วยความจำ

แทนที่จะบันทึกไฟล์ EML ลงดิสก์ สามารถบันทึกลงสตรีมหน่วยความจำได้ ซึ่งเป็นประโยชน์เมื่อคุณต้องการบันทึกสตรีมไปยังที่เก็บข้อมูลเช่นฐานข้อมูล เมื่อสตรีมถูกบันทึกลงฐานข้อมูลแล้ว คุณสามารถโหลดไฟล์ EML กลับเข้าไปใน MailMessage class. โค้ดสคริปต์ต่อไปนี้แสดงวิธีบันทึกข้อความจากกล่องเมล Exchange Server ไปยังสตรีมหน่วยความจำโดยใช้ EWS.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    String strMessageURI = msgInfo.getUniqueUri();

    // Now save the message in memory stream
    ByteArrayOutputStream stream = new ByteArrayOutputStream();
    client.saveMessage(strMessageURI, stream);
}

บันทึกข้อความในรูปแบบ MSG

นี้ IEWSClient.saveMessage() เมธอดสามารถบันทึกข้อความเป็นรูปแบบ EML โดยตรง เพื่อบันทึกเป็นรูปแบบ MSG ก่อนอื่นให้เรียก IEWSClient.fetchMessage() เมธอดที่คืนอินสแตนซ์ของ MailMessage คลาส จากนั้นเรียก MailMessage.save() เมธอดเพื่อบันทึกข้อความเป็น MSG โค้ดสคริปต์ต่อไปนี้แสดงวิธีรับข้อความจากกล่องเมล Exchange Server และบันทึกเป็นรูปแบบ MSG โดยใช้ EWS.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

int count = 0;
// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    String strMessageURI = msgInfo.getUniqueUri();

    // Now get the message details using FetchMessage() and Save message as Msg
    MailMessage message = client.fetchMessage(strMessageURI);
    message.save(dataDir + (count++) + "_out.msg", SaveOptions.getDefaultMsgUnicode());
}

รับ ExchangeMessageInfo จาก Message URI

ข้อความอีเมลถูกแทนด้วยตัวระบุที่ไม่ซ้ำกัน, URI, และเป็นส่วนสำคัญของ ExchangeMessageInfo อ็อบเจ็กต์. ในกรณีที่มีเฉพาะ URI ของข้อความเท่านั้น แล้ว ExchangeMessageInfo อ็อบเจ็กต์สามารถดึงได้โดยใช้ข้อมูลที่มีอยู่นี้ เวอร์ชันโอเวอร์โหลดของ listMessages รับรายการ Ids เพื่อใช้ ExchangeMessageInfoCollection. โค้ดสคริปต์ต่อไปนี้แสดงวิธีรับ ExchangeMessageInfo จาก URI ของข้อความ.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "user@domain.com", "pwd", "domain");

List<String> ids = new ArrayList<String>();
List<MailMessage> messages = new ArrayList<MailMessage>();

for (int i = 0; i < 5; i++) {
    MailMessage message = new MailMessage("user@domain.com", "receiver@domain.com", "EMAILNET-35033 - " + UUID.randomUUID().toString(),
            "EMAILNET-35033 Messages saved from Sent Items folder doesn't contain 'To' field");
    messages.add(message);
    String uri = client.appendMessage(message);
    ids.add(uri);
}

ExchangeMessageInfoCollection messageInfoCol = client.listMessages(ids);

for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) messageInfoCol) {
    // Do something ...
    System.out.println(messageInfo.getUniqueUri());
}

ดึงข้อความจากกล่องจดหมาย Exchange Server

การแสดงรายการข้อความบน Exchange Server ใช้เมธอด listMessages() เมธอดเพื่อดึงรายการข้อความจากกล่องจดหมาย Exchange Server. เมธอด listMessages() เมธอดนี้รับข้อมูลพื้นฐานของข้อความ เช่น หัวข้อ, รหัสข้อความ, ผู้ส่งและผู้รับ เพื่อรับรายละเอียดของข้อความทั้งหมด Aspose.Email.Exchange มีเมธอด IEWSClient.fetchMessage() เมธอดนี้รับ URI ของข้อความเป็นพารามิเตอร์และคืนค่าอินสแตนซ์ของ MailMessage คลาส. เมธอด MailMessage class จากนั้นจะให้รายละเอียดของข้อความ เช่น เนื้อหา, ส่วนหัวและไฟล์แนบ ค้นหาข้อมูลเพิ่มเติมเกี่ยวกับ MailMessage API หรือค้นหาวิธีจัดการอีเมลด้วย MailMessage class. เพื่อดึงข้อความจากกล่องเมลของ Exchange Server:

สร้างอินสแตนซ์ของประเภท IEWSClient.
ระบุชื่อเซิร์ฟเวอร์, ชื่อผู้ใช้, รหัสผ่านและโดเมน.
เรียก listMessages เพื่อรับ ExchangeMessageInfoCollection.
วนลูปผ่านคอลเลกชัน ExchangeMessageInfoCollection เพื่อรับค่า ExchangeMessageInfo.UniqueURI.
เรียก IEWSClient.fetchMessage() และส่ง ExchangeMessageInfo.UniqueURI เป็นพารามิเตอร์.

โค้ดสคริปต์ต่อไปนี้แสดงให้คุณเชื่อมต่อกับกล่องเมลของ Exchange Server และดึงข้อความทั้งหมดโดยใช้ EWS.

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    String strMessageURI = msgInfo.getUniqueUri();

    // Now get the message details using FetchMessage()
    MailMessage msg = client.fetchMessage(strMessageURI);

    for (Attachment att : (Iterable<Attachment>) msg.getAttachments()) {
        System.out.println("Attachment Name: " + att.getName());
    }
}

ใช้เมธอด FetchItem เพื่อดึงข้อความ

หมายเหตุ, the FetchItem เมธอดส่งคืนข้อความโดยไม่มีไฟล์แนบ เพื่อดึงข้อความที่มีไฟล์แนบ ให้ใช้ FetchItem เมธอด, อธิบายไว้ในส่วนต่อไปนี้.

นี้ FetchItem เมธอดนี้เป็นที่แนะนำหากคุณต้องการดึง MapiMessage และทำงานกับคุณสมบัติของ MAPI คุณยังสามารถใช้เมธอดนี้เพื่อดึงข้อมูลรายการ Outlook ใด ๆ เช่น รายชื่อติดต่อ, นัดหมาย, งาน เป็นต้น

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : msgCollection)
{
    // Now get the message using FetchItem()
    MapiMessage msg = client.fetchItem(msgInfo.getUniqueUri());

    // If necessary, you can cast the MapiMessage to the proper item type to simplify working with its properties.
    MapiContact contact = (MapiContact) msg.toMapiMessageItem();
}

ดึงขนาดข้อความล่วงหน้า

Microsoft Outlook InterOp มีฟีเจอร์การดึงขนาดข้อความก่อนที่จะดึงข้อความเต็มจากเซิร์ฟเวอร์ ในกรณีของ Aspose.Email API ข้อมูลสรุปที่ดึงจาก Exchange server แสดงโดย ExchangeMessageInfo คลาส มันให้คุณลักษณะเดียวกันในการดึงขนาดข้อความโดยใช้คุณสมบัติ Size เพื่อดึงขนาดข้อความ จะใช้การเรียกมาตรฐานไปยัง listMessages ของ IEWSClient ซึ่งดึงคอลเลกชันของ ExchangeMessageInfo. โค้ดส่วนต่อไปนี้จะแสดงวิธีแสดงขนาดข้อความโดยใช้ ExchangeMessageInfo คลาส.

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to display the basic information
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    System.out.println("Subject: " + msgInfo.getSubject());
    System.out.println("From: " + msgInfo.getFrom().toString());
    System.out.println("To: " + msgInfo.getTo().toString());
    System.out.println("Message Size: " + msgInfo.getSize());
    System.out.println("==================================");
}

ดาวน์โหลดข้อความอย่างทำซ้ำ

นี้ EWSClient’s listSubFolders() เมธอดนี้สามารถใช้เพื่อดึงข้อความจากโฟลเดอร์และโฟลเดอร์ย่อยจากกล่องข้อความของ Exchange Server อย่างทำซ้ำได้ ต้องใช้ Exchange Server 2007 หรือใหม่กว่า เนื่องจากใช้ EWS โค้ดส่วนต่อไปนี้จะแสดงวิธีดาวน์โหลดกล่องเมลทั้งหมด (โฟลเดอร์และโฟลเดอร์ย่อย) ของ Exchange Server โครงสร้างโฟลเดอร์จะถูกสร้างในเครื่องและดาวน์โหลดข้อความทั้งหมด

public static void run() {
    try {
        downloadAllMessages();
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

private static void downloadAllMessages() {
    try {
        String rootFolder = domain + "-" + username;
        new File(rootFolder).mkdirs();
        String inboxFolder = rootFolder + "\\Inbox";
        new File(inboxFolder).mkdirs();

        System.out.println("Downloading all messages from Inbox....");
        // Create instance of IEWSClient class by giving credentials
        IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", username, password, domain);

        ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
        System.out.println("Mailbox URI: " + mailboxInfo.getMailboxUri());
        String rootUri = client.getMailboxInfo().getRootUri();
        // List all the folders from Exchange server
        ExchangeFolderInfoCollection folderInfoCollection = client.listSubFolders(rootUri);
        for (ExchangeFolderInfo folderInfo : (Iterable<ExchangeFolderInfo>) folderInfoCollection) {
            // Call the recursive method to read messages and get sub-folders
            listMessagesInFolder(client, folderInfo, rootFolder);
        }

        System.out.println("All messages downloaded.");
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

// Recursive method to get messages from folders and sub-folders
private static void listMessagesInFolder(IEWSClient client, ExchangeFolderInfo folderInfo, String rootFolder) {
    // Create the folder in disk (same name as on IMAP server)
    String currentFolder = rootFolder + "\\" + folderInfo.getDisplayName();
    new File(currentFolder).mkdirs();

    // List messages
    ExchangeMessageInfoCollection msgInfoColl = client.listMessages(folderInfo.getUri());
    System.out.println("Listing messages....");
    int i = 0;
    for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgInfoColl) {
        // Get subject and other properties of the message
        System.out.println("Subject: " + msgInfo.getSubject());

        // Get rid of characters like ? and :, which should not be included in a file name
        String fileName = msgInfo.getSubject().replace("?", " ").replace(":", " ");

        MailMessage msg = client.fetchMessage(msgInfo.getUniqueUri());
        msg.save(dataDir + "\\" + fileName + "-" + i + ".msg");

        i++;
    }
    System.out.println("============================\n");
    try {
        // If this folder has sub-folders, call this method recursively to get messages
        ExchangeFolderInfoCollection folderInfoCollection = client.listSubFolders(folderInfo.getUri());
        for (ExchangeFolderInfo subfolderInfo : (Iterable<ExchangeFolderInfo>) folderInfoCollection) {
            listMessagesInFolder(client, subfolderInfo, currentFolder);
        }
    } catch (java.lang.RuntimeException e) {
    }
}

ดาวน์โหลดข้อความจากโฟลเดอร์สาธารณะ

Microsoft Exchange Server อนุญาตให้ผู้ใช้สร้างโฟลเดอร์สาธารณะและโพสต์ข้อความในนั้น เพื่อทำผ่านแอปพลิเคชันของคุณ ให้ใช้ Aspose.Email’s EWSClient คลาสสำหรับเชื่อมต่อกับ Exchange Server และอ่านและดาวน์โหลดข้อความและโพสต์จากโฟลเดอร์สาธารณะ โค้ดส่วนต่อไปนี้จะแสดงวิธีอ่านโฟลเดอร์สาธารณะทั้งหมดและโฟลเดอร์ย่อย, และแสดงรายการและดาวน์โหลดข้อความใด ๆ ที่พบในโฟลเดอร์เหล่านี้ ตัวอย่างนี้ทำงานได้เฉพาะกับ Microsoft Exchange Server 2007 หรือใหม่กว่าเนื่องจากมีการสนับสนุน EWS เท่านั้น

public static void run() {
    try {
        readPublicFolders();
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

private static void readPublicFolders() {
    NetworkCredential credential = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);

    ExchangeFolderInfoCollection folders = client.listPublicFolders();
    for (ExchangeFolderInfo publicFolder : (Iterable<ExchangeFolderInfo>) folders) {
        System.out.println("Name: " + publicFolder.getDisplayName());
        System.out.println("Subfolders count: " + publicFolder.getChildFolderCount());
        listMessagesFromSubFolder(publicFolder, client);

    }
}

private static void listMessagesFromSubFolder(ExchangeFolderInfo publicFolder, IEWSClient client) {
    System.out.println("Folder Name: " + publicFolder.getDisplayName());
    ExchangeMessageInfoCollection msgInfoCollection = client.listMessagesFromPublicFolder(publicFolder);
    for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) msgInfoCollection) {
        MailMessage msg = client.fetchMessage(messageInfo.getUniqueUri());
        System.out.println(msg.getSubject());
        msg.save(dataDir + msg.getSubject() + ".msg", SaveOptions.getDefaultMsgUnicode());
    }

    // Call this method recursively for any subfolders
    if (publicFolder.getChildFolderCount() > 0) {
        ExchangeFolderInfoCollection subfolders = client.listSubFolders(publicFolder);
        for (ExchangeFolderInfo subfolder : (Iterable<ExchangeFolderInfo>) subfolders) {
            listMessagesFromSubFolder(subfolder, client);
        }
    }
}

ย้ายข้อความ

คุณสามารถย้ายอีเมลจากโฟลเดอร์หนึ่งไปยังอีกโฟลเดอร์โดยใช้ IEWSClient คลาส ย้าย เมธอด รับพารามิเตอร์:

URI ที่เป็นเอกลักษณ์ของข้อความที่ต้องการย้าย
URI ที่เป็นเอกลักษณ์ของโฟลเดอร์ปลายทาง

ย้ายข้อความระหว่างโฟลเดอร์

โค้ดส่วนต่อไปนี้จะแสดงวิธีย้ายข้อความในกล่องเมลจากโฟลเดอร์ Inbox ไปยังโฟลเดอร์ชื่อ Processed. ในตัวอย่างนี้, แอปพลิเคชัน:

อ่านข้อความจากโฟลเดอร์ Inbox
ประมวลผลข้อความบางส่วนตามเกณฑ์ (ในตัวอย่างนี้เราค้นหาคำสำคัญในหัวข้อข้อความ)
ย้ายข้อความที่ตรงตามเงื่อนไขที่กำหนดไปยังโฟลเดอร์ processed

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();

// List all messages from Inbox folder
System.out.println("Listing all messages from Inbox....");
ExchangeMessageInfoCollection msgInfoColl = client.listMessages(mailboxInfo.getInboxUri());
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgInfoColl) {
    // Move message to "Processed" folder, after processing certain messages based on some criteria
    if (msgInfo.getSubject() != null && msgInfo.getSubject().toLowerCase().contains("process this message")) {
        client.moveItem(mailboxInfo.getDeletedItemsUri(), msgInfo.getUniqueUri()); // EWS
        System.out.println("Message moved...." + msgInfo.getSubject());
    } else {
        // Do something else
    }
}

ลบข้อความ

คุณสามารถลบอีเมลจากโฟลเดอร์ได้โดยใช้ IEWSClient คลาส deleteItem เมธอดนี้รับ URI เฉพาะของข้อความเป็นพารามิเตอร์

โค้ดสคริปต์ต่อไปนี้แสดงวิธีลบข้อความจากโฟลเดอร์ Inbox เพื่อเป็นตัวอย่าง โค้ด:

อ่านข้อความจากโฟลเดอร์ Inbox
ประมวลผลข้อความตามเกณฑ์บางอย่าง (ในตัวอย่างนี้เราค้นหาคำสำคัญในหัวเรื่องของข้อความ)
ลบข้อความ.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();

// List all messages from Inbox folder
System.out.println("Listing all messages from Inbox....");
ExchangeMessageInfoCollection msgInfoColl = client.listMessages(mailboxInfo.getInboxUri());
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgInfoColl) {
    // Delete message based on some criteria
    if (msgInfo.getSubject() != null && msgInfo.getSubject().toLowerCase().contains("delete") == true) {
        client.deleteItem(msgInfo.getUniqueUri(), DeletionOptions.getDeletePermanently()); // EWS
        System.out.println("Message deleted...." + msgInfo.getSubject());
    } else {
        // Do something else
    }
}

การคัดลอกข้อความ

Aspose.Email API อนุญาตให้คัดลอกข้อความจากโฟลเดอร์หนึ่งไปยังอีกโฟลเดอร์โดยใช้ copyItem เมธอด. เวอร์ชันที่โอเวอร์โหลดของเมธอดนี้จะคืนค่า URI ที่ไม่ซ้ำของข้อความที่คัดลอกตามที่แสดงในบทความนี้.

คัดลอกข้อความไปยังโฟลเดอร์อื่น

โค้ดสคริปต์ต่อไปนี้แสดงวิธีคัดลอกข้อความไปยังโฟลเดอร์อื่น.

try {
    // Create instance of EWSClient class by giving credentials
    IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
    MailMessage message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-34997 - " + UUID.randomUUID().toString(),
            "EMAILNET-34997 Exchange: Copy a message and get reference to the new Copy item");
    String messageUri = client.appendMessage(message);
    String newMessageUri = client.copyItem(messageUri, client.getMailboxInfo().getDeletedItemsUri());
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

Java: กรองข้อความจากกล่องจดหมาย Exchange

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

Aspose.Email for Java มีความสามารถในการกรองข้อความจากกล่องจดหมาย Exchange ด้วย EWSClient และ ExchangeQueryBuilder. สามารถกรองข้อความโดยใช้เกณฑ์ต่าง ๆ เช่น ตามวันที่, โดเมน, message-id, และการแจ้งเตือนการจัดส่งเมล. บทความนี้แสดงวิธีกรองข้อความจาก Exchange Server โดยใช้เกณฑ์ที่แตกต่างกัน.

การกรองข้อความโดยใช้ EWS

นี้ IEWSClient class ให้ listMessages() เมธอดที่ดึงข้อความทั้งหมดจากกล่องเมล. เพื่อดึงเฉพาะข้อความที่ตรงกับเงื่อนไขบางอย่าง, ใช้เมธอดที่มีการโอเวอร์โหลด listMessages() เมธอดที่รับค่า MailQuery คลาสเป็นอาร์กิวเมนต์ เมธอด MailQuery คลาสนี้ให้คุณสมบัติต่างๆ สำหรับระบุเงื่อนไข เช่น วันที่, หัวเรื่อง, ผู้ส่งและผู้รับ. นอกจากนี้ API ยังอนุญาตให้ใช้ตัวกรองความไวต่อขนาดตัวอักษรสำหรับดึงอีเมลจากกล่องจดหมาย.

การกรองข้อความ

เพื่อดึงข้อความที่กรองจากกล่องจดหมาย:

เชื่อมต่อกับเซิร์ฟเวอร์ Exchange.
สร้างอินสแตนซ์ของ MailQuery และตั้งค่าคุณสมบัติที่ต้องการ.
เรียกเมธอด IEWSClient.listMessages() และส่ง MailQuery ในพารามิเตอร์เพื่อรับเฉพาะข้อความที่กรองแล้ว.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีเชื่อมต่อกับกล่องเมล IMAP และรับข้อความที่มีสตริง "Newsletter" ในหัวเรื่องและส่งในวันนี้.

try {
    // Connect to EWS
    final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
    final String username = "username";
    final String password = "password";
    final String domain = "domain";

    IEWSClient client = EWSClient.getEWSClient(mailboxUri, username, password, domain);

    // Query building by means of ExchangeQueryBuilder class
    ExchangeQueryBuilder builder = new ExchangeQueryBuilder();

    // Set Subject and Emails that arrived today
    builder.getSubject().contains("Newsletter");
    builder.getInternalDate().on(new Date());

    MailQuery query = builder.getQuery();

    // Get list of messages
    ExchangeMessageInfoCollection messages = client.listMessages(client.getMailboxInfo().getInboxUri(), query, false);
    System.out.println("EWS: " + messages.size() + " message(s) found.");

    // Disconnect from EWS
    client.dispose();
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

กรองข้อความตามเกณฑ์

ตัวอย่างโค้ดข้างต้นกรองข้อความตามหัวเรื่องและวันที่ของอีเมล เราสามารถกรองตามคุณสมบัติอื่น ๆ ได้ด้วย ตัวอย่างต่อไปนี้แสดงการตั้งเงื่อนไขโดยใช้ MailQuery.

กรองข้อความตามวันที่วันนี้

โค้ดตัวอย่างต่อไปนี้แสดงวิธีกรองอีเมลทั้งหมดโดยอิงจากวันที่ของวันนี้.

// Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();
builder.getInternalDate().on(new Date());

กรองข้อความตามช่วงวันที่

โค้ดสแนปพัดด้านล่างแสดงวิธีกรองอีเมลทั้งหมดตามช่วงวันที่.

// Emails that arrived in last 7 days
Calendar cal = Calendar.getInstance();
builder.getInternalDate().before(cal.getTime());
cal.add(Calendar.DATE, -7);
builder.getInternalDate().since(cal.getTime());

กรองข้อความตามผู้ส่งที่ระบุ

โค้ดสแนปพัดด้านล่างแสดงวิธีกรองอีเมลทั้งหมดตามผู้ส่งเฉพาะ.

// Get emails from specific sender
builder.getFrom().contains("saqib.razzaq@127.0.0.1");

กรองข้อความตามโดเมนที่ระบุ

โค้ดสแนปพัดด้านล่างแสดงวิธีกรองอีเมลทั้งหมดตามโดเมนเฉพาะ.

// Get emails from specific domain
builder.getFrom().contains("SpecificHost.com");

กรองข้อความตามผู้รับที่ระบุ

โค้ดสแนปพัดด้านล่างแสดงวิธีกรองอีเมลทั้งหมดตามผู้รับเฉพาะ.

// Get emails sent to specific recipient
builder.getTo().contains("recipient");

กรองข้อความโดย MessageID

โค้ดสแนปพัดด้านล่างแสดงวิธีกรองอีเมลทั้งหมดตาม MessageID.

// Get email with specific MessageId
ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
builder.getMessageId().equals("MessageID");

กรองข้อความโดยใช้การแจ้งเตือนการจัดส่งเมล์ทั้งหมด

โค้ดสแนปพัดด้านล่างแสดงวิธีกรองอีเมลทั้งหมดตามการแจ้งเตือนการจัดส่งเมลทั้งหมด.

// Get Mail Delivery Notifications
builder = new ExchangeQueryBuilder();
builder.getContentClass().equals(ContentClassType.getMDN().toString());

กรองข้อความตามขนาด

builder = new ExchangeQueryBuilder();
builder.getItemSize().greater(80000);

กรองข้อความด้วยค่าสตริง

โค้ดตัวอย่างต่อไปนี้แสดงวิธีกรองอีเมลทั้งหมดโดยอิงจากสตริงที่กำหนดในส่วนหัว (หัวเรื่อง, จาก, ถึง, cc). The getText() เมธอดคืนค่าข้อความสตริงพร้อมกับเนื้อหาของข้อความ.

 ExchangeQueryBuilder builder = new ExchangeQueryBuilder();

builder.getText().equals("SomeText");

MailQuery query = builder.getQuery();

ExchangeMessageInfoCollection messages = ewsClient.listMessages("InboxUri", query, false);

กรองข้อความในลำดับเพิ่มลง/ลดลง

Aspose.Email ให้ ComparisonField.orderBy(boolean ascending) เมธอดที่ตั้งค่าบ่งชี้ว่าคลายันต์ใช้การเรียงลำดับจากน้อยไปมากหรือมากไปน้อยบนฟิลด์ค้นหา. มันทำให้คุณเรียงข้อความอีเมลตามลำดับจากน้อยไปมาก/มากไปน้อยตามเกณฑ์ที่ระบุโดย MailQueryBuilder.

ส่วนของโค้ดด้านล่างแสดงวิธีกรองข้อความตามลำดับจากน้อยไปมาก/มากไปน้อย:

MailQueryBuilder builder = new MailQueryBuilder();
builder.getSubject().contains("Report");
builder.getInternalDate().since(sinceDate);
builder.getSubject().orderBy(true); // sort the subject ascending
builder.getInternalDate().orderBy(false); // sort the date descending  

ExchangeMessageInfoCollection miColl = client.listMessages(client.getMailboxInfo().getInboxUri(), builder.getQuery());

การสร้างคิวรีซับซ้อน

หากแตกต่าง MailQueryBuilder คุณสมบัติตั้งค่าในคำสั่งแยกต่างหาก, ทุกเงื่อนไขจะตรงกัน. ตัวอย่างเช่น เพื่อรับข้อความในช่วงวันที่ระบุและจากโฮสต์เฉพาะ, เขียนสามคำสั่ง:

การรวมคิวรีด้วย AND

ส่วนของโค้ดต่อไปนี้แสดงวิธีรวมคิวรีด้วย AND.

// Emails from specific host, get all emails that arrived before today and all emails that arrived since 7 days ago
builder.getFrom().contains("SpecificHost.com");
Calendar cal = Calendar.getInstance();
builder.getInternalDate().before(cal.getTime());
cal.add(Calendar.DATE, -7);
builder.getInternalDate().since(cal.getTime());

การรวมคิวรีด้วย OR

MailQueryBuilder ให้ or() เมธอดที่รับสอง MailQuery อินสแตนซ์เป็นพารามิเตอร์. มันรับข้อความที่ตรงกับเงื่อนไขใดเงื่อนไขหนึ่งจากสองเงื่อนไขที่กำหนด. ตัวอย่างด้านล่างกรองข้อความที่หรือมีคำ "test" ในหัวเรื่องหรือ "noreply@host.com" เป็นผู้ส่ง. ส่วนของโค้ดต่อไปนี้แสดงวิธีรวมคิวรีด้วย OR.

builder.or(builder.getSubject().contains("test"), builder.getFrom().contains("noreply@host.com"));

การกรองอีเมลแบบแยกแยะตัวพิมพ์ใหญ่-เล็ก

อีเมลสามารถกรองโดยพิจารณาความแตกต่างของตัวพิมพ์โดยระบุแฟล็ก IgnoreCase ในเกณฑ์การกรองตามที่แสดงในส่วนของโค้ดต่อไปนี้.

// Query building by means of ExchangeQueryBuilder class
ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
builder.getSubject().contains("Newsletter", true);
builder.getInternalDate().on(new Date());
MailQuery query = builder.getQuery();

การกรองข้อความพร้อมการรองรับการแบ่งหน้า

int itemsPerPage = 5;
String sGuid = UUID.randomUUID().toString();
String str1 = sGuid + " - " + "Query 1";
String str2 = sGuid + " - " + "Query 2";

MailQueryBuilder queryBuilder1 = new MailQueryBuilder();
queryBuilder1.getSubject().contains(str1);
MailQuery query1 = queryBuilder1.getQuery();
List<ExchangeMessagePageInfo> pages = new ArrayList<ExchangeMessagePageInfo>();
ExchangeMessagePageInfo pageInfo = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), query1, itemsPerPage);
pages.add(pageInfo);
int str1Count = pageInfo.getItems().size();
while (!pageInfo.getLastPage()) {
    pageInfo = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), query1, itemsPerPage, pageInfo.getPageOffset() + 1);
    pages.add(pageInfo);
    str1Count += pageInfo.getItems().size();
}

Java: การจัดการรายการสนทนา

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

Aspose.Email for Java สามารถใช้เพื่อจัดการรายการสนทนาบน Exchange Server ด้วย EWSClient คลาส นี้ใช้ Exchange Web Services ซึ่งมีเฉพาะใน Exchange Server 2007 ขึ้นไป บทความนี้แสดงวิธีการ ค้นหา, คัดลอก, ย้าย และ ลบ รายการสนทนาบน Exchange Server 2010 ต้องใช้ Microsoft Exchange Server 2010 Service Pack 1 สำหรับคุณลักษณะทั้งหมดที่รวมอยู่ในส่วนนี้.

การค้นหาการสนทนา

เพื่อรับข้อมูลการสนทนาจากโฟลเดอร์เฉพาะบน Exchange Server:

เชื่อมต่อกับ Exchange Server โดยใช้คลาส IEWSClient.
เรียกเมธอด IEWSClient.findConversations() เพื่อค้นหารายการสนทนาทั้งหมดจากโฟลเดอร์.
แสดงคุณสมบัติของรายการสนทนา เช่น ID, หัวข้อการสนทนา และสถานะธง.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการค้นหาการสนทนา.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Find Conversation Items in the Inbox folder
ExchangeConversation[] conversations = client.findConversations(client.getMailboxInfo().getInboxUri());
// Show all conversations
for (ExchangeConversation conversation : conversations) {
    // Display conversation properties like Id and Topic
    System.out.println("Topic: " + conversation.getConversationTopic());
    System.out.println("Flag Status: " + conversation.getFlagStatus());
    System.out.println();
}

การคัดลอกการสนทนา

เพื่อคัดลอกการสนทนาจากโฟลเดอร์หนึ่งไปยังอีกโฟลเดอร์:

เชื่อมต่อกับ Exchange Server โดยใช้คลาส IEWSClient.
เรียกเมธอด IEWSClient.copyConversationItems() เพื่อคัดลอกรายการสนทนาจากโฟลเดอร์ต้นทางไปยังโฟลเดอร์ปลายทาง.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการคัดลอกการสนทนา.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Find those Conversation Items in the Inbox folder which we want to copy
ExchangeConversation[] conversations = client.findConversations(client.getMailboxInfo().getInboxUri());
for (ExchangeConversation conversation : conversations) {
    System.out.println("Topic: " + conversation.getConversationTopic());
    // Copy the conversation item based on some condition
    if (conversation.getConversationTopic().contains("test email")) {
        client.copyConversationItems(conversation.getConversationId(), client.getMailboxInfo().getDeletedItemsUri());
        System.out.println("Copied the conversation item to another folder");
    }
}

การย้ายการสนทนา

เพื่อย้ายการสนทนาจากโฟลเดอร์หนึ่งไปยังอีกโฟลเดอร์:

เชื่อมต่อกับ Exchange Server โดยใช้คลาส IEWSClient.
เรียกเมธอด IEWSClient.moveConversationItems() เพื่อย้ายการสนทนาจากโฟลเดอร์ต้นทางไปยังโฟลเดอร์ปลายทาง.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการย้ายการสนทนา.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Find those Conversation Items in the Inbox folder which we want to move
ExchangeConversation[] conversations = client.findConversations(client.getMailboxInfo().getInboxUri());

for (ExchangeConversation conversation : conversations) {
    System.out.println("Topic: " + conversation.getConversationTopic());
    // Move the conversation item based on some condition
    if (conversation.getConversationTopic().contains("test email") == true) {
        client.moveConversationItems(conversation.getConversationId(), client.getMailboxInfo().getDeletedItemsUri());
        System.out.println("Moved the conversation item to another folder");
    }
}

การลบการสนทนา

เพื่อลบการสนทนาจากโฟลเดอร์:

เชื่อมต่อกับ Exchange Server โดยใช้คลาส IEWSClient.
เรียกเมธอด IEWSClient.deleteConversationItems() เพื่อลบรายการสนทนาจากโฟลเดอร์ต้นทาง.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการลบการสนทนา.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Find those Conversation Items in the Inbox folder which we want to delete
ExchangeConversation[] conversations = client.findConversations(client.getMailboxInfo().getInboxUri());
for (ExchangeConversation conversation : conversations) {
    System.out.println("Topic: " + conversation.getConversationTopic());
    // Delete the conversation item based on some condition
    if (conversation.getConversationTopic().contains("test email") == true) {
        client.deleteConversationItems(conversation.getConversationId());
        System.out.println("Deleted the conversation item");
    }
}

Java: ทำงานกับรายการปฏิทินบน Exchange Server

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

การส่งคำขอประชุม

บทความนี้แสดงวิธีส่งคำขอประชุมไปยังผู้รับหลายคนโดยใช้ Exchange Web Services และ Aspose.Email.

สร้างคำขอประชุมโดยใช้คลาส Appointment และตั้งค่าที่ตั้ง, เวลา, และผู้เข้าร่วม.
สร้างอินสแตนซ์ของคลาส MailMessage และตั้งค่านัดหมายโดยใช้เมธอด MailMessage.addAlternateView().
เชื่อมต่อกับ Exchange Server และส่งคำขอประชุมโดยใช้เมธอด send(MailMessage).

นี้ EWSClient คลาสนี้สามารถใช้เชื่อมต่อกับ Exchange Server ที่รองรับ Exchange Web Services (EWS). เพื่อให้ทำงานได้, เซิร์ฟเวอร์ต้องเป็น Exchange Server 2007 หรือใหม่กว่า. โค้ดตัวอย่างต่อไปนี้แสดงวิธีใช้ EWS เพื่อส่งคำขอประชุม.

try {
    // Create instance of IEWSClient class by giving credentials
    IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

    Calendar c = Calendar.getInstance();
    c.add(Calendar.HOUR_OF_DAY, 1);
    Date startTime = c.getTime();
    c.add(Calendar.MINUTE, 90);
    Date endTime = c.getTime();

    // Create the meeting request
    Appointment app = new Appointment("meeting request", startTime, endTime, MailAddress.to_MailAddress("administrator@test.com"),
            MailAddressCollection.to_MailAddressCollection("bob@test.com"));
    app.setSummary("meeting request summary");
    app.setDescription("description");

    c = Calendar.getInstance();
    c.add(Calendar.DATE, 5);
    RecurrencePattern pattern = new DailyRecurrencePattern(c.getTime());
    app.setRecurrence(pattern);

    // Create the message and set the meeting request
    MailMessage msg = new MailMessage();
    msg.setFrom(MailAddress.to_MailAddress("administrator@test.com"));
    msg.setTo(MailAddressCollection.to_MailAddressCollection("bob@test.com"));
    msg.isBodyHtml(true);
    msg.setHtmlBody("<h3>HTML Heading</h3><p>Email Message detail</p>");
    msg.setSubject("meeting request");
    msg.addAlternateView(app.requestApointment(0));

    // send the appointment
    client.send(msg);
    System.out.println("Appointment request sent");
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

การทำงานกับรายการปฏิทินโดยใช้ EWS

Aspose.Email มีความสามารถในการเพิ่ม, อัปเดต และยกเลิกนัดหมายโดยใช้ไคลเอนต์ Exchange Web Service (EWS). IEWSClients createAppointment, updateAppointment, และ cancelAppointment เมธอดเหล่านี้อนุญาตให้จัดการรายการปฏิทินโดยใช้ EWS. บทความนี้ให้ตัวอย่างโค้ดอย่างละเอียดเกี่ยวกับการทำงานกับรายการปฏิทิน. ตัวอย่างโค้ดต่อไปนี้แสดงวิธี:

สร้างนัดหมาย.
อัปเดตนัดหมาย.
ลบ/ยกเลิกนัดหมาย.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "your.username", "your.Password");
Calendar c = Calendar.getInstance();
c.set(Calendar.MINUTE, 0);
c.set(Calendar.SECOND, 0);
c.set(Calendar.MILLISECOND, 0);
Date startTime = c.getTime();
c.add(Calendar.HOUR_OF_DAY, 1);
Date endTime = c.getTime();
String timeZone = "America/New_York";

Appointment app = new Appointment("Room 112", startTime, endTime, MailAddress.to_MailAddress("organizeraspose-email.test3@domain.com"),
        MailAddressCollection.to_MailAddressCollection("attendee@gmail.com"));
app.setTimeZone(timeZone);
app.setSummary("NETWORKNET-34136" + UUID.randomUUID().toString());
app.setDescription("NETWORKNET-34136 Exchange 2007/EWS: Provide support for Add/Update/Delete calendar items");

String uid = client.createAppointment(app);
Appointment fetchedAppointment1 = client.fetchAppointment(uid);
app.setLocation("Room 115");
app.setSummary("New summary for " + app.getSummary());
app.setDescription("New Description");
client.updateAppointment(app);

Appointment[] appointments1 = client.listAppointments();
System.out.println("Total Appointments: " + appointments1.length);
Appointment fetchedAppointment2 = client.fetchAppointment(uid);
System.out.println("Summary: " + fetchedAppointment2.getSummary());
System.out.println("Location: " + fetchedAppointment2.getLocation());
System.out.println("Description: " + fetchedAppointment2.getDescription());
client.cancelAppointment(app);
Appointment[] appointments2 = client.listAppointments();
System.out.println("Total Appointments: " + appointments2.length);

คืนค่ารายการปฏิทินที่เกิดซ้ำภายในช่วงวันที่ที่ระบุ

Aspose.Email EWSClient รองรับการคืนค่ารายการปฏิทินที่เกิดซ้ำภายในช่วงที่กำหนดโดย StartDate และ EndDate. The AppointmentQueryBuilder.setCalendarView(Date startDate, Date endDate, int maxEntriesReturned) เมธอด, หากกำหนด CalendarView, จะคืนค่ารายการของรายการปฏิทินเดี่ยวและเหตุการณ์ของรายการปฏิทินที่เกิดซ้ำภายในช่วงที่กำหนดโดย StartDate และ EndDate. พารามิเตอร์ maxEntriesReturned ระบุจำนวนผลลัพธ์สูงสุด (ค่า <= 0 หมายถึงทั้งหมด).

ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
builder.getAppointment().setCalendarView(startDate, endDate, -1);

Appointment[] appointments = client.listAppointments(builder.getQuery());

การแสดงรายการนัดหมายพร้อมการรองรับการแบ่งหน้า

เมธอด ListAppointments ที่เปิดโดย IEWSClient API ดึงรายการนัดหมายทั้งหมดจากเซิร์ฟเวอร์ Exchange. อาจใช้เวลาถ้ามีนัดหมายจำนวนมากบนเซิร์ฟเวอร์ Exchange. API มีเมธอดที่โอเวอร์โหลดของ listAppointments เมธอดที่ให้การรองรับการแบ่งหน้าในปฏิบัติการ. สามารถใช้ร่วมกับฟีเจอร์การค้นหาได้หลายรูปแบบ. เมธอดที่มีการโอเวอร์โหลดต่อไปนี้สามารถใช้เพื่อแสดงรายการนัดหมายจาก Exchange Server พร้อมการรองรับการแบ่งหน้า.

AppointmentCollection IEWSClient.listAppointments(int itemsPerPage).
AppointmentCollection IEWSClient.listAppointments(String folderUri, int itemsPerPage).
AppointmentCollection IEWSClient.listAppointments(MailQuery query, int itemsPerPage).
AppointmentCollection IEWSClient.listAppointments(String folderUri, MailQuery query, int itemsPerPage).
AppointmentCollection IEWSClient.listAppointments(int itemsPerPage, int itemOffset).
AppointmentCollection IEWSClient.listAppointments(String folderUri, int itemsPerPage, int itemOffset).
AppointmentCollection IEWSClient.listAppointments(MailQuery query, int itemsPerPage, int itemOffset).
AppointmentCollection IEWSClient.listAppointments(String folderUri, MailQuery query, int itemsPerPage, int itemOffset).

โค้ดตัวอย่างต่อไปนี้แสดงวิธีแสดงรายการนัดหมายพร้อมการรองรับการแบ่งหน้า.

        IEWSClient client = EWSClient.getEWSClient("exchange.domain.com", "username", "password");
        try {
            try {
                Appointment[] appts = client.listAppointments();
                System.out.println(appts.length);

                Calendar c = Calendar.getInstance();
                c.set(Calendar.MINUTE, 0);
                c.set(Calendar.SECOND, 0);
                c.set(Calendar.MILLISECOND, 0);

                int appNumber = 10;
                Map<String, Appointment> appointmentsDict = new HashMap<String, Appointment>();
                for (int i = 0; i < appNumber; i++) {
                    c.set(Calendar.HOUR_OF_DAY, i + 1);
                    Date startTime = c.getTime();
                    c.set(Calendar.HOUR_OF_DAY, i + 2);
                    Date endTime = c.getTime();

                    String timeZone = "America/New_York";
                    Appointment appointment = new Appointment("Room 112", startTime, endTime, MailAddress.to_MailAddress("from@domain.com"),
                            MailAddressCollection.to_MailAddressCollection("to@domain.com"));
                    appointment.setTimeZone(timeZone);
                    appointment.setSummary("NETWORKNET-35157_3 - " + UUID.randomUUID().toString());
                    appointment.setDescription("EMAILNET-35157 Move paging parameters to separate class");
                    String uid = client.createAppointment(appointment);
                    appointmentsDict.put(uid, appointment);
                }
                AppointmentCollection totalAppointmentCol = AppointmentCollection.to_AppointmentCollection(client.listAppointments());

                ///// LISTING APPOINTMENTS WITH PAGING SUPPORT ///////
                int itemsPerPage = 2;
                List<AppointmentPageInfo> pages = new ArrayList<AppointmentPageInfo>();
                AppointmentPageInfo pagedAppointmentCol = client.listAppointmentsByPage(itemsPerPage);
                System.out.println(pagedAppointmentCol.getItems().size());
                pages.add(pagedAppointmentCol);
                while (!pagedAppointmentCol.getLastPage()) {
                    pagedAppointmentCol = client.listAppointmentsByPage(itemsPerPage, pagedAppointmentCol.getPageOffset() + 1);
                    pages.add(pagedAppointmentCol);
                }
                int retrievedItems = 0;
                // foreach to while statements conversion
                for (AppointmentPageInfo folderCol : pages) {
                    retrievedItems += folderCol.getItems().size();
                }
            } finally {
            }
        } finally {
            client.dispose();
        }

การเพิ่มเหตุการณ์ในโฟลเดอร์ปฏิทินรองบน Exchange Server

Aspose.Email API ช่วยให้คุณสร้างโฟลเดอร์ปฏิทินรองบน Exchange Server โดยใช้ IEWSClient. นัดหมายสามารถเพิ่ม, ปรับปรุง หรือยกเลิกจากปฏิทินรองโดยใช้ createAppointment, updateAppointment และ cancelAppointment เมธอดต่างๆ. เมธอดและคุณสมบัติ API ต่อไปนี้ถูกใช้ในตัวอย่างโค้ดด้านล่างเพื่อแสดงการทำงานของฟีเจอร์นี้. โปรดทราบว่า ฟีเจอร์นี้รองรับโดย Aspose.Email for Java ตั้งแต่เวอร์ชัน 6.5.0 ขึ้นไป.

เมธอด IEWSClient.cancelAppointment(Appointment, String).
เมธอด IEWSClient.cancelAppointment(String, String).
เมธอด IEWSClient.createAppointment(Appointment, String).
เมธอด IEWSClient.createFolder(String, String, ExchangeFolderPermissionCollection, String).
เมธอด IEWSClient.fetchAppointment(String, String).
เมธอด IEWSClient.updateAppointment(Appointment, String).
คุณสมบัติ IEWSClient.CurrentCalendarFolderUri.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีเพิ่มเหตุการณ์ลงในโฟลเดอร์ปฏิทินรองบนเซิร์ฟเวอร์ Exchange.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "your.username", "your.Password");
try {
    try {
        // Create an appointmenta that will be added to secondary calendar folder

        Calendar c = Calendar.getInstance();
        c.set(Calendar.MINUTE, 0);
        c.set(Calendar.SECOND, 0);
        c.set(Calendar.MILLISECOND, 0);
        Date startTime = c.getTime();
        c.add(Calendar.HOUR_OF_DAY, 1);
        Date endTime = c.getTime();

        String timeZone = "America/New_York";

        Appointment[] listAppointments;
        Appointment appointment = new Appointment("Room 121", startTime, endTime, MailAddress.to_MailAddress("from@domain.com"),
                MailAddressCollection.to_MailAddressCollection("attendee@domain.com"));
        appointment.setTimeZone(timeZone);
        appointment.setSummary("EMAILNET-35198 - " + UUID.randomUUID().toString());
        appointment.setDescription("EMAILNET-35198 Ability to add event to Secondary Calendar of Office 365");

        // Verify that the new folder has been created
        ExchangeFolderInfoCollection calendarSubFolders = client.listSubFolders(client.getMailboxInfo().getCalendarUri());

        String getfolderName;
        String setFolderName = "New Calendar";
        boolean alreadyExits = false;

        // Verify that the new folder has been created already exits or not

        for (int i = 0; i < calendarSubFolders.size(); i++) {
            getfolderName = calendarSubFolders.get_Item(i).getDisplayName();

            if (getfolderName.equals(setFolderName)) {
                alreadyExits = true;
            }
        }

        if (alreadyExits) {
            System.out.println("Folder Already Exists");
        } else {
            // Create new calendar folder
            client.createFolder(client.getMailboxInfo().getCalendarUri(), setFolderName, null, "IPF.Appointment");

            System.out.println(calendarSubFolders.size());

            // Get the created folder URI
            String newCalendarFolderUri = calendarSubFolders.get_Item(0).getUri();

            // appointment api with calendar folder uri
            // Create
            client.createAppointment(appointment, newCalendarFolderUri);
            appointment.setLocation("Room 122");
            // update
            client.updateAppointment(appointment, newCalendarFolderUri);
            // list
            listAppointments = client.listAppointments(newCalendarFolderUri);

            // list default calendar folder
            listAppointments = client.listAppointments(client.getMailboxInfo().getCalendarUri());

            // Cancel
            client.cancelAppointment(appointment, newCalendarFolderUri);
            listAppointments = client.listAppointments(newCalendarFolderUri);

            // appointment api with context current calendar folder uri
            client.setCurrentCalendarFolderUri(newCalendarFolderUri);
            // Create
            client.createAppointment(appointment);
            appointment.setLocation("Room 122");
            // update
            client.updateAppointment(appointment);
            // list
            listAppointments = client.listAppointments();

            // list default calendar folder
            listAppointments = client.listAppointments(client.getMailboxInfo().getCalendarUri());

            // Cancel
            client.cancelAppointment(appointment);
            listAppointments = client.listAppointments();

        }
    } finally {
    }
} finally {
    client.dispose();
}

การแชร์คำเชิญปฏิทิน

Microsoft Exchange server ให้ความสามารถในการแชร์ปฏิทินโดยการส่งคำเชิญปฏิทินไปยังผู้ใช้คนอื่นที่ลงทะเบียนบนเซิร์ฟเวอร์ Exchange เดียวกัน. API ของ Aspose.Email ให้ความสามารถเดียวกันโดยอนุญาตให้แชร์ปฏิทินผ่าน EWS API.

final IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
try {
    // delegate calendar access permission
    ExchangeDelegateUser delegateUser = new ExchangeDelegateUser("sharingfrom@domain.com", ExchangeDelegateFolderPermissionLevel.NotSpecified);
    delegateUser.getFolderPermissions().setCalendarFolderPermissionLevel(ExchangeDelegateFolderPermissionLevel.Reviewer);
    client.delegateAccess(delegateUser, "sharingfrom@domain.com");

    // Create invitation
    MapiMessage mapiMessage = client.createCalendarSharingInvitationMessage("sharingfrom@domain.com");
    MailConversionOptions options = new MailConversionOptions();
    options.setConvertAsTnef(true);
    MailMessage mail = mapiMessage.toMailMessage(options);
    client.send(mail);
} finally {
    client.dispose();
}

การดึงข้อมูลแอตทริบิวต์ขยายจากรายการปฏิทิน

IEWSClient client = EWSClient.getEWSClient("https://exchange.office365.com/Exchange.asmx", "username", "password");

java.util.List<String> uriList = java.util.Arrays.asList(client.listItems(client.getMailboxInfo().getCalendarUri()));

// Define the Extended Attribute Property Descriptor for searching purpose
// In this case, we have a K1 Long named property for Calendar item
UUID uuid = UUID.fromString("00020329-0000-0000-C000-000000000046");
PropertyDescriptor propertyDescriptor = new PidNamePropertyDescriptor("K1", PropertyDataType.Integer32, uuid);

java.util.List<PropertyDescriptor> propertyDescriptors = java.util.Arrays.asList(new PropertyDescriptor[] { propertyDescriptor });
IGenericList<MapiCalendar> mapiCalendarList = client.fetchMapiCalendar(uriList, propertyDescriptors);

for (MapiCalendar cal : mapiCalendarList) {
    for (MapiNamedProperty namedProperty : (Iterable<MapiNamedProperty>) cal.getNamedProperties().getValues()) {
        System.out.println(namedProperty.getNameId() + " = " + namedProperty.getInt32());
    }
}

Java: ทำงานกับรายชื่อบน Exchange Server

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

บัญชี Exchange Server มีมากกว่าข้อความอีเมลเท่านั้น รวมถึง ดึงข้อมูล, ย้าย, ส่ง และ ลบข้อความอีเมล จาก Exchange Servers, Aspose.Email อนุญาตให้คุณทำงานกับรายชื่อ บทความนี้อธิบายวิธีดึงข้อมูลรายชื่อโดยใช้ Exchange Web Services บทความนี้ยังแสดงวิธีที่คุณสามารถแสดงรายการรายชื่อจากโฟลเดอร์ Contacts หรือแก้ไขรายชื่อโดยอิงตามชื่อรายชื่อ

ดึงรายชื่อด้วย EWS

Aspose.Email ให้ EWSClient คลาสเพื่อเชื่อมต่อกับ Microsoft Exchange Server โดยใช้ Exchange Web Services โค้ดส่วนต่อไปนี้ใช้ Exchange Web Services เพื่ออ่านรายชื่อทั้งหมด โค้ดส่วนต่อไปนี้จะแสดงวิธีดึง Contacts ด้วย EWS.

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// List all the contacts
Contact[] contacts = client.getContacts(client.getMailboxInfo().getContactsUri());
for (Contact contact : contacts) {
    MapiContact mapiContact = Contact.to_MapiContact(contact);
    // Display name and email address
    System.out.println("Name: " + mapiContact.getNameInfo().getDisplayName() + "+ Email Address: " + mapiContact.getElectronicAddresses().getEmail1());
}

ค้นหารายชื่อโดยใช้ชื่อติดต่อ

โค้ดส่วนต่อไปนี้จะแสดงวิธีใช้ get contacts กับ EWS

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// List all the contacts
Contact[] contacts = client.resolveContacts("Changed Name", ExchangeListContactsOptions.FetchPhoto);
for (Contact c : contacts) {
    MapiContact contact = Contact.to_MapiContact(c);
    // Display name and email address
    System.out.println("Name: " + contact.getNameInfo().getDisplayName() + "+ Email Address: " + contact.getElectronicAddresses().getEmail1());
}

กำหนดรูปแบบหมายเหตุของรายชื่อ

NotesFormat ระบุประเภทรูปแบบข้อความของหมายเหตุรายชื่อที่กำหนดโดยตัวนับ TextFormat.

ดึงรายชื่อโดยใช้ Id

รายชื่อเฉพาะสามารถดึงจากเซิร์ฟเวอร์โดยใช้ contact id ของมันตามตัวอย่างโค้ดต่อไปนี้.

Contact fetchedContact = client.getContact(id);

เพิ่มรายชื่อ

นี้ EWSClient คลาส createContact() เมธอดนี้สามารถใช้เพื่อเพิ่มข้อมูลรายชื่อไปยัง Exchange Server. ส่วน createContact() เมธอดรับ รายชื่อ ออบเจกต์เป็นพารามิเตอร์อินพุต.

เพื่อเพิ่มรายชื่อไปยัง Exchange Server:

เริ่มต้น EWSClient ด้วยที่อยู่และข้อมูลรับรอง.
เริ่มต้นออบเจกต์ Contact ด้วยคุณสมบัติที่ต้องการ.
เรียกเมธอด CreateContact เพื่อเพิ่มรายชื่อไปยัง Exchange Server.

Aspose.Email ให้ EWSClient คลาสสำหรับเชื่อมต่อกับ Microsoft Exchange Server โดยใช้ Exchange Web Services โค้ดส่วนต่อไปนี้จะแสดงวิธีต่อไปนี้ใช้ Exchange Web Services เพื่อเพิ่มรายชื่อไปยัง Exchange Server.

// Set mailboxURI, Username, password, domain information
String mailboxUri = "https://ex2010/ews/exchange.asmx";
String username = "test.exchange";
String password = "pwd";
String domain = "ex2010.local";
NetworkCredential credentials = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// Create New Contact
Contact contact = new Contact();

// Set general info
contact.setGender(Gender.Male);
contact.setDisplayName("Frank Lin");
contact.setCompanyName("ABC Co.");
contact.setJobTitle("Executive Manager");
PhoneNumber tmp0 = new PhoneNumber();
tmp0.setNumber("123456789");
tmp0.setCategory(PhoneNumberCategory.getHome());

// Add Phone numbers
contact.getPhoneNumbers().add(tmp0);
AssociatedPerson tmp1 = new AssociatedPerson();
tmp1.setName("Catherine");
tmp1.setCategory(AssociatedPersonCategory.getSpouse());

// contact's associated persons
contact.getAssociatedPersons().add(tmp1);
AssociatedPerson tmp2 = new AssociatedPerson();
tmp2.setName("Bob");
tmp2.setCategory(AssociatedPersonCategory.getChild());
contact.getAssociatedPersons().add(tmp2);
AssociatedPerson tmp3 = new AssociatedPerson();
tmp3.setName("Merry");
tmp3.setCategory(AssociatedPersonCategory.getSister());
contact.getAssociatedPersons().add(tmp3);
Url tmp4 = new Url();
tmp4.setHref("www.blog.com");
tmp4.setCategory(UrlCategory.getBlog());

// URLs
contact.getUrls().add(tmp4);
Url tmp5 = new Url();
tmp5.setHref("www.homepage.com");
tmp5.setCategory(UrlCategory.getHomePage());
contact.getUrls().add(tmp5);
EmailAddress tmp6 = new EmailAddress();
tmp6.setAddress("Frank.Lin@Abc.com");
tmp6.setDisplayName("Frank Lin");
tmp6.setCategory(EmailAddressCategory.getEmail1());

// Set contact's Email address
contact.getEmailAddresses().add(tmp6);

try {
    client.createContact(contact);
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

อัปเดตรายชื่อ

Contact information can be updated using Microsoft Outlook. Aspose.Email can also update contact information on Exchange Server using the Exchange Web Service (EWS). The IEWSClient’s updateContact() เมธอดนี้สามารถอัปเดตข้อมูลรายชื่อบน Exchange Server.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// List all the contacts and Loop through all contacts
Contact[] contacts = client.getContacts(client.getMailboxInfo().getContactsUri());
Contact contact = contacts[0];
System.out.println("Name: " + contact.getDisplayName());
contact.setDisplayName("David Ch");
client.updateContact(contact);

ลบรายชื่อ

นี้ EWSClient class ให้ deleteItem เพื่อเข้าถึงและลบรายชื่อจากโฟลเดอร์รายชื่อของ Exchange Server เมธอดนี้รับพารามิเตอร์เป็น ID ของรายชื่อ.

เพื่อที่จะลบรายชื่อจาก Exchange Server:

เริ่มต้น ExchangeWebServiceClient ด้วยที่อยู่และข้อมูลรับรอง.
ลบรายชื่อโดยใช้ ID ของมัน.

โค้ดส่วนต่อไปนี้จะแสดงวิธีลบรายชื่อจาก Exchange server โดยใช้ Exchange Web Service.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

String strContactToDelete = "John Teddy";
Contact[] contacts = client.getContacts(client.getMailboxInfo().getContactsUri());
for (Contact contact : contacts) {
    if (contact.getDisplayName().equals(strContactToDelete))
        client.deleteItem(contact.getId().getEWSId(), DeletionOptions.getDeletePermanently());

}
client.dispose();

Java: การทำงานกับรายการแจกจ่ายบน Exchange Server

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

การทำงานกับรายการกระจาย

Aspose.Email API มีความสามารถในการสร้างและอ่านรายการกระจายจากเซิร์ฟเวอร์ Exchange. รายการกระจายสามารถสร้างบนเซิร์ฟเวอร์และสามารถเพิ่มสมาชิกลงในรายการได้โดยใช้ IEWSClient. บทความนี้แสดงวิธีการทำงานกับรายการกระจายบนเซิร์ฟเวอร์ Exchange.

การสร้างรายการกระจาย

ส่วนของโค้ดต่อไปนี้แสดงวิธีการสร้างรายการกระจาย

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList distributionList = new ExchangeDistributionList();
distributionList.setDisplayName("test private list");
MailAddressCollection members = new MailAddressCollection();
members.add("address1@host.com");
members.add("address2@host.com");
members.add("address3@host.com");
client.createDistributionList(distributionList, members);

ดึงรายการกระจายส่วนตัว

ส่วนของโค้ดต่อไปนี้แสดงวิธีการดึงรายการกระจายส่วนตัว

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList[] distributionLists = client.listDistributionLists();
for (ExchangeDistributionList distributionList : distributionLists) {
    MailAddressCollection members = client.fetchDistributionList(distributionList);
    for (MailAddress member : (Iterable<MailAddress>) members) {
        System.out.println(member.getAddress());
    }
}

ขยายรายการกระจายสาธารณะ

ส่วนของโค้ดต่อไปนี้แสดงวิธีการขยายรายการกระจายสาธารณะ

MailAddressCollection members = client.expandDistributionList(new MailAddress("public.distribution.list@host.com"));
for (MailAddress member : (Iterable<MailAddress>) members) {
    System.out.println(member.getAddress());
}

กำลังเพิ่มสมาชิก

การเพิ่มสมาชิกไปยังรายการกระจายส่วนตัว

ส่วนของโค้ดต่อไปนี้แสดงวิธีการเพิ่มสมาชิกไปยังรายการกระจายส่วนตัว

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList[] distributionLists = client.listDistributionLists();
MailAddressCollection newMembers = new MailAddressCollection();
newMembers.add("address4@host.com");
newMembers.add("address5@host.com");
client.addToDistributionList(distributionLists[0], newMembers);

เพิ่มสมาชิกโดยไม่แสดงรายการ

ส่วนของโค้ดต่อไปนี้แสดงวิธีการเพิ่มสมาชิกโดยไม่แสดงรายการ

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList distributionList = new ExchangeDistributionList();
distributionList.setId("list's id");
distributionList.setChangeKey("list's change key");
MailAddressCollection newMembers = new MailAddressCollection();
newMembers.add("address6@host.com");
client.addToDistributionList(distributionList, newMembers);

ส่งไปยังรายการกระจายส่วนตัว

ส่วนของโค้ดต่อไปนี้แสดงวิธีการส่งข้อความไปยังรายการกระจายส่วนตัว

ExchangeDistributionList[] distributionLists = client.listDistributionLists();
MailAddress distributionListAddress = distributionLists[0].toMailAddress();
MailMessage message = new MailMessage(new MailAddress("from@host.com"), distributionListAddress);
message.setSubject("sendToPrivateDistributionList");
client.send(message);

กำลังลบสมาชิก

การลบสมาชิกจากรายการกระจายส่วนตัว

ส่วนของโค้ดต่อไปนี้แสดงวิธีการลบสมาชิกจากรายการกระจายส่วนตัว

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList[] distributionLists = client.listDistributionLists();
MailAddressCollection members = client.fetchDistributionList(distributionLists[0]);
MailAddressCollection membersToDelete = new MailAddressCollection();
membersToDelete.addMailAddress(members.get_Item(0));
membersToDelete.addMailAddress(members.get_Item(1));
client.deleteFromDistributionList(distributionLists[0], membersToDelete);

ลบสมาชิกโดยไม่แสดงรายการ

ส่วนของโค้ดต่อไปนี้แสดงวิธีการลบสมาชิกโดยไม่แสดงรายการ

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList distributionList = new ExchangeDistributionList();
distributionList.setId("list's id");
distributionList.setChangeKey("list's change key");
MailAddressCollection membersToDelete = new MailAddressCollection();
MailAddress addressToDelete = new MailAddress("address", true);
// addressToDelete.Id.EWSId = "member's id";
membersToDelete.addMailAddress(addressToDelete);
client.addToDistributionList(distributionList, membersToDelete);

ลบรายการกระจายส่วนตัว

ส่วนของโค้ดต่อไปนี้แสดงวิธีการลบรายการกระจายส่วนตัว

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList[] distributionLists = client.listDistributionLists();
client.deleteDistributionList(distributionLists[0], true);

ลบโดยไม่แสดงรายการ

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการลบโดยไม่ต้องแสดงรายการ.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList distributionList = new ExchangeDistributionList();
distributionList.setId("list's id");
client.deleteDistributionList(distributionList, true);

Java: การทำงานกับโฟลเดอร์บน Exchange Server

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

แสดงโฟลเดอร์ทั้งหมดจากเซิร์ฟเวอร์

Aspose.Email API ให้ความสามารถในการเชื่อมต่อกับ Exchange Server และแสดงรายการโฟลเดอร์และโฟลเดอร์ย่อยทั้งหมด คุณสามารถดึงโฟลเดอร์ย่อยทั้งหมดจากแต่ละโฟลเดอร์โดยทำซ้ำได้ อีกทั้งยังให้ความสามารถในการเรียงลำดับโฟลเดอร์พร้อมการแบ่งหน้า จากไคลเอนต์ Exchange โดยใช้ Exchange Web Service (EWS) บทความนี้แสดงวิธีดึงโฟลเดอร์ย่อยทั้งหมดจากเซิร์ฟเวอร์ Exchange และดึงโฟลเดอร์พร้อมการแบ่งหน้า.

โค้ดสแนปต่อไปนี้แสดงวิธีแสดงรายการโฟลเดอร์จาก Exchange Server

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static void run() {
    try {
        IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
        System.out.println("Downloading all messages from Inbox....");

        ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
        System.out.println("Mailbox URI: " + mailboxInfo.getMailboxUri());
        String rootUri = client.getMailboxInfo().getRootUri();
        // List all the folders from Exchange server
        ExchangeFolderInfoCollection folderInfoCollection = client.listSubFolders(rootUri);
        for (ExchangeFolderInfo folderInfo : (Iterable<ExchangeFolderInfo>) folderInfoCollection) {
            // Call the recursive method to read messages and get sub-folders
            listSubFolders(client, folderInfo);
        }

        System.out.println("All messages downloaded.");
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

private static void listSubFolders(IEWSClient client, ExchangeFolderInfo folderInfo) {
    // Create the folder in disk (same name as on IMAP server)
    System.out.println(folderInfo.getDisplayName());
    try {
        // If this folder has sub-folders, call this method recursively to get messages
        ExchangeFolderInfoCollection folderInfoCollection = client.listSubFolders(folderInfo.getUri());
        for (ExchangeFolderInfo subfolderInfo : (Iterable<ExchangeFolderInfo>) folderInfoCollection) {
            listSubFolders(client, subfolderInfo);
        }
    } catch (java.lang.RuntimeException e) {
    }
}

รับข้อมูลประเภทโฟลเดอร์โดยใช้ EWS

นี้ FolderType คุณสมบัติที่ให้โดย ExchangeFolderInfo คลาสสามารถใช้เพื่อรับข้อมูลเกี่ยวกับประเภทของโฟลเดอร์ ตามที่แสดงในตัวอย่างโค้ดด้านล่าง.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

ExchangeFolderInfoCollection folderInfoCol = client.listSubFolders(client.getMailboxInfo().getRootUri());
for (ExchangeFolderInfo folderInfo : (Iterable<ExchangeFolderInfo>) folderInfoCol) {
    switch (folderInfo.getFolderType()) {
    case ExchangeFolderType.Appointment:
        // handle Appointment
        break;
    case ExchangeFolderType.Contact:
        // handle Contact
        break;
    case ExchangeFolderType.Task:
        // handle Task
        break;
    case ExchangeFolderType.Note:
        // handle email message
        break;
    case ExchangeFolderType.StickyNote:
        // handle StickyNote
        break;
    case ExchangeFolderType.Journal:
        // handle Journal
        break;
    default:
        break;
    }
}

การเรียงลำดับโฟลเดอร์พร้อมการแบ่งหน้าโดยใช้ EWS

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการใช้การสนับสนุนการแบ่งหน้าโดยใช้ EWS.

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "UserName", "Password");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());
int itemsPerPage = 5;
List<PageInfo> pages = new ArrayList<PageInfo>();
PageInfo pagedMessageInfoCol = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage);
pages.add(pagedMessageInfoCol);
while (!pagedMessageInfoCol.getLastPage()) {
    pagedMessageInfoCol = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage);
    pages.add(pagedMessageInfoCol);
}
pagedMessageInfoCol = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage);
while (!pagedMessageInfoCol.getLastPage()) {
    client.listMessages(client.getMailboxInfo().getInboxUri());
}

การเข้าถึงโฟลเดอร์หรือโฟลเดอร์ย่อยที่กำหนดเองของกล่องเมล

IEWSClient ทำให้ผู้พัฒนาสามารถเข้าถึงโฟลเดอร์หรือโฟลเดอร์ย่อยที่กำหนดเองใดๆ จากกล่องเมลได้. folderExists() ฟังก์ชันของ IEWSClient ส่งคืน URI ของโฟลเดอร์/โฟลเดอร์ย่อยที่กำหนดเองที่ระบุ ซึ่งสามารถใช้เพื่อเข้าถึงโฟลเดอร์เป้าหมายได้ ในตัวอย่างต่อไปนี้ โฟลเดอร์ที่กำหนดเองชื่อ "TestInbox" ที่สร้างภายใต้ INBOX จะถูกเข้าถึงและแสดงข้อความทั้งหมดจากโฟลเดอร์นี้ เพื่อทำงานนี้ ให้ทำตามขั้นตอนต่อไปนี้:

เริ่มต้นอ็อบเจ็กต์ IEWSClient โดยระบุข้อมูลประจำตัวที่ถูกต้อง.
เข้าถึงกล่องเมลเริ่มต้น.
เข้าถึงโฟลเดอร์พาเรนท์ ซึ่งในตัวอย่างนี้คือ INBOX โฟลเดอร์พาเรนท์นี้อาจเป็นโฟลเดอร์ที่กำหนดเองได้เช่นกัน.
ใช้ folderExists() เพื่อค้นหาโฟลเดอร์ย่อยที่กำหนดเองที่ระบุ เช่น "TestInbox" จะคืนค่า URI ของ "TestInbox".
ใช้ Uri นี้เพื่อเข้าถึงข้อความทั้งหมดในโฟลเดอร์ที่กำหนดเองนั้น.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการเข้าถึงโฟลเดอร์หรือโฟลเดอร์ย่อยที่กำหนดเองของกล่องเมลด้วย EWS.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Create ExchangeMailboxInfo, ExchangeMessageInfoCollection instance
ExchangeMailboxInfo mailbox = client.getMailboxInfo();
ExchangeMessageInfoCollection messages = null;
ExchangeFolderInfo subfolderInfo = new ExchangeFolderInfo();

// Check if specified custom folder exisits and Get all the messages info from the target Uri
ExchangeFolderInfo[] referenceToSubfolderInfo = { subfolderInfo };
client.folderExists(mailbox.getInboxUri(), "TestInbox", /* out */ referenceToSubfolderInfo);
subfolderInfo = referenceToSubfolderInfo[0];

// if custom folder exists
if (subfolderInfo != null) {
    messages = client.listMessages(subfolderInfo.getUri());

    // Parse all the messages info collection
    for (ExchangeMessageInfo info : (Iterable<ExchangeMessageInfo>) messages) {
        String strMessageURI = info.getUniqueUri();
        // now get the message details using FetchMessage()
        MailMessage msg = client.fetchMessage(strMessageURI);
        System.out.println("Subject: " + msg.getSubject());
    }
} else {
    System.out.println("No folder with this name found.");
}

รายการโฟลเดอร์สาธารณะ

Microsoft Exchange Server อนุญาตให้ผู้ใช้สร้างโฟลเดอร์สาธารณะและโพสต์ข้อความในนั้น เพื่อทำผ่านแอปพลิเคชันของคุณ ให้ใช้ Aspose.Email’s EWSClient คลาสเพื่อเชื่อมต่อกับ Exchange Server และอ่านและดาวน์โหลดข้อความและโพสต์จากโฟลเดอร์สาธารณะ โค้ดตัวอย่างต่อไปนี้แสดงวิธีการอ่านโฟลเดอร์สาธารณะทั้งหมดและโฟลเดอร์ย่อย รวมถึงรายการและดาวน์โหลดข้อความใดๆ ที่พบในโฟลเดอร์เหล่านี้ ตัวอย่างนี้ทำงานได้เฉพาะกับ Microsoft Exchange Server 2007 ขึ้นไปเนื่องจากรุ่นเหล่านั้นเท่านั้นที่สนับสนุน EWS.

public static void run() {
    try {
        readPublicFolders();
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

private static void readPublicFolders() {
    NetworkCredential credential = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);

    ExchangeFolderInfoCollection folders = client.listPublicFolders();
    for (ExchangeFolderInfo publicFolder : (Iterable<ExchangeFolderInfo>) folders) {
        System.out.println("Name: " + publicFolder.getDisplayName());
        System.out.println("Subfolders count: " + publicFolder.getChildFolderCount());
        listMessagesFromSubFolder(publicFolder, client);

    }
}

private static void listMessagesFromSubFolder(ExchangeFolderInfo publicFolder, IEWSClient client) {
    System.out.println("Folder Name: " + publicFolder.getDisplayName());
    ExchangeMessageInfoCollection msgInfoCollection = client.listMessagesFromPublicFolder(publicFolder);
    for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) msgInfoCollection) {
        MailMessage msg = client.fetchMessage(messageInfo.getUniqueUri());
        System.out.println(msg.getSubject());
        msg.save(dataDir + msg.getSubject() + ".msg", SaveOptions.getDefaultMsgUnicode());
    }

    // Call this method recursively for any subfolders
    if (publicFolder.getChildFolderCount() > 0) {
        ExchangeFolderInfoCollection subfolders = client.listSubFolders(publicFolder);
        for (ExchangeFolderInfo subfolder : (Iterable<ExchangeFolderInfo>) subfolders) {
            listMessagesFromSubFolder(subfolder, client);
        }
    }
}

คัดลอกข้อความไปยังโฟลเดอร์อื่น

try {
    // Create instance of EWSClient class by giving credentials
    IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
    MailMessage message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-34997 - " + UUID.randomUUID().toString(),
            "EMAILNET-34997 Exchange: Copy a message and get reference to the new Copy item");
    String messageUri = client.appendMessage(message);
    String newMessageUri = client.copyItem(messageUri, client.getMailboxInfo().getDeletedItemsUri());
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

การซิงค์รายการในโฟลเดอร์

Aspose.Email for Java API IEWSClient ให้คุณสมบัติการซิงค์โฟลเดอร์ Exchange สำหรับเนื้อหาในนั้น. syncFolder เมธอดที่เปิดเผยโดย IEWSClient คลาสสามารถใช้เพื่อทำข้อมูลการซิงค์โฟลเดอร์บนโฟลเดอร์ที่ระบุ โค้ดตัวอย่างต่อไปนี้แสดงวิธีการซิงค์ข้อมูลโฟลเดอร์ Exchange.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
MailMessage message1 = new MailMessage("user@domain.com", "user@domain.com", "EMAILNET-34738 - " + UUID.randomUUID().toString(), "EMAILNET-34738 Sync Folder Items");
client.send(message1);

MailMessage message2 = new MailMessage("user@domain.com", "user@domain.com", "EMAILNET-34738 - " + UUID.randomUUID().toString(), "EMAILNET-34738 Sync Folder Items");
client.send(message2);

ExchangeMessageInfoCollection messageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());
SyncFolderResult result = client.syncFolder(client.getMailboxInfo().getInboxUri(), null);
System.out.println(result.getNewItems().size());
System.out.println(result.getChangedItems().size());
System.out.println(result.getReadFlagChanged().size());
System.out.println(result.getDeletedItems().length);

ดึงสิทธิ์สำหรับโฟลเดอร์ Exchange

ผู้ใช้ได้รับการกำหนดสิทธิ์ให้กับโฟลเดอร์สาธารณะบน Exchange Server ซึ่งจำกัด/กำหนดระดับการเข้าถึงของผู้ใช้ต่อโฟลเดอร์เหล่านี้. ExchangeFolderPermission คลาสให้คุณสมบัติของสิทธิ์ชุดหนึ่งสำหรับโฟลเดอร์ Exchange เช่น PermissionLevel, ไม่ว่าจะสามารถ canCreateItems, deleteItems, และดำเนินการอื่นๆ ตามที่กำหนดโดยคุณลักษณะของสิทธิ์ สามารถดึงสิทธิ์ได้โดยใช้ getFolderPermissions() เมธอดของ IEWSClient. บทความนี้แสดงวิธีดึงสิทธิ์ที่กำหนดให้กับโฟลเดอร์สาธารณะสำหรับผู้ใช้ทั้งหมดที่มีการเข้าถึงโฟลเดอร์ที่แชร์.

เพื่อทำงานนี้:

เริ่มต้น EWSClient.
ใช้ listPublicFolders เพื่อรับรายการของโฟลเดอร์สาธารณะทั้งหมด
เรียกคืนสิทธิ์ที่เกี่ยวข้องกับโฟลเดอร์โดยใช้เมธอด getFolderPermissions()

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการใช้ EWSClient คลาสสำหรับดึงสิทธิ์ที่ใช้กับโฟลเดอร์.

String folderName = "DesiredFolderName";

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

ExchangeFolderInfoCollection folders = client.listPublicFolders();
ExchangeFolderPermissionCollection permissions = new ExchangeFolderPermissionCollection();

ExchangeFolderInfo publicFolder = null;
try {
    for (ExchangeFolderInfo folderInfo : (Iterable<ExchangeFolderInfo>) folders)
        if (folderInfo.getDisplayName().equals(folderName))
            publicFolder = folderInfo;

    if (publicFolder == null)
        System.out.println("public folder was not created in the root public folder");

    ExchangePermissionCollection folderPermissionCol = client.getFolderPermissions(publicFolder.getUri());
    for (ExchangeBasePermission perm : (Iterable<ExchangeBasePermission>) folderPermissionCol) {
        if (perm instanceof ExchangeFolderPermission)
            System.out.println("Permission is null.");
        else {
            ExchangeFolderPermission permission = (ExchangeFolderPermission) perm;

            System.out.println("User's primary smtp address: " + permission.getUserInfo().getPrimarySmtpAddress());
            System.out.println("User can create Items: " + permission.canCreateItems());
            System.out.println("User can delete Items: " + permission.getDeleteItems());
            System.out.println("Is Folder Visible: " + permission.isFolderVisible());
            System.out.println("Is User owner of this folder: " + permission.isFolderOwner());
            System.out.println("User can read items: " + permission.getReadItems());
        }
    }
    ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
    // Get the Permissions for the Contacts and Calendar Folder
    ExchangePermissionCollection contactsPermissionCol = client.getFolderPermissions(mailboxInfo.getContactsUri());
    ExchangePermissionCollection calendarPermissionCol = client.getFolderPermissions(mailboxInfo.getCalendarUri());
} finally {
    // Do the needfull
}

สร้างโฟลเดอร์และโฟลเดอร์ย่อย

Aspose.Email API มีความสามารถในการสร้างโฟลเดอร์ในเมลบ็อกซ์ Exchange ส่วน CreateFolder เมธอดของ IEWSClient สามารถใช้เพื่อจุดประสงค์นี้ เพื่อสร้างโฟลเดอร์ในเมลบ็อกซ์ของ Exchange เซิร์ฟเวอร์ สามารถทำตามขั้นตอนต่อไปนี้

สร้างอินสแตนซ์ของ IEWSClient
ตั้งค่าคุณสมบัติ UseSlashAsFolderSeparator ตามต้องการ หากตั้งเป็น true แอปพลิเคชันจะพิจารณา "Slash" เป็นตัวคั่นโฟลเดอร์และโฟลเดอร์ย่อยจะถูกสร้างหลังสแลช
ใช้เมธอด createFolder เพื่อสร้างโฟลเดอร์

โค้ดสแนปต่อไปนี้แสดงวิธีสร้างโฟลเดอร์และโฟลเดอร์ย่อย

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

String inbox = client.getMailboxInfo().getInboxUri();
String folderName1 = "EMAILNET-35054";
String subFolderName0 = "2015";
String folderName2 = folderName1 + "/" + subFolderName0;
String folderName3 = folderName1 + " / 2015";
ExchangeFolderInfo rootFolderInfo = null;
ExchangeFolderInfo folderInfo = null;

try {
    client.setUseSlashAsFolderSeparator(true);
    client.createFolder(client.getMailboxInfo().getInboxUri(), folderName1);
    client.createFolder(client.getMailboxInfo().getInboxUri(), folderName2);
} finally {
    ExchangeFolderInfo[] referenceToRootFolderInfo = { rootFolderInfo };
    boolean outRefCondition0 = client.folderExists(inbox, folderName1, /* out */ referenceToRootFolderInfo);
    rootFolderInfo = referenceToRootFolderInfo[0];
    if (outRefCondition0) {
        ExchangeFolderInfo[] referenceToFolderInfo = { folderInfo };
        boolean outRefCondition1 = client.folderExists(inbox, folderName2, /* out */ referenceToFolderInfo);
        folderInfo = referenceToFolderInfo[0];
        if (outRefCondition1)
            client.deleteFolder(folderInfo.getUri(), true);
        client.deleteFolder(rootFolderInfo.getUri(), true);
    }
}

สำรองโฟลเดอร์ Exchange ไปยัง PST

บ่อยครั้งที่ผู้ใช้ต้องการสำรองข้อมูลของโฟลเดอร์อีเมลทั้งหมดหรือบางส่วน Aspose.Email มีความสามารถในการสำรองโฟลเดอร์เมลบ็อกซ์ Exchange ทั้งหมดหรือที่ระบุไปยัง PST บทความนี้อธิบายการสำรองโฟลเดอร์ Exchange ไปยัง PST พร้อมตัวอย่างโค้ด เพื่อสำรองโฟลเดอร์เซิร์ฟเวอร์ Exchange ให้ทำตามขั้นตอนต่อไปนี้

เริ่มต้น IEWSClient ด้วยข้อมูลประจำตัวผู้ใช้
เพิ่มข้อมูลโฟลเดอร์ที่ต้องการไปยัง ExchangeFolderInfoCollection
ใช้วิธีการสำรองข้อมูลของลูกค้าเพื่อส่งออกเนื้อหาโฟลเดอร์ไปยัง PST

โค้ดสแนปต่อไปนี้แสดงวิธีสำรองโฟลเดอร์ Exchange ไปยัง PST

String dataDir = "data/";
// Create instance of IEWSClient class by providing credentials
final String mailboxUri = "https://ews.domain.com/ews/Exchange.asmx";
final String domain = "";
final String username = "username";
final String password = "password";
NetworkCredential credential = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);

// Get Exchange mailbox info of other email account
ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
ExchangeFolderInfo info = client.getFolderInfo(mailboxInfo.getInboxUri());
ExchangeFolderInfoCollection fc = new ExchangeFolderInfoCollection();
fc.addItem(info);
client.backup(fc, dataDir + "Backup_out.pst", BackupOptions.None);

Java: การทำงานกับกฎบน Exchange Server

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

การจัดการกฎ

Aspose.Email for Java สามารถใช้จัดการกฎบน Exchange Server โดยใช้ EWSClient คลาส นี้ใช้ Exchange Web Services (EWS) ซึ่งมีใน Exchange Server 2007 และรุ่นต่อมานี้ เพื่อแสดงวิธีจัดการกฎ บทความนี้อธิบายวิธี:

อ่านกฎที่มีอยู่แล้วบนเซิร์ฟเวอร์.
สร้างกฎใหม่.
อัปเดตกฎที่มีอยู่.

Microsoft Exchange Server 2010 Service Pack 1 จำเป็นสำหรับคุณสมบัติทั้งหมดที่อธิบายในบทความนี้

อ่านกฎ

เพื่อรับกฎทั้งหมดจาก Exchange Server:

เชื่อมต่อกับ Exchange Server โดยใช้คลาส IEWSClient
เรียกเมธอด IEWSClient.getInboxRules() เพื่อรับกฎทั้งหมด
ในลูป foreach ให้เรียกดูกฎทั้งหมดและแสดงคุณสมบัติกฎเช่น เงื่อนไข การกระทำ และชื่อ

โค้ดสแนปต่อไปนี้แสดงวิธีอ่านกฎ

IEWSClient client = EWSClient.getEWSClient(mailboxURI, credential);

System.out.println("Connected to Exchange server");

// Get all Inbox Rules
InboxRule[] inboxRules = client.getInboxRules();

// Display information about each rule
for (InboxRule inboxRule : inboxRules) {
    System.out.println("Display Name: " + inboxRule.getDisplayName());

    // Check if there is a "From Address" condition
    if (inboxRule.getConditions().getFromAddresses().size() > 0) {
        for (MailAddress fromAddress : (Iterable<MailAddress>) inboxRule.getConditions().getFromAddresses()) {
            System.out.println("From: " + fromAddress.getDisplayName() + " - " + fromAddress.getAddress());
        }
    }
    // Check if there is a "Subject Contains" condition
    if (inboxRule.getConditions().containsSubjectStrings().size() > 0) {
        // foreach to while statements conversion
        for (String subject : inboxRule.getConditions().containsSubjectStrings()) {
            System.out.println("Subject contains: " + subject);
        }
    }
    // Check if there is a "Move to Folder" action
    if (inboxRule.getActions().getMoveToFolder().length() > 0) {
        System.out.println("Move message to folder: " + inboxRule.getActions().getMoveToFolder());
    }
}

การสร้างกฎใหม่

เพื่อสร้างกฎใหม่บน Exchange Server ให้ทำตามขั้นตอนต่อไปนี้:

เชื่อมต่อกับ Exchange Server โดยใช้คลาส IEWSClient
สร้างอินสแตนซ์ใหม่ของคลาส InboxRule และตั้งค่าคุณสมบัติบังคับต่อไปนี้:
1. ชื่อที่แสดง
2. เงื่อนไข
3. การกระทำ
เรียกเมธอด IEWSClient.createInboxRule() เพื่อสร้างกฎ

โค้ดสแนปต่อไปนี้แสดงวิธีสร้างกฎใหม่

IEWSClient client = EWSClient.getEWSClient(mailboxURI, credential);

System.out.println("Connected to Exchange server");

InboxRule rule = new InboxRule();
rule.setDisplayName("Message from client ABC");

// Add conditions
RulePredicates newRules = new RulePredicates();
// Set Subject contains string "ABC" and Add the conditions
newRules.containsSubjectStrings().addItem("ABC");
newRules.getFromAddresses().addMailAddress(new MailAddress("administrator@ex2010.local", true));
rule.setConditions(newRules);

// Add Actions and Move the message to a folder
RuleActions newActions = new RuleActions();
newActions.setMoveToFolder("120:AAMkADFjMjNjMmNjLWE3NzgtNGIzNC05OGIyLTAwNTgzNjRhN2EzNgAuAAAAAABbwP+Tkhs0TKx1GMf0D/cPAQD2lptUqri0QqRtJVHwOKJDAAACL5KNAAA=AQAAAA==");
rule.setActions(newActions);
client.createInboxRule(rule);

การอัปเดตกฎ

เพื่ออัปเดตกฎบน Exchange Server:

เชื่อมต่อกับ Exchange Server โดยใช้คลาส IEWSClient
เรียกเมธอด IEWSClient.getInboxRules() เพื่อรับกฎทั้งหมด
ในลูป foreach ให้เรียกดูกฎทั้งหมดและเลือกกฎที่ต้องการเปลี่ยนโดยจับคู่ DisplayName ในเงื่อนไข
อัปเดตคุณสมบัติกฎ
เรียกเมธอด IEWSClient.updateInboxRule() เพื่ออัปเดตกฎ

โค้ดสแนปต่อไปนี้แสดงวิธีอัปเดตกฎ

IEWSClient client = EWSClient.getEWSClient(mailboxURI, credential);

System.out.println("Connected to Exchange server");

// Get all Inbox Rules
InboxRule[] inboxRules = client.getInboxRules();

// Loop through each rule
for (InboxRule inboxRule : inboxRules) {
    System.out.println("Display Name: " + inboxRule.getDisplayName());
    if ("Message from client ABC".equals(inboxRule.getDisplayName())) {
        System.out.println("Updating the rule....");
        inboxRule.getConditions().getFromAddresses().set_Item(0, new MailAddress("administrator@ex2010.local", true));
        client.updateInboxRule(inboxRule);
    }
}

Java: ทำงานกับงานบน Exchange Server

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

ทำงานกับงาน

Aspose.Email รองรับการประมวลผลงานบน Exchange โดยใช้ ExchangeTask class. คุณสมบัติต่าง ๆ ที่เปิดเผยโดย ExchangeTask, เช่น Subject, สถานะ, วันครบกำหนด, และ ระดับความสำคัญ, สามารถใช้เพื่อกำหนดค่าการทำงานบน Exchange. The EWSClient คลาสนี้เปิดเผยฟังก์ชันเช่น createTask, updateTask, และ deleteTask ซึ่งใช้ในการประมวลผลงานบน Exchange. บทความนี้แสดงวิธี:

สร้างงานใหม่.
ตั้งค่าโซนเวลาของงาน.
อัปเดตงาน.
ลบงาน.
ส่งคำขอทำงาน
บันทึกงานลงดิสก์

สร้างงานใหม่

โค้ดตัวอย่างต่อไปนี้แสดงวิธีใช้เพื่อสร้างงานใหม่.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Create Exchange task object
ExchangeTask task = new ExchangeTask();

// Set task subject and status to In progress
task.setSubject("New-Test");
task.setStatus(ExchangeTaskStatus.InProgress);
client.createTask(client.getMailboxInfo().getTasksUri(), task);

ระบุโซนเวลา

นี้ IEWSClient อินเทอร์เฟซและ ExchangeTask ให้คุณสมบัติ TimeZoneId สำหรับตั้งค่าข้อมูลโซนเวลาเมื่อสร้างงาน. โค้ดตัวอย่างต่อไปนี้แสดงวิธีระบุโซนเวลา.

client.setTimezoneId("Central Europe Standard Time");

อัปเดตงาน

โค้ดตัวอย่างต่อไปนี้แสดงวิธีอัปเดตงานบนเซิร์ฟเวอร์ Exchange.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get all tasks info collection from exchange
ExchangeMessageInfoCollection tasks = client.listMessages(client.getMailboxInfo().getTasksUri());

// Parse all the tasks info in the list
for (ExchangeMessageInfo info : (Iterable<ExchangeMessageInfo>) tasks) {
    // Fetch task from exchange using current task info
    ExchangeTask task = client.fetchTask(info.getUniqueUri());

    // Update the task status to NotStarted
    task.setStatus(ExchangeTaskStatus.NotStarted);

    // Set the task due date
    SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy HH:mm:ss");
    task.setDueDate(sdf.parse("26/02/2013 00:00:00"));

    // Set task priority
    task.setPriority(MailPriority.Low.getValue());

    // Update task on exchange
    client.updateTask(task);
}

ลบงาน

โค้ดตัวอย่างต่อไปนี้แสดงวิธีลบงานบนเซิร์ฟเวอร์ Exchange.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get all tasks info collection from exchange
ExchangeMessageInfoCollection tasks = client.listMessages(client.getMailboxInfo().getTasksUri());

// Parse all the tasks info in the list
for (ExchangeMessageInfo info : (Iterable<ExchangeMessageInfo>) tasks) {
    // Fetch task from exchange using current task info
    ExchangeTask task = client.fetchTask(info.getUniqueUri());

    // Check if the current task fulfills the search criteria
    if (task.getSubject().equals("test")) {
        // Delete task from exchange
        client.deleteItem(task.getUniqueUri(), DeletionOptions.getDeletePermanently());
    }
}

การส่งคำขอทำงาน

บริการ Aspose.Email Exchange มีความสามารถในการส่งคำขอทำงานคล้าย Outlook. โค้ดตัวอย่างต่อไปนี้แสดงวิธีโหลดข้อความคำขอทำงานจากดิสก์และส่งโดยใช้ IEWSClient.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

MsgLoadOptions options = new MsgLoadOptions();
options.setPreserveTnefAttachments(true);

// load task from .msg file
MailMessage eml = MailMessage.load(dataDir + "task.msg", options);
eml.setFrom(MailAddress.to_MailAddress("firstname.lastname@domain.com"));
eml.getTo().clear();
eml.getTo().addMailAddress(new MailAddress("firstname.lastname@domain.com"));
client.send(eml);

บันทึกงานลงดิสก์

Aspose.Email ยังอนุญาตให้บันทึกงาน Exchange ลงดิสก์ในรูปแบบ Outlook MSG. โค้ดตัวอย่างต่อไปนี้แสดงวิธีบันทึกงานลงดิสก์.

ExchangeTask task = new ExchangeTask();
task.setSubject("TASK-ID - " + UUID.randomUUID());
task.setStatus(ExchangeTaskStatus.InProgress);

Calendar cal = Calendar.getInstance();
task.setStartDate(cal.getTime());
cal.add(Calendar.DATE, 3);
task.setDueDate(cal.getTime());
task.save(dstEmail);

การแสดงรายการงานจาก Exchange Server

IEWSClient ให้ listTasks เมธอดที่สามารถใช้ดึงงานจาก Exchange Web Service. มีการโอเวอร์โหลดหลายแบบที่สามารถใช้เพื่อดึงรายการงานจากโฟลเดอร์เฉพาะหรือโดยใช้เงื่อนไขการค้นหา. ตัวอย่างโค้ดด้านล่างแสดงการดึงงานทั้งหมดหรือเฉพาะงานจากโฟลเดอร์ Tasks.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// Listing Tasks from Server
client.setTimezoneId("Central Europe Standard Time");
TaskCollection taskCollection = client.listTasks(client.getMailboxInfo().getTasksUri());

// print retrieved tasks' details
int iTasksCount = taskCollection.size();
for (int i = 0; i < iTasksCount; i++) {
    ExchangeTask task = (ExchangeTask) taskCollection.get_Item(i);
    System.out.println(task.getSubject());
    System.out.println(task.getStartDate());
    System.out.println(task.getDueDate());
}

// Listing Tasks from server based on Query - Completed and In-Progress
Integer[] selectedStatuses = new Integer[] { ExchangeTaskStatus.Completed, ExchangeTaskStatus.InProgress };
ExchangeQueryBuilder queryBuilder = new ExchangeQueryBuilder();
queryBuilder.getTaskStatus().in(Arrays.asList(selectedStatuses));
MailQuery query = queryBuilder.getQuery();

taskCollection = client.listTasks(client.getMailboxInfo().getTasksUri(), query);

// print retrieved tasks' details
iTasksCount = taskCollection.size();
for (int i = 0; i < iTasksCount; i++) {
    ExchangeTask task = (ExchangeTask) taskCollection.get_Item(i);
    System.out.println(task.getSubject());
    System.out.println(task.getStartDate());
    System.out.println(task.getDueDate());
}

การกรองงานจาก Exchange Server

Aspose.Email มีความสามารถในการดึงงานเฉพาะจากเซิร์ฟเวอร์แทนการดึงงานทั้งหมดจากเซิร์ฟเวอร์. API สามารถดึงงานตามสถานะของงาน เช่น Completed, Deferred, In Progress, Not started หรือ Waiting on others. The ExchangeQueryBuilder คลาสนี้สามารถใช้ระบุเกณฑ์ที่ต้องการโดยใช้คุณสมบัติ Status. นอกจากนี้ยังอนุญาตให้ระบุหลายเงื่อนไขเพื่อดึงงานที่ต้องการจาก Exchange Server. ตัวอย่างโค้ดต่อไปนี้แสดงการทำเช่นนั้น.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Set timezone for tasks
client.setTimezoneId("Central Europe Standard Time");

// We use these status values for specifying in queries
Integer[] values = new Integer[] { ExchangeTaskStatus.Completed, ExchangeTaskStatus.Deferred, ExchangeTaskStatus.InProgress, ExchangeTaskStatus.NotStarted,
        ExchangeTaskStatus.WaitingOnOthers };

messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri());

// Now retrieve the tasks with specific statuses
for (int status : values) {
    queryBuilder = new ExchangeQueryBuilder();
    queryBuilder.getTaskStatus().equals(status);
    query = queryBuilder.getQuery();
    messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);
    fetchedTask = client.fetchTask(messageInfoCol.get_Item(0).getUniqueUri());
}

// retrieve all other than specified
for (int status : values) {
    queryBuilder = new ExchangeQueryBuilder();
    queryBuilder.getTaskStatus().notEquals((int) status);
    query = queryBuilder.getQuery();
    messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);
}

// specifying multiple criterion
Integer[] selectedStatuses = new Integer[] { ExchangeTaskStatus.Completed, ExchangeTaskStatus.InProgress };

queryBuilder = new ExchangeQueryBuilder();
queryBuilder.getTaskStatus().in(Arrays.asList(selectedStatuses));
query = queryBuilder.getQuery();
messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);

// list all those which are not in our specified statuses
queryBuilder = new ExchangeQueryBuilder();
queryBuilder.getTaskStatus().notIn(Arrays.asList(selectedStatuses));
query = queryBuilder.getQuery();
messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);

Java: การทำงานกับการกำหนดค่าผู้ใช้บนเซิร์ฟเวอร์

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

การจัดการการกำหนดค่าผู้ใช้

Aspose.Email for Java สามารถใช้เพื่อจัดการการกำหนดค่าผู้ใช้บน Exchange Server ด้วย EWSClient คลาส นี้ใช้ Exchange Web Services ซึ่งมีเฉพาะใน Exchange Server 2007 ขึ้นไป ในบทความนี้ เราจะดูวิธีการอ่าน, สร้าง, อัปเดต และลบการกำหนดค่าผู้ค้าบน Exchange Server 2010 จำเป็นต้องมี Microsoft Exchange Server 2010 Service Pack 1 สำหรับคุณลักษณะทั้งหมดที่อธิบายในบทความนี้ โค้ดตัวอย่างต่อไปนี้แสดงวิธีเชื่อมต่อกับ Exchange Server 2010 ในตัวอย่างทั้งหมดของบทความนี้.

private static IEWSClient getExchangeEWSClient() {
    final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
    final String domain = "";
    final String username = "username@ASE305.onmicrosoft.com";
    final String password = "password";
    NetworkCredential credentials = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
    return client;
}

การอ่านการกำหนดค่าผู้ใช้

เพื่อรับข้อมูลการกำหนดค่าผู้ใช้ของโฟลเดอร์เฉพาะจาก Exchange Server:

เชื่อมต่อกับ Exchange Server โดยใช้คลาส IEWSClient.
เรียกเมธอด IEWSClient.getUserConfiguration() เพื่อรับการกำหนดค่าผู้ใช้สำหรับโฟลเดอร์.
แสดงคุณสมบัติการกำหนดค่าผู้ใช้ เช่น ID, ชื่อ และรายการพจนานุกรมในรูปแบบคู่คีย์-ค่า.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการอ่านการกำหนดค่าผู้ใช้.

IEWSClient client = getExchangeEWSClient();
System.out.println("Connected to Exchange 2010");

// Get the User Configuration for Inbox folder
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
UserConfiguration userConfig = client.getUserConfiguration(userConfigName);

System.out.println("Configuration Id: " + userConfig.getId());
System.out.println("Configuration Name: " + userConfig.getUserConfigurationName().getName());
System.out.println("Key value pairs:");
// foreach to while statements conversion
for (Object key : userConfig.getDictionary().keySet()) {
    System.out.println(key + ": " + userConfig.getDictionary().get(key).toString());
}

การสร้างการกำหนดค่าผู้ใช้

เพื่อสร้างการกำหนดค่าผู้ใช้สำหรับโฟลเดอร์เฉพาะบน Exchange Server:

เชื่อมต่อกับ Exchange Server โดยใช้คลาส IEWSClient.
เรียกเมธอด IEWSClient.createUserConfiguration() เพื่อสร้างการกำหนดค่าผู้ใช้สำหรับโฟลเดอร์.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการสร้างการกำหนดค่าผู้ใช้.

IEWSClient client = getExchangeEWSClient();
System.out.println("Connected to Exchange 2010");

// Create the User Configuration for Inbox folder
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
UserConfiguration userConfig = new UserConfiguration(userConfigName);
userConfig.getDictionary().put("key1", "value1");
userConfig.getDictionary().put("key2", "value2");
userConfig.getDictionary().put("key3", "value3");
client.createUserConfiguration(userConfig);

การอัปเดตการกำหนดค่าผู้ใช้

เพื่ออัปเดตการกำหนดค่าผู้ใช้สำหรับโฟลเดอร์เฉพาะใน Exchange Server:

เชื่อมต่อกับ Exchange Server โดยใช้คลาส IEWSClient.
เรียกเมธอด IEWSClient.updateUserConfiguration() เพื่ออัปเดตการกำหนดค่าผู้ใช้สำหรับโฟลเดอร์.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการอัปเดตการกำหนดค่าผู้ใช้.

IEWSClient client = getExchangeEWSClient();
System.out.println("Connected to Exchange 2010");

// Create the User Configuration for Inbox folder
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
UserConfiguration userConfig = client.getUserConfiguration(userConfigName);
userConfig.setId(null);

// Update User Configuration
userConfig.getDictionary().put("key1", "new-value1");
client.updateUserConfiguration(userConfig);

การลบการกำหนดค่าผู้ใช้

เพื่อลบการกำหนดค่าผู้ใช้สำหรับโฟลเดอร์เฉพาะใน Exchange Server:

เชื่อมต่อกับ Exchange Server โดยใช้คลาส IEWSClient.
เรียกเมธอด IEWSClient.deleteUserConfiguration() เพื่อลบการกำหนดค่าผู้ใช้สำหรับโฟลเดอร์.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการลบการกำหนดค่าผู้ใช้.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Delete User Configuration
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
client.deleteUserConfiguration(userConfigName);

Java: คุณสมบัติอรรถประโยชน์

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

การส่งข้อความพร้อมตัวเลือกการโหวต

Microsoft Outlook อนุญาตให้ผู้ใช้สร้างแบบสำรวจเมื่อเขียนข้อความใหม่. ทำได้โดยใส่ตัวเลือกการโหวตเช่น ใช่, ไม่ใช่, บางอย่าง ฯลฯ. คลาส FollowUpOptions ที่ Aspose.Email มีให้, มีคุณสมบัติ VotingButtons ที่ใช้ตั้งหรือรับค่าตัวเลือกการโหวต. บทความนี้ให้ตัวอย่างอย่างละเอียดของการสร้าง MapiMessage พร้อมตัวเลือกการโหวตเพื่อสร้างการสำรวจและส่งข้อความโดยใช้ Exchange Web Service (EWS) client.

การสร้างและส่งข้อความพร้อมตัวเลือกการโหวต

ส่วนของโค้ดต่อไปนี้แสดงวิธีการสร้างข้อความใหม่และส่งพร้อมตัวเลือกการโหวต.

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

เมธอดตัวอย่างที่ใช้ในตัวอย่าง

ส่วนของโค้ดต่อไปนี้แสดงวิธีใช้เมธอดที่ใช้ในตัวอย่างข้างต้น.

private static MailMessage createTestMessage(String address) {
    MailMessage eml = new MailMessage(address, address, "Flagged message",
            "Make it nice and short, but descriptive. The description may appear in search engines' search results pages...");

    return eml;
}

สร้างข้อความ RE และ FW จากไฟล์ MSG

IEWSClient ทำให้นักพัฒนาสามารถสร้างข้อความ RE (Reply/Reply All) และ FW (Forward) จากข้อความต้นทาง. ข้อความต้นทางถูกระบุโดยการเลือก ExchangeMessageInfo จาก ExchangeMessageInfoCollection ได้มาจาก IEWSClient.listMessages(). อากิวเมนต์อีกอันคือค่าจริงของ MailMessage เพื่อส่งเป็นข้อความ RE หรือ FW. ส่วนของโค้ดต่อไปนี้แสดงวิธีสร้างบัญชีตัวอย่างที่ใช้ส่งข้อความและจากนั้นฟีเจอร์การตอบกลับและส่งต่อข้อความจะถูกสาธิตบนข้อความตัวอย่างนั้น. เพื่อทำงานนี้:

เริ่มต้นอ็อบเจ็กต์ IEWSClient โดยระบุข้อมูลประจำตัวที่ถูกต้อง.
ส่งข้อความตัวอย่างบางข้อความ.
เรียกฟังก์ชัน IEWSClient.reply(), IEWSClient.replyAll() และ IEWSClient.forward() เพื่อส่งข้อความ.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);

try {
    MailMessage message = new MailMessage("user@domain.com", "user@domain.com", "TestMailRefw - " + UUID.randomUUID().toString(),
            "TestMailRefw Implement ability to create RE and FW messages from source MSG file");

    client.send(message);

    ExchangeMessageInfoCollection messageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());
    if (messageInfoCol.size() == 1)
        System.out.println("1 message in Inbox");
    else
        System.out.println("Error! No message in Inbox");

    MailMessage message1 = new MailMessage("user@domain.com", "user@domain.com", "TestMailRefw - " + UUID.randomUUID().toString(),
            "TestMailRefw Implement ability to create RE and FW messages from source MSG file");

    client.send(message1);
    messageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());

    if (messageInfoCol.size() == 2)
        System.out.println("2 messages in Inbox");
    else
        System.out.println("Error! No new message in Inbox");

    MailMessage message2 = new MailMessage("user@domain.com", "user@domain.com", "TestMailRefw - " + UUID.randomUUID().toString(),
            "TestMailRefw Implement ability to create RE and FW messages from source MSG file");
    message2.getAttachments().addItem(Attachment.createAttachmentFromString("Test attachment 1", "Attachment Name 1"));
    message2.getAttachments().addItem(Attachment.createAttachmentFromString("Test attachment 2", "Attachment Name 2"));

    // Reply, Replay All and forward Message
    client.reply(message2, messageInfoCol.get_Item(0));
    client.replyAll(message2, messageInfoCol.get_Item(0));
    client.forward(message2, messageInfoCol.get_Item(0));
} catch (java.lang.RuntimeException ex) {
    System.out.println("Error in program" + ex.getMessage());
}

การสนับสนุน OAuth สำหรับ EWS กับ Office 365

Aspose.Email API ให้การสนับสนุนสำหรับ Exchange Web Service (EWS) กับ Office 365. API’s EWSClient อินเทอร์เฟซให้เมธอด overload ที่ให้ OAuthNetworkCredential เป็นอินพุตสำหรับการเข้าถึงบัญชี Exchange ผ่าน OAuth. ผู้ใช้ต้องระบุ Authority, Client Id, Client App Uri, และพารามิเตอร์ Resource เพื่อให้ทำงานได้. ส่วนของโค้ดต่อไปนี้แสดงการสนับสนุน OAuth สำหรับ EWS กับ Office 365.

// token provider
/*ITokenProvider provider = new ITokenProvider() {

    @Override
    public void dispose() {
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        return null;
    }
};

NetworkCredential credentials = new OAuthNetworkCredential(provider);*/

// accessToken
NetworkCredential credentials = new OAuthNetworkCredential("accessToken");

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", credentials);
client.listMessages();

รองรับการบันทึกในคลายันต์ Exchange

Aspose.Email API มีความสามารถในการให้บริการบันทึกของคลายันต์ Exchange Web Service.

การบันทึกสำหรับ EWS Client

client.setLogFileName("logs/ews");
// OR
EWSClient.setCommonLogFileName("logs/ews");

การเพิ่มส่วนหัวในคำขอ EWS

Aspose.Email API อนุญาตให้เพิ่มส่วนหัวในคำขอ Exchange. สามารถใช้เพื่อเพิ่มส่วนหัวในคำขอ EWS สำหรับส่วนหัวต่าง ๆ ที่ใช้เพื่อวัตถุต่าง ๆ. ตัวอย่างหนึ่งคือการเพิ่มส่วนหัว X-AnchorMailbox ที่ใช้จัดการปัญหา throttling บนเซิร์ฟเวอร์ Exchange. เมธอด addHeader ของ IEWSClient ใช้ในการเพิ่มส่วนหัวในคำขอ EWS ตามที่แสดงในส่วนของโค้ดต่อไปนี้.

final IEWSClient client = EWSClient.getEWSClient("exchange.domain.com/ews/Exchange.asmx", "username", "password", "");
try {
    client.addHeader("X-AnchorMailbox", "username@domain.com");
    ExchangeMessageInfoCollection messageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());
} finally {
    client.dispose();
}

ส่งคืน Client Request ID ในส่วนหัว

นี้ return-client-request-id ส่วนหัวถูกส่งในคำขอและใช้โดยเซิร์ฟเวอร์เพื่อตัดสินใจว่า client-request-id ส่วนหัวที่ระบุโดยคลายันต์ควรถูกส่งกลับในการตอบสนองของเซิร์ฟเวอร์. เมธอดต่อไปนี้ใช้ในการดำเนินการนี้:

getReturnClientRequestId()
setReturnClientRequestId(boolean value) - รับหรือกำหนดค่าแฟล็กเพื่อระบุว่าคลายันต์ต้องการให้เซิร์ฟเวอร์ส่งคืน request id หรือไม่.

try (IEWSClient client = createEWSClient())
{
    // Client will create random id and pass it to the server.
    // The server should include this id in request-id header of all responses.
    client.setReturnClientRequestId(true);
    
    client.setLogFileName("ews.log");
    client.getMailboxInfo();
}

การทำงานกับการสื่อสารแบบรวม

Aspose.Email สามารถเรียกคืนข้อมูลการสื่อสารแบบรวมจาก Exchange Server 2010. การสื่อสารแบบรวมเช่น การรับข้อมูลการกำหนดค่า, เริ่มการโทรออก, ดึงข้อมูลการโทรตาม ID การโทรและตัดการโทรตาม ID ได้รับการสนับสนุนในปัจจุบัน. ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการดึงข้อมูลการกำหนดค่าการสื่อสารแบบรวมจาก Microsoft Exchange Server 2010.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);
UnifiedMessagingConfiguration umConf = client.getUMConfiguration();

รับเคล็ดลับอีเมล

Microsoft Exchange Server เพิ่มคุณลักษณะใหม่หลายอย่างใน Exchange Server 2010 และ 2013. หนึ่งในนั้นทำให้ผู้ใช้ได้รับเคล็ดลับอีเมลขณะเขียนข้อความอีเมล. เคล็ดลับเหล่านี้มีประโยชน์เพราะให้ข้อมูลก่อนส่งอีเมล. ตัวอย่างเช่น หากที่อยู่อีเมลในรายการผู้รับไม่ถูกต้อง ระบบจะแสดงเคล็ดลับบอกว่าที่อยู่นั้นไม่ถูกต้อง. เคล็ดลับอีเมลยังให้คุณเห็นการตอบกลับ “นอกสำนักงาน” ก่อนส่งอีเมล: Exchange Server (2010 & 2013) จะส่งเคล็ดลับอีเมลขณะเขียนหากผู้รับคนหนึ่งหรือหลายคนตั้งค่าการตอบกลับนอกสำนักงาน. ต้องใช้ Microsoft Exchange Server 2010 Service Pack 1 สำหรับคุณลักษณะทั้งหมดที่แสดงในบทความนี้. ส่วนของโค้ดต่อไปนี้แสดงวิธีการใช้ EWSClient คลาสที่ใช้ Exchange Web Services, มีให้ใน Microsoft Exchange Server 2007 และรุ่นต่อ ๆ ไป.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
System.out.println("Connected to Exchange server...");
// Provide mail tips options
MailAddressCollection addrColl = new MailAddressCollection();
addrColl.addMailAddress(new MailAddress("test.exchange@ex2010.local", true));
addrColl.addMailAddress(new MailAddress("invalid.recipient@ex2010.local", true));
GetMailTipsOptions options = new GetMailTipsOptions(MailAddress.to_MailAddress("administrator@ex2010.local"), addrColl, MailTipsType.All);

// Get Mail Tips
MailTips[] tips = client.getMailTips(options);

// Display information about each Mail Tip
for (MailTips tip : tips) {
    // Display Out of office message, if present
    if (tip.getOutOfOffice() != null) {
        System.out.println("Out of office: " + tip.getOutOfOffice().getReplyBody().getMessage());
    }

    // Display the invalid email address in recipient, if present
    if (tip.getInvalidRecipient() == true) {
        System.out.println("The recipient address is invalid: " + tip.getRecipientAddress());
    }
}

การแสดงตนของ Exchange

การแสดงตนของ Exchange อนุญาตให้บุคคลหนึ่งแสดงตนเป็นบัญชีอื่นและดำเนินงานต่าง ๆ ด้วยสิทธิของบัญชีที่แสดงตนแทนของตนเอง. ในขณะที่การมอบอำนาจทำให้ผู้ใช้ทำงานในนามของผู้ใช้คนอื่น, การแสดงตนทำให้พวกเขาเป็นผู้ใช้คนอื่น. Aspose.Email รองรับการแสดงตนของ Exchange. EWSClient คลาสนี้ให้เมธอด ImpersonateUser และ ResetImpersonation เพื่ออำนวยความสะดวกสำหรับฟีเจอร์นี้.

เพื่อทำงานนี้:

เริ่มต้น ExchangeWebServiceClient สำหรับผู้ใช้ 1.
เริ่มต้น ExchangeWebServiceClient สำหรับผู้ใช้ 2.
เพิ่มข้อความทดสอบไปยังบัญชี.
เปิดใช้งานการแสดงตน.
รีเซ็ตการแสดงตน.

โค้ดตัวอย่างต่อไปนี้แสดงวิธีการใช้ EWSClient คลาสสำหรับทำฟีเจอร์การแสดงตน (Impersonation).

// Create instance's of EWSClient class by giving credentials
IEWSClient client1 = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser1", "pwd", "domain");
IEWSClient client2 = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser2", "pwd", "domain");
{
    String folder = "Drafts";
    try {
        for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) client1.listMessages(folder))
            client1.deleteItem(messageInfo.getUniqueUri(), DeletionOptions.getDeletePermanently());
        String subj1 = "NETWORKNET_33354 User User1";
        client1.appendMessage(folder, new MailMessage("User1@exchange.conholdate.local", "To@aspsoe.com", subj1, ""));

        for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) client2.listMessages(folder))
            client2.deleteItem(messageInfo.getUniqueUri(), DeletionOptions.getDeletePermanently());
        String subj2 = "NETWORKNET_33354 User User2";
        client2.appendMessage(folder, new MailMessage("User2@exchange.conholdate.local", "To@aspose.com", subj2, ""));

        ExchangeMessageInfoCollection messInfoColl = client1.listMessages(folder);
        // Assert.AreEqual(1, messInfoColl.Count);
        // Assert.AreEqual(subj1, messInfoColl[0].Subject);

        client1.impersonateUser(ItemChoice.PrimarySmtpAddress, "User2@exchange.conholdate.local");
        ExchangeMessageInfoCollection messInfoColl1 = client1.listMessages(folder);
        // Assert.AreEqual(1, messInfoColl1.Count);
        // Assert.AreEqual(subj2, messInfoColl1[0].Subject);

        client1.resetImpersonation();
        ExchangeMessageInfoCollection messInfoColl2 = client1.listMessages(folder);
        // Assert.AreEqual(1, messInfoColl2.Count);
        // Assert.AreEqual(subj1, messInfoColl2[0].Subject);
    } finally {
        try {
            for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) client1.listMessages(folder))
                client1.deleteItem(messageInfo.getUniqueUri(), DeletionOptions.getDeletePermanently());
            for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) client2.listMessages(folder))
                client2.deleteItem(messageInfo.getUniqueUri(), DeletionOptions.getDeletePermanently());
        } catch (java.lang.RuntimeException e) {
        }
    }
}

ฟีเจอร์ Auto Discover ด้วย EWS

Aspose.Email API ช่วยให้คุณค้นพบการตั้งค่า Exchange Server ด้วยการใช้ EWS Client

AutodiscoverService svc = new AutodiscoverService();
svc.setCredentials(new NetworkCredential(email, password));

IGenericDictionary</* UserSettingName */Integer, Object> userSettings = svc.getUserSettings(email, UserSettingName.ExternalEwsUrl).getSettings();
String ewsUrl = (String) userSettings.get_Item(UserSettingName.ExternalEwsUrl);
System.out.println("Auto discovered EWS Url: " + ewsUrl);

ยกเลิกการกู้คืน PST ไปยัง Exchange Server

Aspose.Email API ช่วยให้คุณกู้คืนไฟล์ PST ไปยัง Exchange Server. อย่างไรก็ตาม หากการดำเนินการใช้เวลานานเนื่องจากไฟล์ PST มีขนาดใหญ่ อาจจำเป็นต้องระบุเกณฑ์สำหรับการยกเลิกการดำเนินการ. สามารถทำได้โดยใช้ API ตามที่แสดงในตัวอย่างโค้ดต่อไปนี้.

final IEWSClient client = EWSClient.getEWSClient("https://exchange.office365.com/ews/exchange.asmx", "username", "password");
try {
    final long startTime = System.currentTimeMillis();
    final AtomicInteger processedItems = new AtomicInteger(0);
    final long S15 = 15 * 1000;

    BeforeItemCallback callback = new BeforeItemCallback() {
        public void invoke(ItemCallbackArgs item) {
            if (System.currentTimeMillis() - startTime > S15) {
                throw new AbortRestoreException();
            }

            processedItems.incrementAndGet();
        }
    };

    try {
        // create a test pst and add some test messages to it
        PersonalStorage pst = PersonalStorage.create(new ByteArrayOutputStream(), FileFormatVersion.Unicode);
        FolderInfo folder = pst.getRootFolder().addSubFolder("My test folder");
        for (int i = 0; i < 20; i++) {
            MapiMessage message = new MapiMessage("from@gmail.com", "to@gmail.com", "subj", "body");
            folder.addMessage(message);
        }
        RestoreSettings rs = new RestoreSettings();
        rs.setBeforeItemCallback(callback);

        // now restore the PST with callback
        client.restore(pst, rs);
        System.out.println("Success!");
    } catch (AbortRestoreException e) {
        System.out.println("Timeout! " + processedItems.get());
    }
} finally {
    client.dispose();
}

Java: กรองการนัดหมายจาก Exchange Server

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

กรองการนัดหมายด้วย EWS

นี้ IEWSClient ให้ความสามารถในการกรองการนัดหมายจาก Exchange server ด้วยการใช้ ExchangeQueryBuilder. การนัดหมายสามารถกรองตาม:

วันที่
การเกิดซ้ำ

กรองการนัดหมายตามวันที่

IEWSClient client = EWSClient.getEWSClient(mailboxUri, username, password, domain);

SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy HH:mm:ss");
Date startTime = sdf.parse("15/09/2017 00:00:00");
Date endTime = sdf.parse("10/10/2017 00:00:00");
ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
builder.getAppointment().getStart().since(startTime);
builder.getAppointment().getEnd().beforeOrEqual(endTime);
MailQuery query = builder.getQuery();
Appointment[] appointments = client.listAppointments(query);

กรองการนัดหมายตามเหตุการณ์ที่เกิดซ้ำ

builder = new ExchangeQueryBuilder();
builder.getAppointment().isRecurring().equals(false);
query = builder.getQuery();
appointments = client.listAppointments(query);

Java: ทำงานกับแอตทริบิวต์ขยายของรายการ Exchange

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

Aspose.Email API ช่วยให้คุณสร้าง, ดึงและอัปเดตคุณสมบัติขยายของข้อความโดยใช้ EWS client ของ API ตัวอย่างโค้ดต่อไปนี้แสดงวิธีการสร้างแอตทริบิวต์ขยาย, เพิ่มลงในข้อความบนเซิร์ฟเวอร์และดึงข้อความเป็น MapiMessage จาก Exchange server โดยใช้ของไคลเอนต์ fetchItem.

// Define a PidTagBodyContentId extended property
PropertyDescriptor extendedProperty = KnownPropertyList.BODY_CONTENT_ID;

// Create a message and set an extended property value
MapiMessage msg = new MapiMessage("from@from.com", "to@to.com",
        "Test message", "This is a test message");
msg.setProperty(extendedProperty, "03454432-6230-4e4b-887f-a498ea223599");

// Append message
String uri = ewsClient.appendMessage(ewsClient.getMailboxInfo().getInboxUri(), msg, true);

// Fetch appended item. Pass the extended property descriptor as method parameter.
MapiMessage fetchedMsg = ewsClient.fetchItem(uri, Arrays.asList(new PropertyDescriptor[] { extendedProperty }));

// Print the extended property value
System.out.println(fetchedMsg.getProperties().get_Item(extendedProperty).getString());

Java: การทำงานกับที่เก็บไว้ในตำแหน่ง (In-Place Archive)

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

In-Place Archives ใน Office 365

In-Place Archives ใน Office 365 ให้พื้นที่จัดเก็บเพิ่มเติมแก่ผู้ใช้. หลังจากเปิดใช้งานกล่องจดหมาย Archive แล้ว ผู้ใช้สามารถเข้าถึงและเก็บข้อความใน Archive Mailbox ของตนโดยใช้ Microsoft Outlook และ Outlook บนเว็บ. เมื่อเปิดกล่องจดหมายที่เปิดใช้งาน In-Place Archiving ด้วย Outlook, กล่องจดหมาย Archive จะแสดงเป็นกล่องจดหมายแยกต่างหาก.

ย้ายรายการไปยัง In-Place Archive

Aspose.Email API สามารถใช้เพื่อย้ายรายการไปยังกล่องจดหมาย Archive ของผู้ใช้โดยใช้ IEWSClient.archiveItem เมธอด. IEWSClient.archiveItem เมธอดให้ overload สี่แบบซึ่งระบุด้านล่าง.

archiveItem(String sourceFolderUri, Appointment appointment)
archiveItem(String sourceFolderUri, ExchangeTask task)
archiveItem(String sourceFolderUri, MapiMessageItemBase item)]
archiveItem(String sourceFolderUri, String uniqueId)

ตัวอย่างโค้ดด้านล่างแสดงการใช้ของ IEWSClient.archiveItem เมธอดเพื่อย้ายอีเมลไปยังกล่องจดหมาย Archive โดยใช้ UniqueUri.

NetworkCredential credentials = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    System.out.println("Subject:" + msgInfo.getSubject());
    client.archiveItem(client.getMailboxInfo().getInboxUri(), msgInfo.getUniqueUri());
}
client.dispose();

Java: รับข้อความจากกล่องจดหมายที่แชร์

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

Aspose.Email รองรับการเข้าถึงข้อความจากกล่องจดหมายที่แชร์ เพื่อทำเช่นนี้ คุณเชื่อมต่อกับกล่องจดหมายหลักของคุณโดยใช้ EWSClient class. เพื่อเข้าถึงข้อความจากกล่องจดหมายที่แชร์ คุณต้องส่งชื่อกล่องจดหมายที่แชร์เป็นพารามิเตอร์ประเภทสตริงไปยัง listMessages หรือ listItems เมธอด.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเข้าถึงข้อความจากกล่องจดหมายที่แชร์โดยใช้ listItems เมธอด.

final String mailboxUri = "<HOST>";
final String domain = "";
final String username = "<EMAIL ADDRESS>";
final String password = "<PASSWORD>";
final String sharedEmail = "<SHARED EMAIL ADDRESS>";
NetworkCredential credentials = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

String[] items = client.listItems(sharedEmail, "Inbox");

for (String item : items) {
    MapiMessage msg = client.fetchItem(item);
    System.out.println("Subject:" + msg.getSubject());
}
client.dispose();

Java: รองรับ TLS 1.2 และ AutodiscoverService

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

Aspose.Email for Java ตอนนี้รองรับ TLS 1.2 ด้วยการใช้ SAAJ API. ส่วน EWSClient ให้คุณสมบัติสแตติก useSAAJAPI ซึ่งสามารถตั้งค่าเป็น true เพื่อใช้ TLS 1.2 Aspose.Email for Java ยังสนับสนุน AutodiscoverService สำหรับ TLS 1.2 ตัวอย่างโค้ดต่อไปนี้แสดงการใช้ SAAJ API และ AutodiscoverService สำหรับ TLS 1.2.

ใช้ SAAJ API

คลายเอนต์ Java EE SOAP ที่ใช้ในโหมด SAAJAPI - https://docs.oracle.com/cd/E19651-01/817-2151-10/wsgjaxm.html.

ตัวอย่างโค้ดต่อไปนี้แสดงการใช้ SAAJ API โดยตั้งค่า EWSClient.useSAAJAPI คุณสมบัติเป็น true.

ในโค้ดสแนปต่อไปจะกำหนดหัวข้อการตรวจสอบสิทธิ Basic:

EWSClient.useSAAJAPI(true);
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testuser", "pw", "domain");
client.listMessages();

ในโค้ดสแนปต่อไปจะกำหนดหัวข้อการตรวจสอบสิทธิ OAUTH2:

EWSClient.useSAAJAPI(true);
// token provider
/*ITokenProvider provider = new ITokenProvider() {

    @Override
    public void dispose() {
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        return null;
    }
};

NetworkCredential credentials = new OAuthNetworkCredential(provider);*/

// accessToken
NetworkCredential credentials = new OAuthNetworkCredential("accessToken");

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", credentials);
client.listMessages();

หมายเหตุว่าในโหมดนี้ API ไม่ได้ควบคุมกระบวนการตรวจสอบสิทธิ NTLM จำเป็นต้องใช้ Java Authenticator สำหรับการตรวจสอบสิทธิ NTLM

โค้ดสแนปการตรวจสอบสิทธิ NTLM สำหรับ Java 8:

import java.net.Authenticator;
import java.net.PasswordAuthentication;
import java.net.URL;

static Authenticator getAuthenticator(String user, String pw, String domain) {
    final String username = domain + "\\" + user;
    final String password = pw;
    System.out.println("New Credentials " + username);
    return new Authenticator() {
        protected PasswordAuthentication getPasswordAuthentication() {
            System.out.println("Authenticate " + username);
            return new PasswordAuthentication(username, password.toCharArray());
        }
    };
}

EWSClient.useSAAJAPI(true);
System.setProperty("http.auth.preference", "NTLM");
Authenticator.setDefault(getAuthenticator("user", "pw", ""));
IEWSClient client = EWSClient.getEWSClient(new URL("https://domain.com/ews/Exchange.asmx"));

static Authenticator getAuthenticator() {

    // This block is written for suppressing a bug in sun implementation.
    // In Sun Impl client doesn't authenticate user for each connection,
    // uses cached credentials instead.
    sun.net.www.protocol.http.AuthCacheValue.setAuthCache(new sun.net.www.protocol.http.AuthCache() {
        public void remove(String pkey, sun.net.www.protocol.http.AuthCacheValue entry) {
        }
        public void put(String pkey, sun.net.www.protocol.http.AuthCacheValue value) {
        }
        public sun.net.www.protocol.http.AuthCacheValue get(String pkey, String skey) {
            return null;
        }
    });

    return new Authenticator() {
        protected PasswordAuthentication getPasswordAuthentication() {
            return getEmbeddedCredentials(getRequestingURL());
        }

        PasswordAuthentication getEmbeddedCredentials(URL url) {
            if (url == null) {
                return null;
            }
            String userInfo = url.getUserInfo();
            int colon = userInfo == null ? -1 : userInfo.indexOf(":");
            if (colon == -1) {
                return null;
            } else {
                String userName = userInfo.substring(0, colon);
                String pass;
                try {
                    pass = URLDecoder.decode(userInfo.substring(colon + 1), "UTF-8");
                } catch (UnsupportedEncodingException e) {
                    pass = "";
                }
                System.out.println("Authenticate " + userInfo);
                return new PasswordAuthentication("\\" + userName, pass.toCharArray());
            }
        }
    };
}

static URL getURL(String url, String user, String pw, String domain) throws Exception {
    String host = new URL(url).getHost();
    URL endpoint = new URL(url.replace(host, user + ":" + URLEncoder.encode(pw, "UTF-8") + "@" + host));

    return endpoint;
}

EWSClient.useSAAJAPI(true);
Authenticator.setDefault(getAuthenticator());

System.setProperty("http.auth.preference", "NTLM");
IEWSClient client1 = EWSClient.getEWSClient(getURL("https://domain.com/ews/Exchange.asmx", "user1", "pw", "domain"));
IEWSClient client2 = EWSClient.getEWSClient(getURL("https://domain.com/ews/Exchange.asmx", "user2", "pw", "domain"));

ตั้งแต่ Java 9 เป็นต้นไป Authenticator สามารถตั้งค่าสำหรับการเชื่อมต่อได้:

static Map<String, Authenticator> authInfo = new HashMap<String, Authenticator>();
static URL getURL(String url, final String user, final String pw, final String domain) throws MalformedURLException {
    URL endpoint = new URL(new URL(url), "", new URLStreamHandler() {
        protected URLConnection openConnection(URL url) throws IOException {
            URL target = new URL(url.toString());
            HttpURLConnection connection = (HttpURLConnection) target.openConnection();
            // Cache for User@Url
            Authenticator auth = authInfo.get(user + "@" + url);
            if (auth == null) {
                auth = new Authenticator() {
                    protected PasswordAuthentication getPasswordAuthentication() {
                        System.out.println("Authenticate " + user);
                        return new PasswordAuthentication(domain + "\\" + user, pw.toCharArray());
                    }
                };
                authInfo.put(user + "@" + url, auth);
            }
            connection.setAuthenticator(auth);

            return connection;
        }
    });

    return endpoint;
}

EWSClient.useSAAJAPI(true);
System.setProperty("http.auth.preference", "NTLM");
IEWSClient client1 = EWSClient.getEWSClient(getURL("https://domain.com/ews/Exchange.asmx", "user1", "pw", "domain"));
IEWSClient client2 = EWSClient.getEWSClient(getURL("https://domain.com/ews/Exchange.asmx", "user2", "pw", "domain"));

หมายเหตุ: API ของ JAXB ถือเป็น API ของ Java EE ดังนั้นจึงไม่รวมอยู่ใน class path เริ่มต้นของ Java SE 9 อีกต่อไป

การพึ่งพา Maven JAXB:

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-core</artifactId>
</dependency>
<dependency>
    <groupId>com.sun.xml.messaging.saaj</groupId>
    <artifactId>saaj-impl</artifactId>
</dependency>

ใช้ AutodiscoverService

ตัวอย่างโค้ดต่อไปนี้แสดงการใช้ AutodiscoverService สำหรับ TLS 1.2

AutodiscoverService service = new AutodiscoverService();
service.setCredentials(new NetworkCredential("user", "password"));
GetUserSettingsResponse response = service.getUserSettings("userSmtpAddress", UserSettingName.ExternalEwsUrl, UserSettingName.UserDisplayName);