Documentation – کار با موارد Outlook - API تجزیه‌کننده ایمیل C++

Cpp: ایجاد و ذخیره فایل‌های Outlook MSG با استفاده از API ایمیل C++

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

Aspose.Email for C++ به توسعه‌دهندگان امکان می‌دهد به‌صورت برنامه‌نویسی فایل‌های Outlook MSG را ایجاد، تغییر و ذخیره کنند با کنترل کامل بر ویژگی‌ها و قالب‌بندی پیام. می‌توانید پیام‌های MSG را از صفر تولید کنید، پیوست‌ها اضافه کنید، از بدنه‌های متن غنی (RTF) استفاده کنید، پیش‌نویس‌ها را ذخیره کنید و با استفاده از گزینه‌های فشرده‌سازی بدنه، اندازه پیام را بهینه کنید.

ایجاد و ذخیرهٔ پیام‌های اوتلوک

این MailMessage کلاس فراهم می‌کند Save() روشی برای ذخیره فایل‌های MSG به‌صورت دیسک یا جریان. می‌توانید فرستنده، گیرندگان، موضوع و بدنه را تعریف کنید و سپس پیام را به فرمت Outlook MSG تبدیل کنید با استفاده از MapiMessage کلاس.

نمونه کد زیر نشان می‌دهد چگونه یک پیام ایمیل ساده را با تنظیم فرستنده، گیرنده، موضوع و بدنه ایجاد کنید، سپس این پیام ایمیل را به یک پیام MAPI سازگار با Outlook تبدیل کرده و در نهایت آن را به‌صورت فایل MSG ذخیره نمایید.

ایجاد فایل‌های MSG با بدنهٔ RTF

پیام‌های Outlook از بدنه‌های Rich Text Format (RTF) پشتیبانی می‌کنند که قالب‌بندی پیشرفته متن مانند بولد، زیرخط و عناوین را نگه می‌دارند. Aspose.Email به‌صورت خودکار تبدیل می‌کند HtmlBody از یک MailMessage به RTF هنگام ذخیره به‌عنوان MSG تبدیل می‌شود و تمام قالب‌بندی‌ها حفظ می‌گردند.

نمونه کد زیر نشان می‌دهد چگونه یک پیام ایمیل با بدنه قالب‌بندی شده HTML، شامل سرصفحه‌ها و متن‌های استایل‌دار ایجاد کنید، سپس این ایمیل را به یک پیام MAPI Outlook تبدیل کرده و به‌عنوان فایل MSG ذخیره کنید. این امکان را می‌دهد تا فایل‌های ایمیل سازگار با Outlook تولید شوند که قالب‌بندی متن غنی را با استفاده از Aspose.Email حفظ می‌کنند.

ذخیره یک پیام در وضعیت پیش‌نویس

می‌توانید یک پیام را به‌عنوان پیش‌نویس نشان دهید با تنظیم پرچم مناسب پیش از ذخیره به‌عنوان MSG. پیش‌نویس‌ها بعداً می‌توانند بازگردانده و ویرایش شوند.

بهینه‌سازی با فشرده‌سازی بدنه

Aspose.Email فشرده‌سازی بدنه برای فایل‌های MSG را از طریق MapiConversionOptions کلاس. فعال‌سازی فشرده‌سازی فایل‌های MSG و PST کوچکتری تولید می‌کند اما ممکن است پردازش را کمی کندتر کند.

نمونه کد زیر نشان می‌دهد چگونه یک پیام ایمیل موجود را از فایل بارگذاری کنید، گزینه‌های تبدیل با فشرده‌سازی بدنه فعال را ایجاد کنید و پیام بارگذاری‌شده را تبدیل کنید MailMessage به یک MapiMessage فرمت با استفاده از این گزینه‌ها. این فرایند اندازه بدنه ایمیل را در حین تبدیل بهینه می‌کند برای مدیریت بهتر در فایل‌های پیام Outlook.

UseBodyCompression = true → حجم فایل کوچکتر، عملکرد کندتر.
UseBodyCompression = false → تبدیل سریع‌تر، خروجی بزرگ‌تر.

Cpp: بارگذاری، تجزیه فایل‌های Outlook MSG با استفاده از Aspose.Email برای C++

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

Aspose.Email برای C++ ابزارهای قدرتمندی برای خواندن و تجزیه فایل‌های پیام Microsoft Outlook (.msg) فراهم می‌کند. MapiMessage کلاس برای بارگذاری و تجزیه فایل‌های MSG استفاده می‌شود و دسترسی به جزئیات پیام مانند موضوع، ارسال‌کننده، بدنه، دریافت‌کنندگان و پیوست‌ها را فراهم می‌کند. می‌توانید پیام‌ها را مستقیماً از یک فایل یا از یک جریان حافظه بارگذاری کنید، بسته به نیازهای برنامه‌تان.

امتحان کنید!

تجزیه فایل‌های ایمیل با نسخهٔ رایگان Aspose.Email Parser App.

بارگذاری فایل‌های MSG از دیسک

مثال زیر نشان می‌دهد چگونه یک فایل .msg را از سیستم فایل محلی بارگذاری کرده و به ویژگی‌های پایه‌ای آن مانند موضوع، ارسال‌کننده، بدنه و پیوست‌ها دسترسی پیدا کنید.

بارگذاری فایل‌های MSG از جریان

همچنین می‌توانید فایل‌های Outlook MSG را از یک جریان داده بارگذاری کنید که به‌ویژه هنگام کار با داده‌های در حافظه یا فایل‌های ایمیل ذخیره‌شده در پایگاه داده مفید است.

Cpp: قالب‌های Outlook، پیام‌های امضاشده و دسته‌ها در C++

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

خواندن و نوشتن فایل‌های قالب Outlook (OFT)

