Paul at 14:43, 1 February 2013

2013-02-01T14:43:41Z

Paul at 20:54, 20 August 2012

2012-08-20T20:54:38Z

Paul: Created page with "'''Support of National Charsets''' == International Characters in Email Messages == Most of the modern email clients support national character in the email body. Enc..."

2012-08-20T20:52:41Z

Created page with "<big>'''Support of National Charsets'''</big> == International Characters in Email Messages == Most of the modern email clients support national character in the email body. Enc..."

New page

<big>'''Support of National Charsets'''</big>

== International Characters in Email Messages ==
Most of the modern email clients support national character in the email body. Encoding can be specified in the message envelope using '''Content-Type''' header. For instance, the following line added to the message header would inform email client that email body should be treated as HTML using UTF-8 character set.
Content-Type: text/html; charset=utf-8

Nevertheless, what do we suppose to do with international characters in the message envelope, such as email subject or "From" email address? Depending on your environment, there are few options.

=== Transfer unicode characters in UTF-8 ===
While it was not originally supported in SMTP protocol, using UTF-8 encoding in message envelopes became standard de facto, and eventually was documented in RFCs extending SMTP protocol.
In most of the environments, and for most of the modern email clients it is safe to assume that UTF-8 content can be transferred as-is, and it is default behavior for the Email Notification package. Nevertheless, you still need to specify character set using '''Content-Type''' header as described above.

=== Transcoding unicode characters ===
In some rare cases when email client or email server cannot handle UTF-8 encoded characters in the message envelope, a workaround documented in the [http://tools.ietf.org/html/rfc2047|RFC 2047] can be used.
The following is an example of user-defined function that can be used to encode UTF-8 strings using Base64 encoding and presenting it in the format specified in the RFC.
 
{| width="100%" border="1" cellspacing="2" cellpadding="2"
! width="20%" valign="top" | Name 
! valign="top" | nm_value 
|-
| width="20%" valign="top" | RT_Encode_Envelope 
| valign="top" | <source lang="perl">

my $string = shift;

require utf8;
require MIME::Base64;

utf8::encode($string);
$string = MIME::Base64::encode($string);
return "=?UTF-8?B?$string?=";
</source>
|}
 
When udb_property record is submitted, this user-defined function can be used to safely encode envelope fields that can contain unicode characters, for instance message subject:
RT_Encode_Envelope("Defect $ID - $headline")

[[Category:ClearQuest]] [[Category:Email_Notification_Package]]

← Older revision		Revision as of 14:43, 1 February 2013
Line 35:		Line 35:
	RT_Encode_Envelope("Defect $ID - $headline")		RT_Encode_Envelope("Defect $ID - $headline")

−	[[Category:ClearQuest]] [[Category:Email_Notification_Package]]	+	<br />
		+
		+	[[Category:Rational]] [[Category:ClearQuest]] [[Category:Email_Notification_Package]]

@@ Line 20: / Line 20: @@
 |-
 | width="20%" valign="top" | RT_Encode_Envelope<br />
-| valign="top" | <source lang="perl">
+| valign="top" | <source lang="perl">my $string = shift;
 require utf8;
@@ Line 29: / Line 27: @@
 utf8::encode($string);
 $string = MIME::Base64::encode($string);
 return "=?UTF-8?B?$string?=";
 </source>

Email Envelope and UTF-8 - Revision history

Paul at 14:43, 1 February 2013

Paul at 20:54, 20 August 2012

Paul: Created page with "'''Support of National Charsets''' == International Characters in Email Messages == Most of the modern email clients support national character in the email body. Enc..."