اتوماسیون ایمیل - تبدیل MSG به EML با استفاده از PowerShell و .NET

• Prerequisites
  • Download the API
  • Load the API’s DLL in PowerShell
  • Create the PowerShell Script File
• Automating MSG to EML Conversion
  • Define the Conversion Function
  • Convert Multiple Files
• Extracting and Saving Attachments from EML Files
  • Define the Attachment Extraction Function
  • Extract Attachments from Multiple EML Files
• Running the PowerShell Script

اگر به دنبال بهینه‌سازی گردش کار ایمیل خود یا توسعه راهکارهای سفارشی ایمیل هستید، این پست وبلاگ برای شماست. ما بررسی خواهیم کرد که چگونه از PowerShell و Aspose.Email for .NET به‌طور همزمان برای خودکار کردن وظایف مختلف پردازش ایمیل با استفاده از مثال تبدیل فرمت‌های ایمیل و استخراج پیوست‌ها استفاده کنیم. با ادغام این ابزارها در گردش کار خود، می‌توانید زمان را صرفه‌جویی کنید، تلاش دستی را کاهش دهید و دقت و کارآیی فرآیندهای مدیریت ایمیل خود را افزایش دهید.

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

چرا از PowerShell استفاده کنیم؟

PowerShell یک زبان اسکریپت‌نویسی است که به خوبی با فریم‌ورک .NET یکپارچه می‌شود. این زبان به طور گسترده‌ای برای اتوماسیون و وظایف مدیریتی در سیستم‌عامل ویندوز کاربرد دارد. در این مقاله وبلاگ، ما به بررسی مثال‌های عملی و موارد استفاده برای اتوماسیون وظایف پردازش ایمیل خواهیم پرداخت.

Aspose.Email چیست؟

این یک کتابخانه جامع مدیریت ایمیل است که از دامنه وسیعی از فرمت‌های ایمیل، شامل MSG و EML پشتیبانی می‌کند. با استفاده از Aspose.Email با PowerShell، می‌توانید فرآیند تبدیل را خودکار کنید، زمان را صرفه‌جویی کرده و از ثبات اطمینان حاصل کنید.

پیش‌نیازها

قبل از شروع، اطمینان حاصل کنید که PowerShell بر روی سیستم شما نصب شده و کتابخانه Aspose.Email for .NET در پروژه شما موجود است.

دانلود API

شما می‌توانید به راحتی آن را از صفحه دانلود Aspose یا از طریق NuGet دریافت کنید و سپس آن را در اسکریپت PowerShell خود ارجاع دهید.

بارگذاری DLL API در PowerShell

برای استفاده از Aspose.Email در PowerShell، شما باید DLL را بارگذاری کنید. فرض کنید که DLL را دانلود کرده‌اید، از دستور زیر برای بارگذاری آن استفاده کنید:

  Add-Type -Path "path_to_your_Aspose.Email.dll"

به‌جای path_to_your_Aspose.Email.dll، مسیر واقعی فایل را قرار دهید.

توجه: برای جلوگیری از مشکلات مربوط به مسیر، پیشنهاد می‌کنیم فایل DLL را در همان پوشه اسکریپت خود قرار دهید.

ایجاد فایل اسکریپت PowerShell

برای ایجاد یک فایل اسکریپت PowerShell، مراحل زیر را دنبال کنید:

• یک ویرایشگر متن مانند Notepad یا یک ویرایشگر کد مانند Visual Studio Code را باز کنید.
• اسکریپت PowerShell را در ویرایشگر کپی کنید.
• فایل را با پسوند .ps1 ذخیره کنید، به عنوان مثال، ConvertMsgToEml.ps1.

اتوماسیون تبدیل MSG به EML

بیایید یک مثال عملی از تبدیل فایل‌های MSG به فرمت EML را در نظر بگیریم. تصور کنید که مجموعه بزرگی از فایل‌های MSG داریم که باید به سرعت به فایل‌های EML تبدیل شوند. علاوه بر این، نیاز به استخراج تمام پیوست‌ها از این پیام‌ها و ذخیره آن‌ها به‌صورت جداگانه داریم. این کار می‌تواند با استفاده از PowerShell و Aspose.Email خودکار شود.

تعریف تابع تبدیل

ابتدا، هر ویرایشگر متنی را باز کرده و کد بلوک زیر را چسباند:

