Documentation – Міграція з Office Automation до Aspose

Java: Читання файлу Outlook Message (MSG)

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

Наші поради щодо міграції демонструють, як продукти Aspose можна використовувати для покращення ваших застосунків і звільнення від залежності від традиційної автоматизації.

Ця порада щодо міграції показує, як читати файл повідомлення Microsoft Outlook та відображати його вміст на екрані, використовуючи обидва Автоматизація Microsoft Office і Aspose.Email код. Наведений нижче приклад коду лише виводить вміст у консоль, щоб дати уявлення про його роботу. Використовуйте фрагменти коду у власному Windows, веб або іншому застосуванні.

Автоматизація Office

Щоб використовувати об’єкти автоматизації Office для Microsoft Outlook, потрібно додати посилання на бібліотеки Microsoft Office та Microsoft Office Interop для Outlook у ваш проект.

Зразки коду


// Add the namespaces

using Microsoft.Office;

using Microsoft.Office.Interop.Outlook;

// Create a new Application Class

Application app = new Application();

// Create a MailItem object

MailItem item = (MailItem)outlook.CreateItemFromTemplate(@"d:\temp\test.msg", Type.Missing);

// Access different fields of the message

System.Console.WriteLine(string.Format("Subject:{0}", item.Subject));

System.Console.WriteLine(string.Format("Sender Email Address:{0}", item.SenderEmailAddress));

System.Console.WriteLine(string.Format("SenderName:{0}", item.SenderName));

System.Console.WriteLine(string.Format("TO:{0}", item.To));

System.Console.WriteLine(string.Format("CC:{0}", item.CC));

System.Console.WriteLine(string.Format("BCC:{0}", item.BCC));

System.Console.WriteLine(string.Format("Html Body:{0}", item.HTMLBody));

System.Console.WriteLine(string.Format("Text Body:{0}", item.Body));

Aspose.Email для Java

Наступний фрагмент коду робить те саме, що і вищенаведений код використовуючи Aspose.Email for Java.

Щоб отримати доступ до Aspose.Email Outlook об’єкти, вам потрібно додати посилання на Aspose.Email у ваш проект.

Зразки коду


// Create a new object of type MapiMessage
MapiMessage msg = MapiMessage.fromFile("d:\\temp\\test.msg");

// Access the fields of the message
System.out.println("Subject: " + msg.getSubject());
System.out.println("Sender Email Address: " + msg.getSenderEmailAddress());
System.out.println("SenderName:{0}" + msg.getSenderName());
System.out.println("TO:{0}" + msg.getDisplayTo());
System.out.println("CC:{0}" + msg.getDisplayCc());
System.out.println("BCC:{0}" + msg.getDisplayBcc());
System.out.println("Html Body:{0}" + msg.getBodyHtml());
System.out.println("Text Body:{0}" + msg.getBody());
System.out.println("Rtf Body:{0}" + msg.getBodyRtf());

Java: Створення файлу повідомлення Outlook (MSG)

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

Ця порада щодо міграції показує, як створити файл Outlook Message (MSG) за допомогою Автоматизація Microsoft Office і Aspose.Email. Приклади коду встановлюють базові властивості файлу MSG — To, Cc, Subject та HTML‑тіло — перед збереженням файлу на диск.

Автоматизація Office

Щоб використовувати автоматизацію Office, Microsoft Outlook має бути встановлений на машині, на якій виконується код. Також потрібне посилання на Outlook.interop.dll.

Зразки коду

Наступні фрагменти коду створюють файл MSG за допомогою автоматизації Office.


 // Creates a new Outlook Application instance

Outlook.Application objOutlook = new Outlook.Application();

// Creating a new Outlook message from the Outlook Application instance

Outlook.MailItem msgInterop = (Outlook.MailItem)(objOutlook.CreateItem(Outlook.OlItemType.olMailItem));

// Set recipient information

msgInterop.To = "to@domain.com";

msgInterop.CC = "cc@domain.com";

// Set the message subject

msgInterop.Subject = "Subject";

// Set some HTML text in the HTML body

msgInterop.HTMLBody = "<h3>HTML Heading 3</h3> <u>This is underlined text</u>";

// Save the MSG file in local disk