قالب‌های Outlook فایل‌های ایمیل قابل استفاده مجدد (.oft) هستند که برای خودکارسازی ارسال پیام‌های مشابه یا دوره‌ای کمک می‌کنند. به‌جای نوشتن دوباره محتوا هر بار، می‌توانید یک قالب ذخیره‌شده را باز کنید، جزئیات را به‌روزرسانی کنید و فوراً ارسال کنید.

با استفاده از Aspose.Email for C++، می‌توانید قالب‌های OFT را از طریق MailMessage کلاس. پس از بارگذاری، می‌توانید فیلدهایی مانند فرستنده، گیرنده، موضوع و بدنه را به‌روزرسانی کنید و سپس یا:

پیام به‌روزشده را با استفاده از کلاس SmtpClient ارسال کنید، یا
آن را به‌صورت فایل MSG ذخیره کنید برای ویرایش یا اعتبارسنجی بیشتر در Microsoft Outlook.

نمونه کد زیر نشان می‌دهد چگونه یک قالب ایمیل Outlook (فایل OFT) را بارگذاری، جزئیات فرستنده و گیرنده آن را ویرایش، محتوای ایمیل را با جایگزینی متغیرهای جایگزین با مقادیر خاص شخصی‌سازی و سپس پیام به‌روزشده را به‌صورت فایل Outlook MSG با تنظیم پرچم ارسال‌نشده ذخیره کنید.

مدیریت پیام‌های امضاشده دیجیتالی (S/MIME)

حفظ امضا هنگام تبدیل EML به MSG

Aspose.Email به‌طور کامل از عملیات S/MIME پشتیبانی می‌کند و امکان ذخیره یا تبدیل پیام‌های امضاشده دیجیتالی را بدون شکستن یکپارچگی امضا فراهم می‌سازد. این API دو روش برای حفظ امضا هنگام تبدیل از EML به MSG ارائه می‌دهد.

۱. حفظ خودکار امضای S/MIME

فایل EML را با استفاده از MailMessage::Load(). این ساختار MIME را تجزیه می‌کند: سرآیندها، بخش‌های بدنه، پیوست‌ها، امضاها.
با فراخوانی ذخیره به‌صورت MSG Save() با SaveOptions::get_DefaultMsgUnicode(). این به‌صورت خودکار فرمت Unicode MSG را می‌سازد در حالی که ساختار سلسله‌مراتبی پیام و یکپارچگی محتوا را حفظ می‌کند.

اگر پیام اصلی شامل امضای دیجیتال S/MIME باشد، به‌عنوان پیوست ویژه‌ای در فایل MSG حاصل شناسایی و حفظ می‌شود.

بدنه بازنویسی نمی‌شود تا امضا معتبر بماند.

۲. تبدیل کنترل‌شده

این روش از یک فرآیند دو مرحله‌ای استفاده می‌کند که به‌طور صریح یک پیام مبتنی بر MIME را به نمایندگی پیام مبتنی بر MAPI تبدیل می‌کند.

فایل EML را با استفاده از MailMessage::Load(). این EML را به مدل شیء MIME با سرآیندها، بخش‌های بدنه و پیوست‌ها تجزیه می‌کند.
تبدیل به پیام MAPI با MapiMessage::FromMailMessage().
پیکربندی MapiConversionOptions:
- کدگذاری خروجی را تنظیم کنید (ANSI/Unicode).
- قالب پیام را انتخاب کنید.
- در صورت نیاز، پیوست‌های TNEF را حفظ کنید.
- شامل یا حفظ امضای دیجیتال.
- فرمت بدنه را تعریف کنید (متن ساده، RTF، HTML).
فعال‌سازی PreserveSignature = true برای حفظ یکپارچگی امضای S/MIME. این کار بخش MIME امضا (application/pkcs7-mime یا pkcs7-signature) را بدون رمزگشایی یا بازپکیج کردن وارد می‌کند.
پیام MAPI حاصل را به‌صورت فایل MSG ذخیره کنید در حالی که تمام خصوصیات و امضاها حفظ می‌شوند.

از این متد برای امکان‌سنجی سفارشی‌سازی قالب بدنه پیام، کدگذاری و مدیریت پیوست‌ها استفاده کنید. برای تبدیل در حالی که داده‌های TNEF حفظ می‌شوند، مدیریت متفاوت پیوست‌ها یا ادغام ایجاد MSG در جریان‌های کاری پیچیده Outlook/MAPI مفید است. این دسترسی به مجموعه خصوصیات MAPI برای دستکاری سطح عمیق را فراهم می‌کند.

تنظیم دسته‌های رنگی برای فایل‌های Outlook MSG

دسته‌های رنگی به سازماندهی ایمیل‌ها در Outlook کمک می‌کنند. Aspose.Email فراهم می‌کند FollowUpManager کلاس و برخی توابع برای مدیریت این دسته‌ها:

AddCategory می‌گیرد MapiMessage و رشته دسته رنگی، برای مثال "Purple Category" یا "Red Category" به‌عنوان آرگومان.
RemoveCategory می‌گیرد MapiMessage و رشته دسته رنگی که باید از پیام حذف شود.
ClearCategories() برای حذف تمام دسته‌های رنگی از پیام استفاده می‌شود.
GetCategories برای بازیابی تمام دسته‌های رنگی از یک پیام خاص استفاده می‌شود.

نمونه کد زیر نشان می‌دهد چگونه یک فایل ایمیل MSG Outlook را بارگذاری، دسته‌های رنگی را به پیام اضافه، دسته‌های موجود را بازیابی و نمایش، و سپس دسته‌های خاص را حذف یا تمام دسته‌ها را پاک کنید با استفاده از FollowUpManager.

دسترسی به اطلاعات پیگیری در فایل‌های MSG

