4D Doc Center : SMTP

4D Internet Commands v14

SMTP_Charset


SMTP_Charset ( codifiCab ; conjCorpos ) -> Resultado

Parâmetro	Tipo	Descrição
codifiCab	Inteiro	-1 = Utilizar a configuração atual, 0 = Não fazer nada, 1 = Converter utilizando o conjunto de caracteres especificado se ISO-8859-1 ou ISO-2022-JP, codificar os caracteres estendidos
conjCorpos	Inteiro	-1 = Utilizar o parâmetro atual, 0 = Não faz nada, 1 = Converter no conjunto de caracteres Mac OS se ISO-8859-1 ou ISO-2022-JP
Resultado	Inteiro	Código de erro

Descrição

O comando SMTP_Charset permite o suporte automático das mensagens que contém caracteres estendidos, durante seu envio com os comandos SMTP_QuickSend ou SMTP_Send. Se este comando não é chamado ou tem os parâmetros em 0, os Internet Commands versão 6.7 ou superior funcionarão do mesmo modo que a versão 6.5.x.

O comando SMTP_Charset permite em primeiro lugar, definir se o conjunto de caracteres definido no parâmetro tipoCorpo do comando SMTP_SetPrefs deve ser aplicado aos cabeçalhos e corpos das mensagens a enviar; em segundo lugar, para definir se um cabeçalho que contém caracteres estendidos deve ser codificados utilizando a sintaxes “=?ISO-8859-1?Q?Test=E9?= …” como o especifica a RFC # 1342. Este comando tem um alcance interprocessos e terá efeito em todos as mensagens posteriores que se enviem com SMTP_QuickSend e SMTP_Send em todos os processos 4D.

Este comando é especialmente útil para suportar caracteres estendidos incluídos nos cabeçalhos da mensagem, tais como Assunto ou os nomes inseridos nos endereços (por exemplo, para a codificação de endereços como “=?ISO-8859-1?Q?Test=E9?= <test@n.net >”).

Dependendo dos cabeçalhos da mensagem, a codificação (sempre é estabelecida em base 64 (a exceção do cabeçalho Assunto) e dependendo do valor do parâmetro tipoCorpo do comando SMTP_SetPrefs) é realizado da seguinte maneira:

Para os cabeçalhos Assunto e Comentários (chamado "cabeçalhos não estruturados"): toda a cadeia é codificada se inclui caracteres estendidos.
Para os cabeçalhos From, To, CC, Bcc, Sender, ReplyTo, InReplyTo (chamados "cabeçalhos estruturados"):
- Qualquer texto entre (“<”, “>”) é sistematicamente considerado como um endereço de email e não é codificado.
- Os caracteres separadores tais como SPC < > ( ) @ , ; : " / ? . = não são codificados.
- As cadeias delimitadas por caracteres especiais são codificados se incluem caracteres estendidos.
- Exemplos de endereços:
  someone@somewhere não é codificado;
  Michèle <michele@somewhere>, só é codificado o nome Michèle.

O parâmetro CodifiCab especifica como lidar com a conversão do cabeçalho e a codificação durante o envio de uma mensagem. O valor por padrão é 0.

-1: Usar a configuração atual;
0: Não fazer nada;
1:
- Por uma parte, se o comando SMTP_SetPrefs define o conjunto de caracteres ISO-8859-1 ou ISO-2022-JP, os cabeçalhos são convertidos utilizando o conjunto de caracteres especificado.
- Por outra parte, os cabeçalhos é codificado utilizando a seguinte sintaxes “=? Charset specified by the SMTP_SetPrefs command? Base64 Encoding?Test=E9?= …” (ver RFC#1342) se incluem caracteres estendidos, sem importar o conjunto de caracteres especificado.
- Exceção: O cabeçalho Assunto é codificado no modo definido pelo parâmetro tipoCorpo do comando SMTP_SetPrefs caso seja necessário.

Nota: Os cabeçalhos estendidos de tipo X_Mailer devem estar em ASCII US.

O parâmetro conjCorpos define os tratamentos a aplicar ao corpo da mensagem durante seu envio. O valor por padrão é 0.

-1: Usar a configuração atual;
0: Não fazer nada;
1: Se o comando SMTP_SetPrefs define o conjunto de caracteres como ISO-8859-1 ou ISO-2022-JP, o corpo da mensagem se converte utilizando o conjunto de caracteres especificado.

Exemplo

Neste exemplo, o assunto e o corpo se convertem utilizando o conjunto de caracteres ISO-8859-1 e o assunto está codificado de acordo a sintaxes RFC 1342:

 SMTP_SetPrefs(1;1;0)

 $err:=SMTP_Charset(1;1)

 $err:=SMTP_QuickSend("mimail.com";"meuendereço";"destino";"O Euro €";"o símbolo do Euro é €")