string strMsg = @"c:\\temp\TestInterop.msg";

msgInterop.SaveAs(strMsg, Outlook.OlSaveAsType.olMSG);

Aspose.Email для Java

Нижче наведених приклади використовують Aspose.Email для створення файлу Outlook MSG. Він написаний чистою Java і не використовує COM Interop. Встановлення Outlook не потрібно для створення файлу MSG таким способом.


// Create an instance of the Aspose.Email.MailMessage class
MailMessage msg = new MailMessage();

// Set recipients information
msg.setTo(MailAddressCollection.to_MailAddressCollection("to@domain.com"));
msg.setCC(MailAddressCollection.to_MailAddressCollection("cc@domain.com"));

// Set the subject
msg.setSubject("Subject");

// Set HTML body
msg.setHtmlBody("<h3>HTML Heading 3</h3> <u>This is underlined text</u>");

// Add an attachment
msg.getAttachments().addItem(new Attachment("test.txt"));

// Save it in local disk
String strMsg = "c:\\ TestAspose.msg";
msg.save(strMsg, SaveOptions.getDefaultMsgUnicode());

Java: Додавання вкладень та HTML‑тексту до файлу Outlook MSG

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

Ця порада щодо міграції показує, як створити файл MSG з тілом у форматі HTML та додати до нього кілька вкладень:

Розділ коду VBA, який використовує Автоматизація Microsoft Office для створення файлу MSG з вкладеннями та HTML‑тілом.
Те саме, що досягнуто за допомогою Aspose.Email для Java.

Автоматизація Office

При використанні цього методу Microsoft Outlook повинен бути встановлений на машині, де виконується код VBA. Нижче наведений фрагмент коду створює файл Outlook MSG з вкладеннями та HTML‑тілом.

VBA


 ' Create an object of type Outlook.Application

Set objOutlookApplication = CreateObject("Outlook.Application")

' Create an object of type olMailItem

Set objMsg = objOutlookApplication.CreateItem(olMailItem)

' Set properties of the message file e.g. subject, body and to address

' Set subject

objMsg.Subject = "This MSG file is created using Office Automation."

' Set to (recipient) address

objMsg.To = "to@domain.com"

' Set body of the email message

objMsg.HTMLBody = "<html><p>This MSG file is created using VBA code.</p>"

' Add attachments to the message

objMsg.Attachments.Add "C:\test.bmp"

objMsg.Attachments.Add "C:\test2.jpg"

' Save as Outlook MSG file

objMsg.SaveAs ("c:\testvba.msg")

' Open the MSG file

objMsg.Display

Aspose.Email для Java

Нижче наведений фрагмент коду використовує бібліотеку Aspose.Email for Java для створення файлу MSG, подібно до той, що створено вище, з кількома вкладеннями та HTML‑тілом. Оскільки Aspose.Email for Java написаний повністю на Java, COM‑interop не потрібен. Крім того, Microsoft Outlook 2003/2007 не обов’язково має бути встановленим на машині. Описаний нижче метод підходить, коли Microsoft Outlook не встановлений або коли потрібно генерувати файли MSG на сервері.

Нижче наведені фрагменти коду, які показують, як виконати те саме завдання на Java за допомогою Aspose.Email for Java:


// Create an instance of type MailMessage
MailMessage msg = new MailMessage();

// Set properties of message like subject, to and HTML body
// Set subject
msg.setSubject("This MSG file is created using Aspose.Email for .NET");

// Set from (sender) address
msg.setSender(new MailAddress("from@domain.com", "From Name"));

// Set to (recipient) address and name
msg.getTo().addItem(new MailAddress("to@domain.com", "To Name"));

// Set HTML body of the email message
msg.setHtmlBody("<html><p>This MSG file is created using Java code.</p>" 
        + "<p>Microsoft Outlook does not need to be installed on the machine running this code.</p>"
        + "<p>This method is suitable for creating MSG files on the server side.</html>");

// Add attachments to the message file
msg.getAttachments().addItem(new Attachment("C:\\test.bmp"));
msg.getAttachments().addItem(new Attachment("C:\\test2.jpg"));

// Save as Outlook MSG file
String strSaveFile = "C:\\TestAspose.msg";