Aspose.Email می‌تواند رسیدهای خواندن، رسیدهای تحویل و نتایج نظرسنجی را از پیام‌های Outlook استخراج کند.

نمونه کد زیر نشان می‌دهد چگونه یک فایل Outlook MSG را بخوانید و از طریق دریافت‌کنندگان آن پیمایش کنید تا اطلاعات ردیابی جزئیات را نمایش دهید. به‌طور خاص، نشان می‌دهد چگونه نام نمایشی هر دریافت‌کننده، زمان تحویل پیام به آن دریافت‌کننده و زمان خواندن پیام توسط دریافت‌کننده را از خصوصیات دریافت‌کننده پیام MAPI بدست آورید.

Cpp: مدیریت فایل‌های پیام Outlook با API تجزیه‌گر ایمیل C++

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

خواندن و نوشتن فایل قالب آوتلوک (.OFT)

قالب‌های Outlook بسیار مفید هستند وقتی می‌خواهید پیام ایمیل مشابهی را بارها و بارها ارسال کنید. به‌جای آماده‌سازی پیام از ابتدا در هر بار، ابتدا پیام را در Outlook تهیه کرده و به‌عنوان قالب Outlook (OFT) ذخیره می‌کنید. پس از آن، هر زمان که نیاز به ارسال پیام داشتید، می‌توانید آن را از قالب ایجاد کنید، که در نوشتن متن یکسان در بدنه یا خط موضوع، تنظیم قالب‌بندی و غیره زمان صرفه‌جویی می‌کند. می‌توان از کلاس MailMessage در Aspose.Email برای بارگذاری و خواندن فایل قالب Outlook (OFT) استفاده کرد. پس از بارگذاری قالب Outlook در یک نمونه از کلاس MailMessage، می‌توانید فرستنده، گیرنده، بدنه، موضوع و سایر ویژگی‌ها را به‌روزرسانی کنید. پس از به‌روزرسانی ویژگی‌ها:

ایمیل را با استفاده از کلاس SmtpClient ارسال کنید یا
ذخیره پیام به‌صورت MSG و انجام به‌روزرسانی‌ها/اعتبارسنجی‌های بیشتر با استفاده از Microsoft Outlook.

در نمونه‌های کد زیر، ما:

قالب را با استفاده از کلاس MailMessage بارگذاری کنید.
به‌روزرسانی برخی از ویژگی‌ها.
ذخیره پیام در قالب MSG.

قطعه کد زیر نشان می‌دهد چگونه فایل OFT را با استفاده از API کتابخانه تجزیه‌گر ایمیل C++ بارگذاری کنید، پیام را به‌روزرسانی کنید و آن را در فرمت MSG ذخیره نمایید.

مدیریت پیام‌های امضاشده دیجیتالی

Aspose.Email الگوریتم کامل شیء ایمیل S/MIME را پیاده‌سازی می‌کند. این به API قدرت کامل برای حفظ امضاهای دیجیتال هنگام تبدیل پیام‌ها بین فرمت‌ها می‌دهد.

حفظ امضا هنگام تبدیل از EML به MSG

هنگام تبدیل از EML به MSG، پرچم preserveSignature را روی true تنظیم کنید تا امضا حفظ شود. قطعه کد زیر نشان می‌دهد چگونه از EML به MSG تبدیل کنید.

تبدیل پیام‌های S/MIME از MSG به EML

Aspose.Email امضای دیجیتال را هنگام تبدیل از MSG به EML حفظ می‌کند همان‌طور که در قطعه کد زیر نشان داده شده است.

تنظیم دسته رنگی برای فایل‌های MSG آوتلوک

دسته‌بندی رنگی یک پیام ایمیل را برای نشان دادن اهمیت یا دسته‌ای خاص علامت‌گذاری می‌کند. Microsoft Outlook به کاربران امکان می‌دهد تا دسته‌بندی‌های رنگی را برای تمایز ایمیل‌ها اختصاص دهند. برای مدیریت دسته‌بندی رنگی، از FollowUpManager استفاده کنید. این کلاس شامل توابعی مانند AddCategory، RemoveCategory، ClearCategories و GetCategories است.

متد AddCategory یک شیء MapiMessage و رشته دسته‌بندی رنگی، برای مثال "Purple Category" یا "Red Category" را به عنوان آرگومان دریافت می‌کند.
متد RemoveCategory یک شیء MapiMessage و رشته دسته‌بندی رنگی که باید از پیام حذف شود را می‌گیرد.
متد ClearCategories() برای حذف تمام دسته‌بندی‌های رنگی از پیام استفاده می‌شود.
متد GetCategories برای بازیابی همه دسته‌بندی‌های رنگی از یک پیام خاص استفاده می‌شود.

مثال زیر کارهای زیر را انجام می‌دهد:

اضافه کردن یک دسته رنگی.
اضافه کردن یک دسته رنگی دیگر.
دریافت لیست تمام دسته‌ها.
حذف تمام دسته‌ها.

دسترسی به اطلاعات پیگیری از فایل MSG

API Aspose.Email امکان دسترسی به اطلاعات پیگیری از یک پیام ارسال‌شده یا دریافت‌شده را فراهم می‌کند. می‌تواند اطلاعات خوانده شدن، رسید تحویل خواندن و نتایج نظرسنجی را از یک فایل پیام بازیابی کند.

بازیابی اطلاعات دریافت و تحویل رسید

قطعه کد زیر نشان می‌دهد چگونه اطلاعات دریافت و تحویل رسیدها را بازیابی کنید.

Cpp: کار با لیست‌های توزیع Outlook در C++

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

