Documentation – مهاجرت از Office Automation به Aspose

Java: خواندن یک فایل پیام Outlook (MSG)

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

نکات مهاجرت ما نشان می‌دهند چگونه می‌توان از محصولات Aspose برای بهبود برنامه‌های خود استفاده کرد و شما را از وابستگی به خودکارسازی سنتی آزاد کرد.

این نکته مهاجرت نشان می‌دهد چگونه یک فایل پیام Microsoft Outlook را بخوانید و محتویات آن را بر روی صفحه نمایش دهید با استفاده از هر دو اتوماسیون Microsoft Office و Aspose.Email کد. کد نمونه زیر فقط محتویات را در کنسول نشان می‌دهد تا به شما ایده‌ای از نحوه کار آن بدهد. از کدهای نمونه در برنامه‌های ویندوز، وب یا سایر برنامه‌های خود استفاده کنید.

اتوماسیون Office

برای استفاده از اشیاء Office Automation برای 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 برای جاوا.

برای دسترسی به 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 (MSG) ایجاد شود با استفاده از اتوماسیون Microsoft Office و Aspose.Email. نمونه‌های کد ویژگی‌های پایه فایل MSG را - To، Cc، Subject و بدنه HTML - قبل از ذخیره‌سازی فایل بر روی دیسک تنظیم می‌کنند.

اتوماسیون Office

برای استفاده از اشیاء Office Automation برای Microsoft Outlook، Microsoft Outlook باید بر روی دستگاهی که کد اجرا می‌شود نصب باشد. همچنین نیاز به ارجاع به Outlook.interop.dll دارید.

نمونه‌های برنامه‌نویسی

کدهای نمونه زیر یک فایل MSG را با استفاده از Office Automation ایجاد می‌کنند.


 // 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 استفاده می‌کنند. این کتابخانه به‌صورت خالص جاوا نوشته شده و از 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 برای جاوا استفاده می‌کند تا یک فایل MSG ایجاد کند، مشابه آنکه در بالا ایجاد شد, با چندین پیوست و بدنه HTML. از آنجا که Aspose.Email برای جاوا به‌طور کامل به جاوا نوشته شده است، نیاز به COM interop نیست. همچنین، نیازی به نصب Microsoft Outlook 2003/2007 بر روی دستگاه نیست. روش شرح داده شده در زیر زمانی مناسب است که Microsoft Outlook نصب نشده باشد یا وقتی می‌خواهید فایل‌های MSG را بر روی سرور تولید کنید.

کدهای نمونه زیر نشان می‌دهند چگونه همان کار را در جاوا با استفاده از Aspose.Email برای جاوا انجام دهید:


// 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 برای جاوا

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

این نکته مهاجرت یک درخواست جلسه را به گیرنده ارسال می‌کند. این نمایش می‌دهد چگونه درخواست جلسه را به دو روش ارسال کنیم:

ما همچنین مزایای رویکرد دوم را بررسی خواهیم کرد.

ارسال درخواست جلسه با Outlook Interop

برای استفاده از کلاس‌های Outlook، باید Outlook.Interop را در پروژه .NET خود ارجاع دهید. کد نمونه زیر:

درخواست جلسه را ایجاد می‌کند.
ویژگی‌هایی مانند موضوع، بدنه، مکان و زمان را تنظیم می‌کند.
درخواست جلسه را به گیرنده ارسال می‌کند.

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 برای جاوا

کد زیر از Aspose.Email برای جاوا برای ارسال درخواست جلسه استفاده می‌کند. ابتدا، درخواست جلسه را با استفاده از Aspose.Email Appointment کلاس. سپس ایمیل را ارسال کنید، درخواست جلسه را پیوست کنید و ایمیل را با استفاده از Aspose.Email SmtpClient کلاس.

مزایای استفاده از Aspose.Email برای جاوا

Outlook Interop برای استفاده نیاز به نصب Microsoft Outlook بر روی سیستمی که استفاده می‌شود دارد. Aspose.Email برای جاوا نیازی به نصب 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

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

این نکتهٔ مهاجرت به یک صندوق‌پست سرور Microsoft Exchange متصل می‌شود و لیست پیام‌ها را از پوشه Inbox دریافت می‌کند. نمونه‌های کد زیر نشان می‌دهند چگونه از Microsoft Office Interop برای دریافت لیست پیام‌ها قبل از انجام کار مشابه با استفاده از کلاس‌ها در Aspose.Email Exchange، با استفاده از Java.

استفاده از Microsoft Office Interop

برای استفاده از اشیاء Office Automation برای 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 استفاده کنید, در جاوا، برای انجام همان کار.

استفاده از Microsoft Office Interop

برای استفاده از اشیاء Office Automation برای Microsoft Outlook، مراجع به کتابخانه‌های Microsoft Office Interop برای Outlook را به پروژه اضافه کنید. Microsoft Office Outlook نیز باید بر روی دستگاهی که کد در آن اجرا می‌شود نصب باشد. فضای نام (namespace) استفاده‌شده در نمونه کد زیر 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 برای جاوا، دیگر نیازی به 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

این نکته مهاجرت نشان می‌دهد چگونه یک مخاطب Microsot Outlook با استفاده از اتوماسیون Microsoft Office و Aspose.Email. نمونه کد نشان می‌دهد چگونه اطلاعات مختلف یک مخاطب مانند اطلاعات شخصی، حرفه‌ای و تجاری را تنظیم کنید. ایجاد یک مخاطب Outlook شامل مراحل زیر است:

ایجاد یک شیء Contact.
پرکردن یا تنظیم ویژگی‌های مختلف خاصیت.
ذخیره‌سازی شیء.

اتوماسیون Office

نمونه‌های برنامه‌نویسی

کد نمونه زیر یک مخاطب Outlook را در قالب VCard ایجاد کرده و با استفاده از Office Automation بر روی دیسک ذخیره می‌کند.


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