اگر به ایمیلهای ارسالی از طرف GitHub دقت کرده باشید، کلاینتهای دریافت ایمیلها، تمام ایمیلهای مرتبط با یک Issue موجود را، در ذیل هم نمایش میدهند و بجای اینکه چند 10 ایمیل ارسالی را به نحوی جداگانه نمایش دهند، برای خلوتتر کردن نحوهی نمایش ایمیلهای رسیده و کاهش نویز، آنها را تنها در طی یک ایمیل ارائه میکنند:
برای نمونه در اینجا کل موضوع مرتبط با ELMAH، تنها در طی یک ایمیل نمایش داده میشود و هرچند 13 ایمیل، مرتبط با آن هستند، اما 13 ایمیل به صورت جداگانه نمایش داده شده را دریافت نمیکنیم. علت این موضوع به Header خاص این نوع ایمیلها بر میگردد:
در اینجا هدرهای استاندارد (RFC 5322) و ویژهی Message-ID، In-Reply-To و References هستند که سبب فعال شدن گروه بندی ایمیلهای ارسالی یا message threading در کلاینتهای دریافت و نمایش ایمیلها میشوند و فرمت کلی آنها به صورت<ID@HOST> است.
Message-ID بیانگر شمارهی منحصربفرد ایمیل ارسالی است.
فیلدهای اختیاری In-Reply-To و References تنها زمانی ذکر میشوند که قصد ارسال پاسخی، به یک Message-ID خاص، وجود داشته باشد. بنابراین مقدار درج شدهی در آنها دقیقا باید معادل Message-ID ایی باشد که پیشتر ارسال شدهاست.
اگر تنها فیلد References ذکر شود، از آن جهت تشخیص گروه یا Thread ایمیلهای رسیده استفاده میشود.
اگر نیاز به ذکر بیش از یک Message-ID وجود داشته باشد، نحوهی درج آن به صورت ذیل است:
نحوهی پیاده سازی این قابلیت توسط SmtpClient دات نت
در کدهای ذیل نحوهی افزودن هدرهای یاد شده را توسط SmtpClient دات نت مشاهده میکنید:
ابتدا یک ایمیل معمولی ارسال شدهاست؛ با این تفاوت که هدر جدید Message-ID را به آن افزودهایم.
از این ID در ایمیلهای بعدی جهت ارجاع به آن و نمایش Thread مانند آنها، به کمک فیلدهای In-Reply-To و References، استفاده خواهیم کرد.
برای مثال هدر اطلاع رسانی شروع یک بحث جدید به صورت ذیل است:
و سپس نظری که برای آن ارسال میشود، چنین هدرهایی را خواهد داشت:
برای نمونه در اینجا کل موضوع مرتبط با ELMAH، تنها در طی یک ایمیل نمایش داده میشود و هرچند 13 ایمیل، مرتبط با آن هستند، اما 13 ایمیل به صورت جداگانه نمایش داده شده را دریافت نمیکنیم. علت این موضوع به Header خاص این نوع ایمیلها بر میگردد:
From: Atif Aziz <notifications@github.com> Reply-To: elmah/Elmah <reply+000bb03ad52eb40a4ec2d49bf78c53c3eba42efc401701a592cf00000001143e18c892a169ce0ae0bf4c@reply.github.com> To: elmah/Elmah <Elmah@noreply.github.com> Message-ID: <elmah/Elmah/issues/407/260080923@github.com> In-Reply-To: <elmah/Elmah/issues/407@github.com> References: <elmah/Elmah/issues/407@github.com> Subject: Re: [elmah/Elmah] Will ELMAH be ported to ASP.NET Core? (#407)
Message-ID بیانگر شمارهی منحصربفرد ایمیل ارسالی است.
فیلدهای اختیاری In-Reply-To و References تنها زمانی ذکر میشوند که قصد ارسال پاسخی، به یک Message-ID خاص، وجود داشته باشد. بنابراین مقدار درج شدهی در آنها دقیقا باید معادل Message-ID ایی باشد که پیشتر ارسال شدهاست.
اگر تنها فیلد References ذکر شود، از آن جهت تشخیص گروه یا Thread ایمیلهای رسیده استفاده میشود.
اگر نیاز به ذکر بیش از یک Message-ID وجود داشته باشد، نحوهی درج آن به صورت ذیل است:
References:<11111@yoursite.com><22222@yoursite.com><33333@yoursite.com>
نحوهی پیاده سازی این قابلیت توسط SmtpClient دات نت
در کدهای ذیل نحوهی افزودن هدرهای یاد شده را توسط SmtpClient دات نت مشاهده میکنید:
var smtpClient = new SmtpClient("….",587); using (MailMessage message = new MailMessage("USERNAME@gmail.com","USERNAME@gmail.com")) { message.Subject = "test"; message.Headers.Add("Message-ID", "<MESSAGEID@site.com>"); smtpClient.Send(message); } using (MailMessage message = new MailMessage("USERNAME@gmail.com","USERNAME@gmail.com")) { message.Subject = "Re: test"; message.Headers.Add("In-Reply-To", "<MESSAGEID@site.com>"); message.Headers.Add("References", "<MESSAGEID@site.com>"); smtpClient.Send(message); }
از این ID در ایمیلهای بعدی جهت ارجاع به آن و نمایش Thread مانند آنها، به کمک فیلدهای In-Reply-To و References، استفاده خواهیم کرد.
برای مثال هدر اطلاع رسانی شروع یک بحث جدید به صورت ذیل است:
message.Headers.Add("Message-ID", $"<post/{post.id}@your-app-name.example>");
message.Headers.Add("Message-ID", $"<comments/{comment.id}@your-app-name.example>"); message.Headers.Add("In-Reply-To", $"<post/{post.id}@your-app-name.example>"); message.Headers.Add("References", $"<post/{post.id}@your-app-name.example>");