یک distribution list گروه پیش‌تعریف‌شده‌ای از گیرندگان ایمیل است که تحت یک نام لیست واحد سازماندهی می‌شوند و به کاربران اجازه می‌دهند پیام‌ها را به‌طور همزمان به چندین تماس ارسال کنند بدون اینکه هر آدرس ایمیل را به‌صورت جداگانه وارد کنند. این لیست‌ها که معمولاً در ارتباطات تجاری و سازمانی استفاده می‌شوند، ایمیل‌های انبوه را ساده‌سازی، کارایی را ارتقا و تحویل ثابت پیام‌ها به گروه خاصی را تضمین می‌کنند. می‌توان آنها را در کلاینت‌های ایمیل مانند Microsoft Outlook یا سرورهای ایمیل مدیریت کرد و ویژگی‌هایی نظیر افزودن یا حذف اعضا و کنترل دسترسی‌های لیست را پشتیبانی می‌نمایند. لیست‌های توزیع برای ارتباط هدفمند، اعلان‌ها، خبرنامه‌ها و همکاری درون تیم‌ها ضروری هستند.

Aspose.Email به شما امکان ایجاد و مدیریت لیست‌های توزیع Outlook را به‌صورت برنامه‌نویسی می‌دهد.

ایجاد و ذخیره یک لیست توزیع

قطعه کد زیر نشان می‌دهد چگونه یک لیست توزیع را با API کتابخانه ایمیل C++ ایجاد و ذخیره کنید.

خواندن یک لیست توزیع از PST

کد نمونه زیر نشان می‌دهد چگونه یک لیست توزیعی را از یک فایل PST بخوانید.

Cpp: مدیریت پرچم‌های پیگیری و یادآورها در پیام‌های Outlook با C++

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

پرچم‌های پیگیری در Outlook به کاربران کمک می‌کند تا کارهای مهم را ردیابی کنند و اقدام به موقع روی ایمیل‌های خاص انجام دهند. آنها می‌توانند شامل یادآورها، تاریخ سررسید و وضعیت تکمیل باشند.

اتوماتیک‌سازی این ویژگی‌ها به‌صورت برنامه‌نویسی می‌تواند به بهینه‌سازی جریان کار کمک کند، برای مثال ارسال یادآورهای منظم به تیم‌ها یا ردیابی پاسخ‌های معلق.

با Aspose.Email برای C++، توسعه‌دهندگان می‌توانند پرچم‌های پیگیری و یادآورها را در پیام‌های Outlook (اشیاء MapiMessage) با استفاده از کلاس‌های FollowUpManager و FollowUpOptions ایجاد، اصلاح و مدیریت کنند.

تنظیم پرچم پیگیری

از FollowUpManager::SetOptions() متدی برای افزودن پرچم پیگیری با تاریخ شروع، تاریخ سررسید و زمان یادآوری همان‌طور که در نمونه کد زیر نشان داده شده است.

تنظیم پرچم پیگیری برای گیرندگان

همچنین می‌توانید یک یادآور پیگیری به طور خاص برای گیرندگان یک پیام ایمیل تنظیم کنید.

علامت‌گذاری پیگیری به‌عنوان تکمیل‌شده

پرچم پیگیری را به‌عنوان تکمیل‌شده علامت‌گذاری کنید وقتی کار یا پاسخ مربوطه انجام شد.

حذف پرچم پیگیری

یک پرچم پیگیری موجود را از یک پیام ایمیل پاک کنید همان‌طور که در نمونه کد زیر نشان داده شده است.

خواندن گزینه‌های پیگیری

اطلاعات پیگیری مانند متن پرچم، تاریخ سررسید و جزئیات یادآور را بازیابی کنید.

Cpp: دسترسی و مدیریت خصوصیات MAPI Outlook در C++

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

MAPI properties موارد متادیتایی هستند که در پیام‌های Microsoft Outlook استفاده می‌شوند و ویژگی‌هایی مانند فرستنده، گیرنده، موضوع، پیوست‌ها و داده‌های سفارشی را تعریف می‌کنند.

Aspose.Email for C++ به توسعه‌دهندگان امکان دسترسی، تغییر و حذف این ویژگی‌ها را به‌صورت برنامه‌نویسی در MapiMessage اشیاء، پیوست‌ها و ویژگی‌های نام‌گذاری شده.

این MapiProperty کلاس نمایانگر یک ویژگی MAPI است که شامل:

Name – شناسه رشته‌ای ویژگی.
Tag – شناسه عددی استفاده‌شده برای ارجاع به ویژگی.
Data – آرایه بایتی که مقدار ویژگی را نشان می‌دهد.

خواندن خصوصیات MAPI

Aspose.Email به شما امکان می‌دهد خصوصیات MAPI را با استفاده از برچسب‌های خصوصیت بخوانید.

نمونه کد زیر نشان می‌دهد چگونه خصوصیت موضوع را از یک فایل پیام MAPI (.msg) بخوانید و نمایش دهید.

مسیر دایرکتوری که فایل‌های پیام Outlook در آن ذخیره شده‌اند دریافت کنید.
فایل پیام Outlook ("message.msg") را به یک MapiMessage شیء.
به مجموعه خصوصیات MAPI پیام دسترسی پیدا کنید.
سعی کنید خصوصیت موضوع را با استفاده از PR_SUBJECT (ANSI) برچسب.
اگر خصوصیت موضوع ANSI یافت نشد، سعی کنید خصوصیت موضوع Unicode را با استفاده از PR_SUBJECT_W.
اگر خصوصیت موضوع وجود داشته باشد، مقدار رشته‌ای آن را در کنسول نمایش دهید.

تنظیم ویژگی‌های MAPI

ویژگی‌های MAPI می‌توانند برای پیام‌ها یا گیرندگان تنظیم شوند تا ویژگی‌های سفارشی، نوع ایمیل یا وضعیت همگام‌سازی را تعریف کنند.