1. با تعریف تابع Convert-MsgToEml شروع کنید و دو پارامتر مشخص کنید:
   • inputFilePath یک پارامتر رشته‌ای برای مسیر فایل .msg ورودی است.
   • outputDirectory یک پارامتر رشته‌ای برای مسیر دایرکتوری است که فایل .eml در آن ذخیره خواهد شد.
2. بارگذاری فایل MSG:
   • از روش Load برای بارگذاری فایل EML به یک متغیر $msg استفاده کنید.
3. ذخیره شی MapiMessage:
   • Save شی MapiMessage را به‌عنوان یک فایل .eml در دایرکتوری خروجی مشخص شده ذخیره کنید.

function Convert-MsgToEml {
    param (
        [string]$inputFilePath,
        [string]$outputDirectory
    )
    
    try {
        # Load the MSG file
        $msg = [Aspose.Email.Mapi.MapiMessage]::Load($inputFilePath)

        # Define the output file path
        $outputFilePath = Join-Path -Path $outputDirectory -ChildPath ([System.IO.Path]::GetFileNameWithoutExtension($inputFilePath) + ".eml")

        # Save as EML
        $msg.Save($outputFilePath, [Aspose.Email.SaveOptions]::DefaultEml)

        Write-Host "Converted $inputFilePath to $outputFilePath"
    
    } catch {
        Write-Host "Error converting $inputFilePath"
    }
}

تبدیل چندین فایل

حال می‌توانیم از این تابع برای تبدیل چندین فایل MSG در یک دایرکتوری استفاده کنیم:

1. دایرکتوری‌های ورودی و خروجی را با تعریف دایرکتوری حاوی فایل‌های MSG inputDirectory و دایرکتوری که فایل‌های EML تبدیل‌شده در آن ذخیره خواهند شد emlDirectory مشخص کنید.
2. تمام فایل‌های MSG را از دایرکتوری ورودی بازیابی کنید.
3. در هر فایل MSG در دایرکتوری ورودی حلقه بزنید و آن را به فرمت EML تبدیل کنید و خروجی را در دایرکتوری مشخص شده ذخیره کنید.

# Load Aspose.Email DLL
Add-Type -Path ".\Aspose.Email.dll"

# Define the input and output directories
$inputDirectory = "path_to_your_input_directory"
$emlDirectory = "path_to_your_output_directory"

# Get all MSG files in the input directory
$msgFiles = Get-ChildItem -Path $inputDirectory -Filter "*.msg"

foreach ($msgFile in $msgFiles) {
    # Convert each MSG file to EML
    Convert-MsgToEml -inputFilePath $msgFile.FullName -outputDirectory $emlDirectory
}

به‌جای path_to_your_input_directory و path_to_your_output_directory، مسیرهای واقعی را قرار دهید.

استخراج و ذخیره پیوست‌ها از فایل‌های EML

علاوه بر تبدیل فایل‌های MSG به فایل‌های EML، همچنین نیاز داریم تا پیوست‌ها را از فایل‌های EML حاصل استخراج و ذخیره کنیم. در اینجا نحوه دستیابی به این هدف با استفاده از API .NET و PowerShell آمده است.

تعریف تابع استخراج پیوست

یک تابع PowerShell تعریف کنید که استخراج و ذخیره پیوست‌ها از یک فایل EML واحد را انجام دهد:

1. با تعریف تابع Extract-AttachmentsFromEml شروع کنید و دو پارامتر مشخص کنید:
   • emlFilePath - مسیر فایل EML که از آن باید پیوست‌ها استخراج شوند.
   • attachmentsDirectory - دایرکتوری که در آن پیوست‌های استخراج‌شده ذخیره خواهند شد.
2. بارگذاری فایل EML:
   • از روش Load برای بارگذاری فایل EML به یک متغیر $eml استفاده کنید.
3. استخراج پیوست‌ها:
   • از طریق هر پیوست در مجموعه Attachments با استفاده از یک حلقه foreach عبور کنید.
   • پیوست را با استفاده از روش Save ذخیره کنید.

function Extract-AttachmentsFromEml {
    param (
        [string]$emlFilePath,
        [string]$attachmentsDirectory
    )

    try {
        # Load the EML file
        $eml = [Aspose.Email.MailMessage]::Load($emlFilePath)

        # Extract attachments
        foreach ($attachment in $eml.Attachments) {
            $attachmentFilePath = Join-Path -Path $attachmentsDirectory -ChildPath $attachment.Name
            $attachment.Save($attachmentFilePath)
            Write-Host "Saved attachment $attachmentFilePath"
        }
    } catch {
        Write-Host "Error extracting attachments from $emlFilePath"
    }
}

