MAIL New attachment

4D v19

Mail

MAIL New attachment


MAIL New attachment ( valor {; nome {; cid {; tipo {; disposição}}}} ) -> Resultado

Parâmetro	Tipo	Descrição
valor	Texto, BLOB	Rota no arquivo anexado (texto), ou Blob contendo o anexo (BLOB)
nome	Texto	Nome + extensão usado pelo cliente de email para designar o anexo
cid	Texto	ID do anexo (apenas mensagens HTML) ou "" se não precisar de cid
tipo	Texto	Valor do cabeçalho tipo conteúdo
disposição	Texto	Valor do cabeçalho disposição-conteúdo: "inline" ou "attachment"
Resultado	Objeto	Objeto anexado

Descrição

O comando MAIL New attachment permite que crie um objeto anexado que pode adicioanr a um objeto mail (ver transporter.send( )).

Em valor, passe os conteúdos do anexo. Pode passar:

um texto valor contendo a rota do arquivo anexo, expresso com a sintaxe de sistema. Pode pasar um nome de rota completo ou um nome simples de arquivo (neste caso 4D vai procurar pelo arquivo no mesmo diretório como um arquivo de estrutura de banco de dados).
ou um BLOB valor contendo o próprio anexo.

O parâmetro opcional nome permite passar o nome e extensão a ser usado pelo cliente mail para atribuir o anexo. Se nome for omitido e:

valor for uma rota arquivo, o nome e extensão do arquivo for usado,
valor é um BLOB, um nome aleatório sem extensão é gerado automaticamente.

O parâmetro opcional cid permite passar uma ID interna para o anexo. Este ID é o valor do cabeçalho Content-Id header, será usado apenas nas mensagens HTML. O cid associa o anexo com uma referência definida no corpo da mensagem usando uma tag HTML como <img src="cid:ID">. Isso significa que os conteúdos do anexo (por exemplo uma imagem) pode ser exibida dentro da mensagem no cliente mail. O resultado final pode variar dependendo do cliente mail. Pode passar uma string vazia em cid se não quiser usar este parâmetro.

Pode usar o parâmetro opcional tipo para explicitamente estabelecer o tipo-conteúdo do arquivo anexo. Por exemplo, pode pasar uma string definindo um tipo MIME ("video/mpeg"). Este valor conteúdo-tipo é estabelecido para o anexo, independente da extensão. Para saber mais sobre tipos MIME, veja a página da wikipedia sobre tipos MIME.
Como padrão, se este parâmetro for omitido ou contendo uma string vazia, o conteúdo-tipo do arquivo anexo é baseado em sua extensão. As regras abaixo são aplicadas para os tipos principais MIME:

Extensão

Tipo 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

O parâmetro opcional disposição permite que passe o cabeçalho conteúdo-disposição do anexo. Pode passar uma das constantes abaixo do tema constantes "Mail":

Constante	Valor	Comentário
mail disposition attachment	attachment	Define o valor do cabeçalho Content-disposition para "attachment", o que significa que o arquivo adjunto deve ser proporcionado como um link na mensagem.
mail disposition inline	inline	Define o valor do cabeçalho Content-disposition para "inline", o que significa que o arquivo adjunto deve ser representado dentro do conteúdo da mensagem, na localização "cid". A renderização depende do cliente de correio.

Como padrão, se o parâmetro disposição for omitido:

Se o parâmetro cid for usado, o cabeçalho conteúdo-disposição é estabelecido para "inline",
Se o parâmetro cid não for passado ou estiver vazio, o cabeçalho Conteúdo-dispoição é estabelecido para "attachment".