نمونه کد زیر نشان می‌دهد چگونه یک پیام MAPI ایجاد کنید، چندین ویژگی سفارشی MAPI از جمله جزئیات فرستنده و گیرنده، پرچم‌های پیام و زمان اصلاح را تنظیم کنید و سپس پیام را در یک فایل ذخیره نمایید.

توجه: تابع کمکی ConvertDateTime() مقدار System::DateTime را به یک آرایه بایتی filetime سازگار با MAPI برای ویژگی‌های تاریخ/زمان به شکل زیر تبدیل می‌کند:

int64_t filetime = t.ToFileTime();

System::ArrayPtr<uint8_t> d = System::MakeArray<uint8_t>(8, 0);

d[0] = (uint8_t)(filetime & 0xFF);

d[1] = (uint8_t)((filetime & 0xFF00) >> 8);

d[2] = (uint8_t)((filetime & 0xFF0000) >> 16);

d[3] = (uint8_t)((filetime & 0xFF000000) >> 24);

d[4] = (uint8_t)((filetime & 0xFF00000000) >> 32);

d[5] = (uint8_t)((filetime & 0xFF0000000000) >> 40);

d[6] = (uint8_t)((filetime & 0xFF000000000000) >> 48);

d[7] = (uint8_t)(((uint64_t)filetime & 0xFF00000000000000) >> 56);

خواندن ویژگی‌های MAPI نام‌گذاری شده

ویژگی‌های نام‌گذاری شده MAPI ویژگی‌های سفارشی هستند که توسط کاربران یا برنامه‌ها اضافه می‌شوند.

Aspose.Email امکان خواندن این ویژگی‌ها را از پیام‌ها و پیوست‌ها فراهم می‌کند.

خواندن ویژگی‌های نام‌گذاری شده MAPI از فایل‌های MSG

نمونه کد زیر نشان می‌دهد چگونه یک فایل پیام MAPI را بارگذاری کنید، تمام ویژگی‌های نام‌گذاری شده MAPI آن را بازیابی کنید و بر روی آنها حلقه بزنید تا مقادیر ویژگی‌های نام‌گذاری شده خاص ("TEST" و "MYPROP") را پیدا و نمایش دهید. این نمونه نشان می‌دهد چگونه به ویژگی‌های سفارشی یا گسترش‌یافته در یک پیام MAPI دسترسی پیدا کنید با شمارش مجموعه ویژگی‌ها و پردازش شرطی ویژگی‌ها بر اساس شناسه‌های نامی آنها.

دست‌رسی به ویژگی‌های نام‌گذاری شده MAPI در پیوست‌ها

ویژگی‌های نام‌گذاری شده MAPI در پیوست‌ها به‌طور مشابه قابل بازیابی هستند:

حذف ویژگی‌های MAPI

می‌توانید هر دو ویژگی استاندارد و نام‌گذاری شده MAPI را از پیام‌ها یا پیوست‌ها همان‌طور که در نمونه کد زیر نشان داده شده، حذف کنید:

Cpp: مدیریت پیوست‌ها در فایل‌های Outlook MSG با استفاده از Aspose.Email برای C++

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

Aspose.Email for C++ یک API غنی برای دسترسی، ذخیره، حذف و درج پیوست‌ها هنگام کار با فایل‌های Microsoft Outlook MSG فراهم می‌کند. پیوست‌ها از طریق MapiMessage کلاس، با استفاده از Attachments ویژگی که یک MapiAttachmentCollection.

ذخیره پیوست‌ها از یک فایل MSG

برای استخراج و ذخیره پیوست‌ها از یک فایل MSG:

پیام را بارگذاری کنید با استفاده از MapiMessage::Load.
درون MapiAttachmentCollection.
هر پیوست را با استفاده از MapiAttachment::Save() متد.

// Create an instance of MapiMessage from file
System::SharedPtr<MapiMessage> message = MapiMessage::Load(fileName);
    
// Iterate through the attachments collection
    
{
    auto attachment_enumerator = (message->get_Attachments())->GetEnumerator();
    decltype(attachment_enumerator->get_Current()) attachment;
    while (attachment_enumerator->MoveNext() && (attachment = attachment_enumerator->get_Current(), true))
    {
        // Save the individual attachment
        attachment->Save(dataDir + attachment->get_FileName());
    }
}

حذف پیوست‌ها

Aspose.Email برای C++ دو روش برای حذف پیوست‌ها از فایل‌های MSG ارائه می‌دهد:

فراخوانی RemoveAttachments() متد

آدرس فایل پیام را به‌عنوان پارامتر می‌گیرد. به‌صورت یک متد عمومی استاتیک پیاده‌سازی شده است، بنابراین شما نیازی ندارید

قطعه کد زیر نشان می‌دهد چگونه از این متد استفاده کنید.

فراخوانی DestoryAttachment() متد

این روش سریع‌تر کار می‌کند زیرا پیوست‌ها را بدون تجزیه‌وتحلیل کامل فایل MSG حذف می‌کند.

افزودن پیوست‌های MSG

فایل‌های MSG می‌توانند حاوی سایر فایل‌های MSG به‌عنوان پیوست‌های استاندارد یا توکار باشند. از نسخه بیش‌بارگذاری‌شده استفاده کنید Add متدها در MapiAttachmentCollection برای جاسازی پیام‌های Outlook.

نمونه کد زیر نشان می‌دهد چگونه یک پیام MAPI جدید با فرستنده، گیرنده، موضوع و بدنه مشخص ایجاد کنید، سپس یک فایل MSG موجود را به‌عنوان پیام توکار پیوست کنید و در نهایت پیام حاصل را همراه با پیوست توکار به یک فایل MSG جدید ذخیره نمایید.

