4D Internet Commands v14

SMTP_Charset

Página Inicial

 
4D Internet Commands v14
SMTP_Charset

SMTP_Charset 


 

SMTP_Charset ( codifiCab ; conjCorpos ) -> Resultado 
Parâmetro Tipo   Descrição
codifiCab  Inteiro in -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 in -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 in Código de erro

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 é €")

 
PROPRIEDADES 

Produto: 4D Internet Commands
Tema: IC Send Mail
Número 88892

 
HISTÓRIA 

Modificado: 4D Internet Commands 6.8.1

 
VER TAMBÉM 

POP3_Charset
SMTP_SetPrefs

 
ARTICLE USAGE

4D Internet Commands ( 4D Internet Commands v11.4)
4D Internet Commands ( 4D v13.2)
4D Internet Commands ( 4D Internet Commands v12.1)
4D Internet Commands ( 4D Internet Commands v14 R2)
4D Internet Commands ( 4D Internet Commands v14)
4D Internet Commands ( 4D Internet Commands v14 R3)
4D Internet Commands ( 4D Internet Commands v14 R4)