msg.save(strSaveFile, SaveOptions.getDefaultMsgUnicode());

Java: Надсилання запиту на зустріч за допомогою Outlook Interop та Aspose.Email for Java

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

Ця порада щодо міграції надсилає запит на зустріч одержувачу. Вона демонструє, як відправити запит на зустріч у два способи:

Ми також обговоримо переваги останнього підходу.

Надсилання запиту на зустріч за допомогою Outlook Interop

Щоб використовувати класи Outlook, у вашому .NET‑проекті має бути посилання на Outlook.Interop. Нижче наведений фрагмент коду:

Створює запит на зустріч.
Встановлює такі властивості, як тема, тіло, місце та час.
Надсилає запит на зустріч одержувачу.

Microsoft Outlook має бути встановлений у системі, де буде виконуватись це приклад застосунку.

Зразки коду


// Create an instance of Outlook Application class

Outlook.Application outlookApp = new Outlook.Application ();

// Create an instance of AppointmentItem object and set the properties:

Outlook.AppointmentItem oAppointment = (Outlook.AppointmentItem) outlookApp.CreateItem (Outlook.OlItemType.olAppointmentItem);

oAppointment.Subject = "subject of appointment";

oAppointment.Body = "body text of appointment";

oAppointment.Location = "Appointment location";

// Set the start date and end dates

oAppointment.Start = Convert.ToDateTime ("01/22/2010 10:00:00 AM");

oAppointment.End = Convert.ToDateTime("01/22/2010 2:00:00 PM");

// Save the appointment

oAppointment.Save ();

// Send the appointment

Outlook.MailItem mailItem = oAppointment.ForwardAsVcal ();

mailItem.To = "recipient@domain.com";

mailItem.Send();

Надсилання запиту на зустріч за допомогою Aspose.Email for Java

Нижче наведений код використовує Aspose.Email for Java для надсилання запиту на зустріч. Спочатку створіть запит на зустріч, використовуючи Aspose.Email Appointment клас. Потім надішліть лист, прикріпіть запит на зустріч і надішліть лист, використовуючи Aspose.Email SmtpClient клас.

Переваги використання Aspose.Email for Java

Outlook Interop вимагає, щоб Microsoft Outlook був встановлений у системі, де він використовується. Aspose.Email for Java не потребує встановлення Microsoft Outlook і підходить для серверних застосувань.

Зразки коду


// Create attendees of the meeting
MailAddressCollection attendees = new MailAddressCollection();
attendees.add("recipient1@domain.com");
attendees.add("recipient2@domain.com");

java.util.Calendar c = java.util.Calendar.getInstance();
Date startDate = c.getTime();
c.add(java.util.Calendar.HOUR_OF_DAY, 1);
Date endDate = c.getTime();

// Set up appointment
Appointment app = new Appointment(
    "Location", // location of meeting
    startDate, // start date
    endDate, // end date
    new MailAddress("organizer@domain.com"), // organizer
    attendees); // attendees

// Set up message that needs to be sent
MailMessage msg = new MailMessage();
msg.setFrom(new MailAddress("from@domain.com"));
msg.setTo(MailAddressCollection.to_MailAddressCollection("to@domain.com"));
msg.setSubject("appointment request");
msg.setBody("you are invited");

// Add meeting request to the message
msg.addAlternateView(app.requestApointment());

// Set up the SMTP client to send email with meeting request
try (SmtpClient client = new SmtpClient("host", 25, "user", "password")) {
    client.send(msg);
}

Java: Отримання списку листів з папки Inbox поштової скриньки Microsoft Exchange Server

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

Ця порада щодо міграції підключається до поштової скриньки Microsoft Exchange Server і отримує список листів з папки Inbox. Наведені нижче зразки коду показують, як використовувати Microsoft Office Interop для отримання списку листів перед виконанням того ж за допомогою класів у Aspose.Email Exchange, використовуючи Java.

Використання Microsoft Office Interop

Щоб використовувати об’єкти автоматизації Office для Microsoft Outlook, додайте посилання на бібліотеки Microsoft Office та Microsoft Office Interop для Outlook у проект. Microsoft Office Outlook також має бути встановлений на машині, на якій виконується код.

