Add extensive Aspose.Email examples for Zimbra and Outlook items

[agent-aspose-email-examples]

Automated submission from agentic runner.

Change summaries (LLM):
Added Zimbra TGZ processing example using Aspose.Email.Storage.Zimbra.TgzReader
Demonstrates counting items via GetTotalItemsCount() without extraction
Iterates over multiple archive paths with File.Exists guard for missing files
Wraps reader in using block for proper disposal
Includes try/catch to surface runtime errors safely
// TODO: validate archive paths and handle large archives securely

Added Zimbra subscription setup using Aspose.Email EWS client (IEWSClient, EWSClient.GetEWSClient)
Calls UpdateSubscription and sets NotificationsCheckInterval / NotificationTimeout
Intent: enable product update notifications via subscription service
Safety guard skips execution when placeholder credentials contain “example.com”
Wrapped in nested try/catch for robust error handling
No real secrets exposed; placeholders remain for CI safety

Added conversion utility using Aspose.Email to transform .ics to .msg.
Utilizes Appointment.Load and Appointment.ToMapiMessage for calendar data.
Creates a minimal placeholder iCalendar file when the source .ics is absent.
Saves the resulting MapiMessage via msg.Save to the specified .msg path.
Wraps processing in try/catch and logs errors to standard error.

Added MSG‑to‑HTML conversion using Aspose.Email MailMessage and HtmlSaveOptions.
Implements input existence check; creates placeholder MSG via MailMessage.Save if missing.
Ensures output directory creation with safe error handling.
Sets HtmlSaveOptions.ResourceRenderingMode to EmbedIntoHtml to preserve attachments inline.
Wraps all operations in try/catch blocks and logs errors to Console.Error.

Added Aspose.Email EWS example showing Exchange mailbox discovery and folder inspection.
Uses IEWSClient, EWSClient.GetEWSClient, ExchangeMailboxInfo, ExchangeFolderInfo APIs.
Demonstrates retrieving inbox, sent items, drafts URIs and server version.
Iterates through contacts returned by client.GetMailboxes().
Includes placeholder credential guard to avoid live server calls.
Intended for Email/Exchange integration demos with safety check.

Convert MSG to EML using Aspose.Email MailMessage API.
Create placeholder MSG when source missing via MsgSaveOptions.
Validate input file existence before processing.
Load MSG with MailMessage.Load and save as EML with message.Save.
Wrap operations in try/catch for robust error reporting.
Category: File conversion utility; safety: placeholder generation and error handling.

Added Zimbra TGZ extraction demo using Aspose.Email.Storage.Zimbra
Uses TgzReader to open archive and GetTotalItemsCount for message enumeration
Iterates with ReadNextMessage, accesses MailMessage via CurrentMessage property
Sanitizes subject for safe file names before saving each message as .eml
Creates output folder if missing; includes basic console logging and error handling
Category: Email archive processing – placeholder paths for input TGZ and output directory.

PST handling with Aspose.Email.Storage.Pst.PersonalStorage – create if missing, enumerate folders, extract messages to .msg files.
Calendar loading via Aspose.Email.Calendar.Appointment.Load – reads .ics, creates minimal placeholder when absent.
TGZ processing using Aspose.Email.Storage.Zimbra.TgzReader – count items and export full contents to output folder.
Ensures output directory exists and checks file existence before each operation.
Sanitizes message subjects for filenames, defaults to “Untitled” when subject is empty.
Wraps all logic in a try/catch, writes errors to stderr; no secrets included.