System::SharedPtr<MapiMessage> message = System::MakeObject<MapiMessage>(L"from@test.com", L"to@test.com", L"Subj", L"This is a message body");
System::SharedPtr<MapiMessage> attachMsg = MapiMessage::Load(L"Message.msg");
message->get_Attachments()->Add(L"Weekly report.msg", attachMsg);
message->Save(dataDir + L"WithEmbeddedMsg_out.msg");

Cpp: کار با موارد تقویم Outlook در Aspose.Email for C++

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

Aspose.Email for C++ فراهم می‌کند MapiCalendar کلاسی برای ایجاد، ویرایش و مدیریت موارد تقویم Microsoft Outlook. می‌توانید به‌صورت برنامه‌نویسی با یادآورها، پیوست‌ها، وضعیت دریافت‌کنندگان جلسه و مناطق زمانی کار کنید.

ایجاد و ذخیره موارد تقویم (ICS)

نمونه کد زیر نشان می‌دهد چگونه یک قرار ملاقات تقویم ایجاد و به عنوان فایل ICS با استفاده از Aspose.Email for C++ ذخیره کنید.

ابتدا، یک قرار ملاقات جدید با جزئیات خاص شامل مکان، موضوع، توضیح، زمان شروع و زمان پایان مقداردهی اولیه می‌شود. 2. سپس در قالب استاندارد iCalendar ذخیره می‌شود که می‌تواند به برنامه‌های تقویم مختلف وارد شود.

ذخیره تقویم به‌صورت MSG

نمونه کد زیر نشان می‌دهد چگونه یک قرار ملاقات تقویم را به‌صورت فایل MSG ذخیره کنید.

افزودن یادآور نمایش

نمونه کد زیر نشان می‌دهد چگونه یک قرار ملاقات تقویم با یادآور ایجاد و به‌صورت فایل ICS ذخیره کنید.

ابتدا، یک درخواست ملاقات ایجاد و به یک مورد تقویم MAPI تبدیل می‌شود که خصوصیات یادآور (از جمله اعلان ۴۵ دقیقه‌ای پیش‌از‑زمان) را تنظیم می‌کند.
سپس قرار ملاقات در قالب iCalendar ذخیره می‌شود.

افزودن یادآور صوتی

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

ابتدا، یک درخواست ملاقات ایجاد و به یک مورد تقویم MAPI تبدیل می‌شود که خصوصیات یادآور شامل اعلان پیش‌از‑زمان ۵۸ دقیقه‌ای با فایل صوتی سفارشی را تنظیم می‌کند.
سپس قرار ملاقات در قالب iCalendar با مشخصات هشدار صوتی ذخیره می‌شود.

افزودن و بازیابی پیوست‌ها

نمونه کد زیر نشان می‌دهد چگونه یک قرار ملاقات تقویم با چندین پیوست فایلی ایجاد، به‌صورت فایل ICS ذخیره و سپس برای تأیید پیوست‌ها آن را بارگذاری کنید.

یک قرار ملاقات ایجاد کنید.
چندین پیوست سند و تصویر را از سیستم فایل اضافه کنید.
قرار ملاقات را همراه با پیوست‌ها در قالب iCalendar ذخیره کنید.
سپس قرار ملاقات ذخیره‌شده را بارگذاری مجدد کنید و فایل‌های پیوست‌شده را مرور کنید تا تأیید شود که به‌درستی حفظ شده‌اند.

بررسی وضعیت دریافت‌کننده در درخواست‌های جلسه

نمونه کد زیر نشان می‌دهد چگونه وضعیت ردیابی همه دریافت‌کنندگان در یک فایل پیام Outlook را بخوانید و نمایش دهید.

یک پیام MAPI ابتدا از یک فایل بارگذاری می‌شود.
سپس، برای هر دریافت‌کننده پیمایش می‌کند تا وضعیت پاسخ فردی آن‌ها (مانند None، Tentative، Accepted یا Declined) برای درخواست‌های جلسه یا پاسخ‌های رأی‌گیری را دریافت و چاپ کند.

ایجاد MapiCalendarTimeZone از منطقه‌زمانی سیستم

نمونه کد زیر نشان می‌دهد چگونه یک MapiCalendarTimeZone شیء با استفاده از اطلاعات منطقه‌زمانی سیستم محلی.

تنظیم یادآورها با استفاده از برچسب‌های VALARM

نمونه کد زیر نشان می‌دهد چگونه یک قرار ملاقات تقویم با چندین نوع یادآور پیشرفته ایجاد کنید. این نمونه نحوه پیکربندی چهار نوع یادآور مختلف با شرایط و رفتارهای مختلف تحریک را نشان می‌دهد:

یک آلارم صوتی که در زمان مشخصی فعال می‌شود و ۴ بار با فاصله ۱۵ دقیقه‌ای همراه با فایل صوتی سفارشی تکرار می‌کند
یک آلارم نمایش که ۳۰ دقیقه پیش از شروع رویداد فعال می‌شود و ۲ بار با فاصله ۱۵ دقیقه‌ای همراه با پیام سفارشی تکرار می‌شود
یک یادآور ایمیل که ۲ روز قبل از رویداد فعال می‌شود و ایمیلی به شرکت‌کنندگان مشخص شده با موضوع، بدنه و پیوست ارسال می‌کند
یک آلارم فرآیندی که در تاریخ/زمان مشخصی فعال می‌شود و ۲۳ بار با فاصله ساعتی تکرار می‌شود و برنامه اجرایی را فراخوانی می‌کند

کد پیکربندی پیچیده یادآورها را نشان می‌دهد که شامل تحریکات مطلق و نسبی، الگوهای تکرار، اعمال مختلف یادآور و مدیریت پیوست‌ها است، سپس قرار ملاقات کامل همراه با تمام یادآورها را به‌صورت فایل ICS ذخیره می‌کند.