Зразки коду


 // Create Application class and get namespace

Outlook.Application outlook = new Outlook.ApplicationClass();

Outlook.NameSpace ns = outlook.GetNamespace("Mapi");

object _missing = Type.Missing;

ns.Logon(_missing, _missing, false, true);

// Get Inbox information in objec of type MAPIFolder

Outlook.MAPIFolder inbox = ns.GetDefaultFolder(Outlook.OlDefaultFolders.olFolderInbox);

// Unread emails

int unread = inbox.UnReadItemCount;

// Display the subject of emails in the Inbox folder
foreach (Outlook.MailItem mail in inbox.Items)

{

    Console.WriteLine(Wmail.Subject);


}

Використання Aspose.Email

Наступні фрагменти коду роблять те ж саме, що й вищенаведені фрагменти але використовує Aspose.Email.

Проте Microsoft Outlook не потрібно встановлювати на машину, на якій виконується код. Додайте посилання на Aspose.Email, щоб успішно створити та запустити проєкт.

Зразки коду


// Create instance of IEWSClient class by giving credentials
try (IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/EWS/Exchange.asmx", "username", "password", "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 : 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());
        System.out.println("==================================");
    }
}

Java: Витягування повідомлень з Outlook PST і збереження їх у форматі MSG

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

Ця порада щодо міграції показує, як витягнути повідомлення з файлу Outlook PST і зберегти їх на диск як файли MSG. Це включає кілька кроків:

Прочитати файл Outlook PST,
витягнути повідомлення і, нарешті,
зберегти витягнуті повідомлення.

Існують різні способи досягти того ж результату: у цій статті порівнюються використання VSTO та Aspose.Email. По-перше, це зразки коду для використання Microsoft Office Interop для витягування повідомлень з PST. Після цього прикладу, зразки коду показують, як використовувати Aspose.Email Outlook, на Java, щоб виконати те саме завдання.

Використання Microsoft Office Interop

Щоб використовувати об’єкти автоматизації Office для Microsoft Outlook, додайте посилання на бібліотеки Microsoft Office Interop для Outlook у проект. Microsoft Office Outlook також має бути встановлений на машині, на якій виконується код. Простір імен, який використовується у наступному прикладі коду, — Microsoft.Office.Interop.Outlook.

Приклади коду


 string pstFilePath = @"C:\sample.pst";

Application app = new Application();

NameSpace outlookNs = app.GetNamespace("MAPI");

// Add PST file (Outlook Data File) to Default Profile

outlookNs.AddStore(pstFilePath);

MAPIFolder rootFolder = outlookNs.Stores["items"].GetRootFolder();

// Traverse through all folders in the PST file

// TODO: This is not recursive

Folders subFolders = rootFolder.Folders;

foreach (Folder folder in subFolders)

