SMTP_Attachment

4D v20

SMTP_Attachment


SMTP_Attachment ( smtp_ID ; nomeArquivo ; tipoCod ; excluirOpcao {; idAdjunto {; tipoConteudo}} ) -> Resultado

Parâmetro	Tipo	Descrição
smtp_ID	Inteiro longo	Referencia da mensagem
nomeArquivo	Texto	Nome do arquivo a anexar
tipoCod	Inteiro	0 = Não codificar (só envia o DataFork) ±1 = BinHex ±2 = Base64; (só envia o DataFork) ±3 = AppleSingle ±4 = AppleDouble ±5 = AppleSingle E Base64 ±6 = AppleDouble E Base64 ±7 = UUEncode
excluirOpcao	Inteiro	0 = Adicionar à lista existente, 1 = Substituir todos os anexos por nomeArquivo, 2 = Excluir somente este anexo
idAdjunto	Texto	ID do arquivo adjunto(mensagens HTML unicamente)
tipoConteudo	Texto	Valor do tipo de conteúdo
Resultado	Inteiro	Código de erro

Descrição

O comando SMTP_Attachment permite adicionar arquivos binários ou de texto a sua mensagem em formato MIME. Este comando pode ser chamado várias vezes para anexar vários documentos a uma mensagem. Se passa um valor maior que zero no parâmetro tipoCod, este comando realizará a codificação no momento do envio da mensagem.

smtp_ID é a referencia inteiro longo de uma mensagem criado com o comando SMTP_New.

nomeArquivo contém o nome do arquivo a anexar a mensagem. Este valor pode ser especificado de três formas diferentes:

    nomArchivo = busca o nome de arquivo no mesmo diretório da estrutura do banco de dados

    Rota:nomeArquivo = rota de acesso completa incluindo o nome de arquivo

Nota:, os nomes dos arquivos estão limitados a 1.024 caracteres, qualquer que seja o sistema operacional.

tipoCod é um valor inteiro que indica que tipo de codificação aplicar ao arquivo antes de integrar a mensagem. Se anexa um arquivo binário, deve utilizar um método de codificação adequado (BinHex, AppleSingle). O método de codificação mais comum é BinHex.

Se passar valores positivos em tipoCod o comando codifica automaticamente o arquivo utilizando o método especificado quando é enviada a mensagem. A codificação de um arquivo se produz no momento em que é executado o comando SMTP_Send. Se o arquivo é grande a execução do comando SMTP_Send pode demorar uns momentos. Pode economizar tempo quando o mesmo arquivo se envia várias vezes. Nestes casos o melhor é codificar o arquivo uma vez com o comando IT_Encode e depois anexar o arquivo resultante a sua mensagem utilizando o valor negativo de tipoCod. Um valor negativo em tipoCod não realizará nenhuma codificação adicional, mas que o tipo de codificação é descrito no cabeçalho do arquivo adjunto à mensagem. Isto informa ao software de mensagens do destinatário a forma correta de interpretar os dados anexos.

Nota: Não pode passar um elemento de array no parâmetro tipoCod.

excluirOpcao é um parâmetro inteiro opcional que especifica a forma de tratar os dados adjuntos.

Um valor de zero adiciona o arquivo anexo à lista atual dos arquivos adjuntos.
Um valor de 1 substitui todos os arquivos anexos com o arquivo nomeArquivo. Se nomeArquivo é uma cadeia vazia, todos os arquivos anexos serão excluídos.
Um valor de 2 eliminará somente o arquivo adjunto listado em nomeArquivo da lista de arquivos anexos.

O parâmetro idAdjunto associa o arquivo adjunto com uma referência definida no corpo da mensagem utilizando a etiqueta HTML t<img src=\"cid:ID\">. Isto significa que o conteúdo dos arquivos, por exemplo uma imagem, podem ser mostrados na mensagem no cliente de correio eletrônico.
Este funcionamento só é compatível com as mensagens em HTML. Também tenha em conta que o resultado final pode variar dependendo do cliente de correio eletrônico.

O parâmetro opcional tipoConteudo define explicitamente o tipo de conteúdo do arquivo adjunto. De forma pré determinada, se este parâmetro se omite ou contém uma cadeia vazia, 4DIC define automaticamente o tipo de conteúdo do arquivo adjunto em função de sua extensão. Se aplicam as seguintes regras:

Extensão	Tipo de conteúdo
jpg, jpeg	image/jpeg
png	image/png
gif	image/gif
pdf	application/pdf
doc	application/msword
xls	application/vnd.ms-excel
ppt	application/vnd.ms-powerpoint
zip	application/zip
gz	application/gzip
json	application/json
js	application/javascript
ps	application/postscript
xml	application/xml
htm, html	text/html
mp3	audio/mpeg
other	application/octet-stream

Em tipoConteudo, pode passar uma cadeia que defina o tipo de conteúdo para o arquivo (tipo MIME), por exemplo "video/mpeg". Este valor de tipo de conteúdo se estabelecerá para os dados adjuntos, independentemente de sua extensão.

Nota: passe uma cadeia vazia ("") no parâmetro idAdjunto se não o deseja utilizar.

Exemplo 1

Envio de uma mensagem HTML com uma imagem incluída:

 $error:=SMTP_New($smtp_id)

 $error:=SMTP_Host($smtp_id;"smtp.gmail.com")

 $error:=SMTP_From($smtp_id;"henry@gmail.com")

 $error:=SMTP_ReplyTo($smtp_id;"replies@gmail.com")

 $error:=SMTP_Subject($smtp_id;"HTML Test & picture included")

 $error:=SMTP_To($smtp_id;"john@4d.com";1)

 $error:=SMTP_Body($smtp_id;"<html><B><I>Hello world in bold!</I></B> <img src=\"cid:myID123\">(normal text)</HTML>";4)

 $error:=SMTP_Attachment($smtp_id;"c:\\temp\\tulips.jpg";2;0;"myID123")

 $error:=SMTP_Auth($smtp_id;"henry@gmail.com";"*******")

 $error:=SMTP_Send($smtp_id;1)

 $error:=SMTP_Clear($smtp_id)

Exemplo 2

Queremos declarar seus arquivos de configuração como arquivos XML:

 $path:=Get 4D folder(Database folder)+"Settings.mySettings"

 $err:=SMTP_Attachment($smtp_id;$path;2;0;"myID123";"application/xml")

Ver também

IT_Encode
SMTP_New
SMTP_Send