Cpp: ایجاد، ذخیره و بارگذاری مخاطبین Outlook در C++

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

Aspose.Email برای C++ به شما امکان می‌دهد مخاطبین Microsoft Outlook را به‌صورت برنامه‌نویسی ایجاد و مدیریت کنید. MapiContact کلاس تمام ویژگی‌های مرتبط با مخاطب از جمله نام‌ها، اطلاعات حرفه‌ای، آدرس‌ها، حساب‌های ایمیل، شماره تلفن‌ها، دسته‌ها، فیلدهای سفارشی و عکس‌ها را فراهم می‌کند.

این مقاله نشان می‌دهد چگونه مخاطبین Outlook را در فرمت‌های MSG و vCard (VCF) ایجاد، ذخیره و بخوانید.

ایجاد و ذخیره یک مخاطب Outlook

برای ایجاد یک مخاطب Outlook و ذخیره‌اش بر روی دیسک، مراحل زیر را دنبال کنید:

نمونه‌سازی MapiContact.
جزئیات نام، حرفه‌ای، شخصی و آدرس را پر کنید.
آدرس‌های الکترونیکی و شماره‌های تلفن را اضافه کنید.
دسته‌ها، مسافت، صورتحساب و فیلدهای سفارشی را اختصاص دهید.
به‌صورت اختیاری، یک عکس مخاطب را درج کنید.
مخاطب را در فرمت MSG یا vCard (VCF) ذخیره کنید.

کد نمونه زیر نشان می‌دهد چگونه یک مخاطب Outlook با اطلاعات شخصی، حرفه‌ای و سازمانی دقیق ایجاد کرده و در فرمت‌های مختلف ذخیره کنید:

خواندن یک مخاطب با استفاده از MapiContact

این MapiContact کلاس می‌تواند مخاطبین Outlook ذخیره‌شده در هر دو فرمت MSG و VCF را بارگذاری کند.

بارگذاری یک مخاطب از MSG

کد نمونه زیر نشان می‌دهد چگونه یک مخاطب را از یک فایل MSG Outlook بارگذاری کرده و به یک تبدیل کنید MapiContact شیء.

بارگذاری یک مخاطب از vCard (VCF)

کد نمونه زیر نشان می‌دهد چگونه اطلاعات مخاطب را از یک فایل vCard (VCF) با استفاده از دو روش مختلف در Aspose.Email برای C++ بارگذاری کنید. هر دو روش را نشان می‌دهد VCardContact متد کلاس برای بارگذاری مستقیم vCard و MapiContact متد کلاس برای تبدیل داده‌های vCard به قالب مخاطب MAPI Outlook، انعطاف‌پذیری برای کار با داده‌های مخاطب در زمینه‌های مختلف برنامه‌نویسی را فراهم می‌کند.

Cpp: ایجاد، ذخیره و خواندن نکات Outlook در C++

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

Aspose.Email for C++ به شما امکان می‌دهد تا نُت‌های Outlook را به‌صورت برنامه‌نویسی ایجاد و مدیریت کنید. این MapiNote کلاس تمام خصوصیات اساسی – مانند موضوع، متن بدنه، رنگ و اندازه – را برای ساخت و سفارشی‌سازی یک نُت فراهم می‌کند.

این مقاله نشان می‌دهد چگونه نُت‌بوک‌های Outlook را که در قالب MSG ذخیره شده‌اند، ایجاد، ذخیره و خواند.

ایجاد و ذخیره یک یادداشت Outlook

برای ایجاد و ذخیره یک یادداشت Outlook بر روی دیسک، مراحل زیر را دنبال کنید:

یک نمونه از MapiNote شیء.
ویژگی‌های یادداشت مانند موضوع، بدنه، رنگ، ارتفاع و عرض را تنظیم کنید.
یادداشت را در فرمت MSG بر روی دیسک ذخیره کنید.

کد نمونه زیر نشان می‌دهد چگونه یک یادداشت چسبناک رنگی با ابعاد سفارشی ایجاد کرده و به عنوان یک فایل پیام Outlook ذخیره کنید.

خواندن یک نُت Outlook

یک نُت که به صورت فایل MSG ذخیره شده است می‌تواند به عنوان یک MapiMessage و سپس به یک MapiNote شیء.

نمونه کد زیر نشان می‌دهد چگونه یک نُت چسبناک را از یک فایل MSG Outlook بارگذاری و به شیء MapiNote تبدیل کنید.

Cpp: ایجاد، ذخیره و خواندن وظایف Outlook با C++

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

Aspose.Email for C++ به توسعه‌دهندگان امکان ایجاد، تغییر و خواندن وظایف Microsoft Outlook را به‌صورت برنامه‌نویسی می‌دهد. MapiTask کلاس ویژگی‌هایی مانند زیر را ارائه می‌دهد PercentComplete, EstimatedEffort, ActualEffort, History, LastUpdate، و موارد دیگر، که به شما امکان تعریف کامل جزئیات وظیفه را می‌دهد.

این مقاله توضیح می‌دهد چگونه وظایف Outlook را ایجاد، ذخیره و خوانده، شامل پردازش وظایف VToDo، یادآورها، پیوست‌ها و الگوهای تکرار.

ایجاد و ذخیره یک وظیفه Outlook

برای ساخت یک وظیفه و ذخیره آن در فرمت MSG، مراحل زیر را دنبال کنید:

یک نمونه از MapiTask شیء.
ویژگی‌های موردنظر وظیفه را تنظیم کنید.
وظیفه را بر روی دیسک ذخیره کنید.