بیایید این را به اسکریپت خود اضافه کنیم، بعد از اعلام تابع Convert-MsgToEml.

استخراج پیوست‌ها از چندین فایل EML

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

• مسیر دایرکتوری پیوست‌های خود را که می‌خواهید پیوست‌های استخراج‌شده را در آن ذخیره کنید، مشخص کنید.
• از Get-ChildItem برای بازیابی تمام فایل‌های EML از دایرکتوری مشخص شده استفاده کنید. این فرمان فقط فایل‌هایی با پسوند .eml را فیلتر خواهد کرد.
• از طریق هر فایل EML با استفاده از یک حلقه foreach عبور کنید.
• برای هر فایل، تابع Extract-AttachmentsFromEml را برای استخراج و ذخیره پیوست‌ها فراخوانی کنید.

$attachmentsDirectory = "path_to_your_attachments_directory"

# Get all EML files in the directory
$emlFiles = Get-ChildItem -Path $emlDirectory -Filter "*.eml"

foreach ($emlFile in $emlFiles) {
    # Extract attachments from each EML file
    Extract-AttachmentsFromEml -emlFilePath $emlFile.FullName -attachmentsDirectory $attachmentsDirectory
}

به‌جای path_to_your_attachments_directory، مسیرهای واقعی را قرار دهید.

اجرای اسکریپت PowerShell

برای اجرای اسکریپت PowerShell، مراحل زیر را دنبال کنید:

1. PowerShell را باز کنید.

2. با استفاده از دستور cd به دایرکتوری که اسکریپت شما در آن قرار دارد، بروید. به عنوان مثال:

   cd path_to_your_script_directory
   

   کپی

3. اسکریپت را با تایپ .\ به‌علاوه نام اسکریپت اجرا کنید. به عنوان مثال:

   .\ConvertMsgToEml.ps1
   

   کپی

   اگر با خطای سیاست اجرایی مواجه شدید، ممکن است نیاز باشد سیاست اجرایی PowerShell را تنظیم کنید. می‌توانید سیاست را برای اجازه اجرای اسکریپت با استفاده از دستور زیر تنظیم کنید:

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   

   کپی

   در صورت درخواست، تغییر را تأیید کنید. این تنظیم به شما اجازه می‌دهد تا اسکریپت‌هایی را که بر روی ماشین محلی خود نوشته شده‌اند یا اسکریپت‌هایی که توسط ناشر معتبر امضا شده‌اند، اجرا کنید.

نتیجه‌گیری

با استفاده از Aspose.Email با PowerShell، می‌توانید تبدیل فایل‌های MSG به فرمت EML و استخراج پیوست‌ها از فایل‌های EML را به‌طور کارآمد خودکار کنید. مراحل outlined در این مقاله یک رویکرد ساده برای راه‌اندازی محیط، ایجاد یک اسکریپت تبدیل، اجرای آن و استخراج پیوست‌ها ارائه می‌دهد. با این ابزارها، می‌توانید فرآیندهای مدیریت فایل ایمیل خود را ساده‌تر کنید و از سازگاری و دسترسی آسان اطمینان حاصل کنید. اتوماسیون تبدیل فایل‌ها و استخراج پیوست‌ها با PowerShell و Aspose.Email نه تنها زمان را صرفه‌جویی می‌کند بلکه همچنین در گردش کار شما ثبات و قابلیت اطمینان را تضمین می‌کند. خواه شما با چند ایمیل کار کنید یا یک آرشیو بزرگ را مدیریت کنید، این تکنیک‌ها به افزایش بهره‌وری شما و ساده‌سازی وظایف شما کمک خواهد کرد.

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

همچنین ببینید

• خواندن و ایجاد اقلام Outlook با استفاده از API .NET
• وارد کردن EML به PST در C# با استفاده از یک API شهودی .NET
• مدیریت مخاطبین MS: بارگذاری، تجزیه و ذخیره فایل‌های MSG در C# .NET
• تبدیل فایل‌های MSG یا EML با تصاویر جاسازی شده به HTML در C# .NET
• خواندن فایل‌های Outlook MSG در C#