{

    Items items = folder.Items;

    foreach (object item in items)

    {

        if (item is MailItem)

        {

            // Retrieve the Object into MailItem

            MailItem mailItem = item as MailItem;

            Console.WriteLine("Saving message {0} ....", mailItem.Subject);

            // Save the message to disk in MSG format

            // TODO: File name may contain invalid characters [\ / : * ? " < > |]

            mailItem.SaveAs(@"\extracted\" + mailItem.Subject + ".msg",OlSaveAsType.olMSG);

        }

    }

}

// Remove PST file from Default Profile

outlookNs.RemoveStore(rootFolder);

Використання Aspose.Email

Наступні фрагменти коду роблять те ж саме, що й вищенаведений код але використовує Aspose.Email. Після встановлення Aspose.Email for Java Microsoft Outlook більше не потрібен на машині. Достатньо додати посилання на Aspose.Email, щоб успішно зібрати та запустити проект.

Зразки коду


String pstFilePath = "C:\\sample.pst";

// Create an instance of PersonalStorage and load the PST from file
try (PersonalStorage personalStorage = PersonalStorage.fromFile(pstFilePath)) {
    // Get the list of subfolders in PST file
    FolderInfoCollection folderInfoCollection = personalStorage.getRootFolder().getSubFolders();

    // Traverse through all folders in the PST file
    // This is not recursive
    for (FolderInfo folderInfo : folderInfoCollection) {
        // Get all messages in this folder
        MessageInfoCollection messageInfoCollection = folderInfo.getContents();

        // Loop through all the messages in this folder
        for (MessageInfo messageInfo : messageInfoCollection) {
            // Extract the message in MapiMessage instance
            MapiMessage message = personalStorage.extractMessage(messageInfo);

            System.out.println("Saving message " + message.getSubject() + " ...");

            // Save the message to disk in MSG format
            // TODO: File name may contain invalid characters [\ / : * ? " < > |]
            message.save("\\extracted\\" + message.getSubject() + ".msg");
        }
    }
}

Java: Створення контакту Outlook

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

Ця порада щодо міграції показує, як створити контакт Microsoft Outlook за допомогою Автоматизація Microsoft Office і Aspose.Email. Приклад коду показує, як встановити різну інформацію контакту, таку як особисту, професійну та ділову. Створення контакту Outlook складається з наступних кроків:

Створення об’єкта Contact.
Заповнення або встановлення різних властивостей властивості.
Збереження об’єкта.

Автоматизація Office

Зразки коду

Наступний фрагмент коду створює контакт Outlook у форматі VCard і зберігає його на диск, використовуючи автоматизацію Office.


 Microsoft.Office.Interop.Outlook._Application OutlookObject = new Microsoft.Office.Interop.Outlook.Application();

//Create a new Contact Item

Microsoft.Office.Interop.Outlook.ContactItem contact = OutlookObject.CreateItem(

                        Microsoft.Office.Interop.Outlook.OlItemType.olContactItem);

//Set different properties of this Contact Item.

contact.FirstName = "Mellissa";

contact.LastName = "MacBeth";

contact.JobTitle = "Account Representative";

contact.CompanyName = "Contoso Ltd.";

contact.OfficeLocation = "36/2529";

contact.BusinessTelephoneNumber = "4255551212 x432";

contact.BusinessAddressStreet = "1 Microsoft Way";

contact.BusinessAddressCity = "Redmond";

contact.BusinessAddressState = "WA";

contact.BusinessAddressPostalCode = "98052";

contact.BusinessAddressCountry = "United States of America";

contact.Email1Address = "melissa@contoso.com";

contact.Email1AddressType = "SMTP";

contact.Email1DisplayName = "Melissa MacBeth (mellissa@contoso.com)";

//Save the Contact to disc

contact.SaveAs("OutlookContact.vcf", OlSaveAsType.olVCard);

Aspose.Email для Java

Нижче наведених прикладів використовують Aspose.Email для створення контакту Outlook у форматі VCard та збереження його на диск. Приклад показує, як створити контакт за допомогою MapiContact класу та встановлення деталей контакту в об’єкті перед збереженням контакту.

Зразки коду


//Create a new MapiContact Object
MapiContact mapiContact = new MapiContact();

//Set different properties of this Contact object
mapiContact.setNameInfo(new MapiContactNamePropertySet("Mellissa", "", "MacBeth"));
mapiContact.getProfessionalInfo().setTitle("Account Representative");
mapiContact.getProfessionalInfo().setCompanyName("Contoso Ltd.");
mapiContact.getProfessionalInfo().setOfficeLocation("36/2529");
mapiContact.getTelephones().setBusinessTelephoneNumber("4255551212 x432");
mapiContact.getPhysicalAddresses().getWorkAddress().setStreet("1 Microsoft Way");
mapiContact.getPhysicalAddresses().getWorkAddress().setCity("Redmond");
mapiContact.getPhysicalAddresses().getWorkAddress().setStateOrProvince("WA");
mapiContact.getPhysicalAddresses().getWorkAddress().setPostalCode("98052");
mapiContact.getPhysicalAddresses().getWorkAddress().setCountry("United States of America");
mapiContact.getElectronicAddresses().getEmail1().setEmailAddress("milissa@contoso.com");
mapiContact.getElectronicAddresses().getEmail1().setAddressType("SMTP");
mapiContact.getElectronicAddresses().getEmail1().setDisplayName("Melissa MacBeth (mellissa@contoso.com)");

//Save the Contact object to disc
mapiContact.save("Contact.vcf", ContactSaveFormat.VCard);