نمونه کد زیر نشان می‌دهد چگونه یک وظیفه Outlook دقیق با ویژگی‌های جامع ایجاد کنید و آن را به‌عنوان فایل MSG با استفاده از Aspose.Email برای C++ ذخیره نمایید. این نمونه نشان می‌دهد چگونه ویژگی‌های وظیفه را شامل عنوان، توضیح، تاریخ‌های شروع/پایان، پیگیری پیشرفت (۲۰٪ تکمیل)، تخمین تلاش، اطلاعات مالکیت، تاریخچه اختصاص، دسته‌بندی، تنظیمات حساسیت، علامت‌گذاری وضعیت و فیلدهای سازمانی اضافی مانند شرکت‌ها، دسته‌ها، مسافت و اطلاعات صورتحساب پیکربندی کنید.

خواندن یک MapiTask از دیسک

یک وظیفه ذخیره‌شده به‌صورت فایل MSG می‌تواند با استفاده از https://reference.aspose.com/email/cpp/class/aspose.email.mapi.mapi_message/ بارگذاری شود، سپس به MapiTask.

نمونه کد زیر نشان می‌دهد چگونه یک وظیفه را از فایل Outlook MSG بارگذاری کنید و به یک MapiTask شیء برای دسترسی به ویژگی‌ها و عملکردهای خاص وظیفه.

System::SharedPtr<MapiMessage> msg = MapiMessage::FromFile(dataDir + L"Task.msg");
System::SharedPtr<MapiTask> mapiTask = System::DynamicCast<Aspose::Email::Outlook::MapiTask>(msg->ToMapiMessageItem());

بارگذاری یک وظیفه VToDo (iCalendar)

Aspose.Email به شما امکان می‌دهد وظایفی که به عنوان فایل‌های VToDo (.ics) صادر شده‌اند را بارگذاری کنید (مانند

نمونه کد زیر نشان می‌دهد چگونه یک وظیفه vCalendar VTODO را از فایل ICS به فرمت وظیفه Outlook MSG تبدیل کنید.

افزودن اطلاعات یادآوری به یک وظیفه

مشابه Microsoft Outlook، Aspose.Email می‌تواند اطلاعات یادآوری را به یک MapiTask اضافه کند.

نمونه کد زیر نشان می‌دهد چگونه یک وظیفه Outlook با قابلیت یادآوری و اطلاع‌رسانی صوتی سفارشی ایجاد کنید.

افزودن پیوست‌ها به یک وظیفه

نمونه کد زیر نشان می‌دهد چگونه یک وظیفه Outlook با پیوست فایل متنی ایجاد کنید و آن را به‌عنوان فایل MSG ذخیره نمایید

افزودن تکرار به یک وظیفه

MapiTask از الگوهای تکرار روزانه، هفتگی، ماهانه و سالانه پشتیبانی می‌کند.

نمونه کد زیر نشان می‌دهد چگونه با استفاده از Aspose.Email برای C++ وظایف تکراری Outlook با الگوهای تکرار مختلف ایجاد کنید. این نمونه نشان می‌دهد چگونه چهار نوع الگوی تکرار برای یک وظیفه پیکربندی شود: تکرار روزانه که هر روز تکرار می‌شود، تکرار هفتگی که هر چهارشنبه تکرار می‌شود، تکرار ماهانه که در روز ۳۰ هر ماه تکرار می‌شود، و تکرار سالانه که هر ۱۲ ماه برای ۱۰ بار تکرار می‌شود. کد تنظیمات مختلف ویژگی‌های تکرار شامل نوع الگو، دوره، شرایط پایان، مشخصات روز و تعداد وقوع‌ها را نشان می‌دهد و سپس وظایف را در قالب MSG ذخیره می‌کند.

Cpp: ایجاد و مدیریت گزینه‌های رأی‌گیری Outlook در C++

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

Microsoft Outlook به کاربران اجازه می‌دهد هنگام نوشتن ایمیل‌ها دکمه‌های رأی‌گیری (مانند بله، نه، شاید) را اضافه کنند تا پاسخ‌های سریع جمع‌آوری شود. Aspose.Email برای C++ پشتیبانی کامل برای ایجاد، اصلاح و خواندن این گزینه‌های رأی‌گیری را به‌صورت برنامه‌نویسی از طریق FollowUpOptions و FollowUpManager کلاس‌ها را می‌سازد.

در این مقاله، شما خواهید آموخت:

ایجاد یک پیام با گزینه‌های رأی‌گیری
خواندن گزینه‌های رأی‌گیری از یک MapiMessage
افزودن یا حذف دکمه‌های رأی‌گیری
بازیابی نتایج رأی‌گیری
کار با پیام‌های موجود یا جدید

خواندن گزینه‌های رأی‌گیری از پیام MAPI

استفاده کنید FollowUpManager::GetOptions برای خواندن تمام تنظیمات پیگیری، شامل دکمه‌های رأی‌گیری.

کد نمونه زیر نشان می‌دهد چگونه گزینه‌های پیگیری و دکمه‌های رأی‌گیری را از یک فایل پیام Outlook با استفاده از Aspose.Email برای C++ استخراج کنید.

خواندن فقط دکمه‌های رأی‌گیری

قطعه کد زیر نشان می‌دهد چگونه فقط دکمه‌های رأی‌گیری را بخوانید.

اضافه‌کردن دکمه رأی‌گیری به یک پیام موجود

کد نمونه زیر نشان می‌دهد چگونه یک گزینه رأی‌گیری سفارشی ("در واقع!") را به یک پیام Outlook موجود اضافه کنید. پیام اصلاح‌شده سپس در یک فایل MSG جدید ذخیره می‌شود.

حذف دکمه‌های رأی‌گیری از یک پیام

حذف یک گزینه یا پاک‌کردن تمام دکمه‌های رأی‌گیری.

خواندن اطلاعات نتایج رأی‌گیری

Aspose.Email به شما امکان می‌دهد پاسخ‌های گیرندگان ثبت‌شده توسط Outlook را استخراج کنید.